Pro module16 abilities

Avada

These abilities register when Avada is detected on the site and a Pro licence is active. If either is missing the module stays absent rather than failing at call time.

At a glance

Avada registers 16 abilities: 11 that only read, 4 that write, and 1 marked destructive. That split is the practical answer to how much of this module can run unattended. Reads cost nothing and are safe to repeat, so discovery is the part to be generous with; the writes are where review belongs, and the destructive calls stop for an explicit confirmation every single time regardless of which profile is active.

What this module is for

Inspect and update Avada theme options, global colors, global typography, sliders and slides, while discovering hooks, portfolio items, and FAQs.

Before you rely on it: Theme-option and global-token edits should be compared across templates before publishing.

Typical workflows

Review theme options before a visual-system change
Update a slide and its parent slider settings together
Inventory global colors before consolidating a palette

The Avada integration page covers the same module from the workflow side, with the capability map and the questions worth asking before a first write.

Availability on your site

The Avada module needs three things at once: WPPilot Free as the MCP foundation, an active Pro licence, and the companion plugin detected on the site. Miss any one and the module does not register, which is deliberate: an ability that appears in the tool list but fails at call time is worse than an ability that was never offered. What the connected agent can actually call is then narrowed twice more: by the safety profile active on the site, and by the WordPress capabilities of the user behind the credential. A read that succeeds for an administrator can be absent entirely for an editor.

Every write these abilities perform is recorded in the change ledger, and destructive calls can be routed through the approval queue so a person signs off before anything is applied. A successful tool result means the operation returned, not that the front end, the cache, and every dependent template are correct: that still needs a look.

Reads

Available in every safety profile, including Read Only. Inspection costs nothing and is not rate limited.

Ability	What it does
`wppilot/avada-check-setup`Check Avada Setup	Reports the Avada theme environment status: theme active, version, minimum-satisfied flag, Fusion Builder companion-plugin state, Fusion Core companion-plugin state, current-user capability, `fusion_options` presence, and counts of portfolio + FAQ posts. Run this before any Avada-touching workflow to confirm the environment is ready and to detect the "theme installed but companion plugin missing" configuration.
`wppilot/avada-get-slide`Get Avada Fusion Slide	Read a single Fusion Slider slide (a `slide` post) with its full `_fusion` postmeta bag — heading + caption, media routing (image/youtube/vimeo/mp4), color overrides, per-slide link. Also returns the featured-image URL (background of the slide when `type=image`) and the slider(s) the slide is assigned to. Fields whose serialised value exceeds `max_field_bytes` are truncated and listed in `truncated_fields[]` (progressive disclosure). Set `max_field_bytes: 0` to opt out of truncation. Read-only; requires Fusion Core plugin active at min version.
`wppilot/avada-get-slider`Get Avada Fusion Slider	Read a single Fusion Slider (a `slide-page` term) with its full `_fusion` term_meta settings bag (dimensions, autoplay, animation, navigation, indicator) plus a compact list of the slides assigned to it (id, title, slug, status, modified). Use `slider` as the term slug returned by `avada-list-sliders`, or the numeric term id. Set `include_slides: false` to skip slide enumeration when only the settings are needed. Read-only; requires Fusion Core plugin active at min version.
`wppilot/avada-get-theme-options`Get Avada Theme Options	Snapshot of the `fusion_options` DB row grouped by tab (color, typography, layout, header, footer, extra). Large fields (custom CSS / custom JS) are byte-capped at `max_field_bytes` (default 20_000, opt-out with `0`) and flagged with `<field>_truncated: true`. Use `include: ["color","typography"]` to fetch a narrow subset when the caller only cares about a few tabs — progressive disclosure prevents dumping the whole option payload (~50 KB on a configured install).
`wppilot/avada-list-faqs`List Avada FAQs	Compact enumeration of `avada_faq` CPT posts. Returns rows with id, title, slug, status, modified. Paginated: default `limit=25`, hard cap 100. Use `status` to filter (default: any). This is inventory only — use `wppilot/read-post` or an execute-php recipe to fetch the full content of a specific FAQ.
`wppilot/avada-list-global-colors`List Avada Global Colors	Enumerate the AWB Global Colors palette. Each row: slug (`color1`..`colorN`), label, and current color value (typically an `rgba(...)` string). Read-only. Palette storage lives in `fusion_options.color_palette`; the ability reads through `AWB_Global_Colors::get_instance()->get_palette()` so any theme filter overlaying the base palette is honoured.
`wppilot/avada-list-global-typography`List Avada Global Typography	Enumerate the AWB Global Typography presets. Each row: slug (`typography1`..`typographyN`), label, family, size, weight, lineHeight, letterSpacing, textTransform. Read-only. Preset storage lives in `fusion_options.typography_sets`; the ability reads through `AWB_Global_Typography::get_instance()->get_typography()` so any theme filter overlaying the defaults is honoured.
`wppilot/avada-list-hooks`List Avada Hooks	Curated catalogue of the ~20 most commonly used `fusion_` and `avada_` filter hooks the Avada theme exposes for customisation. Each entry reports the hook name, its category (dynamic-css, options-injection, layout, search, related-posts, other), a short description, and the number of parameters the callback receives. This is a static catalogue kept in sync with the theme source — NOT an exhaustive enumeration of every hook.
`wppilot/avada-list-portfolio-items`List Avada Portfolio Items	Compact enumeration of `avada_portfolio` CPT posts. Returns rows with id, title, slug, status, modified, and the first assigned `portfolio_category` term. Paginated: default `limit=25`, hard cap 100. Use `status` to filter (default: any). This is inventory only — use `wppilot/read-post` or an execute-php recipe to fetch the full block/shortcode content of a specific item.
`wppilot/avada-list-sliders`List Avada Fusion Sliders	Enumerates every Fusion Slider registered on this site. In Avada, a "slider" is a term of the `slide-page` taxonomy — this ability returns the slug + display name + numeric term id + slide count for each. Use before `avada-get-slider` (to know the slug) and before writing to `avada-edit-slider-settings`. Read-only; requires Fusion Core plugin active at min version.
`wppilot/avada-list-slides`List Avada Fusion Slides	Paginated enumeration of Fusion Slider slides (posts of type `slide`). Returns compact rows: id, title, slug, status, modified, and (for classification convenience) the parent slider slug/name if the slide belongs to exactly one slider. Filter by `slider` (slug or term id) to scope the listing to one slider; omit to list every slide on the site. `limit` is clamped to a hard maximum of 100 to keep responses agent-friendly (progressive disclosure — page through with `offset`). Read-only; requires Fusion Core plugin active at min version.

