Step-by-step installation guides, Bring Your Own Key (BYOK) provider setups, editorial campaign workflows, and technical troubleshooting.
/
No matching documentation guides found
Try searching with different terms like "Gemini", "Groq", "Ollama", "Campaign", or "License".
Getting Started3 min read · v1.1.0+
Installation & System Requirements
OpenContent AI is distributed as a standard, standalone WordPress plugin. It operates entirely on your server with zero external database dependencies or cloud middleware.
Minimum System Specifications
WordPress Core: Version 6.0 or higher (Gutenberg block support required).
PHP Environment: PHP 8.1, 8.2, or 8.3 with standard curl, json, and mbstring extensions enabled.
Database: MySQL 5.7+ or MariaDB 10.3+ (InnoDB engine recommended).
Execution Timeout: max_execution_time set to 120s or higher (for generating multi-thousand word deep-dive guides).
Step-by-Step Installation
Download the latest opencontent-ai.zip package from your Customer Account Portal.
In your WordPress dashboard, navigate to Plugins > Add New Plugin.
Click Upload Plugin at the top, select your zip archive, and click Install Now.
Once unpacked, click Activate Plugin. The OpenContent AI administration menu will appear in your sidebar.
No Bloat Guarantee:
OpenContent AI only executes scripts when you are actively inside the campaign studio or editor, ensuring zero impact on your front-end page load speed or Core Web Vitals.
Getting Started2 min read
Licence Key Activation & Domain Management
Activating your license enables automatic in-dashboard plugin updates, newly trained AI model provider adapters, and direct technical developer support.
Activating Your License Key
Copy your standardized licence key (format: OCAI-XXXX-XXXX-XXXX-XXXX) from your purchase receipt or /my-account/my-licenses/.
Navigate to OpenContent AI > Settings in your WordPress admin menu.
Select the Licence tab, paste your key into the Licence Key field, and click Activate Licence.
The system verifies the cryptographic signature with our High-Performance Order Storage (HPOS) server and grants your plan entitlements.
Free Staging Activations:
Local and test domains (localhost, 127.0.0.1, *.local, *.test, *.staging, or staging.* subdomains) do not count toward your license site activation quota. You can test without consuming live slots.
BYOK Provider Setup4 min read · Highly Recommended
Connecting Google Gemini AI Studio (Free Tier Available)
Google Gemini is the recommended default engine for OpenContent AI. It offers blazing speed, immense context windows, and a generous free tier of up to 1,500 requests per day via Google AI Studio.
Obtaining Your Gemini API Key
Visit Google AI Studio at aistudio.google.com and log in with your Google account.
Click Get API key from the left sidebar.
Click Create API key and copy the resulting string (starts with AIzaSy...).
In WordPress, go to OpenContent AI > Settings > AI Providers, select Google Gemini as your primary model, and paste the API key.
Cost Efficiency:
Gemini 1.5 Flash costs approximately $0.075 per 1,000,000 tokens when billed—equivalent to generating 50 full 2,000-word articles for under 10 cents ($0.10).
BYOK Provider Setup3 min read
Connecting Groq Cloud LPUs (Ultra-Low Latency)
Groq powers LPU (Language Processing Unit) hardware delivering inference speeds exceeding 500 tokens per second. It is perfect for rapid outline generation and instant conversational campaign ideation.
Configuring Groq Cloud
Sign up at console.groq.com and generate an API key under API Keys.
In OpenContent AI Settings > AI Providers, select Groq as your drafting engine.
Choose your preferred model: llama-3.3-70b-versatile or mixtral-8x7b-32768.
Save settings and click Test API Connection to verify instant response times.
BYOK Provider Setup4 min read · 100% Free & Private
Running Local Ollama Instances (Zero API Costs)
If you have an Apple Silicon Mac, NVIDIA GPU, or dedicated local server, you can run OpenContent AI with 100% local privacy and zero API costs using Ollama.
Quick Setup Walkthrough
Install Ollama from ollama.com or run curl -fsSL https://ollama.com/install.sh.
Pull your desired model by running ollama pull llama3 or ollama pull mistral.
Enable cross-origin requests by setting the environment variable OLLAMA_ORIGINS="*" before starting the Ollama service.
In OpenContent AI Settings > AI Providers, select Local Ollama and set Endpoint URL to http://localhost:11434/v1.
Server Environment Note:
If your WordPress site is hosted on a remote production server, ensure your local Ollama port (11434) is exposed via a secure TLS tunnel (e.g. Cloudflare Tunnel or Tailscale) or run Ollama directly on your VPS.
BYOK Provider Setup3 min read
Cloudflare Workers AI for Automatic Featured Images
OpenContent AI connects natively to Cloudflare Workers AI to generate high-resolution, photorealistic, or artistic featured images directly into your WordPress Media Library.
Obtaining Cloudflare Credentials
Log into your Cloudflare dashboard and copy your Account ID from the right sidebar.
Navigate to My Profile > API Tokens and click Create Token.
Select the Workers AI template, grant Read/Edit permissions, and generate the token.
In OpenContent AI Settings > Image Studio, enter your Account ID and API Token, and select your preferred model (Flux-1-Schnell or SDXL).
Campaign Studio5 min read
Building 30-Day Content Roadmaps & Topic Clusters
The AI Campaign Studio moves your editorial process beyond isolated prompts. It constructs cohesive topic silos and 30-day editorial roadmaps designed to establish topical authority in search engines.
How the Campaign Strategy Engine Operates
Seed Briefing: Enter your overarching niche, target audience persona, and primary seed keywords in the conversational briefing interface.
Pillar & Cluster Synthesis: The engine identifies parent pillar guides and generates 8–15 supporting cluster article concepts designed to internally link together.
Timeline Mapping: Articles are scheduled across calendar weeks according to your preferred drip frequency (e.g. 2 posts per week).
Batch Execution: Generate outlines and complete drafts for the entire campaign in sequence or one by one.
Article Writer4 min read
AI Article Writer, Quality Audits & Custom Personas
The Article Writer generates comprehensive, multi-section articles formatted directly as native Gutenberg WordPress blocks.
Custom Tone Profiles & Editorial Personas
Create distinct brand personas in Settings > Writing Styles. You can configure:
Vocabulary Constraints: Enforce brand terminology and prohibit generic AI filler phrases (e.g. "delve into", "in today's digital era").
Reading Grade Level: Target specific Flesch-Kincaid readability scores (Grade 7 for general audiences, Grade 12 for technical documentation).
Point of View: Toggle between First Person ("We at our company"), Second Person ("You should evaluate"), or Third Person.
SEO & Internal Links4 min read
SEO Intelligence, Search Intent & Rank Math / Yoast Bridge
OpenContent AI bridges directly into your WordPress database and existing SEO plugins to maximize search crawl efficiency.
Native Internal Linking Engine
During article generation, the plugin queries your published post table (wp_posts) to locate contextually relevant articles. It automatically injects natural anchor links linking back to your existing content.
SEO Metadata Synchronization
The SEO bridge automatically writes the following custom post meta keys for Yoast SEO and Rank Math:
_yoast_wpseo_title and rank_math_title: SEO optimized title tag under 60 characters.
_yoast_wpseo_metadesc and rank_math_description: Meta description with focus keyphrase under 155 characters.
_yoast_wpseo_focuskw and rank_math_focus_keyword: Primary keyword phrase extracted from search intent analysis.
Automate your publishing pipeline while maintaining human oversight through customizable approval gates.
Publishing Status Workflows
Draft Mode (Recommended): Saves generated articles as drafts for manual review by your editorial team.
Pending Review: Assigns posts to the WordPress editorial review queue for multi-author sites.
Auto-Drip Schedule: Calculates future timestamp dates and automatically schedules posts via WordPress WP-Cron.
Troubleshooting5 min read
Troubleshooting: Rate Limits, Timeouts & FAQs
Resolving HTTP 429 (Rate Limit Exceeded)
An HTTP 429 response indicates that your API provider quota has been temporarily reached. OpenContent AI includes automated exponential backoff with retry logic. To avoid limits, consider adding a backup provider in Settings > AI Providers (e.g. Groq as primary, Gemini as fallback).
Resolving cURL Timeouts on Localhost
If generation times out during long 2,500+ word articles, increase the cURL timeout and PHP script execution limits in php.ini:
To transfer an activation from an old domain or retired staging site: log into your Customer Portal at /my-account/my-licenses/, click Deactivate next to the registered domain, and activate the key on your new site.