2crt/block-sections

v1.0.8 2024-09-24 06:57 UTC

This package is auto-updated.

Last update: 2024-09-24 06:57:49 UTC


README

本软件包提供了一种结构化的基础和工具集,用于高效创建协同工作的分层 ACF 块,这些块可以无缝地构建符合特定设计的部分。

何时使用本软件包

  1. 当你的前端需要传递“像素级”视觉质量保证,并满足强迫症设计师的挑剔眼光时。
  2. 为了实现基于 Gutenberg 的内容管理,并具有真正的 WYSIWYG 功能,同时保持对 HTML 的精确视觉布局或现有 HTML 结构的 ACF 弹性内容级别控制。
  3. 为了提供一个与您的设计规范完美匹配的简洁页面构建体验。
  4. 为了故意限制内容编辑器的选项,拥抱“决策而非选项”的哲学。

不使用本软件包的情况

  1. 如果您在设计或 HTML 结构方面具有灵活性(或者您不需要在 figma 和 WordPress 前端之间实现“像素级”匹配),则核心 Gutenberg 块(辅以静态块的一般工具集)可能更适合您的需求。
  2. 对于非嵌套部分,此软件包是不必要的。相反,请参考此简单方法:https://www.billerickson.net/innerblocks-with-acf-blocks/

使用说明

  1. 通过 Composer 安装

    composer require 2crt/block-sections
    
  2. 将其添加到主题的 composer.json

    {
      "autoload": {
        "psr-4": {
          "Sections\\": "sections/"
        }
      }
    }

    ... 然后运行 composer install 来设置自动加载

  3. 确保 Composer 自动加载是必需的(例如,在 functions.php 中)

    require __DIR__ . '/vendor/autoload.php';
  4. 使用自定义 WP-CLI 命令生成部分

    wp make:section HeroCallToAction
    

遵循 CLI 提示。生成的模板作为开发您自定义部分的基础。