WP Manifestindependent plugin directory
manifest / ai / ai-page-composer

AI Page Composer

AI-powered page composition tool with block preferences, API integration, and intelligent content generation.

by madsad87 · github.com/madsad87/ai-page-composer · website

★ 0stars

Install

Download source zip No release zip yet

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/madsad87/ai-page-composer/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/madsad87/ai-page-composer ↗

AI-powered WordPress plugin for intelligent content generation and page composition.

🚀 Features

AI Content Generation

  • Outline Generation: AI-driven content structure creation
  • Section Generation: Dynamic section content with LLM integration
  • Blueprint System: Reusable content templates with schema validation
  • Block Assembly: Intelligent Gutenberg block composition

Content Governance

  • Run Tracking: Complete audit trail of AI generations
  • History Management: Version control and rollback capabilities
  • Citation System: Source tracking for generated content
  • Rerun Management: Reproducible content generation workflows

Development Tools

  • Composer: PHP dependency management with PSR-4 autoloading
  • Webpack: Modern JavaScript bundling and optimization
  • PHPCS: WordPress coding standards enforcement
  • PHPUnit: Comprehensive test suite
  • ESLint/Stylelint: Frontend code quality tools

📁 Project Structure

ai-page-composer/
├── ai-page-composer.php          # Main plugin file
├── composer.json                 # PHP dependencies
├── package.json                  # Node.js dependencies
├── includes/                     # Core plugin logic
│   ├── class-autoloader.php      # PSR-4 autoloader (fallback)
│   ├── core/                     # Core classes
│   │   ├── plugin.php            # Main plugin class
│   │   ├── activator.php         # Activation handler
│   │   └── deactivator.php       # Deactivation handler
│   ├── admin/                    # Admin interface
│   │   ├── admin-manager.php     # Admin functionality
│   │   ├── settings-manager.php  # Settings management
│   │   └── block-preferences.php # Block preferences
│   ├── api/                      # REST API & AI services
│   │   ├── ai-service-client.php # AI service integration
│   │   ├── outline-controller.php# Outline generation
│   │   ├── section-controller.php# Section generation
│   │   ├── assembly-manager.php  # Block assembly
│   │   └── governance-controller.php # Run tracking
│   ├── blueprints/               # Blueprint system
│   │   ├── blueprint-manager.php # Blueprint management
│   │   └── schema-processor.php  # Schema validation
│   ├── blocks/                   # Gutenberg blocks
│   │   └── block-manager.php     # Block registration
│   └── utils/                    # Utility classes
│       ├── security-helper.php   # Security functions
│       └── validation-helper.php # Validation functions
├── assets/                       # Frontend assets
│   ├── css/                      # Stylesheets
│   └── js/                       # JavaScript files
├── templates/                    # Template files
│   ├── admin/                    # Admin templates
│   └── blocks/                   # Block templates
└── tests/                        # Test suite
    ├── api/                      # API tests
    ├── blueprints/               # Blueprint tests
    └── integration/              # Integration tests

🛠 Development Setup

Prerequisites

  • PHP 8.0+
  • Composer
  • Node.js 16+
  • WordPress development environment

Installation

  1. Clone the repository

    git clone https://github.com/madsad87/ai-page-composer.git
cd ai-page-composer

  2. Install PHP dependencies

    composer install

  3. Install Node.js dependencies

    npm install

Development Workflow

PHP Development

# Check coding standards
composer phpcs

# Fix coding standards
composer phpcbf

# Run unit tests
composer test

# Run tests with coverage
composer test:coverage

Frontend Development

# Build for production
npm run build

# Development with watch mode
npm run dev

# Lint CSS
npm run lint:css

# Lint and fix JavaScript
npm run lint:js
npm run fix:js

# Run JavaScript tests
npm run test

# Create distribution zip
npm run zip

🔧 Plugin Architecture

Core Components

  1. Plugin Manager: Central coordinator for all modules
  2. API Layer: REST endpoints for AI services
  3. Blueprint System: Content template management
  4. Governance Layer: Audit and history tracking
  5. Admin Interface: WordPress dashboard integration

Design Patterns

  • Manager Pattern: Dedicated managers for each domain
  • PSR-4 Autoloading: Composer-based class loading
  • Singleton Pattern: Shared service instances
  • Observer Pattern: WordPress hooks integration
  • Strategy Pattern: Pluggable AI services

🧪 Testing

Run the comprehensive test suite to ensure functionality:

# Run all tests
composer test

# Run specific test suite
composer test --testsuite API

# Run tests with filter
composer test --filter OutlineGeneratorTest

📚 Documentation

  • GOVERNANCE_IMPLEMENTATION.md: Run tracking and audit system
  • MVDB_INTEGRATION.md: Content retrieval pipeline
  • OUTLINE_IMPLEMENTATION.md: Outline generation logic
  • Code-level PHPDoc documentation throughout

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a pull request

📄 License

GPL-2.0-or-later - See LICENSE file for details.