Configuration

Configuration

Every option resolves with this precedence (highest wins):

1. wp-config.php constant — BEXT_WP_* (locked config, power users)
2. Settings page — Bext → Settings (stored in the bext_wp_settings option)
3. Built-in default

Relevant filters apply on top where documented.

On Multisite, network-level settings slot in between: constant > network (enforced) > site > network (default) > built-in default. See Multisite.

Settings page (Bext → Settings)

Requires the manage_options capability.

Connection

Field	Meaning
Mode	Auto (bext on this server, loopback), Cloud (remote bext endpoint), or Off.
Cloud endpoint URL	Cloud mode only — the bext origin serving this site.
Cloud API token	Cloud mode only — sent as Authorization: Bearer ….
App ID	X-Bext-App-Id for the SDK bridge. Defaults to the site host.

Features

Field	Default	Meaning
Edge cache	on	Cooperate with the bext cache (purge-on-change + safe headers).
Purge on save	on	Auto-purge changed URLs when content is edited.
Anonymous Cache-Control	—	Optional header for anonymous pages. Blank = defer to the vhost.
Action Scheduler taming	on	Disable the admin-ajax async runner; defer to system cron.
Health diagnostics	on	Run the dashboard config checks.
Capture PHP warnings	off	Record recent warnings (dev/debug).

SDK bridge

Field	Default	Meaning
Email via bext	off	Route wp_mail() through bext managed email (needs per-app SMTP config).
Jobs via bext	off	Enable bext/enqueue background jobs onto a bext queue.

A Test connection button issues GET <endpoint>/__bext/health with the saved settings and reports the result.

Constants (wp-config.php)

define( 'BEXT_WP_ENABLE', true );              // master switch (default true)
define( 'BEXT_WP_MODE', 'cloud' );             // auto | cloud | off
define( 'BEXT_WP_CLOUD_URL', 'https://…' );    // cloud endpoint
define( 'BEXT_WP_CLOUD_TOKEN', '…' );          // cloud bearer token
define( 'BEXT_WP_APP_ID', 'my-site' );         // X-Bext-App-Id
define( 'BEXT_WP_ASSUME_BEHIND_BEXT', true );  // force-on detection (auto mode)
define( 'BEXT_WP_SDK_EMAIL', true );           // wp_mail via bext
define( 'BEXT_WP_SDK_JOBS', true );            // bext/enqueue
define( 'BEXT_WP_CAPTURE_WARNINGS', true );    // record PHP warnings
define( 'BEXT_WP_DISABLE_CACHE', true );       // hard-disable a module (CACHE|CRON|HEALTH|SDK)

When a constant is set, the matching field on the Settings page shows an "overridden by constant" notice.

Removal

See Installation → Uninstalling.