PHPackages                             ravorona/sage-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. ravorona/sage-acf-gutenberg-blocks

AbandonedArchivedLibrary

ravorona/sage-acf-gutenberg-blocks
==================================

Create Gutenberg blocks from Sage blade templates and ACF fields. Fork of https://github.com/MWDelaney/sage-acf-wp-blocks

0.1.0(5y ago)01.3kMITPHPPHP >=5.3.2

Since Aug 25Pushed 3mo agoCompare

[ Source](https://github.com/ravorona/sage-acf-wp-blocks)[ Packagist](https://packagist.org/packages/ravorona/sage-acf-gutenberg-blocks)[ Docs](https://github.com/ravorona/sage-acf-gutenberg-blocks)[ RSS](/packages/ravorona-sage-acf-gutenberg-blocks/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

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](https://medium.com/nicooprat/acf-blocks-avec-gutenberg-et-sage-d8c20dab6270) by [nicoprat](https://github.com/nicooprat).

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

[](#installation)

Run the following in your Sage (v9 or 10) based theme directory:

```
composer require "ravorona/sage-acf-gutenberg-blocks"
```

Creating blocks
---------------

[](#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:

```
{{--
  Title:
  Description:
  Category:
  Icon:
  Keywords:
  Mode:
  Align:
  PostTypes:
  SupportsAlign:
  SupportsMode:
  SupportsMultiple:
  EnqueueStyle:
  EnqueueScript:
  EnqueueAssets:
  Preview:
  PreviewImage:
--}}
```

### Example block template

[](#example-block-template)

```
{{--
  Title: Testimonial
  Description: Customer testimonial
  Category: formatting
  Icon: admin-comments
  Keywords: testimonial quote
  Mode: edit
  Align: left
  PostTypes: page post
  SupportsAlign: left right
  SupportsMode: false
  SupportsMultiple: false
  EnqueueStyle: styles/style.css
  EnqueueScript: scripts/script.js
  EnqueueAssets: path/to/asset
  Preview: true
  PreviewImage: path/to/my/block/preview.jpg
--}}

    {{ get_field('testimonial') }}

      {{ get_field('author') }}

  [data-{{$block['id']}}] {
    background: {{ get_field('background_color') }};
    color: {{ get_field('text_color') }};
  }

```

Data Options
------------

[](#data-options)

The options in the file header map to options in the [`acf_register_block_type` function](https://www.advancedcustomfields.com/resources/acf_register_block_type/).

FieldDescriptionValuesNotes`Title`Title of the block in the gutenberg editori.e. `Testimonial`*required*`Description`Description of the block in the gutenberg editori.e. `My testimonial block`*optional*`Category`Category to store the block in. Use these values or [register your own custom block categories](https://wordpress.org/gutenberg/handbook/extensibility/extending-blocks/#managing-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](https://developer.wordpress.org/resource/dashicons/)i.e. `book-alt`*optional*`Keywords`An array of search terms to help user discover the block while searching. Sepearate 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. Sepearate 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`)`Preview`Enable block sample preview`true` or `false`*optional*`PreviewImage`Path to block sample preview image. Relative to theme directory`path/to/block/sample/image.jpg`*optional*Creating ACF fields
-------------------

[](#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](https://github.com/MWDelaney/sage-advanced-custom-fields) to keep your ACF fields in version control with Sage.

Filter block data
-----------------

[](#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:

```
add_filter('sage/blocks/my-block/data', function ($block) { // Do your thing here. });
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance53

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 56.7% of commits — single point of failure

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

Unknown

Total

1

Last Release

2086d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/730151?v=4)[яαvoroηα](/maintainers/ravorona)[@ravorona](https://github.com/ravorona)

---

Top Contributors

[![MWDelaney](https://avatars.githubusercontent.com/u/2457670?v=4)](https://github.com/MWDelaney "MWDelaney (34 commits)")[![robmeijerink](https://avatars.githubusercontent.com/u/14540290?v=4)](https://github.com/robmeijerink "robmeijerink (7 commits)")[![xaqrox](https://avatars.githubusercontent.com/u/394919?v=4)](https://github.com/xaqrox "xaqrox (5 commits)")[![ravorona](https://avatars.githubusercontent.com/u/730151?v=4)](https://github.com/ravorona "ravorona (5 commits)")[![palmiak](https://avatars.githubusercontent.com/u/2342458?v=4)](https://github.com/palmiak "palmiak (2 commits)")[![bebjakub](https://avatars.githubusercontent.com/u/10927960?v=4)](https://github.com/bebjakub "bebjakub (2 commits)")[![tombroucke](https://avatars.githubusercontent.com/u/24292260?v=4)](https://github.com/tombroucke "tombroucke (2 commits)")[![cfaria](https://avatars.githubusercontent.com/u/756658?v=4)](https://github.com/cfaria "cfaria (1 commits)")[![robyurkowski](https://avatars.githubusercontent.com/u/230379?v=4)](https://github.com/robyurkowski "robyurkowski (1 commits)")[![lachieh](https://avatars.githubusercontent.com/u/1687902?v=4)](https://github.com/lachieh "lachieh (1 commits)")

---

Tags

wordpressadvanced custom fieldsgutenberg

### Embed Badge

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

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

###  Alternatives

[mwdelaney/sage-acf-gutenberg-blocks

Create Gutenberg blocks from Sage blade templates and ACF fields.

354359.9k1](/packages/mwdelaney-sage-acf-gutenberg-blocks)[palmiak/timber-acf-wp-blocks

Create Gutenberg blocks from Twig templates and ACF fields.

24872.5k1](/packages/palmiak-timber-acf-wp-blocks)

PHPackages © 2026

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