Block Theme / FSE Integration Shortcodes

These shortcodes are designed specifically for Block Themes (Full Site Editing). If you are using a block theme (like Twenty Twenty-Four) and want to design your Archive or Single Book templates using the Site Editor, use these shortcodes.

They dynamically detect the current page content (Category, Author, or Single Book) and render the correct layout automatically.

---

Book Category Archive

Use this shortcode when designing the Taxonomy: Book Category template in the Site Editor. It will automatically display books belonging to the specific category the user is viewing.

• Shortcode:
  [rswpbs_book_category_page]
• Where to use: Inside the Archive: Book Category template.
• Functionality:
  • Automatically fetches the current Category Title and Description.
  • Displays a grid of books from that category.
  • Settings: Inherits layout settings (Columns, Cover Position, Sorting) from the plugin’s Global Settings page.

---

2. Book Series Archive

Use this shortcode for the Taxonomy: Book Series template. It filters and displays books that belong to a specific series.

• Shortcode:
  [rswpbs_book_series_page]
• Where to use: Inside the Archive: Book Series template.
• Functionality:
  • Shows the Series Name and Description.
  • Displays the book gallery filtered by the current series.

---

3. Book Author Archive

Use this shortcode for the Taxonomy: Book Author template. It creates a dynamic profile page for the author.

• Shortcode:
  [rswpbs_book_author_page]
• Where to use: Inside the Archive: Book Author template.
• Functionality:
  • Displays the Author Profile Header (Image, Bio, Social Links).
  • Displays a section titled “Books by [Author Name]”.
  • Showcases all books linked to that specific author.

---

4. Single Book Page

Use this shortcode to design the Single: Book template. It replaces the default post content with a specialized book layout.

• Shortcode:
  [rswpbs_book_single_page]
• Where to use: Inside the Single: Book template.
• Functionality:
  • Renders the complete Single Book layout (Header, Cover, Price, Buy Buttons, Description, Testimonials).
  • Note: When using this, you should remove the default “Post Content” block from the template to avoid duplicate content.

---

⚙️ Configuration Note

Unlike standard shortcodes, these do not require attributes (like id or rows) because they are dynamic.

• Design Control: You can control the appearance (Books per row, Image position, Show/Hide elements) globally from the Plugin Settings Panel (Dashboard > RS WP Book Showcase > Settings).
• Pro Features: If the Pro version is active, these templates automatically upgrade to support advanced sorting, search bars, and styling options defined in your settings.

---

📝 Step-by-Step Implementation Guide (For Users)

1. Go to Appearance > Editor (Site Editor).
2. Click on Templates and click + to add a new template.
3. Select Category Archive (or Author/Series Archive) for the specific taxonomy.
4. In the editor, insert a Shortcode Block.
5. Paste the relevant shortcode (e.g., [rswpbs_book_category_page]).
6. Click Save. Now, all your book category pages will dynamically show the correct books!