create-acf-block-json
v1.0.11
Published
Quickly create an a new WordPress Block that uses Advanced Custom Fields (ACF) and utilised block.json and block-specific CSS.
Downloads
24
Maintainers
Readme
Create ACF Block JSON
Quickly create a new WordPress Block that uses Advanced Custom Fields (ACF) and utilises block.json and block-specific CSS and PHP files.
If you use ACF and make Gutenberg blocks, this simple utility should save you time scaffolding custom blocks.
Quick Start
Install globally via npm:
npm install --global create-acf-block-json
then navigate to where you want your block to be (i.e. /theme/blocks/), and run:
$ create-acf-block-json
What does Create ACF Block JSON do
Create ACF Block JSON is an npm package command line program that will create a new folder in your current directory containing scaffolding for a new WordPress block using Advanced Custom Fields.
It will generate:
- Folder - containg folder for your block.
- block.json - prefilled with common block information and default values.
- PHP file - setup with basic information, classes and innerblocks.
- SCSS files - for the frontend and editor. SCSS is useful if you use a compiler to output CSS files.
- CSS file - for the frontend and editor. To write straight CSS or be overwritten by your processed SCSS.
The script handles generating a unique class (.wp-block-namespace-name) for your block which is then referenced in each file.
This script doesn't handle registration of the block - we recommend directory scanning methods to auto load blocks without registering each one. This method is outlined by Bill Erickson, but there are other examples online. But if you need an easier solution to register an ACF block, follow this guide. FYI, many guides are out of date, make sure you use guides released after 28th September 2022 (when ACF 6.0 was released) which will properly use block.json.
Customisation Options
When you run create-acf-block-json
you are asked a few questions before your block is created:
- Namespace: Specify a namespace for the block (defaults to
acf
) - Name: Give your block a name, i.e. "My Cool Block" (required)
- Description: Describe the functionality of your block so editors and users can find it easily (optional)
- Icon: The icon for your block - use any Dashicons name (defaults to icon
star-filled
). Note, when copying the name of the Dashicon you must remove the prefixdashicons-
, for example:dashicons-smiley
should be written assmiley
.
The script will then generate all required files. From there, you can edit, delete, remove the files as you wish.
Install Create ACF Block
- Using terminal or another CLI, download from npm and install as a global package -
npm install -g create-acf-block-json
- Using terminal or another CLI, navigate to your WordPress theme folder where you want all of your blocks (we use /wp-content/themes/my-theme/blocks/)
- Run
create-acf-block-json
and follow prompts.
Update Create ACF Block
To update to the latest version you can just run the install command again - npm install -g create-acf-block-json
Feedback and issues
Please open an issue in the GitHub repo. Thanks.