OctoberCMS开发入门教程 — Theme主题开发简介

2018-01-03 309

OctoberCMS开发入门教程系列:

主题文件都在/Themes目录,大致的文件结构如下:

themes/
-- demo/ ---- pages/ ---- layouts/ ---- partials/ ---- content/ ---- assets/

pages、partials和layout目录的模板文件内容分为3个部分:参数配置、PHP代码、Twig标签。示例代码如下:

url = "/blog"
layout = "default"
==
function onStart()
{
    $this['posts'] = ...;
}
==
<h3>Blog archive</h3>
{% for post in posts %}
    <h4>{{ post.title }}</h4>
    {{ post.content }}
{% endfor %}

参数配置:支持ini格式语法
PHP代码:开始和结尾必须使用==
Twig标签:和HTML代码一起

每一个主题,包含theme.yaml、version.yaml、assets/images/theme-preview.png 3个通用文件,
theme.yaml 主题配置文件,定义主题相关的全局信息,包含以下字段信息:

字段 描述
name 主题名称,必须参数
author 作者,必须参数
homepage 个人主页URL,必须参数
description 主题描述,必须参数
previewImage 主题预览图,可选参数,默认路径: assets/images/preview.png
code 主题标识,可选参数,如果没有标识则使用目录名称,同时也是OctoberCMS主题应用市场的唯一标识
form 表单数组参数或者引用文件, 可选参数;表单数组参数更详细的说明请看本文后面的主题表单自定义参数
require 主题依赖的插件Plugins,可选参数

version.yaml 主题版本更新日志文件

主题表单自定义参数

以缩进格式定义参数数组,大致结构如下:

OctoberCMS表单数组定义

更多更详细的介绍请看官方文档,http://octobercms.com/docs/backend/forms#form-fields

主题配置参数后台设置示例:

OctoberCMS主题配置

本文只是粗略的介绍了一下OctoberCMS主题开发,后面会写专门的文章来介绍主题开发。

发表评论