506 lines
18 KiB
Markdown
506 lines
18 KiB
Markdown
# WP Agentic Writer - Distribution Strategy
|
|
|
|
**Version:** 1.0
|
|
**Date:** 2026-05-17
|
|
**Strategy:** Freemium with Addon Model
|
|
|
|
---
|
|
|
|
## Executive Summary
|
|
|
|
This document outlines a comprehensive strategy for distributing WP Agentic Writer as two distinct versions:
|
|
- **Free Version** - Published on WordPress.org repository for maximum visibility and user acquisition
|
|
- **Pro Version** - Premium addon sold via your own license server with advanced features
|
|
|
|
**Core Philosophy:** The free version must be a complete, valuable product on its own. Pro features are genuine enhancements that power users will happily pay for.
|
|
|
|
---
|
|
|
|
## Architecture Overview
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ WP AGENTIC WRITER │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ FREE CORE PLUGIN (WordPress.org) │
|
|
│ ├── AI Writing Assistant (sidebar) │
|
|
│ ├── Context Management │
|
|
│ ├── Planning & Writing Pipeline │
|
|
│ ├── Model Selection (OpenRouter) │
|
|
│ ├── Basic Refinement │
|
|
│ ├── Cost Tracking │
|
|
│ └── Hook System (for extensibility) │
|
|
├─────────────────────────────────────────────────────────────┤
|
|
│ PRO ADDON (License Server) │
|
|
│ ├── License Verification System │
|
|
│ ├── Advanced Refinement (multi-pass) │
|
|
│ ├── Local Backend Integration (extended) │
|
|
│ ├── Brave Search Integration │
|
|
│ ├── Image Generation (DALL-E, Stable Diffusion) │
|
|
│ ├── Custom Model Presets │
|
|
│ ├── Team Collaboration │
|
|
│ ├── Priority Support │
|
|
│ └── Advanced Analytics │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Feature Distribution
|
|
|
|
### Free Version Features
|
|
|
|
#### Core Writing Pipeline
|
|
| Feature | Description | Strategic Value |
|
|
|---------|-------------|-----------------|
|
|
| Planning Mode | AI-powered article outline creation | Core value prop |
|
|
| Writing Mode | Generate full articles with context | Core value prop |
|
|
| Chat Mode | Quick AI assistance | Engagement driver |
|
|
| Refinement Mode | Basic content polishing | Entry to refinement |
|
|
| @mention Detection | Link to related posts | Unique capability |
|
|
| Clarification Quiz | Guided topic extraction | User onboarding |
|
|
| Focus Keyword | SEO-first writing | Differentiation |
|
|
|
|
#### Model Integration
|
|
| Feature | Description | Strategic Value |
|
|
|---------|-------------|-----------------|
|
|
| OpenRouter Integration | Access to 100+ models | Flexibility |
|
|
| Model Selection UI | Easy model switching | Usability |
|
|
| Preset Configurations | Budget/Balanced/Premium | Quick start |
|
|
| Cost Estimation | Real-time cost display | Budget control |
|
|
|
|
#### Analytics & Tracking
|
|
| Feature | Description | Strategic Value |
|
|
|---------|-------------|-----------------|
|
|
| Cost Log | Basic usage tracking | Transparency |
|
|
| Token Usage | Input/output tracking | Optimization |
|
|
| Daily/Monthly Stats | Usage overview | Awareness |
|
|
|
|
#### Technical Foundation
|
|
| Feature | Description | Strategic Value |
|
|
|---------|-------------|-----------------|
|
|
| Gutenberg Integration | Block editor sidebar | Core integration |
|
|
| Classic Editor Support | Alternative UI | Coverage |
|
|
| Shortcode Support | Flexible embedding | Versatility |
|
|
| REST API Endpoints | Developer hooks | Ecosystem |
|
|
| WebSocket Status | Real-time updates | Polish |
|
|
|
|
---
|
|
|
|
### Pro Addon Features
|
|
|
|
#### Advanced Refinement (Multi-Pass)
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| Multi-Pass Refinement | 3-stage polishing (clarity, SEO, quality) | High |
|
|
| Keyword Density Optimization | Automatic SEO improvement | High |
|
|
| Readability Scoring | Flesch-Kincaid integration | Medium |
|
|
| Plagiarism Check | Integration with Copyscape API | Premium |
|
|
| Brand Voice Training | Learn from existing content | Premium |
|
|
|
|
#### External Integrations
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| Brave Search Integration | Real-time web research | High |
|
|
| Image Generation (DALL-E 3) | AI-generated featured images | High |
|
|
| Image Generation (SDXL) | Stable Diffusion XL | Premium |
|
|
| Unsplash Integration | Stock photo search | Medium |
|
|
| WordPress Media Library | Direct image management | Medium |
|
|
|
|
#### Local Backend (Extended)
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| LM Studio Support (Full) | Complete integration | Medium |
|
|
| Ollama Support (Full) | Complete integration | Medium |
|
|
| Self-Hosted Models | Custom model hosting | Premium |
|
|
| Multi-Instance Support | Multiple backend servers | Premium |
|
|
| Load Balancing | Automatic failover | Premium |
|
|
|
|
#### Collaboration & Team
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| Team Workspaces | Shared configurations | Premium |
|
|
| User Roles & Permissions | Role-based access | Premium |
|
|
| Activity Logs | Audit trails | Medium |
|
|
| Template Sharing | Team templates | Medium |
|
|
| Content Approvals | Workflow integration | Premium |
|
|
|
|
#### Advanced Analytics
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| ROI Calculator | Content performance vs cost | Medium |
|
|
| Content Performance | SEO ranking tracking | Premium |
|
|
| A/B Testing | Headline variations | Premium |
|
|
| Seasonal Trends | Content calendar | Premium |
|
|
|
|
#### Priority Support
|
|
| Feature | Description | Value |
|
|
|---------|-------------|-------|
|
|
| Email Support | Direct assistance | Medium |
|
|
| Priority Response | 24hr vs 7 days | Medium |
|
|
| Feature Requests | Influence roadmap | Low |
|
|
| Custom Integrations | Bespoke solutions | Premium |
|
|
|
|
---
|
|
|
|
## Hook System Architecture
|
|
|
|
### Purpose
|
|
The free version provides comprehensive hooks that both Pro addon and third-party developers can use to extend functionality.
|
|
|
|
### Hook Types
|
|
|
|
#### 1. Action Hooks (Events)
|
|
```php
|
|
// Writing lifecycle
|
|
do_action('wpaw_before_generate', $post_id, $mode);
|
|
do_action('wpaw_after_generate', $post_id, $mode, $content);
|
|
do_action('wpaw_planning_started', $post_id);
|
|
do_action('wpaw_planning_complete', $post_id, $plan);
|
|
do_action('wpaw_writing_started', $post_id, $section_index);
|
|
do_action('wpaw_writing_section_complete', $post_id, $section_index, $content);
|
|
do_action('wpaw_refinement_started', $post_id);
|
|
do_action('wpaw_refinement_complete', $post_id, $refined_content);
|
|
|
|
// Model interactions
|
|
do_action('wpaw_model_selected', $model_id, $task_type);
|
|
do_action('wpaw_api_request_sent', $model_id, $tokens, $cost);
|
|
do_action('wpaw_api_response_received', $model_id, $response_time);
|
|
|
|
// Context management
|
|
do_action('wpaw_context_loaded', $post_id, $context_data);
|
|
do_action('wpaw_context_updated', $post_id, $changes);
|
|
|
|
// Cost tracking
|
|
do_action('wpaw_cost_recorded', $record);
|
|
do_action('wpaw_daily_limit_reached', $total_cost);
|
|
```
|
|
|
|
#### 2. Filter Hooks (Data Modification)
|
|
```php
|
|
// Context modification
|
|
add_filter('wpaw_context_data', 'modify_context', 10, 2);
|
|
add_filter('wpaw_post_content', 'process_content', 10, 2);
|
|
add_filter('wpaw_planning_prompt', 'customize_planning', 10, 2);
|
|
|
|
// Model selection
|
|
add_filter('wpaw_model_for_task', 'override_model', 10, 3);
|
|
add_filter('wpaw_model_parameters', 'customize_params', 10, 2);
|
|
|
|
// Output modification
|
|
add_filter('wpaw_generated_content', 'post_process', 10, 3);
|
|
add_filter('wpaw_refinement_criteria', 'custom_criteria', 10, 2);
|
|
|
|
// Cost calculations
|
|
add_filter('wpaw_cost_calculation', 'adjust_cost', 10, 2);
|
|
add_filter('wpaw_token_count', 'modify_tokens', 10, 2);
|
|
```
|
|
|
|
#### 3. REST API Endpoints
|
|
```
|
|
POST /wpaw/v1/generate
|
|
- Generate content via API
|
|
- Authentication: API key or OAuth
|
|
|
|
POST /wpaw/v1/refine
|
|
- Refine existing content
|
|
- Parameters: content, criteria, iterations
|
|
|
|
GET /wpaw/v1/cost-log
|
|
- Retrieve cost tracking data
|
|
- Filters: date range, post_id, model
|
|
|
|
GET /wpaw/v1/models
|
|
- List available models
|
|
- Include pricing and capabilities
|
|
|
|
POST /wpaw/v1/context
|
|
- Update context for specific post
|
|
```
|
|
|
|
#### 4. JavaScript Events (Frontend)
|
|
```javascript
|
|
// jQuery / DOM Events
|
|
document.dispatchEvent(new CustomEvent('wpaw:generation-start', {
|
|
detail: { postId, mode }
|
|
}));
|
|
|
|
document.dispatchEvent(new CustomEvent('wpaw:generation-complete', {
|
|
detail: { postId, content, cost }
|
|
}));
|
|
|
|
document.dispatchEvent(new CustomEvent('wpaw:section-written', {
|
|
detail: { postId, sectionIndex, content }
|
|
}));
|
|
|
|
// React component hooks (for sidebar)
|
|
window.wpawHooks = {
|
|
onBeforeGenerate: (postId, mode) => {},
|
|
onAfterGenerate: (postId, mode, content) => {},
|
|
onModelSelected: (modelId, taskType) => {},
|
|
};
|
|
```
|
|
|
|
---
|
|
|
|
## Licensing System
|
|
|
|
### Pro Addon Structure
|
|
|
|
#### License Types
|
|
| Type | Price Point | Activations | Features |
|
|
|------|-------------|-------------|----------|
|
|
| Personal | $49/year | 1 site | All Pro features |
|
|
| Professional | $99/year | 5 sites | All Pro + priority support |
|
|
| Agency | $199/year | 25 sites | All Pro + team features |
|
|
| Enterprise | Custom | Unlimited | White-label + SLA |
|
|
|
|
#### License Verification Flow
|
|
```
|
|
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
|
│ User │ │ Pro Addon │ │ License │
|
|
│ Activates │────▶│ Checks │────▶│ Server │
|
|
└──────────────┘ └──────────────┘ └──────────────┘
|
|
│ │
|
|
│ Valid? │
|
|
▼ ▼
|
|
┌──────────────┐ ┌──────────────┐
|
|
│ Enable Pro │ │ Response: │
|
|
│ Features │◀────│ key, expiry, │
|
|
└──────────────┘ │ features │
|
|
└──────────────┘
|
|
```
|
|
|
|
### License Server Requirements
|
|
|
|
#### Endpoints
|
|
```
|
|
POST /api/v1/verify
|
|
- Input: license_key, domain, product_id
|
|
- Output: { valid: bool, expires: date, features: [] }
|
|
|
|
POST /api/v1/activate
|
|
- Input: license_key, domain
|
|
- Output: { activation_id, sites_used, sites_limit }
|
|
|
|
POST /api/v1/deactivate
|
|
- Input: activation_id
|
|
- Output: { success: bool }
|
|
|
|
GET /api/v1/status
|
|
- Input: license_key
|
|
- Output: { active: bool, sites: [], expires: date }
|
|
```
|
|
|
|
#### Security Measures
|
|
- License key hashed with SHA-256 before storage
|
|
- Domain binding prevents key sharing
|
|
- Activation limit enforcement
|
|
- Automatic deactivation on payment failure
|
|
- IP-based rate limiting on verification
|
|
|
|
---
|
|
|
|
## Migration Path
|
|
|
|
### Upgrading from Free to Pro
|
|
```
|
|
┌──────────────────────────────────────────────────────────┐
|
|
│ Step 1: User purchases Pro license │
|
|
│ └── Receives license key via email │
|
|
│ │
|
|
│ Step 2: User installs Pro Addon │
|
|
│ └── Upload via WordPress admin │
|
|
│ └── Activates alongside free plugin │
|
|
│ │
|
|
│ Step 3: User enters license key │
|
|
│ └── Addon validates against license server │
|
|
│ └── Activates on current domain │
|
|
│ │
|
|
│ Step 4: Pro features unlocked │
|
|
│ └── UI shows Pro indicators │
|
|
│ └── New tabs/options become visible │
|
|
│ └── Settings synced from free version │
|
|
│ │
|
|
│ Step 5: Deactivate/reactivate │
|
|
│ └── Can transfer license to new domain │
|
|
│ └── Previous site features disabled │
|
|
└──────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### Data Migration
|
|
- Settings stored in `wp_options` - shared between free and pro
|
|
- Pro settings prefixed with `wpaw_pro_`
|
|
- Cost tracking uses unified table structure
|
|
- No data loss during upgrade
|
|
|
|
---
|
|
|
|
## File Structure
|
|
|
|
### Free Plugin (WordPress.org)
|
|
```
|
|
wp-agentic-writer/
|
|
├── wp-agentic-writer.php # Main plugin file
|
|
├── readme.txt # WordPress.org readme
|
|
├── uninstall.php # Clean uninstall
|
|
├── includes/
|
|
│ ├── class-plugin.php # Core plugin class
|
|
│ ├── class-settings.php # Settings page
|
|
│ ├── class-gutenberg-sidebar.php # Sidebar UI
|
|
│ ├── providers/
|
|
│ │ └── class-openrouter-provider.php
|
|
│ └── helpers/
|
|
│ └── class-context-manager.php
|
|
├── assets/
|
|
│ ├── css/
|
|
│ │ ├── agentic-variables.css
|
|
│ │ ├── agentic-components.css
|
|
│ │ └── agentic-workflow.css
|
|
│ └── js/
|
|
│ └── sidebar.js
|
|
├── views/
|
|
│ └── settings/
|
|
└── lang/
|
|
└── wp-agentic-writer.pot
|
|
```
|
|
|
|
### Pro Addon
|
|
```
|
|
wp-agentic-writer-pro/
|
|
├── wp-agentic-writer-pro.php # Main addon file
|
|
├── includes/
|
|
│ ├── class-license-manager.php # License verification
|
|
│ ├── class-pro-features.php # Feature toggles
|
|
│ ├── providers/
|
|
│ │ ├── class-brave-search.php
|
|
│ │ └── class-image-generator.php
|
|
│ ├── refinement/
|
|
│ │ └── class-multi-pass-refinement.php
|
|
│ └── analytics/
|
|
│ └── class-pro-analytics.php
|
|
└── admin/
|
|
└── class-pro-admin.php # Pro settings UI
|
|
```
|
|
|
|
---
|
|
|
|
## Testing Checklist
|
|
|
|
### Pre-Release Validation
|
|
|
|
#### Free Version
|
|
- [ ] Works with WordPress 6.0+ (latest stable)
|
|
- [ ] Works with PHP 7.4+ (minimum) and 8.x (recommended)
|
|
- [ ] No PHP errors/warnings in debug mode
|
|
- [ ] All hooks documented and functional
|
|
- [ ] Settings page renders correctly
|
|
- [ ] Sidebar works in Gutenberg and Classic
|
|
- [ ] Uninstall removes all plugin data
|
|
- [ ] Internationalization (i18n) complete
|
|
|
|
#### Pro Addon
|
|
- [ ] Gracefully fails without license
|
|
- [ ] Shows upgrade prompts for locked features
|
|
- [ ] License verification works offline (cached)
|
|
- [ ] Reactivation works correctly
|
|
- [ ] No errors when free plugin inactive
|
|
- [ ] License expiry handled gracefully
|
|
|
|
---
|
|
|
|
## Rollout Strategy
|
|
|
|
### Phase 1: Preparation (Week 1-2)
|
|
1. Finalize Pro feature set
|
|
2. Set up license server infrastructure
|
|
3. Create Pro addon codebase
|
|
4. Prepare marketing copy
|
|
|
|
### Phase 2: Soft Launch (Week 3)
|
|
1. Release free plugin to limited beta
|
|
2. Test with 10-20 trusted users
|
|
3. Gather feedback and fix critical issues
|
|
|
|
### Phase 3: WordPress.org Submission (Week 4)
|
|
1. Prepare WordPress.org assets (banner, icons)
|
|
2. Write compliant readme.txt
|
|
3. Submit for review
|
|
4. Address review feedback (typically 1-2 weeks)
|
|
|
|
### Phase 4: Pro Launch (Week 6-8)
|
|
1. Launch license server
|
|
2. Create sales page
|
|
3. Set up payment processing
|
|
4. Launch Pro addon
|
|
|
|
### Phase 5: Marketing (Ongoing)
|
|
1. Blog posts on AI writing tools
|
|
2. Tutorial videos on YouTube
|
|
3. Guest posts on WordPress blogs
|
|
4. Community forum engagement
|
|
|
|
---
|
|
|
|
## Pricing Considerations
|
|
|
|
### Factors for Pricing
|
|
| Factor | Consideration |
|
|
|--------|---------------|
|
|
| Competition | Compare to AI writing plugins ($49-$299/year) |
|
|
| Value Delivered | Pro features save X hours/month |
|
|
| Market Position | Mid-tier vs premium |
|
|
| Support Costs | Personal vs team tier |
|
|
|
|
### Recommended Pricing
|
|
| Tier | Price | Rationale |
|
|
|------|-------|-----------|
|
|
| Personal | $49/year | ~$4/month - impulse purchase |
|
|
| Professional | $99/year | ~$8/month - small business |
|
|
| Agency | $199/year | ~$8/site/year - good value |
|
|
|
|
---
|
|
|
|
## Risk Mitigation
|
|
|
|
### Technical Risks
|
|
| Risk | Mitigation |
|
|
|------|------------|
|
|
| License server downtime | Cache verification locally (7 days) |
|
|
| Key sharing | Domain binding + monitoring |
|
|
| WordPress.org policy violation | Clear separation of free/pro |
|
|
| Competition | Focus on unique value props |
|
|
|
|
### Business Risks
|
|
| Risk | Mitigation |
|
|
|------|------------|
|
|
| Low adoption | Start with strong free feature set |
|
|
| Support overload | Tiered support, clear documentation |
|
|
| Piracy | Regular audits, IP monitoring |
|
|
| Negative reviews | Proactive beta testing |
|
|
|
|
---
|
|
|
|
## Success Metrics
|
|
|
|
### Free Version
|
|
| Metric | Target |
|
|
|--------|--------|
|
|
| WordPress.org downloads (6 months) | 5,000+ |
|
|
| Active installations | 2,000+ |
|
|
| 5-star rating | 4.5+ |
|
|
| Support forum engagement | <10% of installs |
|
|
|
|
### Pro Version
|
|
| Metric | Target |
|
|
|--------|--------|
|
|
| Conversion rate (free→pro) | 2-5% |
|
|
| Monthly revenue (year 1) | $500-$1,000 |
|
|
| License renewals | 60%+ |
|
|
| Customer satisfaction | 4.0+ |
|
|
|
|
---
|
|
|
|
**Document Version:** 1.0
|
|
**Last Updated:** 2026-05-17
|
|
**Author:** Claude (AI Assistant) |