ModStartCMS 主题入门开发教程

快速创建主题

安装模块开发助手

模块开发助手可以极大效率的提高模块开发效率，在后台安装 模块开发助手。

创建主题模块

使用 模块开发助手 可以快速的创建主题主题模块。

通过 系统管理 → 模块开发助手 → 新建CMS主题模块 可以完成主题模块的快速创建。

完成主题模块代码开发

第二步会根据填写的主题模块基本信息完成模块的创建，并且生成一些示例代码，通过修改和完善模块代码，完成模块的功能开发

主题模块的开发请参照 CmsThemeDemo，该示例中涵盖了主题模块开发的示例。

开发示例程序会不断更新，请随时查看最新的开发示例程序。

模板开发语法

主题使用了 blade 语法，具体语法可参照 视图开发

模板信息

站点基本信息

适用范围：任意页面

// 网站名称
{
  { modstart_config('siteName') }}
// 网站Logo
{
  { modstart_config('siteLogo') }}
// 网站副标题
{
  { modstart_config('siteSlogan') }}
// 网站域名
{
  { modstart_config('siteDomain') }}
// 网站关键词
{
  { modstart_config('siteKeywords') }}
// 网站描述
{
  { modstart_config('siteDescription') }}
// 备案编号
{
  { modstart_config('siteBeian') }}
// 网站ICO
{
  { modstart_config('siteFavIco') }}
// 网站主色调
{
  { modstart_config('sitePrimaryColor') }}
// 网站主题
{
  { modstart_config('siteTemplate') }}

CMS 基本信息

适用范围：任意页面

// 企业名称
{
  { modstart_config('Cms_CompanyName') }}
// 企业邮箱
{
  { modstart_config('Cms_ContactEmail') }}
// 企业电话
{
  { modstart_config('Cms_ContactPhone') }}
// 企业地址
{
  { modstart_config('Cms_ContactAddress') }}
// 企业传真
{
  { modstart_config('Cms_ContactFax') }}
// 联系人
{
  { modstart_config('Cms_ContactContactPerson') }}
// 企业联系QQ
{
  { modstart_config('Cms_ContactQQ') }}
// 企业介绍标题
{
  { modstart_config('Cms_HomeInfoTitle') }}
// 企业介绍图片
{
  { modstart_config('Cms_HomeInfoImage') }}
// 企业介绍说明
{
  { modstart_config('Cms_HomeInfoContent') }}

导航

适用范围：任意页面

循环显示导航

@foreach(\MNav::all('home') as $nav)
  <a href="{
  { $nav['link'] }}">{
  { $nav['name'] }}</a>
@endforeach

可用变量

变量	说明
$nav['name']	导航名称
$nav['link']	导航链接
$nav['_child']	子导航（空表示只有一级导航，不为空表示为二级导航）
$nav['openType']	打开方式（2 = 新窗口 其他值 = 当前窗口）

二级嵌套

@foreach(\MNav::all('home') as $nav)
  @if(empty($nav['_child']))
    <!-- 无二级导航 -->
  	<a href="{
  { $nav['link'] }}">{
  { $nav['name'] }}</a>
  @else
    <!-- 有二级导航 -->
    <div class="title">
    	<a href="{
  {$nav['link']}}">{
  {$nav['name']}}</a>
    </div>
    <div class="child">
      @foreach($nav['_child'] as $child)
      	<a href="{
  {$child['link']}}">{
  {$child['name']}}</a>
      @endforeach
    </div>
  @endif
@endforeach

高亮菜单

当前 URL 匹配链接时输出 CSS 类 active

@foreach(\MNav::all('home') as $nav)
  <a href="{
  { $nav['link'] }}" class="{
  {modstart_baseurl_active($nav['link'],'active')}}">{
  { $nav['name'] }}</a>
@endforeach

更多使用可参考 Nav 模块

轮播图片

适用范围：任意页面

循环显示轮播

@foreach(\MBanner::all('home') as $banner)
  <a href="{
  { $banner['link'] }}">{
  { $banner['image'] }}</a>
@endforeach

更多使用可参考 Banner 模块

友情链接

适用范围：任意页面

循环显示友情链接

@foreach(\MPartner::all('home') as $partner)
  <a href="{
  { $partner['link'] }}">{
  { $partner['title'] }}</a>
@endforeach

更多使用可参考 Partner 模块

站点地图

启用网站需要安装 SiteMapManager 模块获得支持，设置后访问路径如下：

• http://www.example.com/sitemap.xml

系统使用动态站点地图，不需要手动生成，访问地址即为实时地图，输出格式为 xml 格式。具体使用方式可参考 SiteMapManager (opens new window) 模块的使用方法。

当前栏目

适用范围：在列表页或详情页使用

可用变量

变量	说明
$cat['id']	栏目 ID
$cat['pid']	父级栏目 ID
$cat['title']	栏目标题
$cat['url']	栏目 URL
$cat['modelId']	栏目模型 ID
$cat['seoTitle']	SEO 标题
$cat['seoDescription']	SEO 描述
$cat['seoKeywords']	SEO 关键词
$cat['icon']	栏目图标
$cat['cover']	栏目封面
$cat['subTitle']	栏目子标题
$cat['bannerBg']	栏目 Banner 背景
$cat['_model']	栏目模型
$cat['_model']['title']	栏目模型名称
$cat['_model']['name']	栏目模型标识

指定栏目

适用范围：任意页面

// 根据栏目ID获取栏目信息
<?php $cat = MCms::getCat(1); ?>
// 根据栏目URL获取栏目信息
<?php $cat = MCms::getCatByUrl('news'); ?>

可用变量

变量	说明
$cat['id']	栏目 ID
$cat['pid']	父级栏目 ID
$cat['title']	栏目标题
$cat['url']	栏目 URL
$cat['modelId']	栏目模型 ID
$cat['seoTitle']	SEO 标题
$cat['seoDescription']	SEO 描述
$cat['seoKeywords']	SEO 关键词
$cat['icon']	栏目图标
$cat['cover']	栏目封面
$cat['subTitle']	栏目子标题
$cat['bannerBg']	栏目 Banner 背景
$cat['_model']	栏目模型
$cat['_model']['title']	栏目模型名称
$cat['_model']['name']	栏目模型标识

内容列表

适用范围：列表页

循环输入内容列表

@foreach($records as $record)
    <a href="{
  {$record['_url']}}">{
  {$record['title']}}</a>
@endforeach

可用变量

变量	说明
$records