For the library to work and register blocks dynamically, a specific folder structure and naming must be followed.
Your folder structure should be like this:
Don't be confused with the upper and lower case folder names, those are like that on purpose. Everything under the
Block folder is considered a view so they are written in lower caps, and the Blocks.php file is still a part of the PHP PSR-4 standard so it must be written like every other service class.
This folder contains all the blocks defined in your project. Every block is located in the
custom folder, and every component is located in the
components folder. Blocks can be created from multiple block editor components or your project components.
This folder contains all the components that are shared across blocks and project template files. Components are not registered as blocks because they are small chunks of code you can reuse everywhere. For instance, you can create a menu component to be used in the footer but also reused in a separate menu block. Please refer to the component structure chapter for more details.
This folder contains all the custom blocks defined and used in your project. Please refer to the block structure chapter for more details.
This folder contains all the variations blocks defined and used in your project. Please refer to the variations chapter for more details.
This folder contains a wrapper component that wraps all blocks with shared variables and gives blocks the ability to behave as a layout section. Please refer to the wrapper chapter for more details.
This file contains global settings for your project. It must contain
background keys. Everything else is optional. Here you can store data you intend to share across toolbars, components, and blocks. Please refer to the block manifest chapter for more details.
This is the main service class responsible for registering all the PHP parts of the blocks like:
- dynamic blocks view;
- custom category for your blocks;
- default color pallet;
- what blocks you are going to use; and
- all the custom functionality that you will write for the project.