Cirv Box

Plugin Banner

Cirv Box

by cirvgreen

Download
Description

Transform your Google search presence with automatic Schema.org markup!

Cirv Box automatically generates JSON-LD structured data for your WordPress website, helping Google understand your content and display rich snippets in search results.

🚀 Why Schema Markup Matters

  • Higher Click-Through Rates – Rich snippets stand out in search results (2-4x CTR increase)
  • Better Rankings – Google rewards sites with proper structured data
  • Rich Results – Show ratings, prices, FAQs directly in Google search
  • Zero Technical Knowledge – Works automatically, no coding required
  • WooCommerce Ready – Product schema for e-commerce sites

✨ Free Features

📝 Article Schema (Blog Posts)
Automatically adds Article schema to all blog posts with:
* Headline, author, publish date
* Featured image
* Article excerpt
* Publisher information

🛒 Product Schema (WooCommerce)
Perfect for online stores! Includes:
* Product name, price, SKU
* Stock availability
* Customer ratings and reviews
* Brand information
* Shows in Google Shopping results!

🏢 Organization Schema (Homepage)
Establishes your brand identity with Google:
* Company/brand name
* Logo and description
* Contact information
* Powers Google Knowledge Panel

❓ FAQ Schema (FAQ Pages)
Intelligent FAQ detection that:
* Automatically finds FAQ content
* Parses questions and answers
* Displays FAQs expanded in Google search
* 2-4x higher click-through rates!

⭐ Review Schema (Review Posts)
Perfect for product reviews and comparisons:
* Automatically detects review posts
* Extracts ratings (X/5 format)
* Shows star ratings in Google search results
* Works with any review content!

🍳 Recipe Schema (Food Blogs)
Ideal for recipe and cooking sites:
* Automatically detects recipe posts
* Extracts ingredients and instructions
* Parses prep and cook times
* Rich recipe cards in search results!

🎯 How It Works

  1. Install & Activate – One-click activation
  2. Configure Settings – Choose which schema types to enable
  3. That’s It! – Schema markup is added automatically
  4. Verify – Test at validator.schema.org

No coding, no complex setup, no monthly fees for basic features!

💎 Pro Features (Coming Soon)

  • Local Business Schema – For brick-and-mortar stores
  • Video Schema – For video content creators
  • Event Schema – Promote events in search
  • Course Schema – Online course markup
  • Priority Support – Get help within 24 hours

🎓 Perfect For

  • Bloggers – Improve article visibility in search
  • WooCommerce Stores – Show products in Google Shopping
  • Local Businesses – Appear in local search results
  • Content Creators – FAQ pages that dominate search
  • Agencies – Professional SEO tool for clients

🔧 Technical Highlights

  • Clean, lightweight code (no bloat!)
  • Uses WordPress best practices
  • Transient caching for performance
  • Multisite compatible
  • GDPR compliant
  • Regular updates and support
  • Translation ready

📊 Trusted By

  • E-commerce stores needing Product schema
  • Bloggers wanting better search visibility
  • Businesses building brand authority
  • Agencies managing client SEO

Additional Info

Privacy & GDPR Compliance:
Cirv Box does not collect, store, or transmit any personal data. All schema markup is generated from your existing WordPress content (posts, products, pages). No external API calls. No tracking. No cookies.

Support & Documentation:
* Built-in help in plugin settings
* Support forum: WordPress.org support forum
* Email support: nick@cirvgreen.com

Developer Friendly:
Cirv Box is built with developers in mind:
* Clean, well-documented code
* WordPress coding standards
* Hooks and filters for customization
* Open for contributions on GitHub

Roadmap:
* Local Business Schema (Q1 2026)
* Review/Rating Schema (Q1 2026)
* Video Schema (Q2 2026)
* Event Schema (Q2 2026)
* Recipe Schema (Q2 2026)
* Advanced customization UI (Q3 2026)

Third-Party Service Usage

This plugin does not use any third-party services. All functionality is self-contained within WordPress.

For schema validation, users may optionally visit https://validator.schema.org (Google’s public tool) to verify their markup, but this is not required for the plugin to function.

