Sage是一个优秀的WordPress框架,上手也非常简单,官方的文档写得非常清晰明了,英文基本过关的程序就能看懂,不过为了让大家看得更轻松更方便,我还是简单的翻译了一下,根据篇幅不同,可能会分几篇文章,大家可以根据需要查看。翻译的时候根据自己的理解和经验,会加入一些说明性的内容,方便大家理解和使用。水平有限,翻译得有不合适和不正确的地方,欢迎大家在评论中指出。
安装WordPress Sage主题框架
在WordPress主题目录直接克隆Sage的git仓库,或者在Github上下载下来,解压到主题目录。
git clone https://github.com/roots/sage.git theme-name
如果没有使用 Bedrock,需要在 wp-config.php
文件中加入以下配置。
define('WP_ENV', 'development');
WordPress Sage主题框架配置
Sage主题框架的所有配置都在 lib/config.php
这个文件里面,我们可以在这个文件里面启用禁用Sage主题和Soil插件的一些功能,主题默认的一些配置如下。
启用Soil插件的代码清理功能:
add_theme_support('soil-clean-up');
启用Soil插件的导航walker功能:
add_theme_support('soil-nav-walker');
启用Soil插件的相对URL功能:
add_theme_support('soil-relative-urls');
启用Soil插件的搜索URL:
add_theme_support('soil-nice-search');
启用Soil插件的jQuery CDN功能:
add_theme_support('soil-jquery-cdn');
WordPress Sage主题框架功能说明
functions.php
主要主要用来包含 lib/
文件夹里面的文件,主题所有的功能基本上都在这个文件夹里面定义,不要在这个文件中添加任何功能,而是把功能放在lib/文件夹里面,然后通过functions.php文件包含进来,这样会让主题的结构更清晰明了。
因为Sage 主题是一个基本主题,所有你可以根据自己的需要随意修改 lib/
文件夹里面的功能以符合你的需求。
lib/assets.php
- 插入主题使用的样式和javascript到主题
lib/conditional-tag-check.php
ConditionalTagCheck
应用类,在主题侧边栏中使用
lib/config.php
- 启用/禁用主题功能
lib/extras.php
- 主题附加功能,包含了添加CSS类到
<body>
上和添加‘阅读更多’链接到摘要上的功能
lib/gallery.php
- 重新创建相册简码以适应Bootstrap thumbnails 组件
lib/init.php
- 初始化主题,注册导航菜单,侧边栏,定义WordPress主题支持的WordPress核心功能如: post thumbnails, post formats和 HTML5 标签。
lib/nav.php
- 清理导航菜单中多余的HTML标记
lib/titles.php
- 控制页面标题输出
lib/utils.php
- 重新定义模板中 searchform 模板的位置,一些辅助功能
lib/wrapper.php
- 主题封装
这一部分是WordPress Sage主题框架的基本说明,掌握了这些,我们安装配置Sage主题,简单的配置Sage主题的一些功能就没问题了,下一部分中,我会为大家翻译Sage主题模板的结构和扩展自定义模板的方法。