SFR Book Review Showcase

Опис

SFR Book Review Showcase makes it easy to display book reviews from Amazon on your WordPress site. Perfect for book bloggers, review sites, and authors who want to showcase reader feedback in a professional, customisable format.

Whether you’re building a book recommendation site, adding social proof to product pages, or creating a curated reading library, this plugin gives you complete control over how reviews appear.

What Makes This Plugin Special:

  • Book Library Management – Organize books with multiple formats (Kindle, Paperback, Hardback, Audible, Other), each with its own ASIN. Track all formats and review counts in one central location.

  • Smart Import Options – Add reviews manually or use the built-in OCR (Optical Character Recognition) helper to extract text directly from review screenshots. Save hours of manual typing.

  • Flexible Display Options – Choose between grid or list layouts with full control over colours, typography, spacing, and shadows. Display reviews using shortcodes or the Gutenberg block editor.

  • Powerful Filtering – Filter reviews by book title (shows all formats), specific ASIN, category, or featured status. Sort by date, rating, reviewer name, and more.

  • Review Categories – Organize reviews into categories like Fiction, Non-fiction, Photography, Mystery, etc. for easy browsing and filtering.

  • Built-in Analytics – Track views, clicks, and click-through rates (CTR) for each review. Identify your top-performing reviews and optimize your affiliate marketing strategy.

  • Amazon Affiliate Integration – Automatically generate affiliate links with your Amazon Associates ID. Track clicks to measure the effectiveness of your review displays.

  • Gutenberg Block Support – Use the „Book Reviews“ block in the WordPress block editor with visual controls for all styling options. No coding required.

  • Lightweight & Fast – All data is stored locally in your WordPress database. No external API calls that slow down your site. Only optional OCR feature connects to external service.

  • Developer Friendly – Fully namespaced code prevents conflicts with other plugins. Clean, well-documented codebase following WordPress coding standards.

Upgrade to Pro for Advanced Features:

Looking for more power? SFR Book Review Showcase Pro includes:

  • Advanced Analytics & Reporting – Enhanced analytics dashboards with scheduled email reports (weekly/monthly)
  • CSV Import & Export – Bulk import reviews from CSV files or export your entire library
  • KDP Sales Integration – Import and track KDP sales data alongside review performance
  • Elementor Widget – Dedicated widget for Elementor page builder users
  • Carousel Block – Display reviews in a beautiful carousel/slider format
  • Advanced Affiliate Tracking – Enhanced click tracking and affiliate sales monitoring
  • Premium Layout Templates – Additional professional layout options

Pro version available at: https://supportfromrichard.co.uk/brs-pro-plugin

This plugin is not affiliated with, endorsed by, or sponsored by Amazon. Amazon is a trademark of Amazon.com, Inc.

Why Use This Plugin?

  • Increase conversions – Display authentic social proof to boost Amazon affiliate earnings
  • Save time – Import reviews in seconds instead of manual copy-paste
  • Build authority – Create a professional book recommendation site
  • Easy import – Capture reviews manually or use the OCR helper to extract text from screenshots
  • Flexible display – Grid or list layouts with full control over colours, spacing, and typography
  • Smart organisation – Group reviews by category (Fiction, Non-fiction, Photography, etc.)
  • Track performance – See which reviews get the most views and clicks
  • No bloat – Lightweight, namespaced code that won’t conflict with other plugins

Key Features

  • Book Library Management – Organize books with multiple formats (Kindle, Paperback, Hardback, Audible, Other), each with its own ASIN. View all formats and review counts in one place.
  • Dedicated admin area with dashboard, paginated WP_List_Table, add/edit form, book library, categories manager, analytics, and settings
  • Shortcode and dynamic Gutenberg block with grid/list layouts, customisable colours, typography, spacing, and „Load more“ pagination
  • Filter reviews by book title to show all formats of a book, or filter by specific ASIN or category
  • Review categories for quick grouping (e.g. Fiction, Puzzle Books, Photography)
  • OCR-based importer powered by OCR.space to pull text from screenshots in a guided workflow
  • Amazon helpers for ASIN storage per format, associate IDs for affiliate links, and outbound click tracking
  • Analytics summary (views vs clicks, CTR, top performers) stored locally in custom database tables
  • Fully namespaced PHP classes (SFRBRS_), functions (sfrbrs_), CSS, and JS handles to prevent conflicts

Upgrade to Pro

