[novelist-series-grid]

⌘K
  1. Home
  2. General
  3. Shortcodes
  4. [novelist-series-grid]

[novelist-series-grid]

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"]
Was this article helpful to you? No Yes

How can we help?