Now Reading Redux

Please read the Upgrade section under Installation.

Please leave a note on the blog.ashodnakashian.com/projects/now-reading-redux/ . That is probably the easiest way. However, you may also log bugs on github.com/Ashod/Now-Reading-Redux or on https://wordpress.org/extend/plugins/now-reading-redux/ .

Please find the original Now Reading Relaoded readme with the changelog in the readme.old file.

What the plugin ends up looking like is controlled mainly by two things: templates and CSS.

The templates folder contain a single php file for each page or element on the screen, with the exception of ‘shelf.php’ which renders the actual book shelves (starting with v6.5). With a little PHP and HTML knowledge it’s relatively easy to customize these files to fit your needs. However, before doing that I urge you to look into the CSS and make the most of it, failing that, consider making a suggestion on the plugin homepage and everyone may benefit from your suggestion in an upcoming version.

The second method to control the look and style of NRR is via the CSS script. Starting with version 6.5 library, search and sidebar allow you to write a custom CSS script in the options page. The plugin is highly customizable if you know your CSS. For example, lists are rendered in a table-style (images only) using CSS.

With new versions new options are added for ease of use and flexibility. Every effort is done to keep backwards compatibility, however, in some cases this isn’t possible. It’s also desirable to cleanup and refactor old options.

To avoid problems and surprises, please revisit the NRR options page after every update. Check your old options and learn about the new ones. Sometimes default values aren’t set correctly and therefore PHP defaults are effective. This sets some values to false and texts to blank.

If you get a warning such as “URL file-access is disabled in the server configuration” then you need to edit your PHP.ini file. Searching relies on PHP’s file_get_contents() function. This function is subject to security permissions. Specifically, allow_url_fopen must be set to ‘on’ in PHP.ini (which is the default). More information here , file_get_contents’s reference and allow_url_fopen’s reference .

Note: Starting from v6.7.0 file_get_contents has been replaced by Snoopy/cURL controlled from the Options page.

Starting with version 6.5 there is an option that controls the maximum number of books shown for each shelf.

To customize older version, you’ll have to change the query string in the section in question. Under the section heading in question, find the following line (exact values may be different):

This is a PHP function call (named have_books) and the string between the quotes is the query string. To change the number of items returned by this call simply add “&num=4” (without the double quotes.) Here I chose to return 4 items, but you can set it to any number. If you set it to -1 you’ll get all!

Here is how you may set it to return 7 finished books: have_books(‘status=read&orderby=finished&order=desc&num=7’)

Any number of attributes can be used. Leaving out an attribute gives it the default value.

style => [list*, numbered, table]. status => [unread, reading, onhold, read, all*]. orderby => [reading, read, onhold, finished*]. order => [asc, desc*]. search => A substring to match author, title. author => The author to show books by. title => The book title to show. rating => Book rating Between 1 and 10 inclusive. reader => The user’s ID who added the book. started_year => The started year in decimal. started_month => The started month in decimal. finished_year => The finished year in decimal. finished_month => The finished month in decimal. num => The maximum number of items to show. -1 for all (default). viz => hide, show_text*, show_image, show_image_text. items_per_row => Number of books per row. Only for style=table. 1 by default.

Example: Default everything. Lists all titles and authors of books sorted by last-finished first.

[nrr_shelf]

Example: Lists titles and authors of books finished in the year 2011.

[nrr_shelf style=”numbered” viz=”show_text” status=”all” num=”-1″ order=”asc” finished_year=”2011″]

Example: Lists titles and authors of books finished reading with a rating of 9.

[nrr_shelf style=”numbered” viz=”show_text” status=”all” num=”-1″ order=”asc” rating=”9″]

Example: Covers of all books currently reading.

[nrr_shelf style=”table” viz=”show_image” status=”reading” num=”-1″ order=”asc” items_per_row=”3″]

Example: Covers, titles and authors of all books in the library sorted by last-finished first.

[nrr_shelf style=”list” viz=”show_image_text” status=”all” num=”-1″ order=”desc”]

Example: Lists titles and authors of books started reading on or after April 2011, finished before or during November 2011 and has a rating of at least 8.

[nrr_shelf style=”numbered” viz=”show_text” status=”all” num=”-1″ order=”asc” rating=”>=8″ started_year=”2011″ started_month=”>3″ finished_year=”<=2011″ finished_month=”<=11″]