WooAgent AI

Advanced Autonomy for E-Commerce Content Generation

🚀 Overview

WooAgent AI is a cutting-edge WordPress plugin engineered to bridge the gap between human intuition and autonomous AI generation in e-commerce. Built with a focus on Clean Architecture, Secure State Management, and Multimodal LLM Integration, WooAgent allows merchants to transform raw product images and brief hints into complete, SEO-optimized, and richly structured WooCommerce drafts in exactly two clicks.

This tool demonstrates deep expertise in modern WordPress development, utilizing native Core APIs, robust sanitization, and seamless integration with OpenRouter's vision-capable LLMs (such as GPT-4o, Claude 3.5 Sonnet, and Gemini Pro).

✨ Key Technical Achievements

• Multimodal AI Pipeline: Securely processes local WordPress media attachments, converts them into Base64 payloads, and dispatches them to OpenRouter's API inside a strictly defined JSON Schema extraction framework.
• Strict JSON Schema Enforcement: Eliminates AI hallucinations by forcing the LLM to return exactly the data types WordPress requires (e.g., image_alt_texts, category_suggestions, merchant_review_notes), allowing for zero parsing errors.
• Robust Security Standards: Built to strictly adhere to WordPress VIP coding standards. Every endpoint uses strong nonce verification, robust data sanitization (sanitize_text_field, sanitize_textarea_field), and deep data validation before updating the database.
• Frictionless UX/UI Design: Employs an ultra-minimalist native WordPress UI, aggressively reducing user friction by combining complex configuration paradigms into a rapid 2-step execution flow.
• Graceful Error Handling: Implements WP_Error deeply throughout the plugin’s communication channels, ensuring users are gracefully alerted to Provider API rejections, schema mismatches, or missing API keys.

🛠️ Architecture Deep Dive

The plugin follows a modular, object-oriented design:

1. OpenRouter_Client: The underlying intelligence layer. Responsible for managing HTTP interactions with the OpenRouter API. Built with high-level timeouts, payload encapsulation, and dynamic prompt engineering.
2. Admin: The presentation layer. Integrates cleanly into WooCommerce without breaking native routing or submenu systems, leveraging localized scripts for dynamic state manipulation.
3. Core Plugin Registration: The main entrypoint. Handles lifecycle operations (activation/deactivation), permissions checks, and dependency verification to ensure WooCommerce is fully active before injection.

🏁 Installation

1. Clone or download this repository.
2. Upload the folder to your /wp-content/plugins/woo-agent/ directory.
3. Activate the plugin through the 'Plugins' menu in WordPress.
4. Navigate to WooCommerce > WooAgent and insert your OpenRouter API Key.

🧠 Powered by OpenRouter

WooAgent interfaces dynamically with OpenRouter, allowing users to select their model of choice directly from the WordPress Admin Dashboard.

Important: To utilize the image detection algorithms, ensure the selected model supports Vision capabilities (e.g., openai/gpt-4o-mini, anthropic/claude-3-haiku, etc).

👨‍💻 Developed By

Shahriar Arabpour

• Expertise: AI Engineering, Prompt Architecture, WordPress Core Development.
• Mission: Building tools that automate friction and drive autonomy in digital ecosystems.