Book Series List Shortcode

This shortcode generates a responsive grid list of all your Book Series. Like the Author list, it includes built-in AJAX Search and Load More capabilities, allowing users to browse through book series easily.

Shortcode Name

[rswpbs_series_shortcode]

---

🚀 How to Use

Basic Usage:

Paste this code to display a grid of book series with default settings.

Code snippet

[rswpbs_series_shortcode]

Advanced Usage:

Customize the columns and number of items loaded per click:

Code snippet

[rswpbs_series_shortcode series_per_row="3" series_per_page="6" show_description="true"]

---

⚙️ Attributes (Parameters)

Use the following attributes to control the layout and visibility:

1. Layout & Grid Settings

Attribute	Default	Accepted Values	Description
series_per_row	4	1, 2, 3, 4, 6	Defines how many series items to show in a single row. Automatically adjusts for mobile/tablet.
series_per_page	4	Number (e.g., 8, 12)	Sets how many series are loaded initially and per “Load More” click.
layout	standard_layout	standard_layout	The visual style of the series card.

2. Content Visibility

Attribute	Default	Accepted Values	Description
show_description	true	true, false	Show or hide the series description/taxonomy bio.
show_book_count	true	true, false	Display the total number of books belonging to the series.

---

💡 Usage Examples

1. Standard 4-Column Series Grid

Displays 4 series per row, perfect for standard pages.

Code snippet

[rswpbs_series_shortcode series_per_row="4" series_per_page="8"]

2. Detailed Series Showcase (3 Columns)

Gives more space to each series card, ideal if your series have longer descriptions.

Code snippet

[rswpbs_series_shortcode series_per_row="3" series_per_page="6"]

3. Simple List View (1 Column)

Displays series in a vertical list format.

Code snippet

[rswpbs_series_shortcode series_per_row="1" show_book_count="true"]

4. Minimal Grid (Names Only)

Hides descriptions and counts for a cleaner look.

Code snippet

[rswpbs_series_shortcode show_description="false" show_book_count="false" series_per_row="6"]

---

📝 Notes for Developers

• Taxonomy: This shortcode queries the book-series taxonomy.
• AJAX Functionality: It uses wp_ajax_load_more_series to fetch data dynamically without page reloads.
• Pro Features:
  • Series Image: If Rswpbs_Pro exists, it fetches the series image via rswpbs_book_series_picture meta.
  • Social Links: Supports social links for series authors/groups if available.