思客讲堂模板系统说明

[toc]

安装

  1. 同步代码到本地;
  2. 更新数据库,增加表 sike_class_template
  3. 启用插件“思客讲堂模板生成系统”;

菜单说明

安装并启用插件后,在左侧会出现“思客讲堂”的管理菜单,其中包括“思客讲堂”及“模板管理两项。

  • 思客讲堂 — 管理已经通过模板创建的思客讲堂,也可以在这里创建新的思客讲堂;
  • 模板管理 — 用来管理生成思客讲堂的模板,或创建新的模板。

模板管理

创建模板

  1. 点击“创建模板”,填写“模板名称”、“模板目录”等信息,并添加对应的字段区域;
  2. 选择并增加模板中的嵌入字段类型(可使用的类型详见附表1),并获取其对应的嵌入标签ID;
  3. 拷贝嵌入标签ID,并嵌入到您的模板HTML文件中;
  4. 替换模板HTML文件中CSS、JS及图片的地址为HTTP绝对地址(可使用WordPress内建函数);
  5. 上传模板HTML、CSS、JS及图片等文件到录入的“模板目录”中。

注:模板位于 resource/themes/sike/class-templates 中,需要自建。

模板管理

在模板管理中,可以按照模板的创建时间来浏览已经创建的模板。

也可以修改、删除已经创建的思客讲堂模板。

注:正在使用中的模板(已经生成过思客讲堂的模板)不可删除。

思客讲堂管理

创建思客讲堂

  1. 进入左侧菜单“思客讲堂”,并点击“从模板创建”按钮;
  2. 输入“思客讲堂名称”、“思客讲堂标识”、上传“缩略图”,并且选择一个内容模板;
  3. 按需要填写下面的字段,并保存修改。

注1:“思客讲堂名称”将可作为<title>来使用。
注2:“缩略图”仅供管理方便使用。
注3:生成的思客讲堂的访问地址为 http://sike.news.cn/statics/sike/posts/classes/标识 。

管理思客讲堂

在“思客讲堂管理”中,可以“预览”、“修改”或“删除”已经创建好的思客讲堂。

附表

表1:嵌入字段类型

类型名称 类型说明
普通HTML代码 在标签中插入一段纯文本内容,支持对HTML、CSS或JavaScript的解析。
思客文章列表 在标签位置,从思客已经发布的文章中取出指定ID的文章形成文章列表。
组信息 在标签位置插入一组信息,包括“标题”、“副标题”、“链接”、“简介”、“内容”、“时间”、“缩略图”等信息。

表2:模板系统中支持的标签

类型名称 标签 说明
普通HTML代码 ###html_xxx### 要替换的HTML代码
思客文章列表 ###post_xxx.start### 循环起始符
###post_title### 文章标题
###post_excerpt### 文章简介
###post_date### 文章时间
###post_link### 文章链接地址
###post_thumbnail### 文章缩略图
###post_xxx.end### 循环结束符
组信息 ###package_xxx.title### 标题
###package_xxx.subtitle### 副标题
###package_xxx.link### 链接
###package_xxx.excerpt### 简介
###package_xxx.content### 内容
###package_xxx.datetime### 时间
###package_xxx.thumbnail### 缩略图