Wonderful Relations is a WordPress plugin that turns structured data into editable, queryable, exportable surfaces — DataTables, Forms, PDF documents, dashboards — without writing repetitive boilerplate. The plugin is bootstrapped from itself: every concept (Project, Entity, Query, DataTable, Form, Template) is stored in a structured way and is both consumable from the UI and reachable from PHP through stable APIs.

This documentation is written for two audiences:

  • Configurators who model their data inside an existing Wonderful Relations install — Projects, Entities, Queries, Forms, DataTables, PDF Templates, Templates, Services, Groups, Redirects, Locks.
  • Plugin developers who ship Wonderful Relations child plugins — custom action types, tasks, workers, dashboards or background syncers — and who need to extend the system through PHP, hooks and data bundles.

Where to start

You want to …Open
Understand the data modelProjects, Entities, Queries
Build editable formsForms, Linked Forms, Tasks
Render data in the frontendTemplates, DataTables, PDF Templates
Operate cache and runtime performanceCaching, Query Caching, Data Bundles
Lock the system downGroups, Locks, Redirects
Build a child pluginChild Plugins, System Functions, Worker
Ship configuration with your pluginData Bundles
Extend behaviour with hooksHooks Reference
Customize the rendered HTMLTemplate Renderer