DOCUMENTATION & KNOWLEDGE BASE

Master OpenContent AI for WordPress

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 Started 3 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

  1. Download the latest opencontent-ai.zip package from your Customer Account Portal.
  2. In your WordPress dashboard, navigate to Plugins > Add New Plugin.
  3. Click Upload Plugin at the top, select your zip archive, and click Install Now.
  4. 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 Started 2 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

  1. Copy your standardized licence key (format: OCAI-XXXX-XXXX-XXXX-XXXX) from your purchase receipt or /my-account/my-licenses/.
  2. Navigate to OpenContent AI > Settings in your WordPress admin menu.
  3. Select the Licence tab, paste your key into the Licence Key field, and click Activate Licence.
  4. 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 Setup 4 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

  1. Visit Google AI Studio at aistudio.google.com and log in with your Google account.
  2. Click Get API key from the left sidebar.
  3. Click Create API key and copy the resulting string (starts with AIzaSy...).
  4. In WordPress, go to OpenContent AI > Settings > AI Providers, select Google Gemini as your primary model, and paste the API key.

Verifying Connection via cURL

BASH · Gemini 1.5 Flash Verification
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Confirm OpenContent AI connection."}]
  }]
}'
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 Setup 3 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

  1. Sign up at console.groq.com and generate an API key under API Keys.
  2. In OpenContent AI Settings > AI Providers, select Groq as your drafting engine.
  3. Choose your preferred model: llama-3.3-70b-versatile or mixtral-8x7b-32768.
  4. Save settings and click Test API Connection to verify instant response times.
BASH · Groq API Test
curl -X POST "https://api.groq.com/openai/v1/chat/completions" \
-H "Authorization: Bearer gsk_YOUR_GROQ_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "llama-3.3-70b-versatile", "messages": [{"role": "user", "content": "Hello OpenContent AI"}]}'
BYOK Provider Setup 4 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

  1. Install Ollama from ollama.com or run curl -fsSL https://ollama.com/install.sh.
  2. Pull your desired model by running ollama pull llama3 or ollama pull mistral.
  3. Enable cross-origin requests by setting the environment variable OLLAMA_ORIGINS="*" before starting the Ollama service.
  4. 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 Setup 3 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

  1. Log into your Cloudflare dashboard and copy your Account ID from the right sidebar.
  2. Navigate to My Profile > API Tokens and click Create Token.
  3. Select the Workers AI template, grant Read/Edit permissions, and generate the token.
  4. In OpenContent AI Settings > Image Studio, enter your Account ID and API Token, and select your preferred model (Flux-1-Schnell or SDXL).
Campaign Studio 5 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

  1. Seed Briefing: Enter your overarching niche, target audience persona, and primary seed keywords in the conversational briefing interface.
  2. Pillar & Cluster Synthesis: The engine identifies parent pillar guides and generates 8–15 supporting cluster article concepts designed to internally link together.
  3. Timeline Mapping: Articles are scheduled across calendar weeks according to your preferred drip frequency (e.g. 2 posts per week).
  4. Batch Execution: Generate outlines and complete drafts for the entire campaign in sequence or one by one.
Article Writer 4 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 Links 4 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.
Publishing Suite 3 min read

Batch Publishing, Scheduled Drip & Taxonomy Mapping

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.
Troubleshooting 5 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:

INI · Recommended php.ini Settings
max_execution_time = 300
max_input_time = 300
memory_limit = 256M

Transferring a License to a New Domain

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.