README

这是 Blocksy Customizer 的分支，增加了许多功能，如自动 CSS 输出和更简单的参数。

此插件向 WP Customizer 添加了多种选项，如排版和颜色选择器。

它还包含用于头部和尾部的拖放构建器

1. 入门

下载此仓库，将其放入您的 /plugins 文件夹，安装并激活此插件。

如果您使用 Composer 安装插件，此插件可用名为 pixelstudio/wp-custy。

然后转到外观 > 自定义器，您将看到以下默认部分

常规 - 包含颜色方案、阴影和网站宽度的选项。
文本 - 包含正文和标题的排版选项。
头部 - 包含头部拖放构建器。
尾部 - 包含尾部拖放构建器。

2. 术语

选项 - 每个单独的设置。例如（见上图第一张）：根字体类型，小字体大小
部分 - 选项的整个列。例如：常规，文本
构建器 - 头部或尾部拖放设置的任一部分。
项 - 可以放置在头部或尾部的选项集。例如（见上图第二张）：按钮，徽标

3. 使用 CSS 选项

在选项中，您可能会注意到这个 CSS 切换

这意味着该选项的值将自动输出到 :root（默认情况下）使用该变量名。

然后在主题中适合的地方实现该变量。

4. 添加新部分

假设我们想要添加一个新部分，我们可以在此处开启和关闭各种功能。使用下面的过滤器

add_filter( 'custy_sections', function( $sections ) {

  $sections[ 'features' ] = [
    'title' => __( 'Features' ),
    'container' => [ 'priority' => 10 ],
    'options' => [
      
      'has_back_to_top' => [
        'label' => __( 'Has Back to Top?' ),
        'type' => 'ct-switch',
      ],

      'has_fixed_header' => [
        'label' => __( 'Has Fixed Header?' ),
        'type' => 'ct-switch',
      ],

      'has_blog_sidebar' => [
        'label' => __( 'Has Blog Sidebar?' ),
        'type' => 'ct-switch',
      ],
    
    ]
  ];

  return $sections;
} );

然后定义这些新选项的 默认值

add_filter( 'custy_default_values', function( $defaults ) {

  $defaults = wp_parse_args( [
    
    'has_back_to_top' => 'yes',
    'has_fixed_header' => 'no',
    'has_blog_sidebar' => 'yes',

  ], $defaults );

  return $defaults;
} );

完成！，查看自定义器，您将看到一个名为 "功能" 的新部分

查看 Wiki 获取关于选项类型和其他内容的完整信息。

5. 使用非 CSS 选项

使用以下示例中的 Custy::get_mod( $option_id ) 函数

if( Custy::get_mod('has_back_to_top') == 'yes' ) {
  // output the back to top markup
}

为了便于记忆选项 ID，标签应相同。例如：标签 has_back_to_top 是 "有返回顶部?"

6. Wiki 中更多信息

我在 Wiki 中准备了大量信息，包括

7. 使用CUSTY构建的主题

Edje WP Theme - 使用Timber库的自己的WP启动主题。
Blocksy - 该自定义器起源的主题。这是一个令人惊叹的主题，我将其用于我的 WPTips.dev 博客，但自定义器难以编辑，因为它缺少过滤器。

pixelstudio / wp-custy

维护者

详细信息