Flixly for WordPress

Official WordPress plugin for Flixly — generate AI images, video, and audio directly from the post editor and Media Library.

The user-facing readme that ships with the plugin is readme.txt (WordPress.org format). This file is for contributors.

What's in the box

• Settings → Flixly — API key, default model, monthly budget, webhook secret
• Gutenberg block "Flixly Image" — prompt + model + aspect ratio, attaches result to Media Library
• Media Library "Generate with Flixly" — modal that creates a new attachment from a prompt
• REST proxy at /wp-json/flixly/v1/* so the API key never reaches the browser
• Built on the official flixly/sdk Composer package

Requirements

• PHP 7.4 or newer
• WordPress 6.0 or newer
• ext-curl, ext-json, ext-hash (standard everywhere)

Repository layout

flixly-wordpress/
├── flixly.php                  # plugin entry, registers all classes
├── readme.txt                  # WordPress.org listing
├── uninstall.php               # wipes plugin options on uninstall
├── composer.json               # depends on flixly/sdk
├── includes/
│   ├── class-flixly-client.php # SDK wrapper + option getters
│   ├── class-flixly-settings.php
│   ├── class-flixly-rest.php   # /wp-json/flixly/v1/...
│   ├── class-flixly-block.php  # server-side block registration
│   └── class-flixly-media.php  # upload.php button + sideload helper
├── blocks/
│   └── flixly-image/
│       ├── block.json
│       ├── package.json        # @wordpress/scripts build config
│       └── src/                # edit.js, save.js, index.js
└── assets/
    ├── css/admin.css
    └── js/{settings,media}.js

Building from source

# 1. Composer dependencies
composer install --no-dev

# 2. Compile the Gutenberg block
cd blocks/flixly-image
npm install
npm run build
cd ../..

This produces:

• vendor/ — required at runtime for the SDK autoloader
• blocks/flixly-image/build/ — the compiled block bundle

Both are excluded from version control but must be present in the zip you upload to a WordPress site.

Local dev loop

Use any local WP environment — wp-env, LocalWP, or your own LAMP stack. Symlink this directory into wp-content/plugins/flixly and activate.

For block development:

cd blocks/flixly-image
npm run start    # webpack watch mode

Linting

php -l flixly.php
for f in includes/*.php; do php -l "$f"; done
php -l uninstall.php

Publishing to WordPress.org

The plugin directory uses SVN. See the publishSteps in the v0.1.0 plan, or:

1. Sign in at wordpress.org/plugins/developers
2. Submit the plugin slug flixly for review (1–4 weeks)
3. After approval you get SVN access at https://plugins.svn.wordpress.org/flixly/
4. Push releases by copying the built plugin into trunk/ and tagging into tags/0.1.0/

Links

• API docs: www.flixly.ai/developers
• OpenAPI spec: www.flixly.ai/api/v1/openapi.json
• Issues: github.com/Softforge-Digital/flixly-wordpress/issues

License

MIT — see LICENSE.