LuminaSEO Pro Docs
Complete technical documentation for installation, configuration, and advanced usage of the LuminaSEO Pro neural infrastructure.
Quick Start
Installation
Upload the luminaseo-pro.zip via WordPress Admin → Plugins → Add New → Upload Plugin. Activate and navigate to LuminaSEO Pro in your sidebar.
Access Hub Connection
Go to LuminaSEO Pro → Settings → Site Connection. Enter your access key and click Connect. The system will handshake with the LuminaHub platform and unlock all neural features.
First Generation
Navigate to LuminaSEO Pro → Settings. Set your Gemini API Key, choose your daily post count, and click "Generate Now" to trigger your first neural post.
AI Content Engine
Neural Engine Integration
LuminaSEO Pro pushes every prompt to the LuminaHub Neural Engine over a server-side Gemini API (BYOK). The plugin never talks to a model provider directly, so model-swapping or bypass is not possible. Active fallback models on the hub: gemini-3.6-flash, gemini-flash-latest, gemini-2.0-flash. Auto-retries with ramp-up backoff on 503/high-demand responses.
License-Gated Generation
Every generation request is validated against the distributed license registry before contacting the model provider. Invalid or nulled licenses are rejected with a 403 and logged to the LuminaHub security log.
Content Structure
Every generated post includes: SEO-optimised title, H2/H3 headings, 1500–3000 word body, Table of Contents, FAQs, and a meta description. All Yoast-ready.
Category Rotation
The engine automatically cycles through your WordPress categories in sequence, ensuring balanced topical authority across your entire domain.
Featured Images (FLUX Engine)
Ultra-Realistic Generation
Images are generated using the FLUX model via the Pollinations API. Human subjects receive automatic skin-tone and texture enhancement tokens for photorealistic output.
Resolution
All featured images are generated at 1280×720 (16:9 widescreen). They are automatically attached as the featured image of each generated post.
Image Optimization
If Smush, ShortPixel, or Imagify is installed, images are automatically sent for compression immediately after attachment.
Zero-Latency Indexing
Google Indexing API
After each post is published, LuminaSEO Pro dispatches a direct URL_UPDATED signal to the Google Indexing API, bypassing the traditional crawl queue.
Setup
Upload your Google Service Account JSON credentials in Settings → Indexing. Grant the service account "Owner" permission in Google Search Console for your property.
Verification
The Dashboard shows each post's indexing status. Green = indexed. Yellow = pending. Red = error with the raw API response for debugging.
Schema Graph Injection
Supported Types
Article, BlogPosting, FAQPage, HowTo, BreadcrumbList, Product, Organization, WebSite, WebPage, SoftwareApplication, Person, LocalBusiness, Event, VideoObject.
WooCommerce Products
Product Schema is automatically enhanced with Brand, SKU, offers, and aggregate ratings. WooCommerce Product post types are fully detected and handled.
Output Method
All Schema is output as inline JSON-LD in the <head> via the SchemaMarkup class. It does not interfere with Yoast, RankMath, or any other schema output.
SILO Internal Linking
How It Works
After generating a post, the engine analyses the last 20 published posts in the same category and automatically injects contextual internal links based on semantic keyword relevance.
Link Depth
Links are injected into paragraph bodies (not just the footer) to pass maximum topical authority signals through your content hierarchy.
WooCommerce Neural Bridge
Auto Detection
If WooCommerce is active, the Neural Bridge automatically detects Product Categories (product_cat taxonomy) and switches the post type to "product" instead of "post".
Product Metadata
Auto-generated products receive: SKU (LSE-[hash]), _price, _regular_price, _stock_status (instock), _visibility (visible), and product_type (simple).
Conflict Safety
The bridge only activates when WooCommerce is present. On non-WC sites, it returns null with zero overhead.
Security & Licensing
Distributed License Checks
License validation is distributed across LicenseManager.php, GeminiClient.php, and CronTask.php. Removing any one file triggers restricted mode.
Site-Specific Keys
The database option key is unique per domain (MD5 hash), preventing license data from being copied across installations.
Emergency Lockdown
If a tamper attempt is detected or the license has not been verified in over 7 days, the plugin clears all credentials and cancels all scheduled cron tasks.
Settings Reference
Gemini API Key
Required. Get a free key from aistudio.google.com. Supports Flash and Pro models. Flash is recommended for speed; Pro for maximum quality.
Posts Per Day
Default: 1. Maximum: 10. Set higher values only if your server has sufficient cron reliability (recommended: managed WordPress hosting).
Target Keyword
Displayed for reference only. Automatically updated to the next category's name before each generation run.
Indexing Credentials
Paste the full contents of your Google Service Account JSON file. This is stored encrypted in wp_options and never transmitted to third parties.
Dashboard & Analytics
AI Posts Log
The Dashboard tab shows all AI-generated posts with their title, category, date, Yoast score, and Google Indexing status.
Error Reporting
Indexing errors show the raw Google API error code. Common errors: 403 (permission not granted), 429 (rate limit), 404 (URL not accessible to Googlebot).
Need more help?
Use the Support widget on the main page to submit a feature request or bug report directly to our neural engineering team.
Return to LuminaSEO ProDocs Update Policy
These docs are updated with every feature release. Each new version ships with a refreshed #ai-engine section and release notes so the docs always reflect the latest deployed capability. If you spot a difference between this page and the plugin, a newer release is already on the way.