Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/muqo16/wo-rol/archive/refs/heads/main.zipWoRol AI
WordPress Intelligent Web Crawler, Role-Based Content & Image Automation Engine
Source Discovery -> Crawl -> AI Rewrite -> Image Generation -> SEO Meta -> Publish
Full workflow available via dashboard, manual trigger, or background autopilot.
Installation | Features | AI Providers | Security | Documentation
Overview
WoRol AI is an enterprise-grade WordPress automation plugin designed to periodically crawl target websites, discover new content, rewrite and enrich articles with customized persona guidelines and ethics/copyright filters, generate matching high-resolution featured images, and publish to designated categories with complete SEO metadata and Schema.org markup.
Target Website -> Smart Crawler -> Discovery Desk -> Persona & LLM -> Image Engine -> SEO Engine -> WordPress Post
Key Features
Intelligent Crawler & DOM Parser
|
Persona & Prompt Engine
|
7 LLM Providers
|
4 Image Providers
|
SEO & Schema.org Integration
|
Security Architecture
|
Supported AI Providers
| Provider | Supported Models | Details |
|---|---|---|
| DeepSeek | deepseek-chat (V3), deepseek-reasoner (R1), deepseek-v4-flash, deepseek-v4-pro |
Default provider, structured JSON output |
| Google Gemini | gemini-2.0-flash, gemini-1.5-flash, gemini-1.5-pro |
Header-based authentication (x-goog-api-key) |
| OpenAI | gpt-4o, gpt-4o-mini, o3-mini |
Native JSON object response format |
| Anthropic Claude | claude-3-5-sonnet-20241022 |
Token limit: 4096 |
| Groq | llama-3.3-70b-versatile |
Ultra-fast inference with 45s timeout |
| OpenRouter | Full open-source LLM pool | Single key access |
| Ollama | llama3 and local models |
Zero API cost, self-hosted |
Installation
1. Download
git clone https://github.com/muqo16/wo-rol.git
2. Deploy to WordPress
Copy the wo-rol directory to your WordPress installation under wp-content/plugins/.
3. Activation
Navigate to WordPress Admin -> Plugins -> WoRol AI -> Activate.
4. Configure API Keys
Go to WoRol AI -> Settings & API, enter your preferred provider API key, run a connection test, and save.
5. Add Sources
Under Source Sites, add your target RSS or HTML URLs and trigger a scan.
Security Architecture
| Category | Implementation | Status |
|---|---|---|
| Credential Storage | OpenSSL AES-256-CBC encryption using WordPress salts | Active |
| Key Masking | Admin interface masks keys (sk-••••••••9x8a) |
Active |
| Network Requests | wp_safe_remote_get with private/loopback IP validation |
Active |
| Authorization | Strict manage_options capability requirement on all endpoints |
Active |
| CSRF Defense | wp_verify_nonce validation on every AJAX request |
Active |
| Direct Access | ABSPATH check at the top of every PHP file |
Active |
| SQL Injection | Parameterized queries using $wpdb->prepare |
Active |
| Output Escaping | esc_html, esc_attr, esc_url, wp_kses_post, and JSON hex flags |
Active |
| Concurrency | Atomic database claims (status = 'processing') in cron loop |
Active |
| Uninstall Safety | Data retention by default; tables dropped only on explicit admin consent | Active |
Directory Structure
wo-rol/
├── wo-rol.php # Main bootstrap file
├── uninstall.php # Safe uninstall and cleanup script
├── includes/
│ ├── class-worol-security.php # AES-256-CBC, SSRF and nonce handlers
│ ├── class-worol-activator.php # DB schema installer and default seeding
│ ├── class-worol-scraper.php # RSS and HTML/DOM scraper
│ ├── class-worol-ai-engine.php # 7 AI provider integrations
│ ├── class-worol-image-engine.php # 4 image provider integrations
│ ├── class-worol-persona.php # Persona CRUD and prompt compiler
│ ├── class-worol-publisher.php # Post publisher and SEO meta handler
│ ├── class-worol-cron.php # Scheduled tasks and autopilot runner
│ └── class-worol-ajax.php # 13 AJAX endpoints
├── admin/
│ ├── class-worol-admin.php # Admin menu and asset loader
│ ├── css/worol-admin.css # Admin styling
│ ├── js/worol-admin.js # Interactive client-side logic
│ └── views/ # Admin view templates
└── languages/ # Translation files
Documentation
For Turkish documentation and detailed R10 thread template:
Requirements
| Requirement | Minimum |
|---|---|
| WordPress | 6.0+ |
| PHP | 7.4+ |
| OpenSSL | Required (AES-256-CBC) |
| MySQL / MariaDB | 5.6+ / 10.0+ |
| cURL | Required |
License
This project is licensed under the GPL-2.0+ license.
Author
Muzaffer Ulusoy
Website: ulusoydigital.com
GitHub: @muqo16