acf-block-development

Create reusable ACF blocks for the Soma PageBuilder architecture.

Updated Dec 6, 2025
One-click install
npx skills add https://github.com/sanruiz/fibra --skill acf-block-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acf-block-development
Source: https://github.com/sanruiz/fibra/tree/main/.github/skills/acf-block-development
Command: npx skills add https://github.com/sanruiz/fibra --skill acf-block-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides the creation and integration of ACF flexible content blocks (partials) within the Soma PageBuilder system to enable consistent layouts and reusable components across pages and themes.

Core Features & Use Cases

  • Define ACF field groups (including JSON definitions) for new blocks
  • Register blocks in BlockRegistry and render via BlockRenderer and partial templates
  • Create reusable, responsive page sections with PHP partials, SCSS, and optional JavaScript

Quick Start

Create a new ACF block by defining a field group for the block and registering it in BlockRegistry.

Frequently Asked Questions about acf-block-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create reusable ACF blocks for a WordPress page builder?

To create reusable ACF blocks for a WordPress page builder, you define ACF field groups, register the blocks in BlockRegistry, and render them via PHP partial templates. This process ensures consistent layouts and reusable components across themes.

What's the best way to structure PHP partials for ACF flexible content sections?

The best way to structure PHP partials for ACF flexible content is placing them under a partials/ directory alongside corresponding SCSS and JS assets. This organizes block rendering, styling, and interactivity for headers, footers, and content sections.

Can I use JSON definitions for ACF repeater and media fields in block development?

Yes, you can use optional JSON field definitions for ACF repeaters and media fields during block development. Defining these field groups in JSON allows reusable configurations when registering flexible content blocks in the BlockRegistry.

Do I need to register every custom block in BlockRegistry to render it?

Yes, you need to register every custom block in BlockRegistry to render it properly. The system enforces integration with BlockRegistry.php to map ACF field groups to their corresponding BlockRenderer and partial templates for seamless page builder functionality.

How do ACF flexible content blocks integrate with frontend SCSS and JavaScript assets?

ACF flexible content blocks integrate with frontend assets by linking SCSS and JavaScript files to their respective PHP partials. This architecture ensures each reusable page section maintains responsive styling and interactive functionality within the page builder.