Overview

Bridge the gap between schema creation and validation. The Schema Blocks WordPress plugin connects to ValidGraph via secure integration tokens, enabling in-editor validation status, automated monitoring, and a seamless create-validate-monitor workflow.

How It Works

1. User generates an integration token in ValidGraph
2. Token is entered in the Schema Blocks plugin settings
3. Plugin authenticates with ValidGraph API
4. Features enabled:
– Validation badge in block editor (shows current status)
– One-click validation from the editor
– Automatic URL monitoring registration
5. Token management (revoke, regenerate) from ValidGraph dashboard

Tier Availability

| Tier | Available |
|——|———–|
| Free | No |
| Pro | Yes |
| Agency | Yes |
| Enterprise | Yes |

Related Features

– Validate on Publish: Auto-validate when posts are published
– URL Validation: The validation engine used
– URL Monitoring: Auto-register published URLs for monitoring

Mini-Tutorial

Step 1: Generate a Plugin Token

In ValidGraph, go to Integrations > Schema Blocks and click “Generate New Token.”

Step 2: Copy the Token

You’ll see a token starting with svp_. Copy this entire string. Tokens are confidential—treat like a password.

Step 3: Install the Schema Blocks Plugin

If you haven’t already, install the Schema Blocks WordPress plugin from the WordPress plugin directory.

Step 4: Paste Token into Plugin Settings

In WordPress, go to Settings > Schema Blocks and paste your token into the ValidGraph Integration field.

Step 5: Test the Connection

Click “Test Connection.” You should see “Connected successfully.”

Step 6: Start Validating

When you create or edit a post with schema blocks, you’ll see a green or red validation badge. Click it for detailed error messages.

Technical Details

Generate Token Request

POST /api/v1/plugin-tokens
{
  "name": "WordPress Production",
  "expires_in_days": 365
}

Response:

{
  "token_id": "token_abc123",
  "token": "svp_1a2b3c4d5e6f...",
  "created_at": "2025-03-22T14:00:00Z",
  "expires_at": "2026-03-22T14:00:00Z"
}

Plugin Status Check

GET /api/v1/plugin-status

Request header required:

X-Plugin-Token: svp_1a2b3c4d5e6f...

Response:

{
  "status": "active",
  "version": "2.1.0",
  "capabilities": {
    "validate": true,
    "monitor": true,
    "auto_publish_validation": true
  },
  "last_validation": "2025-03-22T13:45:00Z",
  "active_schemas": 24
}

Revoke Token

DELETE /api/v1/plugin-tokens/token_abc123

All requests using that token immediately fail after revocation.

References

– Schema Blocks WordPress Plugin Repository
– WordPress REST API Handbook
– JSON-LD in WordPress
– ValidGraph Plugin Integration Guide