[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'sstrtotime()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'sstrtotime()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'sstrtotime()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'sstrtotime()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"]