PHPackages                             beblife/acf-gutenberg-blocks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. beblife/acf-gutenberg-blocks

Abandoned → [starring-jane/acf-gutenberg-blocks](/?search=starring-jane%2Facf-gutenberg-blocks)ArchivedLibrary[Utility & Helpers](/categories/utility)

beblife/acf-gutenberg-blocks
============================

An elegant way for developers to register Gutenberg blocks using the ACF PRO blocks feature

v0.4.2(5y ago)02MITPHPPHP >7.0

Since Aug 27Pushed 5y ago1 watchersCompare

[ Source](https://github.com/beblife/acf-gutenberg-blocks)[ Packagist](https://packagist.org/packages/beblife/acf-gutenberg-blocks)[ RSS](/packages/beblife-acf-gutenberg-blocks/feed)WikiDiscussions master Synced today

READMEChangelog (6)Dependencies (1)Versions (7)Used By (0)

ACF Gutenberg blocks
====================

[](#acf-gutenberg-blocks)

An elegant way for developers to register Gutenberg blocks using the Advanced Custom Fields PRO features.

- [Installation](#installation)
- [Define blocks](#define-blocks)
- [Register blocks](#register-blocks)
- [Configure fields](#configure-fields)
- [Retrieve data](#retrieve-data)
- [Define classes](#define-classes)
- [Render blocks](#render-blocks)

Installation
------------

[](#installation)

You can install this package through composer:

```
composer require beblife/acf-gutenberg-blocks
```

Define blocks
-------------

[](#define-blocks)

You can define custom blocks by creating classes that extend the base block class provided by this package.

By extending from the base block enables you to easily define custom blocks with a minimum of configuration:

```
use GutenbergBlocks\Block;

class MyCustomBlock extends Block
{
    protected $name = "custom";

    protected $title = "My Custom block";

    protected $description = "This is a custom block!";

    public function render()
    {
        // Render the HTML
    }
}
```

The base block class configures a few things by default behind the scence for convenience but can be changed easily. The following properties are defined out of the box:

```
protected $name;

protected $title;

protected $description;

protected $keywords = [];

protected $category;

protected $icon;

protected $mode = 'preview';

protected $default_align = '';

protected $align = ['wide', 'full'];

protected $allow_mode_switch = true;

protected $allow_multiple = true;

protected $parent = [];
```

Register blocks
---------------

[](#register-blocks)

To enable the custom blocks you need to register them by hooking into the `acf/init` filter. This allows for a flexible way to define which blocks should be enabled.

You can enable blocks by passing an array with classes:

```
add_filter('acf/init', function () {
    \GutenbergBlocks\Gutenberg::register([
        MyCustomBlock::class,
    ]);
});
```

To automatically register all blocks in a directory can provide the relative path in the current theme:

```
add_filter('acf/init', function () {
    // Registers all blocks in `wp-content/themes/{current_theme}/blocks`
    \GutenbergBlocks\Gutenberg::register('blocks');
});
```

### Defining a parent block

[](#defining-a-parent-block)

You can define a block to have a parent block by updating the `$parent` property on your block class. This will result in the block being hidden from the blocks list in Gutenberg but only available as a "sub block" for the parent block.

```
class ChildBlock extends Block
{
    // ...

    protected $parent = [
        ParentBlock::class,
    ];
}
```

> For the child block to be selectable within the parent block you will need to set `$inner_blocks = true` on the parent block.

Configure fields
----------------

[](#configure-fields)

Fields can be added to a custom block by defining a `fields()` method on the class and make it return an array of fields to add.

This package includes [wordplate/extended-acf](https://github.com/wordplate/extended-acf) to define fields for a block in an easy and elegant way. Make sure to read the documentation to see which field types are available.

Below you can find an example of how you can define fields using this package:

```
public function fields()
{
    return [
        Text::make('Title')
            ->required(),

        Text::make('Body'),

        Url::make('Link', 'url')
            ->required()
            ->instructions('The url that should be displayed.'),
    ];
}
```

Retrieve data
-------------

[](#retrieve-data)

To retrieve the data from the defined fields you have a few options.

```
// Retrieve all fields as an array
$data = $this->data();

// Retrieve only the title
$title = $this->get('title');

// Retrieve the body and provide a default value as fallback
$body = $this->get('body', 'Hello world!');

// ...
```

Define classes
--------------

[](#define-classes)

By default a few classes are added to the wrapper HTML-element to be able to add general styles and specific styles for blocks and respect the alignment and other input from the Gutenberg editor.

You can override or extend the classes that are added by defining your own `classes` method:

```
// Override the default classes
protected function classes($block)
{
    return [
        'my-custom-css-class'
        //...
    ];
}

// Extend the default classes
protected function classes($block)
{
    return array_merge(parent::classes($block), [
        'my-custom-css-class',
    ]);
}
```

> Please note that when overriding the default classes some Gutenberg behaviour will no longer work and will have to be added from the `$block` parameter to prevent this from happening!

Render blocks
-------------

[](#render-blocks)

All blocks require a `render()` method to be implemented. The way you render a block is up to you, an example with Wordpress' `get_template_part()` is given below:

```
public function render()
{
    // Make the data available in our template
    set_query_var('data', $this->data());

    return get_template_part('path-to-my-block-template');
}
```

License
-------

[](#license)

[MIT](LICENSE) © [Laurens Bultynck](https://laurensbultynck.me/)

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

6

Last Release

2112d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f586584832cd3efc41160188f4c82f509a352f95d3c738a8087a2e96508a5eb4?d=identicon)[beblife](/maintainers/beblife)

### Embed Badge

![Health badge](/badges/beblife-acf-gutenberg-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/beblife-acf-gutenberg-blocks/health.svg)](https://phpackages.com/packages/beblife-acf-gutenberg-blocks)
```

###  Alternatives

[dompdf/php-font-lib

A library to read, parse, export and make subsets of different types of font files.

1.8k45.3M11](/packages/dompdf-php-font-lib)[consolidation/site-alias

Manage alias records for local and remote sites.

6152.1M28](/packages/consolidation-site-alias)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)