Documentation

Step 1: Download the Plugin

Clone or download the plugin to your WordPress plugins directory:

wp-content/plugins/article-to-video-generator/

Step 2: Install Dependencies

Navigate to the plugin directory and run:

cd wp-content/plugins/article-to-video-generator/
npm install

Step 3: Build Assets

Compile the plugin assets:

npm run build

Step 4: Activate Plugin

Go to WordPress Admin → Plugins and click "Activate" on the Article to Video Generator plugin.

The Video Studio provides a project-based approach to video creation with version control for A/B testing.

Key Features

• ✓Project Management: Create, organize, and manage video projects with multiple versions
• ✓Version Control: Create multiple versions of each video project for A/B testing
• ✓Post Analysis: Analyze WordPress posts and generate scenes directly in the studio
• ✓Deep Linking: URL routing with browser history navigation

Getting Started

1. Navigate to "A2VG Core > Video Studio" in your WordPress admin
2. Click "Create New Project" to start a new video project
3. Create multiple versions within each project for different approaches
4. Select a WordPress post to analyze and generate scenes automatically
5. Edit generated scenes, add text, images, and voiceovers
6. Use the video generator to create your final video
7. Organize, edit, and delete projects from the dashboard

Admin Interface

The plugin adds a new menu item "A2VG Core" to your WordPress admin with multiple tabs:

Rendering Engine Settings

Choose between:

• →V1 Canvas FFmpeg: Current production engine using Canvas API + FFmpeg.wasm
• →V2 Engine: Future engine for higher quality browser-based rendering

Logo Management

Upload light and dark versions of your logo for perfect brand consistency across all videos.

Typography System

Color Palette

Define primary, secondary, accent, text, and background colors. Add unlimited custom colors with custom names.

Real-time Preview

See all branding changes immediately in the interface before generating videos.

Template Categories

Template Features

• ✓Free and premium templates
• ✓Full customization with brand integration
• ✓Unified font system across all templates
• ✓Preview system before applying

V1 Canvas FFmpeg Engine (Current)

V2 Engine (Future)

Engine Selection

Choose your preferred rendering engine in the Home tab settings. The engine selection is stored and will be used for all video generations.

WordPress Hooks

A2VG exposes several hooks for addons and themes:

AJAX Handlers

The plugin includes several AJAX endpoints for video generation, template management, branding, and settings.

Extending Templates

add_filter('a2vg_register_templates', function (array $templates) {
  $templates[] = [
    'id'           => 'my-custom-template',
    'title'        => 'My Custom Template',
    'description'  => 'A custom template',
    'is_premium'   => false,
    'category'     => 'business',
    // ... more settings
  ];
  return $templates;
});

Building Assets

npm run start  # Development build with watch
npm run build  # Production build

Adding New Rendering Engines

1. Create engine class in assets/js/rendering-engines/
2. Implement required methods: renderTextToCanvas(), generateVideo(), getCapabilities()
3. Register engine in RenderingEngineManager
4. Add to home page settings dropdown

Adding New Templates

1. Create template data in includes/class-templates.php
2. Add template assets (images, styles) to assets/images/templates/
3. Update template categories and metadata
4. Test template rendering

Common Issues

Debug Mode

Enable WordPress debug mode for detailed error messages:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);