Title: Book Review Library
Author: Chris Reynolds
Published: <strong>Август 26, 2013-ж.</strong>
Last modified: Июль 19, 2022-ж.

---

Плагиндерди издөө

![](https://ps.w.org/book-review-library/assets/banner-772x250.jpg?rev=2667655)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/book-review-library_ffffff.svg)

# Book Review Library

 Автору [Chris Reynolds](https://profiles.wordpress.org/jazzs3quence/)

[Жүктөө](https://downloads.wordpress.org/plugin/book-review-library.1.4.23.zip)

 * [Кенен маалымат](https://ky.wordpress.org/plugins/book-review-library/#description)
 * [Сын-пикирлер](https://ky.wordpress.org/plugins/book-review-library/#reviews)
 *  [Орнотуу](https://ky.wordpress.org/plugins/book-review-library/#installation)
 * [Development](https://ky.wordpress.org/plugins/book-review-library/#developers)

 [Колдоо](https://wordpress.org/support/plugin/book-review-library/)

## Сүрөттөө

The Book Review Library plugin allows you to create a library of books, with reviews,
that include sortable meta information like author, illustrator, genre, subjects
as well as ratings. This enables you to list all the books of a particular type (
e.g. all books written by a particular author or with a specific rating). With very
little effort, the book review system will be up and running on your site right 
away, with built in filters to add this extra information to the page without any
custom theming.

A configurable shortcode is also built in, to display a book list. `[book-reviews]`
will display all books, while `[book-reviews count=3]` will only display 3 books
and `[book-reviews count=3 covers=true]` will display those reviews with their covers,
if they exist.

Two sidebar widgets have also been included. A Recent Reviews widget will display
the most recent book reviews that have been added, and a Related Books widget will
display a list of similar books when you are looking at a single book or book list
by common genre tags.

Theme developers haven’t been forgotten either. If you want to customize the way
the reviews display, create and edit these template files:

 * `taxonomy.php`
 * `archive-book-review.php`
 * `single-book-review.php`

Additionally, there are a number of template tags that can be used in your theme,
which are found in `inc/func.php`.

This plugin uses the [Genericons icon font](http://genericons.com) in both the dashboard
and the front end to display the book icons and star ratings.

#### Translators!

New translations site is up at https://chrisreynolds.io/glotpress/projects/book-
review-library/
 Please email me at hello at chrisreynolds dot io if you want to
be added as a translator.

 * **Italian translation** by [tristano-ajmone](https://wordpress.org/support/profile/tristano-ajmone)
 * **Hungarian translation** by [Ignácz József](http://joco1114.dyndns.org/)
 * **French translation** by claire idrac
 * **Russian translation** by [Diana Kononova](https://wordpress.org/support/profile/diana-kononova)
 * **Arabic translation** by Salim Solomon
 * **Spanish translation** by Tierras del Rincon
 * **Persian (Farsi) translation** by [Masoud Allameh](http://www.masoudallameh.com/)
 * **Polish translation** by Rafał Szampera
 * **Catalan translation** by Jordi Ramirez
 * **Turkish translation** by Yardımcı Destek Teknolojileri
 * **Dutch translation** by robin ketelaars

#### About this plugin

I sat down with a librarian and a volunteer at the [Open Classroom charter school library](http://ocslc.org/library/)
and asked them what they wanted from the website. The result is this plugin. It 
was built with a real use-case in mind based on specific feedback I received about
things they wanted to share with the school and wider community. If you have questions
or suggestions, feel free to [let me know](http://jazzsequence.com/about/).

### Note

This plugin hasn’t been in active development for a while. However a major revision/
rewrite has been planned for some time. The plugin is stable and works with all 
versions of WordPress and I’m happy to review/merge pull requests on the [GitHub repo](https://github.com/jazzsequence/book-review-library)
or respond to support queries you may have but no new features are planned until
after the rewrite is complete.

### Shortcodes & Shortcode Parameters

Book Review Library currently supports one shortcode. This page will list the shortcode
variations and parameters supported and describe what each available option and 
parameter does.

#### Book Reviews

    ```
    [book-reviews]
    ```

Displays a list of books. If used with no additional parameters, this will display
_all_ books, ordered by date added, with no covers and no review or excerpt displayed.

#### Count

    ```
    [book-reviews count=5]
    ```

Defines how many books to display on a page. Takes any interger. Omit to display
all posts. The above shortcode would display the 5 most recent book reviews. Can
be used in conjunction with any of the other parameters.

#### Covers

    ```
    [book-reviews covers=true]
    ```

Displays the book cover if it’s been added to the review and _if the theme supports
it_. Only accepted argument is `true`. Requires the theme to support post thumbnails.
The above shortcode would display all books with book covers.

#### Order By

    ```
    [book-reviews order_by=title]
    ```

Changes the order in which the books are displayed. By default, lists by date added.
Accepted arguments are `date_added`, `author` — lists by author’s _first_ name (
unless authors have been added last name first, e.g. “Reynolds Chris”), `title` —
lists by book title. The above shortcode would display all books alphabetically 
by title.

#### Формат

    ```
    [book-reviews format=excerpt]
    ```

Determines whether to display the full review or an excerpt. Default is no review
text displayed. Accepted arguments are `full` — displays full book review, `excerpt`—
displays an excerpt of the review or `none`. The above shortcode would display all
book reviews with an excerpt of each review.

#### Автор

    ```
    [book-reviews author=j-k-rowling]
    ```

Filters all book reviews by single author. Any **slug** of an existing book author
is accepted. The above shortcode would display all books by J.K. Rowling. Alternately,
when wrapped in quotes, you can use the full name of any existing book author. The
following would also work to display all books by J.K. Rowling:

    ```
    [book-reviews author="J.K. Rowling"]
    ```

#### Жанр

    ```
    [book-reviews genre=sci-fi]
    ```

Filters all book reviews by genre. Any existing genre slug is accepted. The above
shortcode would display all books in the Sci-Fi genre. When wrapped in quotes, you
can use the full name of any existing genre **if the name matches the slug**. The
following would display all the books in the “Science Fiction” genre if that genre
had a slug of `science-fiction`:

    ```
    [book-reviews genre="Science Fiction"]
    ```

## Скриншоттор

 * [[
 * Add new screen
 * [[
 * Genres (example of the taxonomy screens)
 * [[
 * Admin menu
 * [[
 * Options page
 * [[
 * New user roles
 * [[
 * Example display page with related books widget
 * [[
 * Book Reviews admin page

## Орнотуу

 1. Upload `book-review-library.zip` to the `/wp-content/plugins/` directory or use
    the built-in plugin installer on the WordPress Plugin Dashboard page.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. That’s it! Start writing reviews. 🙂

## FAQ.KG

[Ask some!](https://jazzsequence.com/about/#ninja_forms_form_2_response_msg)

### I have HTML displaying at the top of my page/next to the book cover/somewhere else. How do I get rid of this?

This is most likely because your theme is using `the_title` in a link or somewhere
else. This plugin adds a filter to `the_title` to display the book’s author. To 
prevent this behavior (and fix your problem), go to the Options page in the Book
Reviews menu and disable “Display author with title”. The author will no longer 
display with the book title and will, instead, be displayed with the genre information.

### I get a 404 error when I try to view a book review.

Go to Permalinks in the General Settings and just re-save your settings. This will
update your .htaccess file and should resolve the problem.

### I have *xxxx* problem when I sort by author…

Here are the known issues with sorting by author. Unfortunately, at this time, there
isn’t much that can be done about most of them because sorting by author is kind
of a hack…

**Books with multiple authors display multiple times in the list.**

Reason: This is because we’re doing a separate loop through all the books for each
author. When it sees that book with multiple authors again, it will add that as 
a separate entry.

Workaround: If you have one book that has multiple authors, the easiest solution
is to add them as a _single_ author, e.g. “Brad Williams Ozh Richard and Justin 
Tadlock” — that way the book will only have a single “author” term associated with
it.

**When I sort by author, it’s sorting by their _first name_, not their _last name_.**

Reason: This is because each author is entered into the database as a “term”, similar
to a category. So, while I can make sure that “Orange” comes after “Apple” I can’t
do anything about “Orange Mackenzie” coming after “Apple Smith” programmatically,
because if I tried to feed “Smith, Apple” back into the loop that’s being done to
pull up the list of books, “Smith, Apple” wouldn’t match any entries and no results
would be found.

Workaround: If you must have books sorted by author _last name_, you can add the
authors last name first, e.g. “Williams Brad”.

## Сын-пикирлер

![](https://secure.gravatar.com/avatar/fc0dd959e8ea9837df81974a79fff46733d20a6508aaba8aeb9c8ec285a57598?
s=60&d=retro&r=g)

### 󠀁[Buono](https://wordpress.org/support/topic/buono-2/)󠁿

 [vros63](https://profiles.wordpress.org/vros63/) Февраль 7, 2017-ж. 1 reply

Buono

![](https://secure.gravatar.com/avatar/3c8c28a9089ed2896335925a7a87931d73ffd87dea2e98166ab98bfbd6634226?
s=60&d=retro&r=g)

### 󠀁[I agree. Super plug-in](https://wordpress.org/support/topic/i-agree-super-plug-in/)󠁿

 [mybellenatives](https://profiles.wordpress.org/mybellenatives/) Ноябрь 14, 2016-
ж.

I used it in conjunction with the Book Review plug-in to get the book’s information
automatically populated from Google via the ISBN. Works very well in that situation.
They compliment one another. Thank you.

![](https://secure.gravatar.com/avatar/cb270a23b23c95d2744f0469e29c09a106ad1e9f138990cd7758e110f510d95b?
s=60&d=retro&r=g)

### 󠀁[Super Plugin, one of the best!](https://wordpress.org/support/topic/super-plugin-one-of-the-best/)󠁿

 [ohneel71](https://profiles.wordpress.org/ohneel71/) Октябрь 28, 2016-ж.

Really well designed and maintained, one of the best plugins out there. Never gave
a hiccup and the author really cares.

![](https://secure.gravatar.com/avatar/5221bc0897faa5bdfb4bb73ee57698096b27e9eadacc096a4b6c14520620b349?
s=60&d=retro&r=g)

### 󠀁[i have to confess: this is truely outstanding and overwhelming](https://wordpress.org/support/topic/i-have-to-confess-this-is-truely-outstanding-and-overwhelming/)󠁿

 [say_hello](https://profiles.wordpress.org/say_hello/) Октябрь 21, 2016-ж. 1 reply

i have to confess: this is truely one of the very best WordPress book-review-library
plugins. Super easy to use and super-super powerful. You can do alot with this plugin.
I have tried other solutions but this is as to close perfect as we have found, It
offers everything we wanted so far so, and if we need more there are paid extensions
at reasonable cost. I ve testet many ones; here some features that have convinced
me: The installation of the book-review-library: it is easy – the first steps were
done in a few minutes: you do not have to worry about it nor trouble to do such 
repetitive tasks. With very little effort, the book review system will be up and
running on your site right away, it is ,,,,: – Very easy to use and simplicity enables
me to start using it almost immediately after installed it. – Very easy to search
a specific product, – even if you know only a little about PHP, you can create your
own template! That means you can design the layout. Yes its true: You do not need
develpoer-skills – and if you are no expert or professional – this plugin makes 
you look like a genius sometimes.;) And last but not least: Support is overwhelming:–
the develoer rocks!!! conclusio; book-review-library – this plugin is for many many
users – and for every one who wants to run an a book-based plugin A trillion thanks
for developing and release this plugin for free! keep up this super-work!!! Thousands
of wordpress-fans from all over the globe were happy with this plugin…

![](https://secure.gravatar.com/avatar/07d6a79827f5aee7acb9b220ff5721459f1e4c66e342fab02fc7f75ccc68d679?
s=60&d=retro&r=g)

### 󠀁[Very good Beginning](https://wordpress.org/support/topic/very-good-beginning/)󠁿

 [LSBK](https://profiles.wordpress.org/lsbk/) Сентябрь 3, 2016-ж. 1 reply

I tested it on a local version (XAMPP) it looks nice. But it’s only a beginning,
not yet a usable version: [book-reviews] is resulting in a list with a lot of empty
lines between entries and every time a “Genre” at the end. Do you display all, even
the disabled or empty fields? the listed entry does not show the ISBN even when 
filled I’m missing publisher, “technical data” as pages, price, medium (I have also
CDs and DVDs to show!) Very nice would be an export/import function… I’m desperately
looking for a program like this as I want to handle more than 400 titles and it 
should be manageable.

![](https://secure.gravatar.com/avatar/0918b1cb686f8cc2800ca84f5161702e6948eb2785474131973a06f371b2baa3?
s=60&d=retro&r=g)

### 󠀁[awesome!!!](https://wordpress.org/support/topic/awesome-2910/)󠁿

 [Chema](https://profiles.wordpress.org/deambulando/) Сентябрь 3, 2016-ж. 1 reply

thanks a lot works great, will collaborate on some bugs I found 😉

 [ Read all 16 reviews ](https://wordpress.org/support/plugin/book-review-library/reviews/)

## Contributors & Developers

“Book Review Library” is open source software. The following people have contributed
to this plugin.

Мүчөлөрү

 *   [ Chris Reynolds ](https://profiles.wordpress.org/jazzs3quence/)

“Book Review Library” has been translated into 9 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/book-review-library/contributors)
for their contributions.

[Translate “Book Review Library” into your language.](https://translate.wordpress.org/projects/wp-plugins/book-review-library)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/book-review-library/),
check out the [SVN repository](https://plugins.svn.wordpress.org/book-review-library/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/book-review-library/)
by [RSS](https://plugins.trac.wordpress.org/log/book-review-library/?limit=100&mode=stop_on_copy&format=rss).

## Өзгөртүүлөр

#### 1.4.23

 * updates tested up to
 * fixed an issue with git -> WordPress plugin deploy

#### 1.4.22

 * tested up to WordPress 5.9

#### 1.4.21

 * tested up to WordPress 5.0

#### 1.4.20

 * minor bugfixes (props [Ashley Gibson](https://github.com/nosegraze))
 * added dutch and turkish translations

#### 1.4.19

 * more fixes for same issue.

#### 1.4.18

 * fixed issue where taxonomies that were disabled were throwing an error when we
   were checking if terms from those taxonomies existed. same issue that was resolved
   in 1.4.17, just more places that needed the fix applied to them.

#### 1.4.17

 * fixed issue where next/previous post link for non-reviews wasn’t showing at all
   after last update.
 * fixed issue where taxonomies that were disabled were throwing an error when we
   were checking if terms from those taxonomies existed

#### 1.4.16

 * updated readme, new working links
 * fixed next/previous post link for non-reviews

#### 1.4.15

 * updated readme.txt note for translators
 * tested on WordPress version 4.4

#### 1.4.14

 * fixes next/previous post author displaying the wrong author. Issue reported [here](https://wordpress.org/support/topic/incorrect-author-in-previous-post-navigation)

#### 1.4.13

 * fixes WP_Widget issue reported [here](https://wordpress.org/support/topic/wp-43-notice)

#### 1.4.12

 * adds excerpt support

#### 1.4.11

 * added image size for book covers. users can use that instead of default post 
   thumbnail size or they can use the thumbnail setting. controlled from the options
   page.

#### 1.4.10

 * added Catalan language file

#### 1.4.9

 * Fixed a bug where the book author wasn’t displaying if the title was filtered
   by WordPress before being passed to Book Review Library’s title filter
 * changed string to boolean value for covers check
 * added Arabic language file
 * added Spanish language file
 * added Farsi language file
 * added Polish language file

#### 1.4.8

 * fixed a conflict with other plugins that use post types which prevented single
   posts of other post types from displaying
 * added Russian language file
 * Additional Information box always displays
 * Changed the display of the taxonomy boxes so they don’t do weird things when 
   you move them (see: https://wordpress.org/support/topic/edit-post-screen-elements-
   go-wonky-when-rearranged?replies=4)

#### 1.4.7

 * added new option to display the book author on a separate line than the title
 * updated .pot file

#### 1.4.6

 * changed behavior of book list by author to always display books by title rather
   than forcing an order_by parameter to define order of the books
 * added new `genre` shortcode parameter
 * fixed menu icon for WordPress 3.8
 * fixed issue preventing librarians from saving book review options (note: current
   solution is a workaround)

#### 1.4.5

 * fixed issue where the author was displaying twice when using the shortcode
 * prevented css and iconfont from loading on non-book review pages (thanks [Mte90](https://wordpress.org/support/topic/include-css-only-on-the-page-of-the-plugin))
 * updated documentation
 * added full Hungarian translation
 * added full French translation
 * fixed an undefined notice if order_by is not defined
 * added new `author` shortcode parameter

#### 1.4.4

 * fixed the i18n on “Review Authors”
 * added full Italian language file (thanks [tristano-ajmone](https://wordpress.org/support/profile/tristano-ajmone)!)
 * added initial Hungarian language file (thanks Ignácz József!)
 * added partial French language file (thanks claire idrac!)

#### 1.4.3

 * fixed taxonomy archive page permalink issue
 * fixed i18n issues with untranslatable strings
 * removed the “Add New Rating” and “Most Used” links for ratings

#### 1.4.2

 * fixed an issue where meta boxes randomly disappeared after 1.4.0 update

#### 1.4.1

 * fixed issue where plugin could not be activated if Organize Series was installed

#### 1.4

 * added new shortcode parameter: `format`. Accepted arguments are `format=full`,`
   format=excerpt` and `format=none` (default). This allows the user to control 
   whether the full review or an excerpt of the review will display when using the
   shortcode.
 * fixed issue where text on the page always displayed under the shortcode content
 * fixed issue where librarian was not able to edit the options
 * added ISBN support — you can now add ISBN codes and search by them
 * added support to search by other book metadata (author, genre, subject, reviewer,
   etc)
 * added full i18n support

#### 1.3.5

 * checks if role exists before removing caps on deactivation
 * moves the flush rewrite function to after the post type is registered

#### 1.3.4

 * flushes rewrite rules on activation. should resolve issues relating to posts 
   not being viewable without re-saving the permalink settings.

#### 1.3.3

 * fixed issue where a fatal error was thrown trying to add capabilities to WordPress
   user roles if they do not exist

#### 1.3.2

 * applied 1.3.1 fix to excerpt filter, too

#### 1.3.1

 * fixes “this book is currently checked out” that displays on non-book posts

#### 1.3

 * added new shortcode parameter `order_by` — accepted arguments are ‘title’, ‘date_added’(
   default), and ‘author’. See Frequently Asked Questions for more information about
   sorting by author.

#### 1.2.1

 * Enabling/disabling some options now affect columns in the book review list

#### 1.2.0

 * adds optional support for comments on book reviews

#### 1.1.0

 * adds option to disable the author in the book title (fixes formatting/html issue
   for themes that use the_title in `<a>` tags)
 * fixed some i18n issues
 * fixed “in stock” tag displaying in the shortcode when stock option was disabled
 * fixed an issue that ran the content filter on pages using the book review shortcode

#### 1.0.3

 * fixes layout issues caused by `float: left` on the book covers.

#### 1.0.2

 * runs a check on the_excerpt and the_content filters to make sure those are being
   called in a loop. If not, they don’t apply. This prevents issues in formatting
   if those template tags are being used inside an HTML tag.

#### 1.0.1

 * fixed bug that displayed in/out of stock on all pages (thanks Digital Mosquito
   for reporting it)

#### 1.0

 * initial release

## Мета

 *  Нуска **1.4.23**
 *  Акыркы жаңыртуу **4 жыл мурун**
 *  Активдүү орнотуулар **200+**
 *  WordPress нускасы ** 3.6 же андан жогору **
 *  Tested up to **6.1.10**
 *  Тилдер
 * [Arabic](https://ar.wordpress.org/plugins/book-review-library/), [Catalan](https://ca.wordpress.org/plugins/book-review-library/),
   [Czech](https://cs.wordpress.org/plugins/book-review-library/), [English (US)](https://wordpress.org/plugins/book-review-library/),
   [French (France)](https://fr.wordpress.org/plugins/book-review-library/), [Hungarian](https://hu.wordpress.org/plugins/book-review-library/),
   [Italian](https://it.wordpress.org/plugins/book-review-library/), [Persian](https://fa.wordpress.org/plugins/book-review-library/),
   [Polish](https://pl.wordpress.org/plugins/book-review-library/) жана [Russian](https://ru.wordpress.org/plugins/book-review-library/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/book-review-library)
 * Тег:
 * [book](https://ky.wordpress.org/plugins/tags/book/)[book review](https://ky.wordpress.org/plugins/tags/book-review/)
   [library](https://ky.wordpress.org/plugins/tags/library/)
 *  [Advanced View](https://ky.wordpress.org/plugins/book-review-library/advanced/)

## Рейтинг

 4.8 out of 5 stars.

 *  [  14 5-star reviews     ](https://wordpress.org/support/plugin/book-review-library/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/book-review-library/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/book-review-library/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/book-review-library/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/book-review-library/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/book-review-library/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/book-review-library/reviews/)

## Мүчөлөрү

 *   [ Chris Reynolds ](https://profiles.wordpress.org/jazzs3quence/)

## Колдоо

Комментарийлер барбы? Жардам керекпи?

 [Колдоо форумун көрүү](https://wordpress.org/support/plugin/book-review-library/)

## Кайрымдуулук

Would you like to support the advancement of this plugin?

 [ Кайрымдуулук кылуу ](https://paypal.me/jazzsequence)