johnnyb

<p>DeadTrees is a WordPress plugin that allows you to share the books you’ve been reading with your readers.</p>
<p>It’s slightly influenced by other “My Library” type of plugins, such as the whole Now Reading/Reloaded/Redux group of plugins, but is a complete re-write using WordPress’s Custom Post Type features.</p>
<p>I wrote Dead Trees because I want to post on my blog when I read a book, but only sometimes want to write about the book. Dead Trees lets me, (and you!), do that.</p>
<h3>New in Version 1.1: Multiple Book Cover Sources</h3>
<p>In version 1.1 book covers will be fetched from <a href="https://openlibrary.org/" rel="nofollow ugc">OpenLibrary.org</a>, <a href="https://www.librarything.com/" rel="nofollow ugc">LibraryThing</a>, or Amazon, depending on the settings, and what’s available where.</p>
<p>If you have set your Amazon API credentials, you can choose to look for a cover at Amazon either first or last: first for people who are working on building affiliate income from Amazon, and have plenty of <a href="https://docs.aws.amazon.com/AWSECommerceService/latest/DG/TroubleshootingApplications.html#efficiency-guidelines" rel="nofollow ugc">API quota</a>, or last for people who prefer to promote independent book sources or can’t or don’t want to use Amazon’s services.</p>
<p>For non-Amazon book covers, OpenLibrary.org is checked first as it provides larger images than other options. If OpenLibrary.org doesn’t have a cover for a book and you have set a LibraryThing API key we will fall back to looking for a cover at LibraryThing.</p>
<p>OpenLibrary.org does not require any API credentials or any special configuration.</p>
<h3>How it works</h3>
<p>To post a book that you read, you’ll go to the admin of your site and choose “Books” from the main menu. You can then enter the title of the book, the author’s name(s), ISBN, Amazon’s ASIN, (likely the ISBN), and, if you wish, you may write about the book, but you don’t have to if you don’t want to.</p>
<p>Hit publish and the DeadTrees will grab the cover art from Open Library or Amazon and publish your book.</p>
<p>You can also tag the book, just like a post. The pool of tags is shared between posts & books.</p>
<p>Development is on GitHub at https://github.com/jbeales/DeadTrees</p>
<p>Report issues at https://github.com/jbeales/DeadTrees/issues</p>
<p>See the public side in action, with some custom templating: https://johnbeales.com/books/</p>
<h3>Thanks</h3>
<p>Thanks to OpenLibrary.org and LibraryThing for providing open book cover data. APIs like these that share information make the independent web possible and fun.</p>
<h3>Troubleshooting</h3>
<p>If you get a 404 error when trying to view your first book post, visit the Permalinks page in the admin, (Settings > Permalinks), and please leave a comment on <a href="https://github.com/jbeales/DeadTrees/issues/13" rel="nofollow ugc">Github issue #13</a> or post in the support forums on wordpress.org to let me know that the problem isn’t fixed yet.</p>
<h3>Templating</h3>
<h3>Template Tags</h3>
<p>Dead Trees creates some template tags for you. Here are the important ones. If you want to see the not-so-important ones look in template_tags.php, they’re all there:</p>
<h3>dt_bookbox()</h3>
<p>Displays a box with the book’s cover art and links to buy it from Amazon.com, Amazon.ca, and Amazon.co.uk.</p>
<p>Call dt_bookbox() inside the loop or pass it the post ID of a book.</p>
<p>You can completely customize the output of dt_bookbox() by creating a file called deadtree-bookbox.php in your theme. You might want to copy deadtrees/template/deadtree-bookbox.php as a starting point.</p>
<h3>dt_get_amazon_url($domain=’amazon.com’, $post_id=0)</h3>
<p>Gets the Amazon affiliate URL for a book.<br />
Choose which site to link to with the first argument, (can be ‘amazon.com’ ‘amazon.ca’ or ‘amazon.co.uk’, defaults to ‘amazon.com’). If called in the loop the second argument is not required, but if you want to call this outside of the loop provide the post ID of a book as the second argument.</p>
<h3>dt_get_bookbox_image($post_id=0)</h3>
<p>Gets the cover art for a book. If called in the loop this function can, (and should), be called with no arguments. Uses wp_get_attachment_image() to get the image.</p>
<h3>dt_get_bookbox_comment($post_id=0)</h3>
<p>Gets an extra comment to display in the bookbox. You enter this in the admin in the box that you put the ASIN into. This should be called with no arguments in the loop, or passed the post ID of a book outside of the loop.</p>
<h3>Template Files</h3>
<p>Dead Trees introduces a new post type: dt_book, and a new taxonomy: dt_writer. This means that you can put a file into your theme called type-dt_book.php and it’ll be used in place of single.php, and you can add taxonomy-dt_writer.php and it’ll be used in place of tag.php. This way you can make your reading list look like a real library!</p>
<h3>On Caching Plugins</h3>
<p>If you use WP Super Cache, you’ll need to clear your cache, or turn off caching, when updating the design of the bookbox, (updating deadtree-bookbox.php), and when updating your Amazon Affiliate IDs. Once your changes are made just make sure the cache is clear and turn caching back on.</p>
<p>I’m not sure about other caching plugins, but I suspect they’ll behave in a similar manner.</p>


DeadTrees

Share the books you've read with your readers, family, & friends.  Never again receive a book you've already read as a gift!

Scott

<p>My Reading Library is a very heavy modification of the <a href="http://blog.ashodnakashian.com/projects/now-reading-redux/" title="Now Reading Redux" rel="nofollow ugc">Now Reading Redux plugin by Ashod Nakashian</a> which is a resurrection of the <a href="http://heliologue.com/" title="Now Reading Reloaded" rel="nofollow ugc">Now Reading Reloaded plugin by Ben Gunnink</a> which is a fork of the <a href="http://robm.me.uk/projects/plugins/wordpress/now-reading/" title="Now Reading Plugin" rel="nofollow ugc">Now Reading plugin by Rob Miller</a>.</p>
<p>It allows you to develop a library, show the book details, track your progress, rate the book, and link to a WP post of your book review. It displays the library within the sidebar and on the library/book page with cover art fetched from Amazon.</p>
<p>The home of the My Reading Library plugin is in this WP Repository; however, you may report bugs and receive support: <a href="http://www.affordable-techsupport.com/support/" title="My Reading Library" rel="nofollow ugc">www.affordable-techsupport.com/support/</a></p>
<h4>Disclaimer</h4>
<p>Please backup your database before installing/upgrading. Thought I attempt to releases bug-free plugins (which is very difficult), my ability to perform tests is limited. If you find any bugs or have feature requests, please kindly report them in the Support Forum within my website.</p>
<h3>Update Path</h3>
<ul>
<li>Pull total pages of book from Amazon and set as property on book edit page.</li>
<li>Use calendar UI for dates on the book edit page.</li>
<li>Set number of books displayed in each widget book category.</li>
</ul>
<h3>Known Bugs</h3>
<ul>
<li>In the book manager, the Title and Reader columns will not sort properly when the title is clicked</li>
<li>The integration with the Twenty Eleven WP Theme is inconsistent and buggy</li>
<li>Total books setting in options does not effect onhold books</li>
</ul>
<h3>Demo Site</h3>
<p>You can see the My Reading Library plugin in action on my demo website: http://test.p4x.org/</p>


My Reading Library

Displays books in the sidebar and library/book page with cover art fetched from amazon.com; displays book details, progress, ratings, and reviews.

DeadTrees vs My Reading Library