# CMS主题教程

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

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

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

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

{{$page}}

{{$pageSize}}

{!! $pageHtml !!}

{!! \ModStart\Core\Util\PageHtmlUtil::render($total, $pageSize, $page,
        '?' . \ModStart\Core\Input\Request::mergeQueries(['page' => ['{page}']]), [
    'warp' => '<div>%s%</div>',
    'more' => '<span>...</span>',
    'prev' => '<a href="%s%">上一页</a>',
    'prevDisabled' => '<span>上一页</span>',
    'next' => '<a href="%s%">下一页</a>',
    'nextDisabled' => '<span>下一页</span>',
    'first' => '<a href="%s%">首页</a>',
    'last' => '<a href="%s%">尾页</a>',
    'current' => '<span>%p%</span>',
    'item' => '<a href="%s%">%p%</a>',
]) !!}

{{$pageNextUrl}}

{{$pagePrevUrl}}

标题：{{ $record['title'] }}
内容：{{ $record['content'] }}

<form action="{{ modstart_web_url('cms/form/submit',['cat'=>7]) }}" 
    method="post" data-ajax-form>
    手机：<input type="text" name="phone" >
    姓名：<input type="text" name="name" >
    内容：<input type="text" name="content" >
    <button type="submit">提交</button>
</form>
需要注意，表单提交需要引入这两个JS来处理 data-ajax-form 的表单提交
<script src="@asset('asset/vendor/jquery.js')"></script>
<script src="@asset('asset/common/base.js')"></script>

// 网站名称
{{ modstart_config('siteName') }}
// 网站Logo
{{ modstart_config_asset_url('siteLogo') }}
// 网站副标题
{{ modstart_config('siteSlogan') }}
// 网站域名
{{ modstart_config('siteDomain') }}
// 网站关键词
{{ modstart_config('siteKeywords') }}
// 网站描述
{{ modstart_config('siteDescription') }}
// 备案编号
{{ modstart_config('siteBeian') }}
// 网站ICO
{{ modstart_config_asset_url('siteFavIco') }}
// 网站主色调
{{ modstart_config('sitePrimaryColor') }}
// 网站主题
{{ modstart_config('siteTemplate') }}
// 联系方式-邮箱
{{ modstart_config('Site_ContactEmail') }}
// 联系方式-电话
{{ modstart_config('Site_ContactPhone') }}
// 联系方式-地址
{{ modstart_config('Site_ContactAddress') }}
// 联系方式-二维码
{{ modstart_config_asset_url('Site_ContactQrcode') }}

// 企业名称
{{ modstart_config('Cms_CompanyName') }}
// 企业传真
{{ modstart_config('Cms_ContactFax') }}
// 联系人
{{ modstart_config('Cms_ContactContactPerson') }}
// 企业联系QQ
{{ modstart_config('Cms_ContactQQ') }}
// 企业介绍标题
{{ modstart_config('Cms_HomeInfoTitle') }}
// 企业介绍图片
{{ modstart_config_asset_url('Cms_HomeInfoImage') }}
// 企业介绍说明，富文本
{!! modstart_config('Cms_HomeInfoContent') !!}

MNav::all('head'); // 头部导航
MNav::all('foot'); // 底部导航

// 循环特定位置轮播
@foreach(MBanner::all('Xxx') as $banner)
    @if($banner['type']===\Module\Banner\Type\BannerType::IMAGE)
        图片
        <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
    @elseif($banner['type']===\Module\Banner\Type\BannerType::IMAGE_TITLE_SLOGAN_LINK)
        图片+标题+描述+链接
        <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
        <span>{{ $banner['title'] }}</span>
        <span>{{ $banner['slogan'] }}</span>
        <a href="{{ $banner['link'] }}">{{ $banner['linkText'] }}</span>
    @elseif($banner['type']===\Module\Banner\Type\BannerType::VIDEO)
        视频
        <a href="{{ $banner['link'] }}">{{ $banner['video'] }}</a>
    @endif
@endforeach

// 循环特定位置轮播（仅包含图片）
@foreach(MBanner::allImage('Xxx') as $banner)
  <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
@endforeach

// 位置 Blog
\MBanner::all('Blog')
// 位置 Cms
\MBanner::all('Cms')

// 循环特定位置友情链接
@foreach(\MPartner::all('Xxx') as $partner)
  <a href="{{ $partner['link'] }}">{{ $partner['title'] }}</a>
@endforeach

// 位置 Blog
\MPartner::all('Blog')
// 位置 Cms
\MPartner::all('Cms')

@if(\Module\Member\Auth\MemberUser::isLogin())
    用户ID：{{$_memberUser['id']}}
    用户名：{{$_memberUser['username']}}
    昵称：{{$_memberUser['nickname']}}
@else
    请登录
@endif

