ruben/rl-schema-box
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 3.8 MiB
  • PHP 100%
Find a file
Exact
Ruben Ramirez 2f817a7917 Add The SEO Framework integration for unified JSON-LD output 
When TSF is active, RLSB injects its non-overlapping schemas (Product,
FAQ, HowTo, Review, Recipe, Event) into TSF's unified JSON-LD output
instead of outputting separate script tags. This prevents duplicate
markup and creates cleaner HTML.

Changes:
- Add RLSB_TSF_Detector class to detect TSF and its extensions
- Add RLSB_TSF_Integrator class to hook into TSF's schema filters
- Modify RLSB_Plugin to route between integration and standalone modes
- Update RLSB_Conflict to treat TSF as integration partner (not conflict)
- Add admin notice showing TSF integration status and schema distribution
- Add get_cached_schema_data() method to schema base class
- Add README.md with documentation
- Minor formatting fixes in Event and Recipe schema classes
2026-03-01 00:18:21 -06:00
includes Add The SEO Framework integration for unified JSON-LD output 2026-03-01 00:18:21 -06:00
vendor Configure Mago for WordPress/WooCommerce and fix code quality issues 2026-02-16 06:44:01 -06:00
.gitignore Initial Commit 2026-02-16 04:10:34 -06:00
composer.json Configure Mago for WordPress/WooCommerce and fix code quality issues 2026-02-16 06:44:01 -06:00
composer.lock Configure Mago for WordPress/WooCommerce and fix code quality issues 2026-02-16 06:44:01 -06:00
README.md Add The SEO Framework integration for unified JSON-LD output 2026-03-01 00:18:21 -06:00
readme.txt Initial Commit 2026-02-16 04:10:34 -06:00
rl-schema-box.php Add The SEO Framework integration for unified JSON-LD output 2026-03-01 00:18:21 -06:00

README.md

RL Schema Box

A lightweight WordPress plugin that generates Schema.org JSON-LD structured data for better SEO.

Features

  • Multiple Schema Types: Article, Product (WooCommerce), Organization, FAQ, Breadcrumb, HowTo, Review, Recipe, Event, Local Business
  • The SEO Framework Integration: Automatically integrates with TSF for unified JSON-LD output
  • Conflict Detection: Warns about other SEO plugins that may cause duplicate markup
  • Caching: Built-in caching for optimal performance
  • Admin Preview: Preview JSON-LD output before it goes live

Requirements

  • WordPress 6.0+
  • PHP 8.3+
  • WooCommerce (optional, for Product schema)

Installation

  1. Upload the rl-schema-box folder to /wp-content/plugins/
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Configure settings under Settings > RL Schema Box

Configuration

General Settings

Enable or disable individual schema types:

  • Article
  • Product (WooCommerce)
  • Organization
  • FAQ
  • Breadcrumb
  • HowTo
  • Review
  • Recipe
  • Event
  • Local Business

Organization Settings

Configure your organization details:

  • Organization Name
  • Logo URL
  • Website URL

Local Business Settings

For local business schema:

  • Business Name
  • Street Address
  • City
  • State/Province
  • Postal Code
  • Country Code (2-letter)
  • Phone
  • Price Range
  • Output Page (homepage or specific page)

The SEO Framework Integration

When The SEO Framework is active, RL Schema Box automatically integrates with it for unified JSON-LD output:

Schema Type Handled By
Breadcrumb TSF
Organization TSF
Website TSF
Webpage TSF
Article TSF (with Articles extension)
Local Business TSF (with Local SEO extension)
Product RLSB
FAQ RLSB
HowTo RLSB
Review RLSB
Recipe RLSB
Event RLSB

This prevents duplicate markup and creates cleaner HTML with a single <script type="application/ld+json"> tag.

Schema Types

Article

Outputs on single posts. Uses featured image and author information.

Product

Outputs on WooCommerce product pages. Includes:

  • Product name and description
  • SKU
  • Brand
  • Price and currency
  • Availability
  • Aggregate rating (if reviews exist)

Organization

Outputs on the front page. Includes organization name, URL, and logo.

FAQ

Outputs on pages/posts with FAQ content.

Breadcrumb

Outputs on all pages except the homepage. Creates navigation hierarchy.

HowTo

Outputs on pages/posts with HowTo content.

Review

Outputs on pages/posts with review content.

Recipe

Outputs on pages/posts with recipe content.

Event

Outputs on pages/posts with event content.

Local Business

Outputs on homepage or a specific page. Includes full address and contact information.

Hooks

Filters

  • the_seo_framework_schema_graph_data - Modify TSF graph data (when TSF is active)
  • the_seo_framework_schema_entity_builders - Register entity builders with TSF

Actions

  • wp_head - Output schemas (priority 1, when TSF is not active)
  • save_post - Clear post cache on save

Caching

Schema data is cached using WordPress transients:

  • Default cache expiration: 1 hour
  • Organization schema: 1 day
  • Cache is automatically cleared when posts are saved

Changelog

1.0.0

  • Initial release
  • The SEO Framework integration
  • 10 schema types supported
  • Admin preview functionality
  • Conflict detection for SEO plugins

License

GPL-2.0-or-later