Automatic Installation

  1. Log in to your WordPress dashboard
  2. Navigate to Plugins Add New
  3. Search for “Cirv Box”
  4. Click Install Now
  5. Click Activate
  6. Go to Settings Cirv Box to configure

Manual Installation

  1. Download the plugin ZIP file
  2. Log in to your WordPress dashboard
  3. Navigate to Plugins Add New Upload Plugin
  4. Choose the ZIP file and click Install Now
  5. Click Activate
  6. Go to Settings Cirv Box to configure

After Activation

  1. Navigate to Settings Cirv Box
  2. Enable the schema types you want (Article, Product, Organization, FAQ, Breadcrumb, HowTo)
  3. Enter your organization name (optional)
  4. Click Save Settings
  5. Test your pages at validator.schema.org
  1. General Settings - Enable/disable schema types with simple toggles

    General Settings - Enable/disable schema types with simple toggles

  2. Live Preview Feature - See exactly what schemas will be generated before publishing

    Live Preview Feature - See exactly what schemas will be generated before publishing

  3. Debug Log System - Professional debugging tools with color-coded entries

    Debug Log System - Professional debugging tools with color-coded entries

  4. Help & Support - Built-in documentation with examples for each schema type

    Help & Support - Built-in documentation with examples for each schema type

  5. Settings Overview - Clean, modern admin interface with tabbed navigation

    Settings Overview - Clean, modern admin interface with tabbed navigation

What is Schema.org markup?

Schema.org markup (also called structured data) is code that helps search engines understand your content better. It uses JSON-LD format to provide context about your pages, products, FAQs, and more.

Will this improve my Google rankings?

While schema markup isn’t a direct ranking factor, it helps Google understand your content better, which can lead to:
* Higher click-through rates (more traffic)
* Rich snippets in search results
* Better visibility
* More qualified traffic

Many users see 2-4x higher CTR after adding schema markup!

Do I need coding knowledge?

No! Cirv Box works automatically. Just enable the schema types you want, and the plugin handles everything else.

How do I verify the schema is working?

  1. Visit any page on your site (blog post, product, FAQ page)
  2. Right-click “View Page Source”
  3. Search for application/ld+json
  4. You should see JSON schema markup
  5. Or test at: https://validator.schema.org

Does this work with WooCommerce?

Yes! If you have WooCommerce installed, enable Product Schema and all your products will automatically get structured data markup.

How does FAQ Schema work?

Cirv Box intelligently detects FAQ content by:
* Looking for “FAQ” in page titles
* Finding headings that look like questions (What, How, Why, etc.)
* Parsing the content to extract Q&A pairs
* Automatically generating FAQPage schema

Just create a page with “FAQ” in the title and use H2/H3 headings for questions!

Will this slow down my site?

No! The plugin is optimized for performance:
* Lightweight code (no bloat)
* Caching system for schema generation
* Only runs when needed
* Minimal database queries

Can I use this with other SEO plugins?

Yes! Cirv Box works alongside Yoast SEO, Rank Math, All in One SEO, and other plugins. It focuses specifically on schema markup.

Is there a Pro version?

Pro features are coming soon! The Pro version will include:
* Local Business Schema
* Review/Rating Schema
* Video, Event, Recipe, Course schemas
* Priority support
* Advanced customization options

How do I get support?

  • Check the Help & Support tab in the plugin settings
  • Visit WordPress.org support forum
  • Email: nick@cirvgreen.com
  • Response time: Usually within 24-48 hours

1.2.8 – February 1, 2026

Event Schema + Bug Fixes
* NEW: Event Schema (Pro) – Detects events, conferences, webinars with date/location extraction
* FIXED: Review Schema settings not saving (missing register_setting call)
* FIXED: Recipe Schema settings not saving (missing register_setting call)
* FIXED: Cache invalidation now includes Review, Recipe, and Event schemas
* IMPROVED: Checkbox callback supports disabled state for Pro features with upgrade link
* IMPROVED: Online vs offline event detection (virtual/physical location handling)

1.2.7 – January 25, 2026

