ACF (Advanced Custom Fields)
This curriculum teaches you how to design, build, and operate Advanced Custom Fields implementations that remain stable as your WordPress site and content team grow.
Who This Track Is For
- WordPress developers who build and maintain ACF Pro field schemas entirely in code.
- Engineers managing ACF Pro deployments via Git, WP-CLI, PHP exports, and CI/CD pipelines.
- Developers building ACF-powered Gutenberg blocks using
acf_register_block_type(). - Backend developers exposing ACF Pro data to headless frontends or REST consumers.
- Teams automating ACF schema migrations and quality gates in GitHub Actions or similar CI.
What You Will Master
- Model real business content using the right ACF field and relationship types.
- Render ACF data safely in templates, loops, and Gutenberg blocks.
- Customize ACF behavior with lifecycle hooks and value transformation filters.
- Build dynamic admin experiences with runtime field controls and validation guards.
- Expose ACF data to APIs securely while protecting sensitive fields.
- Deploy and maintain ACF schema changes with migration and rollback discipline.
- Build automated ACF tests and CI/CD quality gates that catch hook and schema regressions early.
How To Use This Track
- Complete modules in order; each module builds on the previous one.
- Build each hands-on exercise inside staging, not production.
- Keep your own project notes and field naming rules as you progress.
Learning Path
| Module | Focus | Lessons |
|---|---|---|
| Module 1: ACF Foundations and Setup | Get your environment and governance model right so fields stay predictable across teams. | 3 lessons |
| Module 2: Data Modeling with ACF | Translate content requirements into scalable field types and relational patterns. | 3 lessons |
| Module 3: Theme Integration and Rendering | Translate field values into resilient frontend output that survives missing or partial data. | 3 lessons |
| Module 4: ACF Blocks and Editor UX | Ship custom blocks that are flexible for editors and controlled for developers. | 3 lessons |
| Module 5: Operations and Delivery | Build repeatable deployment and maintenance workflows for long-term ACF projects. | 3 lessons |
| Module 6: ACF API and Hook Lifecycle | Map hook execution phases and use the right API for each data context. | 3 lessons |
| Module 7: Dynamic Admin UX and Validation Hooks | Build safer editor workflows with dynamic fields, validation, and save-time automation. | 3 lessons |
| Module 8: Headless and Enterprise ACF Patterns | Deliver secure REST payloads, performance optimizations, and migration playbooks at scale. | 3 lessons |
| Module 9: ACF Testing and CI/CD Quality Gates | Turn hooks, schema changes, and releases into enforceable automated quality gates. | 3 lessons |
| Module 10: ACF Options API | Build global ACF Pro configuration pages and option workflows through code and CLI. | 3 lessons |
| Module 11: ACF + Composer and Version-Locked Installs | Deploy ACF Pro through Composer with secure auth, lockfiles, and CI checks. | 3 lessons |
Common Architectures / Patterns / Workflows
Quick Start
first-acf-pro-cli-run.sh
# 1) Verify ACF Pro is active
wp plugin list --status=active | grep advanced-custom-fields
# 2) List all registered field groups
wp eval 'print_r(array_column(acf_get_field_groups(), "title"));'
# 3) Inspect field group saved as Local JSON
ls wp-content/themes/your-theme/acf-json/
# 4) Export-ready schema inspection via runtime API
wp eval 'echo count(acf_get_field_groups()) . PHP_EOL;'
# 5) Register a field group via code
# See Module 5, Lesson 2 for full acf_add_local_field_group() pattern
Prerequisites
- Working WordPress local or staging environment.
- Basic PHP template editing knowledge.
- Access to theme/plugin repository for version control.
- Ability to run content QA before production release.
Success Criteria
By the end of this track, you can:
- Design ACF schemas that match real editorial and business workflows.
- Build template and block rendering logic with safe fallbacks and escaping.
- Implement advanced ACF hooks for lifecycle control, dynamic UI, and validation.
- Expose ACF data to headless consumers with secure and versioned contracts.
- Optimize field-heavy templates with practical caching and query controls.
- Execute schema migrations with verification and rollback confidence.
- Run CI/CD quality gates that validate ACF schema integrity, hook behavior, and smoke checks.
- Operate ACF Pro options and Composer-based installs with deterministic, audited release workflows.
Next Step
Start with Module 1 Lesson 1: What ACF Is and When to Use It.