本页目录
Ashuwp_framework 是由阿树工作室发布的一个 WordPress 后台框架。
*最新版本 6.5 *更新日期 2018.07.30 *系统要求 php5.3 以上* WordPress 版本 4.5 以上
使用本框架的要求:您需要具备基础的 PHP 语法知识,以及对 WordPress 主题有基本的了解。
- 框架介绍: http://www.ashuwp.com/framework/down
- GitHub: https://GitHub.com/ashuwp/Ashuwp_framework
- 框架版本:6.0
框架下载:
框架用途:
- 给你的 WordPress 文章发布页面添加自定义面板和自定义字段
- 给你的 wordperss 网站后台添加设置页面
- 给你的 WordPress 分类页面以及分类编辑页面添加自定义字段
本框架可以添加的表单元素类型有,以下所有元素都支持上面三项。
- 普通提示文字
- 文本输入框 input
- 文本输入域 input
- 图片上传 media upload 使用 WordPress 3.5 以后的新媒体中心
- 单选框 radio(可选择 页面、分类、侧边栏、菜单、自定义的下拉项)
- 复选框 checkbox(可选择 页面、分类、侧边栏、菜单、自定义的下拉项)
- 下拉框 select (可选择 页面、分类、侧边栏、菜单、自定义的下拉项)
- 数组输入 number_array (可保存为一个数字数组)
- 文本编辑器 tinymce (调用 WordPress 默认的 tinymce 编辑器)
加载本框架
文件结构
当你下载我们的框架之后,你将得到一个压缩包,解压这个压缩包。里面文件结构为:
- 本压缩包下面包含了两个文件 add-functions.php readme.html 以及三个文件夹 css include js
- add-functions.php 文件有六行范例代码,用来包加载框架可能需要的 6 个文件,代码中有说明
- css 文件夹下有一个 css 文件,是后台表单元素的样式文件
- js 文件夹里面有 ashuwp_framework.js,用来支持后台文件上传
- include 文件夹中的 ashuwp_framework_core.php 文件,本框架的核心类文件,必须加载
- include 文件夹中的 ashuwp_options_feild.php 文件,用于添加设置页面,如不需要可不加载
- include 文件夹中的 ashuwp_termmeta_feild.php 文件,用于给分分类(支持自定义分类法)添加字段,如不需要可不加载
- include 文件夹中的 ashuwp_postmeta_feild.php 文件,用于给文章(支持自定义文章类型)添加字段,如不需要可不加载
- include 文件夹中的 import_export.php 文件,用于后台设置数据的导入导出,默认不加载。
- include 文件夹中的 config-example.php 文件时配置文件的示例代码
将框架加载包含到主题
1. 下载本框架,并解压,文件结构如下。
2. 将本框架的所有文件和文件夹拷贝到你的主题的文件夹内(如果使用 ftp 上传到服务器,请使用二进制模式上传)。
3. 请将 add-functions.php 文件中的 2 行代码复制到你主题的 functions.php 文件中(位置不重要,一般阿树放最前面。)。
4. 如果新开发的主题不存在 functions.php 文件,请直接将 add-functions.php 文件重命名为 functions.php 文件即可。
5. 如果你的主题中已经存在相同的文件夹,没关系覆盖即可。
6. 如果你的主题中已经存在相同的文件夹,碰巧文件夹内还有同名的文件,请停止。
7.由于框架中的 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-example.php │ └── ... ├── js/ │ ├── ashuwp_framework.js │ └── ... ├── functions.php ├── readme.html ├── screensht.png └── ...在 add-functions.php 文件中的 2 行代码
- require get_template_directory() . '/include/ashuwp_framework_core.php'; //必须 加载核心类
- require get_template_directory() . '/include/config-example.php'; //配置文件-按需配置
注意加载顺序:
config-example.php 等配置文件必须在类文件加载完之后。
如果你直接使用压缩包中提供的默认配置文件,你会发现,在你的网站后台:
- 文章编辑页面多了一大串自定义字段。
- 分类添加和编辑页面多了一些自定义字段
- 后台多了设置页面
这些仅仅是默认参考代码,所以接下来请编辑 config-example.php 文件,根据需要配置。