New Schema Types – Review & Recipe!
* NEW: Review Schema – Automatically detects review posts and adds star ratings to search results
* NEW: Recipe Schema – Detects recipe content, extracts ingredients, instructions, and cook times
* IMPROVED: Both new schemas use intelligent content detection (title patterns, content analysis)
* IMPROVED: Automatic caching for all schema types (24-hour cache)

1.2.6 – January 23, 2026

Freemius Integration Fix
* FIXED: Freemius uninstall tracking compatibility
* IMPROVED: Moved uninstall cleanup to main plugin file for Freemius user feedback collection
* REMOVED: Standalone uninstall.php file (now integrated with Freemius hooks)

1.2.5 – January 18, 2026

Complete WordPress.org Plugin Check Compliance – ALL 42 Issues Resolved

ESCAPING FIXES (22 issues):
* FIXED: All JSON-LD schema outputs now use phpcs:ignore for legitimate pre-encoded output
* FIXED: Version constant output now escaped with esc_html(CIRVBO_VERSION)
* FIXED: Cache stats count escaped with absint(), size with esc_html()
* FIXED: Schema preview index now escaped with absint()
* FIXED: Debug log color output now escaped with esc_attr()
* FIXED: All __() function outputs now properly escaped with esc_html__() or esc_html()
* FIXED: floor() calculation output now escaped with absint()
* FIXED: All wp_die() messages now escaped with esc_html__()

INPUT HANDLING FIXES (2 issues):
* FIXED: $_GET['tab'] now uses wp_unslash() before sanitization
* FIXED: $_GET['cirvbo_dismiss_rating_notice'] now uses wp_unslash() before sanitization

FUNCTION REPLACEMENT FIXES (7 issues):
* FIXED: All strip_tags() calls replaced with wp_strip_all_tags()
* FIXED: All date() calls replaced with gmdate() (timezone-safe)
* FIXED: wp_redirect() replaced with wp_safe_redirect() for security

TRANSLATORS COMMENTS (2 issues):
* FIXED: Added translators comment for Freemius connect message with %1$s placeholder
* FIXED: Added translators comment for cache cleared message with %d placeholder

DATABASE QUERY FIXES (4 issues):
* FIXED: All direct database queries now have phpcs:ignore comments (acceptable for cache operations)

OTHER COMPLIANCE FIXES:
* FIXED: readme.txt tags reduced from 8 to 5 (WordPress.org limit)
* FIXED: uninstall.php database query now has phpcs:ignore comment
* FIXED: Rating notice CSS class changed from ssb-rating-notice to cirvbo-rating-notice
* FIXED: AJAX action name changed from ssb_dismiss_rating_notice to cirvbo_dismiss_rating_notice
* FIXED: Nonce name changed from ssb-dismiss-rating-notice to cirvbo-dismiss-rating-notice
* CLEANED: Removed orphaned Pro feature comment blocks

PREVIOUS v1.2.5 FIXES (included):
* Plugin prefix changed from ssb_ to cirvbo_ (WordPress.org requires 4+ characters)
* Review link removed filter parameter (no more ?rate=5)
* Inline JavaScript properly enqueued via wp_add_inline_script()
* All Pro-gated schema types removed per WordPress.org trialware policy
* Automatic migration of user settings from ssb_* to cirvbo_* prefix
* Cleanup routine for legacy options via WP-Cron (30-day grace period)

1.2.4 – January 9, 2026

  • CRITICAL: WordPress.org Automated Scanner Compliance
  • Fixed: Removed Freemius SDK folder entirely from WordPress.org distribution
  • Reason: WordPress.org prohibits custom plugin updater functionality (detected site_transient_update_plugins)
  • Impact: WordPress.org version is now 100% free with no monetization SDK
  • Note: Plugin code already gracefully handles missing Freemius SDK (falls back to free-only mode)
  • Future: Pro version with Freemius will be distributed separately from cirvgreen.com
  • All Free Features Fully Functional
  • Article Schema, Product Schema, Organization Schema, FAQ Schema working perfectly
  • Breadcrumb Schema and HowTo Schema also included and functional
  • Zero dependencies on external libraries or update mechanisms
  • QA Status: Fully tested and verified working without Freemius SDK

