Book Reviews Shortcode

This shortcode allows you to display customer reviews for your books anywhere on your website. It supports Grid and Slider layouts, different visual styles (Default & Classic), and includes a “Read More” popup feature for long reviews.

Shortcode Name

[rswpbs_reviews]

---

🚀 How to Use

Basic Usage:

Display the latest 8 reviews in a slider format (default setting).

Code snippet

[rswpbs_reviews]

Advanced Usage:

Display reviews in a grid, specifically for one book, using the “Classic” style.

Code snippet

[rswpbs_reviews review_layout="grid" layout_style="classic" book_ids="15,20"]

---

⚙️ Attributes (Parameters)

Customize the appearance and functionality using the following attributes:

1. Layout & Style

Attribute	Default	Accepted Values	Description
review_layout	slider	slider, grid	Slider: Displays reviews in a carousel. Grid: Displays reviews in a masonry grid layout.
layout_style	default	default, classic	Default: Standard look with Title and Stars. Classic: Adds a quote icon and rearranges elements.
review_per_page	8	Number	Total number of reviews to display.
large_screen	3	Number	Columns to show on Large Screens (Desktop).
medium_screen	2	Number	Columns to show on Medium Screens (Tablet).
small_screen	1	Number	Columns to show on Small Screens (Mobile).

2. Content Visibility

Attribute	Default	Accepted Values	Description
section_heading	''	String	Main title text displayed above the reviews (e.g., “What Readers Say”).
section_sub_heading	''	String	Sub-title text displayed above the main heading.
show_section_title	true	true, false	Show or hide the section heading and sub-heading.
show_slider_nagivation	true	true, false	Show or hide the Next/Prev arrows (Slider layout only).
show_ratings	true	true, false	Show or hide the star ratings.
show_reviewer	true	true, false	Show or hide the reviewer’s name, image, and date.
show_quote	true	true, false	Show the quote icon (Works only in classic layout).

3. Filtering

Attribute	Default	Description
book_ids	''	Comma-separated Book IDs. Use this to show reviews only for specific books (e.g., book_ids="101,105"). If empty, it shows all reviews.

---

💡 Usage Examples

1. Review Slider (Default)

A responsive slider showing 3 reviews at a time on desktop.

Code snippet

[rswpbs_reviews large_screen="3" review_layout="slider"]

2. Classic Grid for a Specific Book

Display reviews for a specific book (ID 120) in a grid layout using the “Classic” style (with quote icons).

Code snippet

[rswpbs_reviews book_ids="120" review_layout="grid" layout_style="classic" section_heading="Reader Feedback"]

3. Minimal List

A simple list of reviews hiding the navigation arrows and section titles.

Code snippet

[rswpbs_reviews show_slider_nagivation="false" show_section_title="false"]

---

📝 Key Features

• Read More Popup: Long reviews are automatically truncated to 25 words. A “Read More” link is added, which opens a popup modal displaying the full review content without reloading the page.
• Reviewer Image: The plugin automatically fetches the reviewer’s Gravatar based on their email. If a custom image is set in the review post, that will take priority.
• Responsiveness: You can control how many reviews appear per row on different devices using large_screen, medium_screen, and small_screen attributes.