The Pro version unlocks powerful features for serious book bloggers and affiliate marketers:

  • Advanced Analytics & Reporting – Enhanced dashboards with scheduled email reports
  • CSV Import & Export – Bulk operations to save hours of manual work
  • KDP Sales Integration – Track book sales alongside review performance
  • Elementor Widget – Native Elementor integration for drag-and-drop page building
  • Carousel Block – Beautiful carousel/slider display option
  • Advanced Affiliate Tracking – Enhanced click tracking and sales monitoring
  • Premium Layout Templates – Additional professional design options

Learn more and upgrade at: https://supportfromrichard.co.uk/brs-pro-plugin

Shortcode & Block Usage

[sfr_book_reviews]

Supported attributes (camelCase or kebab-case):

  • layout (grid|list, default grid)
  • limit (1-50, default 6)
  • featured (true|false)
  • asin (single ASIN)
  • book (book title – shows reviews for all formats of the book)
  • category (comma-separated slugs)
  • orderby (review_date, star_rating, reviewer_name, asin, status, created_at)
  • order (ASC|DESC, default DESC)
  • cardBackground, cardTextColor, accentColor (hex colours)
  • shadow (true|false, enables card drop shadow)
  • gap, padding (pixels)
  • titleFontSize, bodyFontSize, reviewTextFontSize (pixels)
  • showCategories (true|false, shows category badges, default false)

Examples:

  • [sfr_book_reviews featured="true" category="fiction"]
  • [sfr_book_reviews asin="B09EXAMPLE" layout="list" limit="3"]
  • [sfr_book_reviews book="The Great Gatsby" layout="grid"]
  • [sfr_book_reviews shadow="false" cardBackground="#f8fafc" accentColor="#F97316"]
  • [sfr_book_reviews category="fiction,mystery" featured="true" layout="grid" limit="9" shadow="true" accentColor="#DC2626"]

External services

This plugin connects to external services to provide certain features:

OCR.space API

The plugin uses OCR.space’s API (powered by Tesseract OCR) to extract text from review screenshots when using the OCR import feature. This service is only used when you explicitly choose to import a review via the OCR helper workflow.

What data is sent:
* Base64-encoded image data (screenshots you upload through the WordPress media library)
* Image metadata (MIME type, language preference)

When data is sent:
* Only when you use the OCR import feature in the admin area
* Images are sent immediately when you click „Extract Text“ during the OCR import process
* No data is sent automatically or in the background

