萨龙网络在2018年9月份就写了一篇《WordPress 简约实用的主题选项框架 Codestar Framework》文章来介绍 Codestar Framework,当时所有功能还是免费的,五大功能都是有,使用后唯一不足的体验较差,还特意修复了些问题。
2019年1月份发布2.0版本就出了专业版本,其实就是把1.0版本的后台选项单独拿出来做为免费版本,专业版本包括所有功能,在购买专业版本使用后,用户体验方面做了很大改进,值得购买。这之后萨龙网络将会写一系列 Codestar Framework Pro 的使用,今天我们就简单说下如何快速使用和获取参数。
一、直接使用插件
1、在codecanyon.net
网站中下载购买的插件
2、在 WordPress 后台 - 插件 - 安装插件中上传安装
3、添加选项代码到 主题functions.php
文件中
// 判断核心类是否有加载,以免出错
if( class_exists( 'CSF' ) ) {
// 设置一个独立的选项 ID
$prefix = 'my_framework';
// 创建选项
CSF::createOptions( $prefix, array(
'menu_title' => 'My Framework',
'menu_slug' => 'my-framework',
) );
// 创建一段选项
CSF::createSection( $prefix, array(
'title' => 'Tab Title 1',
'fields' => array(
// 单行文本框字段
array(
'id' => 'opt-text',
'type' => 'text',
'title' => 'Simple Text',
),
)
) );
// 创建一段选项
CSF::createSection( $prefix, array(
'title' => 'Tab Title 2',
'fields' => array(
// 多行文本框字体
array(
'id' => 'opt-textarea',
'type' => 'textarea',
'title' => 'Simple Textarea',
),
)
) );
}
二、集成到主题中
1、在codecanyon.net
网站中下载购买的插件
2、将插件解压到主题根目录下,比如:/wp-content/themes/theme-name/inc/codestar-framework
或者其它地方也可以
3、添加选项代码到 主题functions.php
文件中
/**
*
* .
* ├── wp-content
* | ├── themes
* | | ├── theme-name
* | | | ├── style.css
* | | | ├── screenshot.png
* | | | ├── functions.php <--------- 通过文本编辑器打开
* | | | ├── ..
* | | | ├── ...
*
*/
/**
*
* Codestar Framework
* 一个简单而轻量级的WordPress主题和插件选项框架
*
*/
require_once get_theme_file_path() .'/inc/codestar-framework/codestar-framework.php';
三、如何获取选项的值
// 获取选项
$options = get_option( 'my_framework' ); // 选项的唯一 ID
echo $options['opt-text']; // 字段的 ID
echo $options['opt-textarea']; // 字段的 ID
Codestar Framework 2.0 后使用稍简化了很多,之前是全部自动加载了,需要添加代码来禁用。选项代码的添加也更加专业,归类明确,五大功能的选项都是通用,还有些不足的地方,比如上传图片不支持预览,有些说明文本样式不够美化,希望之后更新修复下。
PS:萨龙网络的都修复了,哈哈……