如果有需要开发WordPress主题的,那肯定要符合WordPress官方的开发规则。一来可以兼容正常主题的运行和后续维护的二次管理,二来如果有需要推送到官方应用平台也是需要符合规范检测才可以通过的。所以,无论是我们自用的主题,还是将来服务用途的开发项目,一定要遵守 WordPress主题开发规则。
这篇文章,对于初始开发者来说应该是有用的,也算是必备的文档。比如我们在开发WordPress主题的时候,主题文件名的命名都是有规范要求的。
WordPress主题文件名规范
这里,我们常见的WordPress主题文件命名,以及对应的功能。
index.php:主题首页文件,每个主题都必须有,如果没有其他文件会默认这个文件。 style.css:主题的主样式文件,一般放在主题根目录。 rtl.css:从右向左阅读的样式文件,如果站点语言是从右向左阅读的,主题会自动包含此文件。 comments.php:主题评论模版文件。 front-page.php:首页模版文件,无论阅读设置中的首页设置,优先选择此文件模版作为首页模版文件。 home.php:如果阅读设置中设置为静态页面,选择此文件作为首页模版文件。 header.php:网站页头模板文件,通常包含网站的文档类型、元信息、样式表、脚本链接以及其他数据。 footer.php:页面底部文件套用的模板。 siderbar.php:页面侧边栏独立拆分的模板。 singular.php:单页面模板,未找到 single.php 或 page.php 时,使用此文件作为这些文章类型的单页面模版文件。 single.php:「文章」的页面模版文件。 single-{post-type}.php:「post-type」文章类型的详情页模版文件。 archive-{post-type}.php:「post-type」文章类型的存档页模版文件。 page.php:「页面」文章页面模版文件。 page-{slug}.php:别名为「slug」的页面详情页模版文件。 category.php:分类目录存档模版文件。 tag.php:标签存档模版文件。 taxonomy.php:自定义分类法存档模版文件。 author.php:作者存档页模版文件。 date.php:日期存档页模版文件。 archive.php:默认存档页默模版文件。 search.php:搜索结果页模版文件。 attachment.php:单个附件页面模版文件。 image.php:图像页面模版文件。 404.php:404 找不到的错误页面模版文件。
一般而言,我们看到的主题至少需要包含这几个:
style.css index.php header.php footer.php sidebar.php single.php comments.php
主题文件调用
我们在设计主题的文件的时候,文件的目录因为是相对路径的。不论用户如何修改主题文件夹名称,都可以自动的调用主题的文件,这里我们就需要用到内置的文件URL调用。
1、主题路径
<?php bloginfo('template_directory'); ?>
2、头部模块
<?php get_header();?>
3、底部模块
<?php get_footer();?>
4、边栏模块
<?php get_sidebar();?>
5、其他模块
<?php include( TEMPLATEPATH . '/文件名' ); ?>
6、主CSS样式(style.css)
<link rel='stylesheet' href='<?php bloginfo( 'stylesheet_url' ); ?>'>
主题版权信息
我们看到主题选项中是不是看到主题名称、开发者信息,这些是需要包含在 style.css 样式顶部的。
/* Theme Name: Twenty Thirteen Theme URI: http://wordpress.org/themes/twentythirteen Author: the WordPress team Author URI: http://wordpress.org/ Description: The 2013 theme for WordPress takes us back to the blog, featuring a full range of post formats, each displayed beautifully in their own unique way. Design details abound, starting with a vibrant color scheme and matching header images, beautiful typography and icons, and a flexible layout that looks great on any device, big or small. Version: 1.0 License: GNU General Public License v2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Tags: black, brown, orange, tan, white, yellow, light, one-column, two-columns, right-sidebar, flexible-width, custom-header, custom-menu, editor-style, featured-images, microformats, post-formats, rtl-language-support, sticky-post, translation-ready Text Domain: twentythirteen This theme, like WordPress, is licensed under the GPL. Use it to make something cool, have fun, and share what you've learned with others. */
这是来自WordPress官方的默认说明文档。我们可以根据需要修改。
这些名称都代表什么意思呢?
Theme Name:主题名称 。 Theme URI :主题介绍 URL,我们可以引用到主题的详细开发者页面。 Author:主题开发作者。 Author URI :主题开发作者的URL。 Description:主题描述。 Version:主题版本。 Licence:主题许可认证。 Licence URI :主题许可认证的URL。 Text Domain:用于 textdomain 的字符串转换。 Tags:主题的一些可识别的标签化关键字 。
一般我们可以这样:
/* Theme Name: 乐在云博客主题 Theme URI: https://www.lezaiyun.com/boke.html Description:一款博客主题 Author: 老蒋和他的小伙伴 Author URI: https://www.laojiang.me Version: 1.0 Tags: 博客主题 */
一般用上面几个就够。
评论