Shortcode: book_showcase
This shortcode displays a dynamic grid of book images. It provides dynamic way of presenting your books and it’s definitely worth trying it out on your site.
Available attributes:
- animation – The animation to use when bringing in new images as the user scrolls down. Available values are
"fade"
(images fade in) and"move-up"
(where images appear to move up from from the bottom of the screen). The default value is"move-up"
. - images – If this is set to
"thumbnails"
(default) then only the primary image of each book will be shown. Otherwise ALL your book images will be used. - randomise_images – If this is set to
"true"
then the images will be shuffled before they’re displayed on the page. The ordering of images will be different each time the page is loaded. - 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. As the showcase doesn’t include paging controls 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_showcase sku_id="AB12, AB34, TY67"]
.