加载本框架

文件结构

当你下载我们的框架之后,你将得到一个压缩包,解压这个压缩包。里面文件结构为:

  1. 本压缩包下面包含了两个文件 add-functions.php readme.html以及三个文件夹css include js
  2. add-functions.php文件有六行范例代码,用来包加载框架可能需要的6个文件,代码中有说明
  3. css文件夹下有一个css文件,是后台表单元素的样式文件
  4. js文件夹里面有ashuwp_framework.js,用来支持后台文件上传
  5. include文件夹中的ashuwp_framework_core.php文件,本框架的核心类文件,必须加载
  6. include文件夹中的ashuwp_options_feild.php文件,用于添加设置页面,如不需要可不加载
  7. include文件夹中的ashuwp_termmeta_feild.php文件,用于给分分类(支持自定义分类法)添加字段,如不需要可不加载
  8. include文件夹中的ashuwp_postmeta_feild.php文件,用于给文章(支持自定义文章类型)添加字段,如不需要可不加载
  9. include文件夹中的import_export.php文件,用于后台设置数据的导入导出,自2.0版本加入,如不需要可不加载
  10. include文件夹中的config.php文件是配置文件,需要添加的任何字段请编辑此文件添加配置(请编辑此文件)
  11. include文件夹中的config-example.php文件时配置文件的示例代码(可删除)

将框架加载包含到主题

1. 下载本框架,并解压,文件结构如下。

2. 将本框架的所有文件和文件夹拷贝到你的主题的文件夹内(如果使用ftp上传到服务器,请使用二进制模式上传)。

3. 请将add-functions.php文件中的6行代码复制到你主题的functions.php文件中(位置不重要,一般阿树放最前面。)。

4. 如果新开发的主题不存在functions.php文件,请直接将add-functions.php文件重命名为functions.php文件即可。

5. 如果你的主题中已经存在相同的文件夹,没关系覆盖即可。

6. 如果你的主题中已经存在相同的文件夹,碰巧文件夹内还有同名的文件,请停止。

7.由于框架中的config.php中含有大量作为范例的配置代码,加载完成之后你的网站后台会出现一些设置页面,文章编辑页面会出现大量自定义字段,分类页面也会出现大量自定义字段,你可以删除config.php中的代码(config-example.php中还有相同的备份),然后开始自己的配置吧。

文件结构大概如图

          
          ashuwp-theme/
          ├── css/
          │  ├── ashuwp_framework.css
          │  └── ...
          ├── include/
          │  ├── ashuwp_framework_core.php
          │  ├── ashuwp_options_feild.php
          │  ├── ashuwp_termmeta_feild.php
          │  ├── ashuwp_postmeta_feild.php
          │  ├── import_export.php
          │  ├── config.php
          │  └── ...
          ├── js/
          │  ├── ashuwp_framework.js
          │  └── ...
          ├── functions.php
          ├── readme.html
          ├── screensht.png
          └── ...
          

在add-functions.php文件中的6行代码

  1. require get_template_directory() . '/include/ashuwp_framework_core.php'; //必须 加载核心类
  2. require get_template_directory() . '/include/ashuwp_options_feild.php'; //可选 设置页面
  3. require get_template_directory() . '/include/ashuwp_termmeta_feild.php'; //可选 分类字段
  4. require get_template_directory() . '/include/ashuwp_postmeta_feild.php'; //可选 文字字段
  5. require get_template_directory() . '/include/import_export.php'; //可选 设置选项导入导出
  6. require get_template_directory() . '/include/config.php'; //配置文件-按需配置

注意加载顺序:

config.php文件必须在类文件加载完之后。

如果你直接使用压缩包中提供的默认配置文件,你会发现,在你的网站后台:

  • 文章编辑页面多了一大串自定义字段。
  • 分类添加和编辑页面多了一些自定义字段
  • 后台多了两个两个顶级设置页面,以及一个子页面,一个导入导出页面

这些仅仅是默认参考代码,所以接下来请编辑config.php文件,根据需要配置。