Writes

Gated by the active profile and your WordPress capabilities. Rate limited to 120 per minute per credential.

Ability	What it does
`wppilot/avada-edit-global-color`Edit Avada Global Color	Update a single AWB Global Color preset by slug (`color1`..`colorN`). At least one of `label` / `color` must accompany `slug`. `color` accepts any CSS color string the theme will echo verbatim (typical: `rgba(r,g,b,a)` or `#rrggbb`). Read-modify-write on `fusion_options.color_palette`: only the target slug is mutated, siblings preserved. `changed: false` on an idempotent no-op (same value stored). Post-write flushes `fusion_dynamic_css` + fires `fusion_cache_clear` so the front end serves fresh CSS.
`wppilot/avada-edit-global-typography`Edit Avada Global Typography	Update a single AWB Global Typography preset by slug (`typography1`..`typographyN`). At least one field must accompany `slug`. Read-modify-write on `fusion_options.typography_sets` — only the target preset is mutated. `changed: false` on an idempotent no-op. Post-write flushes Fusion cache. Values shape maps to Avada storage keys: `family`→`font-family`, `size`→`font-size`, `weight`→`font-weight`, `lineHeight`→`line-height`, `letterSpacing`→`letter-spacing`, `textTransform`→`text-transform`.
`wppilot/avada-edit-slide`Edit Avada Fusion Slide	Partial-merge update on a Fusion Slider slide (`slide` post). Only the keys passed in `values` are written; siblings are preserved. Keys are validated against the writable-slide-keys whitelist (`avada_writable_slide_keys()`) — unknown keys reject the ENTIRE batch (all-or-nothing, no partial writes). Each value is sanitized against its declared type (string/url/color/bool/int/enum) before persistence — a value that cannot be normalised safely also rejects the entire batch. Post-write flushes the `avada` wp_cache group + fires `fusion_cache_clear`. Idempotent: same values → `changed: false`. Requires Fusion Core plugin active at min version.
`wppilot/avada-edit-slider-settings`Edit Avada Fusion Slider Settings	Partial-merge update on a Fusion Slider `_fusion` term_meta bag — the dimensions, animation, autoplay, and navigation settings the slider ships with. Only the keys passed in `values` are written; siblings are preserved. Keys are validated against `avada_writable_slider_setting_keys()` — unknown keys reject the ENTIRE batch. Each value is sanitized against its declared type before persistence. The read-modify-write cycle is serialized against concurrent editors of the same slider (TOCTOU lock — two callers editing different subkeys of the same term will not clobber each other). Post-write flushes the `avada` wp_cache group + fires `fusion_cache_clear`. Requires Fusion Core plugin active at min version.

Destructive

Marked destructive in the source, so each call needs an explicit confirmation flag, every time.

Ability What it does

wppilot/avada-set-theme-optionsSet Avada Theme Options Whitelist-only write to fusion_options. Accepts a settings map of key → value; every key must be on the curated allowlist (~20 safe scalars — colors, layout, header/footer toggles, extras) AND must NOT be on the reserved list (raw custom_css / custom_js / license fields). Response reports written[] (keys whose stored value actually changed) and unchanged[] (submitted keys already at target — idempotent no-op). Cache flush after every write. The whole batch runs inside a fusion_options row lock so it never interleaves with a concurrent edit-global-color / edit-global-typography / set-theme-options call on the same row.

Ability	What it does
`wppilot/avada-set-theme-options`Set Avada Theme Options	Whitelist-only write to `fusion_options`. Accepts a `settings` map of key → value; every key must be on the curated allowlist (~20 safe scalars — colors, layout, header/footer toggles, extras) AND must NOT be on the reserved list (raw `custom_css` / `custom_js` / license fields). Response reports `written[]` (keys whose stored value actually changed) and `unchanged[]` (submitted keys already at target — idempotent no-op). Cache flush after every write. The whole batch runs inside a `fusion_options` row lock so it never interleaves with a concurrent edit-global-color / edit-global-typography / set-theme-options call on the same row.

PreviousAstra NextBeaver Builder