@foreach([MContentBlock::getCached('标识')] as $cb)
    @if(!empty($cb))
        <p>类型：{{$cb['type']}}</p>
        <p>名称：{{$cb['name']}}</p>
        <p>备注：{{$cb['remark']}}</p>
        <p>通用</p>
        <p>图片：{{join(',',$cb['texts'])}}</p>
        <p>图片：{{join(',',$cb['basicImages'])}}</p>
        <p>图片</p>
        <p>图片：{{$cb['image']}}</p>
        <p>富文本</p>
        <p>HTML：{{$cb['content']}}</p>
    @endif
@endforeach

@foreach(MContentBlock::allCached('标识',5) as $cb)
    <p>类型：{{$cb['type']}}</p>
    <p>名称：{{$cb['name']}}</p>
    <p>备注：{{$cb['remark']}}</p>
    <p>通用</p>
    <p>图片：{{join(',',$cb['texts'])}}</p>
    <p>图片：{{join(',',$cb['basicImages'])}}</p>
    <p>图片</p>
    <p>图片：{{$cb['image']}}</p>
    <p>富文本</p>
    <p>HTML：{{$cb['content']}}</p>
@endforeach

// 根据ID获取内容
<?php $record = MCms::getContent(1); ?>

标题：{{ $record['title'] }}
内容：{{ $record['content'] }}

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

@foreach($cat['_model']['_customFields'] as $customField)
    @if($customField['fieldType']=='text')
        <!-- 文本字段 -->
        <div>
            {{$customField['title']}}
            :
            <input class="form" type="text" name="{{$customField['name']}}" />
        </div>
    @else
        <!-- 其他字段 -->
    @endif
@endforeach

@foreach (\Module\TagManager\Util\TagManagerUtil::allVisible('cms') as $tag)
    <a href="{{ modstart_web_url('tag/'.urlencode($tag['tag'])) }}">{{ $tag['tag'] }}</a>
@endforeach

@extends($_viewFrame)

@section('pageTitleMain')我的视图标题@endsection

@section('bodyContent')
    <div class="ub-container">
        我的视图文件
    </div>
@endsection

// 系统路径
{{ modstart_web_url('foo/bar') }}
// 系统路径，带域名
{{ modstart_web_full_url('foo/bar') }}

// 引入行内 js
\ModStart\ModStart::script('console.log("Hello ModStart");');
// 引入一个 JavaScript 文件内容到页面
\ModStart\ModStart::js('文件路径.js');
// 引入一个 js 文件路径到页面
\ModStart\ModStart::js('文件路径.js');

// 引入行内 css
\ModStart\ModStart::style('.test{ color:red; }');
// 引入一个 CSS 文件内容到页面
\ModStart\ModStart::styleFile('文件路径.css');
// 引入一个 CSS 文件路径到页面
\ModStart\ModStart::css('文件路径.css');

// $t = '2021-01-01 00:00:00'
date('Y-m-d', strtotime($t) )

// 去除HTML并限制输出 100 个字符
\ModStart\Core\Util\HtmlUtil::text($html,100)

// HTML
\ModStart\Core\Util\HtmlUtil::text($html,100)
// 非HTML
\ModStart\Core\Util\StrUtil::limit($text,100,'...')

// 限定浮点格式，更多参考 https://www.php.net/manual/en/function.sprintf.php
sprintf('%0.2f', 3.14159)

// /test/path
\ModStart\Core\Input\Request::path()
// http://example.com/test/path?a=b
\ModStart\Core\Input\Request::currentPageUrl()
// http://example.com/test/path
\ModStart\Core\Input\Request::currentPageUrlWithOutQueries()

\ModStart\Core\Input\Request::currentPageUrl()

// 返回base64图片字符串
\ModStart\Core\Util\QrcodeUtil::pngBase64String('ModStart')

modstart_config('xxx','默认值')

return view('welcome', ['name' => 'Samantha']);

Hello, {{ $name }}.

{{ empty($name) ? '默认值' : $name }}

目前的 UNIX 时间戳为 {{ time() }}。

@if (count($records) === 1)
    我有一条记录！
@elseif (count($records) > 1)
    我有多条记录！
@else
    我没有任何记录！
@endif

@for ($i = 0; $i < 10; $i++)
    目前的值为 {{ $i }}
@endfor

@foreach ($users as $user)
    <p>此用户为 {{ $user->id }}</p>
@endforeach

@forelse ($users as $user)
    <li>{{ $user->name }}</li>
@empty
    <p>没有用户</p>
@endforelse

@while (true)
    <p>我永远都在跑循环。</p>
@endwhile

@extends('theme.pc.default.frame')

@section('title', '页面标题')

@section('sidebar')
    @parent
    <p>这边会附加在主要的侧边栏。</p>
@endsection

@section('content')
    <p>这是我的主要内容。</p>
@endsection

Hello, @{{ name }}.

Hello, {!! $name !!}.

@include('share.header')

@include('view.name', ['some' => 'data'])

{{ isset($name) ? $name : '默认值' }}

{{-- 此注释将不会出现在渲染后的 HTML --}}