[book-grid]

This shows a list of books (not reviews). If you just enter [book-grid] with no parameters, then that essentially lists out all the books added to your library. The parameters allow you to filter the results based on criteria.

Parameters:

• ids – Comma-separated list of specific book IDs to display.
• author – Filter by author name to only show books by that author.
• series – Filter by series name to only show books in that series.
• rating – Filter by rating value to only show books that have been given this rating.
• pub-date-after – Only show books that were published after this date. This can be an exact date or a relative date that can be parsed by PHP’s strtotime() function. Examples include:
  • today – Where the publication date is after today.
  • first day of this month – Where the publication date is after the first day of the current month.
  • last day of this month – Where the publication date is after the last day of the current month.
  • 1 January 2020 – Where the publication date is after January 1st, 2020 (exact date).
• pub-date-before – Only show books that were/are published before this date. This can be an exact date or a relative date that can be parsed by PHP’s strtotime() function.
• pub-year – Filter by the book’s publication year.
• read-status – Filter by whether or not you’ve read the book. Accepted options are: “reading” (currently reading), “read” (you’ve finished the book), “unread” (you have not read the book).
• review-date-after – Only show books that were reviewed after this date. This checks the review “Date Published”. This can be an exact date or a relative date that can be parsed by PHP’s strtotime() function. Examples include:
  • today – Where the review publish date is after today.
  • first day of this month – Where the review publish date is after the first day of the current month.
  • last day of this month – Where the review publish date is after the last day of the current month.
  • 1 January 2020 – Where the review publish date is after January 1st, 2020 (exact date).
• review-date-before – Only show books that were reviewed before this date. This can be an exact date or a relative date that can be parsed by PHP’s strtotime() function.
• reviews-only – Whether to only show reviews (true) or to show all books, regardless of whether or not they’ve been reviewed (default).
• show-ratings – Whether or not to show the book’s average rating in the results.
• show-pub-date – Whether or not to show the book’s publication date in the results.
• show-goodreads-link – Whether or not to show the book’s Goodreads link in the results.
• show-purchase-links – Whether or not to show the book’s purchase link(s) in the results.
• show-review-link – Whether or not to show a link to the book review. Note: only one review link will be shown, even if there’s more than one review of the book.
• orderby – What value to use to order the results. Default is book.id. Accepted values are: author.id, author.name, author.slug, book.id, book.title, book.index_title, book.series_id, book.series_position, book.pub_date, b ook.pages, book.date_created, book.date_modified, series.id, series.slug, series.number_books, series.date_created, avg_rating.rating, avg_rating.date_started, avg_rating.date_finished.
• order – How to order the results. Accepted values are: ASC and DESC. Default is DESC.
• cover-size – Size of the cover images. Default is “large”. Also allowed: “thumbnail”, “medium”.
• per-page – Number of results to show per page. Default is 20.

Examples:

Show books with a publication date in the future. Order the results by the book’s publication date and display that along with a link to Goodreads. This is what I use for my Upcoming Releases page.

[book-grid pub-date-after="today" orderby="book.pub_date" order="ASC" show-goodreads-link="true" show-pub-date="true"]

Show books that I’ve read and include the rating.

[book-grid read-status="read" show-ratings="true"]