pattonwebz/customizer-framework

这是一个帮助主题为自定义设置添加项目的框架。

dev-master 2018-11-01 00:02 UTC

This package is auto-updated.

Last update: 2024-09-29 05:02:17 UTC


README

WordPress 主题自定义设置器的启动模板。

主要来说,这是一个用于在 WordPress 主题中开始自定义设置实现的干净基类,目前仍在开发中。

您需要以完全相同的方式定义所有自己的设置、部分、面板和控制,就像您在其他函数内部做的那样。这个类没有辅助方法,使添加这些比默认 WP 方法更容易。

一些特性

  • 包含添加面板、部分、设置和控制的不同方法。
  • 基于 Justin Tadlock 的 TRT-Customizer-Pro 部分的示例 '帮助部分'(可以用作 '专业' 或 '升级' 部分)。有以下自定义选项
    • 标题
    • 带链接的按钮
    • 描述文本
  • 具有属性来存储传递给设置的默认值,这些值可以从实例化扩展类的主题传递。

扩展类

该类设置成可以扩展来使用。

第一步是创建一个扩展基类的类,并将其放置在一个可以访问的位置(包括基 PattonWebz_Customize 类文件)。在这些示例中,我假设它位于 /path/to/theme/inc/,但您可以将它放在其他位置。

examples/class-themename-customizer.php 中的文件显示了扩展类的一个示例。您应该在类定义中用您自己的前缀替换 'Themename',在文件名中用 'themename' 替换。

需要基类和主题自定义设置类文件,然后获取扩展类的实例,如下所示

// Register the theme customizer settings.
require_once trailingslashit( get_template_directory() ) . 'inc/customizer/class-pattonwebz-customizer.php';
require_once trailingslashit( get_template_directory() ) . 'inc/class-themename-customizer.php';

// pass in the directory of the customizer package, the uri to it and an array of of setting defaults.
$prefix_customizer_class = new Themename_Customizer( $dir, $uri, $defaults );

按照该文件中 NOTE: 文档块中的说明,以帮助了解添加自定义设置选项的位置。

使用 settings_defaults 属性

这里使用属性来存储一个数组,该数组包含用于设置默认值的设置。

许可证信息

此软件包根据 GNU GPLv2 或更高版本的许可证授权。

软件包中的帮助部分基于并受到 Justin Tadlock 的自定义设置升级部分的启发 - https://github.com/justintadlock/trt-customizer-pro - GPLv2 许可证。

版权所有 2018 © William Patton。