Service provider:
* OCR.space (https://ocr.space/)
* Terms of Service: https://ocr.space/ocrapi/TermsOfService
* Privacy Policy: https://ocr.space/ocrapi/PrivacyPolicy

Note: The plugin uses OCR.space’s free API tier by default. You can optionally configure your own API key in the plugin settings if you have an OCR.space account.

Снимци екрана

  • Frontend grid layout with custom styling and load-more pagination

Блокови

Овај додатак пружа 1 блок.

  • Book Reviews Display curated book reviews from the SFR Book Review Showcase plugin.

Постављање

  1. Upload the plugin folder to wp-content/plugins/ or install via Plugins Add New
  2. Activate the plugin from the Plugins screen
  3. Visit Book Reviews Settings to configure:
    • Amazon Associates ID (for affiliate commissions)
    • Default styling (colors, layouts)
    • OCR preferences (optional)
  4. Add books to your Book Library with multiple formats (Kindle, Paperback, Hardback, Audible, Other) and their ASINs
  5. Add reviews under Book Reviews All Reviews or import via the OCR helper, linking them to books and formats
  6. Use the shortcode or Gutenberg block to display reviews anywhere on your site

ЧПП

Is this compliant with Amazon’s terms of service?

Reviews are displayed as quotes with proper attribution and link back to Amazon. Always ensure your use complies with Amazon’s current Associate Programme Operating Agreement and your local regulations.

Will this slow down my site?

No. Reviews are stored in your database and served locally. The only external calls are optional (OCR imports), which don’t affect front-end performance. The plugin does not make API calls to Amazon.

How are reviews stored?

Reviews are stored in the custom wp_sfrbrs_book_reviews database table within your WordPress installation. CSV and JSON export functionality is planned for a future release.

Does the plugin load translations?

Yes. When distributed via WordPress.org, translations load automatically. For manual installs, place .mo files in the languages/ directory.

Can I filter by category or ASIN?

Yes. Use the category attribute with comma-separated slugs (e.g. category="fiction,mystery") or target a specific book with asin="B09EXAMPLE" on the shortcode or Gutenberg block.

Do I need an OCR.space account?

The OCR import feature uses OCR.space’s free API tier.

What data does this plugin collect or share?

The plugin stores review data and view/click analytics locally in your WordPress database. When using the OCR import feature, screenshots are sent to OCR.space for text recognition. The plugin does not make API calls to Amazon—it only displays links to Amazon product pages that you manually enter. No personal data is collected from your site visitors.

Does it add cookies or external tracking?

No. All analytics data stays in your WordPress database and only records aggregate view and click counts. No cookies are set and no visitor data is sent to external services.

Can I customise the review layout?

Yes. Use the shortcode attributes or Gutenberg block controls to adjust colours, spacing, typography, card shadows, and more. You can also override styles with custom CSS if needed.

What happens if I deactivate the plugin?

Your review data remains in the database. Shortcodes will stop rendering. If you reactivate later, everything returns as it was. To remove everything when uninstalling, enable Book Reviews Settings Data Retention Delete plugin data when uninstalling before deleting the plugin via the Plugins screen.

Can I export my reviews?

CSV and JSON export functionality is planned for a future release. Currently, reviews are stored in the wp_sfrbrs_book_reviews database table and can be accessed directly via database tools if needed.

Can I display reviews for my own Amazon books as well as books by other authors?

Yes! You can display Amazon reviews for any book – whether it’s your own book or books you recommend on your site.

Прегледи

Нема рецензија за овај додатак.

Сарадници и градитељи

„SFR Book Review Showcase“ је софтвер отвореног кода. Следећи људи су допринели овом додатку.

Сарадници

Преведите „SFR Book Review Showcase“ на свој језик.

Заинтересовани сте за градњу?

Прегледајте код, проверите SVN складиште или се пријавите на белешку градње преко RSS-а.

Белешка о изменама

1.2.2

  • Enhancement: Expanded shortcode reference documentation with comprehensive examples for use in posts, pages, page builders, and products (e.g. WooCommerce)
  • Enhancement: Added quick access links to shortcode reference from all admin pages
  • Enhancement: Improved shortcode reference table layout for better readability

1.2.1

  • Fix: Added Pro version check to prevent block registration conflicts when Pro plugin is active
  • Enhancement: Improved compatibility between Free and Pro versions

1.2.0 – 2025-01-05

Bug Fixes:
* Fixed title color not changing with card text color setting – title now properly inherits card text color
* Enhanced shadow visibility – improved shadow opacity and added layered shadow effect for better visibility on all background colors
* Fixed security warnings – properly escaped style attribute outputs in review card rendering

Improvements:
* Added help text to font size controls indicating changes won’t appear in preview but will work on frontend
* Improved CSS specificity for title color to ensure it overrides theme styles
* Fixed prepared SQL query warning in admin area by using esc_sql() for table names
* Enhanced code standards compliance for WordPress Plugin Check

1.1.1 – 2025-12-11

Code Standards & Plugin Check Compliance:
* Fixed all WordPress.DB.PreparedSQL.NotPrepared errors by adding proper phpcs:ignore comments
* Fixed WordPress.DB.PreparedSQL.InterpolatedNotPrepared warnings for table name interpolation
* Shortened upgrade notice for version 1.1.0 to comply with WordPress.org character limits
* Improved code documentation and phpcs:ignore comments throughout repository classes

1.1.0 – 2025-12-11

New Features:
* Added Book Library management system for organizing books with multiple formats
* Each book can now have multiple formats (Kindle, Paperback, Hardback, Audible, Other) with individual ASINs
* Book Library page displays all books with format indicators and review counts per format
* Added book title filtering to shortcode and Gutenberg block – filter reviews by book title to show all formats
* Improved book and category selection in Gutenberg block with dropdown menus instead of text inputs
* Enhanced accent color support – now properly applies to Load More button, badges, and review links

Improvements:
* Fixed accent color not applying to Load More button and other elements
* Improved block editor UX with dropdown selectors for books and categories
* Better CSS variable inheritance for consistent styling across all review elements

1.0.1 – 2025-12-12

Bug Fixes:
* Fixed „Security check failed“ error appearing when creating new reviews
* The error was caused by nonce verification running on redirect URLs after successful review creation
* Fixed by skipping nonce check when updated=1 parameter is present (indicates safe redirect after our own form submission)
* Editing existing reviews continues to work correctly with proper nonce verification

0.2.3 – 2025-12-01

Bug Fixes:
* Fixed duplicate Amazon Associate tag parameter in affiliate URLs
* Added auto-generation of Amazon URLs from ASIN, region, and Associate ID on review create/edit page
* Added preview box showing auto-generated URL with „Use This URL“ button
* Added override option to manually enter custom Amazon URLs (e.g., for author pages or review pages)
* Fixed affiliate link generation to correctly format tag parameter and prevent duplication
* Improved URL handling to remove existing tag parameters before adding the correct one
* Fixed executable file permissions issue (svn-commit.sh) for WordPress.org compliance

Code Quality:
* Enhanced database query phpcs:ignore comments with detailed explanations
* Improved code documentation for WordPress.org plugin checker compliance

0.2.1 – 2025-11-26

Security & Compliance:
* Fixed all WordPress.org plugin review security issues
* Added proper nonce verification to all form handlers
* Fixed SQL query preparation to use placeholders correctly
* Replaced $_POST array processing with individual field extraction
* Added proper output escaping for HTML content
* Added External Services documentation for OCR.space API usage
* Fixed variable naming in uninstall.php

Bug Fixes:
* Fixed undefined variable warnings in review form data retrieval
* Corrected readme.txt documentation regarding Amazon API calls (plugin does not call Amazon APIs)

1.0.0 – 2025-12-13

Major Release – Production Ready

This version marks the plugin as stable and production-ready, with significant improvements to reliability and user experience.

New Features:
* Added ASIN change detection – shows warning when ASIN is updated but URL still contains old ASIN
* Added URL mismatch warning in Analytics dashboard – identifies reviews with URLs that don’t match their ASINs
* Enhanced JavaScript to dynamically show/hide warnings as user types
* Improved form layout – moved Save/Update button above OCR section for better UX

Bug Fixes:
* Fixed regex error when extracting ASIN from Amazon URLs (changed delimiter to prevent conflict)
* Fixed auto-generated URL display to use normalized ASIN consistently
* Improved ASIN normalization to preserve all 10 characters correctly
* Fixed nonce security issues in analytics warning links
* Fixed form submission security checks

Improvements:
* Enhanced user experience with better form layout and button placement
* Improved error detection and warnings throughout the admin interface
* Better validation and feedback for ASIN and URL matching

0.2.4 – 2025-12-13

Bug Fixes:
* Fixed regex error when extracting ASIN from Amazon URLs (changed delimiter to prevent conflict)
* Fixed auto-generated URL display to use normalized ASIN consistently
* Improved ASIN normalization to preserve all 10 characters correctly

New Features:
* Added ASIN change detection – shows warning when ASIN is updated but URL still contains old ASIN
* Added reminder to regenerate URL when ASIN changes
* Enhanced JavaScript to dynamically show/hide warnings as user types

0.2.2 – 2025-11-27

Version 0.2.2 (27 November 2025) addresses all issues identified in the 0.2.1 review.

Security Fixes:
* Fixed nonce verification logic in edit review page to fail early if nonce is missing or invalid
* Added nonce verification to all edit links in reviews list table
* Moved nonce check to start of bulk actions handler before accessing request data
* Improved nonce handling for both single and bulk delete actions

Code Standards:
* Replaced inline style tag in helper file with wp_add_inline_style() for WordPress.org compliance
* Fixed ABSPATH check in helper file to use strict exit instead of conditional WordPress loading
* Refactored SQL queries to use single prepare() calls with all values passed together
* Enhanced SQL query safety documentation and comments
* Fixed global variable naming to use plugin prefix (sfrbrs_) in helper file and uninstall.php
* Added proper phpcs:ignore comments for all prepared SQL queries with detailed explanations

0.2.0 – 2025-11-15

New Features:
* Added review categories with admin management, list table filters, and quick edit
* Introduced analytics dashboards with view/click metrics, summaries, and charts
* Implemented OCR-based review import workflow with helper tips
* Enhanced shortcode and block styling controls, category filters, and load-more pagination

Improvements:
* Hardened security with sanitised inputs, escaped outputs, and prepared queries
* Added shortcode attribute recovery so Gutenberg’s Shortcode block preserves styling controls
* Applied Plugin Check fixes for $wpdb access (table/column quoting plus placeholder-based LIMIT/OFFSET)
* Added uninstall handler to drop custom tables, remove options, clear scheduled events, and purge cached transients when the new „Delete plugin data when uninstalling“ toggle is enabled
* Introduced a „Delete plugin data when uninstalling“ option so you control whether reviews persist across reinstalls

0.1.0

  • Initial release