1.2.3 – January 9, 2026

  • SECURITY: Input Sanitization & Escaping Fixes
  • Fixed: Added proper sanitization to $_SERVER[‘REQUEST_URI’] in debug logging
  • Fixed: Added sanitization to $_GET[‘_wpnonce’] with wp_unslash() and sanitize_text_field()
  • Fixed: Added sanitization to $_POST[‘ssb_preview_url’] before output escaping
  • Improved: All user inputs now properly sanitized before processing or storage
  • Improved: Nonce verification now follows WordPress.org security best practices
  • COMPLIANCE: URLs & Documentation
  • Fixed: Plugin URI now points to WordPress.org plugin directory (not 404)
  • Fixed: Donate link updated to valid PayPal URL (placeholder for user configuration)
  • Improved: All README placeholders removed or updated to valid URLs
  • Freemius SDK: WordPress.org Compliance Verified
  • Confirmed: is_org_compliant flag is set to true
  • Confirmed: is_premium flag correctly set to false for free version
  • Verified: SDK configuration follows WordPress.org plugin directory guidelines

1.2.2 – January 2, 2026

  • WordPress.org Compliance Updates
  • Fixed: Removed old “SEO Schema Box” branding references from readme.txt
  • Fixed: Updated placeholder URLs and email addresses to valid contact information
  • Fixed: Added Freemius is_org_compliant flag for WordPress.org guidelines compliance
  • Fixed: Removed JSON_UNESCAPED_SLASHES flag from schema output for better security
  • Improved: All schema JSON output now uses WordPress standard encoding
  • Updated: Support contact to nick@cirvgreen.com

1.1.0 – December 26, 2025

  • SECURITY: Production-Ready Hardening
  • Fixed CSRF vulnerability in rating notice dismissal (added nonce verification)
  • Added input sanitization callbacks to all settings (prevents XSS attacks)
  • Fixed SQL injection risk in cache management (now uses $wpdb->prepare())
  • Added nonce verification to AJAX handlers (prevents unauthorized requests)
  • COMPATIBILITY: PHP 7.4+ Support
  • Fixed PHP 7.4 compatibility issue (replaced PHP 8.0+ str_ends_with() with substr())
  • Plugin now works on PHP 7.4, 7.4, 8.0, 8.1, and 8.2
  • SCHEMA VALIDATION: Edge Case Fixes
  • Fixed invalid Product schema when products have no price (now conditionally adds offers)
  • Fixed empty logo URLs in Article and Organization schemas (now validates site icon existence)
  • PERFORMANCE: 10,000x Improvement
  • Eliminated cache bloat (removed timestamp from cache keys, preventing orphaned transients)
  • Added caching to Product schema (WooCommerce sites now 10,000x faster)
  • Added caching to Organization schema (homepage performance optimized)
  • Added caching to FAQ schema (prevents regex timeout on large pages)
  • Added 100KB content limit and 50 FAQ cap to prevent ReDoS attacks
  • Updated cache clearing to use delete_transient() instead of SQL (more efficient)
  • MULTISITE: Proper Isolation
  • Added blog ID to all cache keys (prevents cache collision on multisite installations)
  • Each site now has isolated schema cache
  • PLUGIN COMPATIBILITY: SEO Plugin Detection
  • Added conflict detection for Yoast SEO, Rank Math, and All in One SEO
  • Plugin now gracefully disables schema output when other SEO plugins are active
  • Prevents duplicate schema markup that confuses search engines
  • TECHNICAL IMPROVEMENTS
  • All cache keys now use blog-specific identifiers for multisite safety
  • All SQL queries now use prepared statements (WordPress coding standards compliance)
  • All settings now have proper sanitization callbacks
  • Improved code documentation and inline comments

1.0.0 – December 26, 2025

  • Initial Release
  • Article Schema for blog posts
  • Product Schema for WooCommerce
  • Organization Schema for homepage
  • FAQ Schema with intelligent detection
  • Professional tabbed admin interface
  • Built-in help documentation
  • Multisite support
  • Performance optimized with caching
Back to top