百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

sage-acf-wp-blocks

> 编程语言
开源

用于从模板生成 ACF Gutenberg 块的 Composer 库。适用于 Roots/Sage (http://roots.io)

352 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

用于从模板生成 ACF Gutenberg 块的 Composer 库。适用于 Roots/Sage (http://roots.io)

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:

bash
composer require "mwdelaney/sage-acf-gutenberg-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:

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

Example block template

blade
{{--
  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
--}}

    
{{ get_field('testimonial') }}

    
      {{ get_field('author') }}
    

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. 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)
SupportsInnerBlocks This property allows the block to support the nesting of other blocks within it. true or false optional (defaults to false)
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 or false optional (defaults to false)

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:

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

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.

php
add_filter('sage-acf-gutenberg-blocks-templates', function ($folders) { 
    $folders[] = 'views/your-folder'; // Adds your folder
    return $folders;
});

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

PHPadvanced-custom-fieldsgutenbergrootssage-theme

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言