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。