diff --git a/AGENTS.md b/AGENTS.md index 66bcfda..574dc5b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,9 +8,7 @@ agents (Claude, Cursor, Windsurf) point here. Read it before making changes. An agentic WordPress starter: Bootstrap 5 + Gutenberg + an auto-registering ACF block factory. Content is driven by ACF blocks and native Gutenberg patterns — not page templates. -**Hard dependency:** ACF Pro 6.0+. No fallback. `inc/dependencies.php` is the single source of -truth (`brmbh_has_acf_pro()`); it surfaces admin notices and aborts `wp brmbh` commands when -ACF Pro is missing. +**Hard dependency:** SCF 6.0+ (Secure Custom Fields — free, wordpress.org/plugins/secure-custom-fields). ACF Pro also works — both define `ACF_PRO=true`. No fallback. `inc/dependencies.php` is the single source of truth (`brmbh_has_acf_pro()`); it surfaces admin notices and aborts `wp brmbh` commands when SCF is missing. ## Skills — everything an agent can do here diff --git a/README.md b/README.md index 384efe2..27e15ad 100644 --- a/README.md +++ b/README.md @@ -48,12 +48,12 @@ Pro, vanilla WordPress, and a set of conventions that automate the repetitive pa | Deploy + DB-sync tooling included | ✅ | — | — | — | | Templating | vanilla PHP | vanilla PHP | vanilla PHP | Blade | | Build toolchain | npm + Webpack + Sass | none | Gulp/npm | Bud + Composer | -| Requires ACF Pro | **yes** | no | no | no | +| Requires SCF | **yes (free)** | no | no | no | **Use it when** you build content-driven WordPress sites with ACF blocks and want a coding agent to do the repetitive block/scaffold/deploy work against a Bootstrap design system. **Skip it when** you want a block-theme/FSE (`theme.json`-only) setup, a Tailwind/Blade stack, -or a theme with no ACF Pro dependency. +or a theme with no ACF dependency. --- @@ -127,7 +127,7 @@ cd wp-content/themes/brmbh-agentic-wp-suite npm install npm run build # or: npm run watch (live rebuild) -# 3. Activate the theme in wp-admin (ACF Pro must be active). +# 3. Activate the theme in wp-admin (SCF must be active). # It scaffolds starter pages + menus once on activation. # 4. Re-run the scaffold any time — it's idempotent @@ -175,7 +175,7 @@ codebase. ## Tech stack -WordPress 6.4+ · PHP 8.0+ · ACF Pro 6.0+ · Bootstrap 5.3 · GSAP · Webpack · Dart Sass · +WordPress 6.4+ · PHP 8.0+ · SCF 6.0+ (free) · Bootstrap 5.3 · GSAP · Webpack · Dart Sass · Node 18+ · WP-CLI (`wp brmbh` namespace) · Inter / InterDisplay variable fonts · GPL-2.0-or-later. diff --git a/inc/dependencies.php b/inc/dependencies.php index 6778cdb..d92b5cf 100644 --- a/inc/dependencies.php +++ b/inc/dependencies.php @@ -1,11 +1,14 @@ brmbh-agentic-wp-suite requires Advanced Custom Fields PRO %s or higher. ACF Pro is not installed or not active. Get it at advancedcustomfields.com/pro.', 'brmbh-agentic-wp-suite' ), + /* translators: %s: required SCF version */ + __( 'brmbh-agentic-wp-suite requires Secure Custom Fields (SCF) %s or higher. SCF is not installed or not active. Install it free at wordpress.org/plugins/secure-custom-fields. ACF Pro also works.', 'brmbh-agentic-wp-suite' ), BRMBH_REQUIRED_ACF_VERSION ); } if ( function_exists( 'acf_get_setting' ) ) { $version = acf_get_setting( 'version' ); return sprintf( - /* translators: 1: installed ACF version, 2: required ACF Pro version */ - __( 'brmbh-agentic-wp-suite requires Advanced Custom Fields PRO %2$s or higher. Installed version: %1$s. Please update ACF Pro.', 'brmbh-agentic-wp-suite' ), + /* translators: 1: installed SCF/ACF version, 2: required version */ + __( 'brmbh-agentic-wp-suite requires Secure Custom Fields (SCF) %2$s or higher. Installed version: %1$s. Please update SCF.', 'brmbh-agentic-wp-suite' ), esc_html( $version ), BRMBH_REQUIRED_ACF_VERSION ); } - return __( 'brmbh-agentic-wp-suite requires Advanced Custom Fields PRO. ACF Pro is installed but not loaded — check the plugin is active.', 'brmbh-agentic-wp-suite' ); + return __( 'brmbh-agentic-wp-suite requires Secure Custom Fields (SCF). SCF is installed but not loaded — check the plugin is active.', 'brmbh-agentic-wp-suite' ); } /** @@ -100,7 +104,7 @@ function brmbh_acf_dependency_post_activate_notice(): void { } delete_transient( 'brmbh_acf_missing_on_activate' ); echo '
'; - echo '

⚠️ ' . esc_html__( 'Theme activated, but ACF Pro is missing.', 'brmbh-agentic-wp-suite' ) . '

'; + echo '

⚠️ ' . esc_html__( 'Theme activated, but Secure Custom Fields (SCF) is missing.', 'brmbh-agentic-wp-suite' ) . '

'; echo '

' . wp_kses_post( brmbh_acf_dependency_message() ) . '

'; echo '
'; } @@ -109,7 +113,7 @@ function brmbh_acf_dependency_post_activate_notice(): void { /** * Surface 3 — Hard error in WP-CLI. * - * Any `wp brmbh` subcommand aborts with a clear message if ACF Pro is missing. + * Any `wp brmbh` subcommand aborts with a clear message if SCF/ACF is missing. * Called by inc/cli.php at the top of each subcommand. */ function brmbh_acf_dependency_cli_guard(): void {