Provimedia GEO Widget

Description

Geo Widget creates structured, citable answer blocks (Answer Cards) directly in the WordPress Gutenberg Editor. This optimizes your content specifically for AI-powered search engines like Google AI Overviews, Bing Copilot, or Perplexity.

Each block consists of a question, answer, bullet points, and sources — including copy buttons so readers and AI systems can correctly cite your content.

Who is this plugin for?

• Content creators who want to be cited in AI answers
• SEO teams focusing on Generative Engine Optimization
• Editorial teams needing structured fact blocks in articles
• Developers integrating Answer Cards into external systems via REST API

Features

Gutenberg Block “Answer Card”

• Question Field — Input field with character limit (max. 140 characters) and live counter
• Answer Field — Multi-line text field for the citable answer
• Word Counter with Traffic Light Indicator — Real-time color-coded assessment of answer length:
  • Gray: Too short (under 40 words)
  • Green: Ideal length (40-80 words)
  • Yellow: Getting long (81-120 words)
  • Red: Too long (over 120 words)
• Bullet Points (Key Points) — Up to 6 key statements with add/remove buttons
• Source Management — Up to 6 sources with label, URL, publisher, and date
• Anchor ID — Automatically generated from the question, with umlaut support. Manually overridable with reset option
• Server-Side Rendering — Output is fully rendered server-side (no frontend JavaScript required)

Copy Buttons

• Copy Link — Copies the permalink including anchor fragment to clipboard
• Copy Citation — Copies a formatted citation: “Question” — Post Title (Site Name, Date) URL
• Visual Feedback — Button shows “Copied!” and is briefly disabled
• Fallback for Older Browsers — Automatic fallback when Clipboard API is unavailable
• Configurable Display — Controllable via sidebar: link only, citation only, or both

REST API

• Public Endpoint — GET /wp-json/provimedia-geo-widget/v1/answers returns all Answer Cards as JSON
• Filter by Post — Parameter post_id to retrieve blocks from a specific post
• Pagination — Parameters per_page and page with response headers X-WP-Total and X-WP-TotalPages
• Read-only — GET requests only, no write operations
• Disableable — Can be completely disabled in settings

Settings Page

• Enable/Disable REST API — Toggles the public API endpoint on or off
• Include Answer in Citation — Adds the answer text to the citation
• Default Copy Mode — Global default: Link & Citation, Link only, or Citation only
• Strict Word Limit — Enforces the 120-word limit when saving

Security

• Input sanitization of all attributes
• Consistent late-escaping against XSS
• Protocol whitelist for URLs (http/https only)
• No innerHTML or eval in frontend JavaScript
• Drafts and password-protected posts excluded from API
• SQL injection protection via parameterized queries
• Whitelist validation of all setting values
• Nonce protection (CSRF) on settings page
• External links with rel="noopener noreferrer"

Clean Uninstallation

• On uninstall, all plugin options and transients are completely removed from the database

Compatibility

• WordPress 6.0 or higher
• PHP 7.4 or higher
• Gutenberg Block API v3
• RTL support (automatically generated stylesheets)
• Translation-ready (Text Domain: provimedia-geo-widget)

Development

The compiled JavaScript and CSS files in the /build directory are generated from source files in the /src directory using WordPress build tools.

Source Code

All source code is included in the plugin:

• /src/index.js – Editor block component (React/JSX)
• /src/frontend.js – Copy button functionality (Vanilla JS)
• /src/editor.scss – Editor-only styles (SCSS)
• /src/style.scss – Frontend styles (SCSS)

Build Instructions

1. Install Node.js (v18 or higher recommended)
2. Navigate to the plugin directory
3. Run npm install to install dependencies
4. Run npm run build to compile assets

Build Commands

• npm run build – Compile production assets
• npm run start – Watch mode for development
• npm run lint – Run code linting
• npm run test – Run unit tests

Dependencies

• @wordpress/scripts – WordPress build toolchain
• @wordpress/blocks – Block registration API
• @wordpress/block-editor – Block editor components
• @wordpress/components – UI components
• @wordpress/i18n – Internationalization utilities
• @wordpress/element – React abstraction layer
• @wordpress/url – URL validation utilities