Download the PHP package larodiel/sage-acf-gutenberg-blocks without Composer
On this page you can find all versions of the php package larodiel/sage-acf-gutenberg-blocks. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download larodiel/sage-acf-gutenberg-blocks
More information about larodiel/sage-acf-gutenberg-blocks
Files in larodiel/sage-acf-gutenberg-blocks
Package sage-acf-gutenberg-blocks
Short Description Fork of the original Sage ACF Gutenberg Blocks project. Create Gutenberg blocks from Sage blade templates and ACF fields.
License MIT
Homepage https://github.com/larodiel/sage-acf-wp-blocks
Informations about the package sage-acf-gutenberg-blocks
Sage ACF Gutenberg Blocks
Generate ACF Gutenberg blocks just by adding templates to your Sage theme.
This package is based heavily on this article by nicoprat.
Installation
Run the following in your Sage (v9 or 10) based theme directory:
Creating blocks
Add blade templates to views/blocks
which get and use ACF data. Each template requires a comment block with some data in it:
Example block template
Data Options
The options in the file header map to options in the acf_register_block_type
function.
Field | Description | Values | Notes |
---|---|---|---|
Title |
Title of the block in the gutenberg editor | i.e. Testimonial |
required |
Description |
Description of the block in the gutenberg editor | i.e. My testimonial block |
optional |
Category |
Category to store the block in. Use these values or register your own custom block categories | common , formatting , layout , widgets , embed |
required |
Icon |
An icon property can be specified to make it easier to identify a block. Uses dashicons | i.e. book-alt |
optional |
Keywords |
An array of search terms to help user discover the block while searching. Separate values with a space. | i.e. quote mention cite |
optional |
Mode |
The display mode for your block. auto: Preview is shown by default but changes to edit form when block is selected. preview: Preview is always shown. Edit form appears in sidebar when block is selected. edit: Edit form is always shown. | auto , preview or edit |
optional (defaults to preview ) |
Align |
The default block alignment. | left center right wide full |
optional (defaults to empty string) |
PostTypes |
An array of post types to restrict this block type to. Separate values with a space. | i.e. post page |
|
SupportsAlign |
This property adds block controls which allow the user to change the block’s alignment. Set to true to show all alignments, false to hide the alignment toolbar. Set to an array (strings separated by spaces) of specific alignment names to customize the toolbar. | (boolean) true , false or (array) left center right wide full |
optional (defaults to true) |
SupportsMode |
This property allows the user to toggle between edit and preview modes via a button. | true or false |
optional (defaults to true ) |
SupportsMultiple |
This property allows the block to be added multiple times. | true or false |
optional (defaults to true ) |
SupportsFullHeight |
This property allows enables the full height button on the toolbar of a block | true or false |
optional (defaults to false ) |
SupportsInnerBlocks |
This property allows the block to support the nesting of other blocks within it. | true or false |
optional (defaults to false ) This works just on preview mode |
SupportsAlignText |
This property adds an alignment toolbar button similar to that seen when editing a paragraph of text. | true or false |
optional (defaults to false ) |
SupportsAlignContent |
This property adds an alignment toolbar button similar to that seen when editing a core "Cover block" | true , false or matrix (Show full alignment matrix in toolbar) |
optional (defaults to false ) |
EnqueueStyle |
A CSS file to load when the block is used. | e.g. styles/my-block.css |
optional (defaults to empty string) |
EnqueueScript |
A JS file to load when the block is used. | e.g. scripts/my-block.js |
optional (defaults to empty string) |
Parent |
An array of block types to restrict where this block can be used. Separate values with a space. | e.g. core/column acf/parent-block |
optional (defaults to usable anywhere) |
Creating ACF fields
Once a block is created you'll be able to assign ACF fields to it using the standard Custom Fields interface in WordPress. We recommend using sage-advanced-custom-fields to keep your ACF fields in version control with Sage.
Filter block data
Block data can be altered via the 'sage/blocks/[block-name]/data' filter. For example, if your block template is called my-block.blade.php
, you can alter the data this way:
Filter template folders
By default all your template files in views/blocks
will be loaded. You can use the templates filter to add more folders if you wish. See an example below of how to add your own folders.
Creating your custom blocks categories
More details about the hook block_categories_all
on registering your own custom block categories