萨龙网络在2018年9月份就写了一篇《[WordPress 简约实用的主题选项框架 Codestar Framework](https://api.salongweb.com/codestar-framework.html)》文章来介绍 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：萨龙网络的都修复了，哈哈……