=== VX Framework ===
Contributors: vxframework
Tags: custom fields, custom post types, dynamic data, ai, mcp
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.4.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The data modeling layer for agentic WordPress. Model your content once and use it with block editor and page builders to headless frontends and AI agents.

== Description ==

VX Framework is the data model layer for WordPress. You describe the
structures your site needs. The framework supplies the editing interface,
the storage, and the validation.

Create fieldsets in the UI, in PHP, as JSON, or through an AI
assistant. Assign them to posts, terms, or users. Bind the values into
the block editor. The same typed model is what your theme and your
agents read.

= Features =

* Fieldsets with Locations, conditional logic, and revisions
* 40 field types, including Repeater, Section and Tabs
* Custom post types and taxonomies
* Dynamic data for the block editor with VX Script
* AI-ready: MCP, WordPress abilities, and WP-CLI
* Config as code: PHP and JSON
* Bricks, Oxygen, and Breakdance integrations
* Built-in documentation

Site: [vxframework.com](https://vxframework.com/)
Docs: [docs.vxframework.com](https://docs.vxframework.com/)

= Create fieldsets. Assign them anywhere. =

A fieldset is a named group of fields - the building block of your
content model. You design it once and reuse it.

**Locations** decide where it appears: a post type (including ones you
did not register), a taxonomy, or a user profile, optionally limited by
role. Conditional logic, revisions, and import/export live in the same
editor.

Create the fieldset visually, describe it to an assistant over MCP, or
define it in Local JSON or PHP and keep it in version control.

= Field types for any model =

* **Input** - Text, Textarea, Rich text, Number, Stepper, Email,
  URL, Phone, Password, Color, List, Slider, Range slider, Code
* **Choice** - Select, Multiselect, Checkboxes, Radio Buttons,
  Button Group, Switcher
* **Dates** - Date, Date range, Time, Date & Time
* **Media** - Image, Gallery, SVG, Video, Audio
* **Relational** - Taxonomy, Select Post, Select User
* **Composite** - Group, Repeater
* **Layout** - Section, Tabs, UI Heading, UI Spacer, UI Notice,
  UI HTML

= One model, any front-end =

Use VX with the block editor, Bricks, Oxygen, Breakdance, or a custom
theme. In templates, PHP helpers and hooks read typed field values.
The model does not change when the front-end does.

= Config as code =

Register post types, taxonomies, and fieldsets as JSON or PHP in your
theme or plugin, and keep your model in version control. Edits made
in the dashboard can be synced back to the files. The files describe
structure only, never content, so they move safely between
development, staging, and production.

= Dynamic data for the block editor and page builders =

Bind any field to any block with VX tags on the Block Bindings API.
Shape values with **VX Script** - tags, modifiers, and chainable
expressions. Loop a repeater or a gallery so each row renders as its
own block. Show or hide any block with visibility rules: user, content,
request, time, or a VX Script expression.

Building with Bricks, Oxygen, or Breakdance instead? The same fields
appear in the builder's dynamic data picker and loops.

= Content editing that feels native =

Navigate fieldsets from a collapsible sidebar. Edit on the canvas or in
form view. Everything stays in sync.

= Agentic WordPress, out of the box =

A typed data model agents can read and write through MCP and WordPress
abilities. The same catalog is available
from WP-CLI. The MCP endpoint stays off until you enable it. Reading and
writing are separate permissions - you grant each one yourself.

= VX Framework Pro =

VX Framework Pro is a separate plugin, available through [vxframework.com](https://vxframework.com/).

Same model, more field types and modules.

[https://www.youtube.com/watch?v=z7I0jxV4Dn0&rel=0](https://www.youtube.com/watch?v=z7I0jxV4Dn0&rel=0)

* **Fields** - Markdown, Files, Clone, Post Relation, User Relation, Recurring Date, Field Table, Content Sections, Location, Area
* **Option Pages** - site-wide settings screens built from fieldsets
* **Dictionaries** - shared choice lists, plus built-in lists of countries, currencies and units
* **REST API** - typed, access-controlled field values for apps and headless front ends
* **Shader** - a local development tool for building WordPress themes with AI and one-click deploy.
* **Premium support** - direct support from the VX team

Get VX Framework Pro at [vxframework.com](https://vxframework.com/pro/).

= Tools =

System information, Meta Watch, field key conflict detection, and
import/export.

= Documentation =

The user guide and the developer documentation ship inside the plugin
and are read from the dashboard. They cover what is in this package,
and they match the version installed on the site, with no connection
required. The same documentation is also online at
[docs.vxframework.com](https://docs.vxframework.com/).

== Installation ==

1. Install through Plugins → Add New, or upload the folder to
   `/wp-content/plugins/vx-framework`.
2. Activate the plugin through the Plugins screen.
3. Open **VX** in the admin menu and create your first fieldset.

== Frequently Asked Questions ==

= Does it work with the block editor? =

Yes. Field values are available as dynamic data inside the block
editor. You can bind them to blocks, loop them, and drive visibility
from the same model.

= Can an AI assistant work with my model? =

Yes. VX registers its operations as WordPress abilities and can serve
them over MCP. The endpoint stays off until you enable it.

= Can I define the model in code? =

Yes. Register fieldsets, post types, and taxonomies in PHP or JSON
in your theme or plugin. The dashboard stays usable for everything
that is not in code.

= Does it work with page builders? =

Yes. With Bricks, Breakdance, or Oxygen 6+, VX fields appear in the
builder's dynamic data picker.

== Screenshots ==

1. The fieldset editor, with an agent adding fields over MCP.
2. The field type picker.
3. VX in the block editor: bindings, VX Script and visibility.
4. A post's fields beside the canvas.
5. Creating a post type.
6. Creating a taxonomy.
7. Binding a block to a field with the dynamic tag picker.
8. The VX Script editor, with a live preview.
9. Visibility rules, grouped with and/or.
10. The same model as PHP, or as JSON in your repo.
11. Abilities over MCP, WP-CLI, the PHP API and hooks.

== External services ==

This plugin does not connect to any external service.

== Source code ==

The admin interface is a compiled Vue application. Its complete, unminified
source ships in this package in `client/src`, with the `package.json`,
`package-lock.json` and `vite.config.js` that build it. Running

    cd client && npm install && npm run build

rebuilds `client/dist` from those sources, with the configuration exactly as it
ships. Nothing in the package is obfuscated.

The PHP libraries in `app/vendor` ship as readable source under their own
licences, each named with its version and its licence file in
`LICENSE-THIRD-PARTY.txt`.

== Changelog ==

= 1.4.0 =
* New: A config file for a post type or taxonomy that another plugin registers, such as WooCommerce's products, can say `"register": false`. VX then applies your settings and leaves registering it to that plugin. Save to project and Sync write the line for you.
* New: Config files are now named `<key>.json.php`, which holds the same JSON after one line of PHP, so a web server that ignores `.htaccess` no longer sends the file to anyone who asks for its address. Every `.json` file keeps working.
* Improved: Sites that keep their config in files are faster on every page.
* Improved: Sites with many fields are faster on every page.
* Improved: AI assistants read config status and system status much faster, and fewer database queries run on sites whose config is in files.
* Fixed: Importing over a post type or taxonomy that VX created from a config file no longer stops VX from registering it.
* Changed: A post type or taxonomy another plugin registers, managed in the dashboard and also saved to a file by an earlier version, shows as out of sync. Sync adds the line. Until then VX keeps its database copy, and refuses Reset and Read only for it.
* Developers: An ability registered by a plugin or theme can write to VX's activity log with `vxframework/abilities/record_change`, name the ability that reverses it with `vxframework/abilities/undo_abilities`, and take a `batch_id` so its change is grouped and undone with the rest of a batch. The same plugin can publish its own MCP prompts and resources through `vxframework/mcp/prompts` and `vxframework/mcp/resources`, shown while the abilities they belong to are exposed.
* Developers: `wp vx-framework config convert` renames a folder's config files to `.json.php` or back, and the `vxframework/config/write_json_php` filter keeps a folder on `.json`. A bundle saved by `wp vx-framework config export --all` gets a name nobody can guess. `post_type()` and `taxonomy()` registrations take `[ 'register' => false ]`, and blueprints `register( false )`. `get-config-status` leaves out its folder and file sections with `include_paths: false`. From `init` on, `vxframework/fieldsets/field_types` runs only when its callbacks change. `wp vx-framework config status --strict` fails for a type that still needs the line.

Earlier releases: [changelog.txt](https://plugins.trac.wordpress.org/browser/vx-framework/trunk/changelog.txt) and [vxframework.com/changelog](https://vxframework.com/changelog/).

== Upgrade Notice ==

= 1.4.0 =
Config files VX saves can no longer be downloaded by address, pages are faster on sites that keep their config in files, and a config file can now leave a post type to the plugin that registers it.