dwindown/wp-agentic-writer

Fork 0

Files

Dwindi Ramadhana 44e06eed88 feat: consolidate docs, backend/session infra, and settings updates

2026-05-28 00:58:20 +07:00

18 KiB

Raw Blame History

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)

// 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)

// 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)

// 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)

Finalize Pro feature set
Set up license server infrastructure
Create Pro addon codebase
Prepare marketing copy

Phase 2: Soft Launch (Week 3)

Release free plugin to limited beta
Test with 10-20 trusted users
Gather feedback and fix critical issues

Phase 3: WordPress.org Submission (Week 4)

Prepare WordPress.org assets (banner, icons)
Write compliant readme.txt
Submit for review
Address review feedback (typically 1-2 weeks)

Phase 4: Pro Launch (Week 6-8)

Launch license server
Create sales page
Set up payment processing
Launch Pro addon

Phase 5: Marketing (Ongoing)

Blog posts on AI writing tools
Tutorial videos on YouTube
Guest posts on WordPress blogs
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)

18 KiB Raw Blame History

WP Agentic Writer - Distribution Strategy

Executive Summary

Architecture Overview

Feature Distribution

Free Version Features

Core Writing Pipeline

Model Integration

Analytics & Tracking

Technical Foundation

Pro Addon Features

Advanced Refinement (Multi-Pass)

External Integrations

Local Backend (Extended)

Collaboration & Team

Advanced Analytics

Priority Support

Hook System Architecture

Purpose

Hook Types

1. Action Hooks (Events)

2. Filter Hooks (Data Modification)

3. REST API Endpoints

4. JavaScript Events (Frontend)

Licensing System

Pro Addon Structure

License Types

License Verification Flow

License Server Requirements

Endpoints

Security Measures

Migration Path

Upgrading from Free to Pro

Data Migration

File Structure

Free Plugin (WordPress.org)

Pro Addon

Testing Checklist

Pre-Release Validation

Free Version

Pro Addon

Rollout Strategy

Phase 1: Preparation (Week 1-2)

Phase 2: Soft Launch (Week 3)

Phase 3: WordPress.org Submission (Week 4)

Phase 4: Pro Launch (Week 6-8)

Phase 5: Marketing (Ongoing)

Pricing Considerations

Factors for Pricing

Recommended Pricing

Risk Mitigation

Technical Risks

Business Risks

Success Metrics

Free Version

Pro Version

18 KiB

Raw Blame History