{"id":11918,"date":"2011-01-28T19:48:27","date_gmt":"2011-01-28T19:48:27","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/currently-reading\/"},"modified":"2024-05-14T08:54:37","modified_gmt":"2024-05-14T08:54:37","slug":"currently-reading","status":"publish","type":"plugin","link":"https:\/\/tah.wordpress.org\/plugins\/currently-reading\/","author":6463,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"4.1.6","stable_tag":"trunk","tested":"6.5.8","requires":"6.0","requires_php":"","requires_plugins":null,"header_name":"Currently Reading","header_author":"Eug\u00e9ne Roux","header_description":"","assets_banners_color":"","last_updated":"2024-05-14 08:54:37","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/blog.damn.org.za\/widgets\/","header_author_uri":"https:\/\/damn.org.za\/","rating":5,"author_block_rating":0,"active_installs":70,"downloads":10030,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-3.png":{"filename":"screenshot-3.png","revision":3086353,"resolution":"3","location":"plugin"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3086353,"resolution":"5","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3086353,"resolution":"2","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":3086353,"resolution":"1","location":"plugin"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3086353,"resolution":"4","location":"plugin"}},"screenshots":{"1":"The Configuration of a \"Currently Reading\" section, with Padding enabled.","2":"The default \"Widget\" configuration, with the Google Country set to South Africa and an ISBN-13.","3":"The previous configuration as rendered by Safari.","4":"The difference between Padding and Box-Shadow Enabled and Disabled.","5":"Widget Configuration location in the Dashboard's sidebar."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[83,563,1779,1936,9342],"plugin_category":[],"plugin_contributors":[85574],"plugin_business_model":[],"class_list":["post-11918","plugin","type-plugin","status-publish","hentry","plugin_tags-admin","plugin_tags-administration","plugin_tags-books","plugin_tags-read","plugin_tags-reading","plugin_contributors-eroux","plugin_committers-eroux"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/currently-reading.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/currently-reading\/trunk\/screenshot-1.png?rev=3086353","caption":"The Configuration of a \"Currently Reading\" section, with Padding enabled."},{"src":"https:\/\/ps.w.org\/currently-reading\/trunk\/screenshot-2.png?rev=3086353","caption":"The default \"Widget\" configuration, with the Google Country set to South Africa and an ISBN-13."},{"src":"https:\/\/ps.w.org\/currently-reading\/trunk\/screenshot-3.png?rev=3086353","caption":"The previous configuration as rendered by Safari."},{"src":"https:\/\/ps.w.org\/currently-reading\/trunk\/screenshot-4.png?rev=3086353","caption":"The difference between Padding and Box-Shadow Enabled and Disabled."},{"src":"https:\/\/ps.w.org\/currently-reading\/trunk\/screenshot-5.png?rev=3086353","caption":"Widget Configuration location in the Dashboard's sidebar."}],"raw_content":"<!--section=description-->\n<p>Supplying an <a href=\"https:\/\/en.wikipedia.org\/wiki\/International_Standard_Book_Number\">ISBN<\/a> (and, optionally, a Title) will display a cover image of the relevant book with a link to that book's page on <a href=\"https:\/\/books.google.co.za\/\">Google Books<\/a> using the Google Books API.<\/p>\n\n<p>Using the Widget you can choose whether to:<\/p>\n\n<ul>\n<li>Force all calls to Google to be HTTPS, instead of the API returned HTTP<\/li>\n<li>Pad the Image (selected by default, uses internal CSS)<\/li>\n<li>Display a Box-Shadow (selected by default, uses internal CSS)<\/li>\n<li>Choose Alternate Google Country (defaults to \"Worldwide\")<\/li>\n<\/ul>\n\n<p>as well as<\/p>\n\n<ul>\n<li>Decide whether you would like to use a Title<\/li>\n<li>Define the ISBN-10 or ISBN-13 of the book.<\/li>\n<\/ul>\n\n<h3>Usage<\/h3>\n\n<ol>\n<li>Activate the Plugin via \"Plugins\" \u2192 \"Currently Reading\" \u2192 \"Activate\" (if you hadn't already done so).<\/li>\n<li>Go to \"Appearance\" \u2192 \"Widgets\" and drag the \"Reading\" widget into whichever Sidebar you choose.<\/li>\n<li>In the \"Currently Reading\" widget, you can then customise it further.<\/li>\n<\/ol>\n\n<!--section=installation-->\n<p><strong>Manual Install<\/strong><\/p>\n\n<ol>\n<li>Unzip the <code>currently-reading.zip<\/code> file.<\/li>\n<li>Upload <code>currently-reading.php<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Use the \"Currently Reading\" widget (found under Appearance \u2192 Widgets).<\/li>\n<\/ol>\n\n<p><strong>Automated Install<\/strong><\/p>\n\n<ol>\n<li>Go to \"Plugins\" \u2192 \"Add New\" in your Control Panel.<\/li>\n<li>Search for the keywords \"Currently Reading\".<\/li>\n<li>Click the \"Install Now\" button on \"Currently Reading\" by \"Eug\u00e9ne Roux\".<\/li>\n<li>When prompted \"Are you sure you want to install this plugin?\" select \"OK\".<\/li>\n<li>Once the installation is finished, you will be prompted to \"Activate Plugin\".<\/li>\n<\/ol>\n\n<p><strong>Upgrade<\/strong><\/p>\n\n<ol>\n<li>Follow your normal installation procedure<\/li>\n<li>Open each Widget's control panel and re-save<\/li>\n<\/ol>\n\n<p><strong>Use the WordPress Plug-in System<\/strong><\/p>\n\n<ol>\n<li>Select \"Upgrade and Activate\"<\/li>\n<li>Congratulate yourself on a sterling job.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='i%20get%20a%20%27%2Awarning%3A%20file_get_contents%20...%20%3A%20failed%20to%20open%20stream%3A%20http%20request%20failed%21%20http%2F1.0%20403%20forbidden%2A%27%20error%20in%20my%20logs%20and%20no%20books%20are%20displayed.%20why%20is%20this%20happening%3F'><h3>I get a '*Warning: file_get_contents ... : failed to open stream: HTTP request failed! HTTP\/1.0 403 Forbidden*' Error in my logs and no books are displayed. Why is this happening?<\/h3><\/dt>\n<dd><p>Your web-site has been configure not to allow outgoing HTTP requests and you have 'Use Google API' enabled.<\/p>\n\n<p>Please de-select the 'Use Google API' option to use the direct connection instead.<\/p><\/dd>\n<dt id='i%20get%20a%20%27%2Ano%20google%20books%20entry%20found%20for%20isbn%3Anumber%2A%27%20on%20my%20blog...%20why%3F'><h3>I get a '*No Google Books Entry Found for ISBN:NUMBER*' on my Blog... Why?<\/h3><\/dt>\n<dd><p>Sometimes Google Books does not return any valid responses on ISBNs. Try the following:<\/p>\n\n<ol>\n<li>See if you can find an alternate ISBN for the book<\/li>\n<li>Toggle the \"Use Google API\" option<\/li>\n<li>Find the eBook on Google's Books Web Page and use its ISBN<\/li>\n<\/ol><\/dd>\n<dt id='are%20you%20planing%20to%20insert%20other%20sources%20than%20google%20books%20to%20the%20currently%20reading%20widget%3F'><h3>Are you planing to insert other sources than Google Books to the Currently Reading widget?<\/h3><\/dt>\n<dd><p>I'll have a look into supporting Amazon, though they do make you jump through hoops to use their API (which is the reason I settled on using Google Books to start with).<\/p><\/dd>\n<dt id='is%20there%20a%20way%20to%20get%20this%20plugin%20to%20do%20a%20library%20of%20all%20of%20your%20books%20into%20wordpress%3F'><h3>Is there a way to get this plugin to do a library of all of your books into WordPress?<\/h3><\/dt>\n<dd><p>It's not currently possible with this plugin, no.<\/p>\n\n<p>I'll give it a bit of thought and see if I can extend it to do that; but it will most likely need the creation of an alternate plugin to do that.<\/p>\n\n<p>This would likely require its own database table to do properly, as well...<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>4.1.6<\/h4>\n\n<ul>\n<li>\"My apologies, your honour, my client is an idiot...\"<\/li>\n<\/ul>\n\n<h4>4.1.5<\/h4>\n\n<ul>\n<li>Updated for 6.5<\/li>\n<\/ul>\n\n<h4>4.0.8<\/h4>\n\n<ul>\n<li>Add option to open Google Books link in a new Tab\/Window<\/li>\n<\/ul>\n\n<h4>4.0.7<\/h4>\n\n<ul>\n<li>Add the option to force the use of SSL (https) on Google's API links<\/li>\n<li>Add the option to force the use of SSL (https) on the Alternate links to Google's API<\/li>\n<li>Tested to WordPress 5.2.3<\/li>\n<\/ul>\n\n<h4>4.0.6<\/h4>\n\n<ul>\n<li>Updated and tested WordPress 5<\/li>\n<\/ul>\n\n<h4>4.0.5<\/h4>\n\n<ul>\n<li>Fix the Google Books API call<\/li>\n<li>Tested to WordPress 4.7<\/li>\n<\/ul>\n\n<h4>4.0.4<\/h4>\n\n<ul>\n<li>Check cache before using it<\/li>\n<li>Check data validity before writing cache<\/li>\n<\/ul>\n\n<h4>4.0.2<\/h4>\n\n<ul>\n<li>Allow (and default to) <em>not<\/em> using the Google Books API in preference to the older -- direct -- connection<\/li>\n<li>Since I'm probably the only Saffer using this, default to \"books.google.com\"<\/li>\n<\/ul>\n\n<h4>4.0.1<\/h4>\n\n<ul>\n<li>Display a message (No Google Books Entry Found for ISBN) when Google has no entry for the book in question<\/li>\n<li>Reduce the width of margins so that the book entries fit better into the sidebar<\/li>\n<li>Added a screenshot of the Widget Configuration location in the Sidebar (mostly since I keep forgetting where it is)<\/li>\n<\/ul>\n\n<h4>4.0<\/h4>\n\n<ul>\n<li>Use the Google Books API instead of previous deep-linking<\/li>\n<li>Fix display of ISBN when updating the widget<\/li>\n<li>Allow the selection of Alternate Google Domains (books.google.com causes issues in some countries)<\/li>\n<li>Display book's Title instead of ISBN on mouse-over<\/li>\n<\/ul>\n\n<h4>3.4<\/h4>\n\n<ul>\n<li>Minor fixes to ensure WordPress compatibility<\/li>\n<\/ul>\n\n<h4>3.3<\/h4>\n\n<ul>\n<li>Moved to a '&lt;div&gt;' based layout instead of using Lists (Kudos to James Sumners for the suggestion)<\/li>\n<\/ul>\n\n<h4>3.2<\/h4>\n\n<ul>\n<li>Improved the book spacing a bit in the internal CSS<\/li>\n<\/ul>\n\n<h4>3.1<\/h4>\n\n<ul>\n<li>Added the ability to have drop-shadows around the front-cover images of the books<\/li>\n<\/ul>\n\n<h4>3.0<\/h4>\n\n<ul>\n<li>Release number re-alignment with internal Hg repo<\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<ul>\n<li>Fixed a potentially embarrassing issue with generated HTML<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial Public Release<\/li>\n<\/ul>","raw_excerpt":"Displays a cover image of a book with a link to Google Books based on a supplied ISBN-10 or ISBN-13.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/11918","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=11918"}],"author":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/eroux"}],"wp:attachment":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=11918"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=11918"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=11918"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=11918"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=11918"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=11918"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}