The [novelist-series-grid] shortcode is an extension of [novelist-books]. It’s used to display a list of all of your books, grouped by series.
If you wanted to do this with [novelist-books] you’d have to add a separate shortcode for each series, like so: [novelist-books series=”My Series Name”]
But [novelist-series-grid] does that for you automatically. It loops through each series you have (Books > Series) and automatically triggers the [novelist-books] shortcode for each series. Optionally, you can also display standalones at the end (these are books with no assigned series).
Attributes
The attributes are very similar to those from [novelist-books]. The first three, however, are unique to this shortcode.
- series-name – true | false – Whether or not to print the name of the series before each series group. Defaults to “true”.
- exclude – Enter a comma-separated list of series IDs or names to exclude from the grid. Books in these series will not appear.
- standalones – true | false – Whether or not to display standalones at the end (books with no assigned series). Defaults to “true”.
- columns – Number of columns in each row. Defaults to 4.
- title – true | false – Whether or not to display the title of each book. Defaults to “false”.
- series-number – true | false – Whether or not to display the number of the book in the series. It prints like so: “Book 1”. Defaults to “false”.
- excerpt – true | false – Whether or not to display the excerpt of each post. The excerpt is taken from the synopsis. Defaults to “false”.
- full-content – true | false – Whether or not to display the entire set of formatted book content (includes cover, title, author, series, publication date, synopsis, etc.). Defaults to “false”.
- full-excerpt – true | false – Whether or not to display the entire synopsis. Defaults to “false”.
- button – true | false – Whether or not to show a button that says “More Details”. Defaults to “true”.
- covers – true | false – Whether or not to display the book cover of each book. Defaults to “true”.
- orderby – menu_order | title | date | publication | rand – How to order the results. Defaults to “menu_order”. ‘date refers to when the book was added in WordPress, while ‘publication’ refers to the book’s publication date.
- order – ASC | DESC – Order of the results. Defaults to “ASC”.
- offset – Number of books to offset (skip) from the beginning of the list.
Note that there are no number or pagination attributes. The shortcode is designed to display all books.
Example
[novelist-series-grid columns="5"]