Shortcode: book_listing

This shortcode displays a list of books in a condensed format. Images are shown along with each book’s title and part of its description.

This plugin should be used on the page you select as the search result page. It will automatically filter the books displayed in response to the search query that a user has entered.

Available attributes:

• include_advanced_search – This will include a search form at the bottom of the page. This is useful on the search results page so that users can alter their search and search again. Should be "true" or "false". The default value is "false".
• include_paging – Shows the page count and page list above and below the book listing. Should be "true" or "false". The default value is "true".
• include_sorting – Shows the sorting drop down list above the book listing. Should be "true" or "false". The default value is "true".
• all_text – Search all the text fields on each book and only display those that match. This a text search rather than an exact match.
• title – Search books by title and only display those that match. This a text search rather than an exact match.
• author – Search books by author and only display those that match. This a text search rather than an exact match.
• keyword – Only show books that have this keyword. This is an exact match.
• tag – Only show books that have this tag/category. On most sites this is an exact match. You can add multiple tags here, separated by commas.
• exclude_all_text – Excludes any books that contain this text in any text field. This a text search rather than an exact match.
• sort_by – The field to search the books by. Available values are "author", "title", "year", "price" and "added" (the date the book was added to the database). The default value is "title".
• sort_order – How to apply the sort_by parameter. Available values are "asc" (ascending) and "desc" (descending). The default value is "asc".
• page_size – The number of books to include on one page of the book listing. If you don’t include paging controls then this will be all the books users can see. If using sku_id this will be changed to match the number of books requested. This should be given as a whole number between 1 and 100. The default value is 20.
• price_min – Only display books of this price and above.
• price_max – Only display books of this price and below.
• year_min – Only display books published in this year or later.
• year_max – Only display books published in this year or earlier.
• first_edition - When set to "true" only books marked as first editions will be shown. When set to "false" only books that aren't marked as first editions will be shown. This will only work properly if these values are included in the book data you've given.
• signed - When set to "true" only books marked as signed will be shown. When set to "false" only books that aren't marked as signed will be shown. This will only work properly if these values are included in the book data you've given.
• dust_jacket - When set to "true" only books marked as having dust jackets will be shown. When set to "false" only books that aren't marked as having dust jackets will be shown. This will only work properly if these values are included in the book data you've given.
• sku_id – Define a book or books that should be displayed. Note that all the other filtering options will still be applied, so you could end up with less books than you list here. Valid values are a single SKU ID or multiple SKU IDs separated by commas, e.g. [book_listing sku_id="AB12, AB34, TY67"].