常见问题

如何在列表页显示子级分类？

可以将以下代码复制到列表的模板中即可显示

<div class="panel panel-default">
    <div class="panel-heading">
        <h3 class="panel-title">分类列表</h3>
    </div>
    <div class="panel-body">
        <div class="row">
            {cms:channellist id="item" type="son" typeid="__CHANNEL__.id"}
            <div class="col-xs-6">
                <a href="{$item.url}" class="tag btn-block"> <span>{$item.name}</span></a>
            </div>
            {/cms:channellist}
        </div>
    </div>
</div>

如何切换普通分页和无刷新加载？

如果你使用的是1.2.0的新版本，可以直接在后台配置中进行修改即可，如果是旧版本，需要找到列表页以下模板，可以看到默认启用的是无刷新加载的模式，普通分页模式是使用了{if false}{/if}给禁用了，可以移除{if false}和{/if}即可，注意采用了普通分页，下方的无刷加载下一页的模式需要移除哦。

{/* 普通分页 */ }
{if false}
    <!-- S 分页栏 -->
    <div class="text-center pager">
        {cms:pageinfo type="simple" /}
    </div>
    <!-- E 分页栏 -->
    {if $__PAGELIST__->isEmpty()}
    <div class="loadmore loadmore-line loadmore-nodata"><span class="loadmore-tips">暂无数据</span></div>
    {/if}
{/if}

{/* 无刷新加载下一页 */ }
{if $__PAGELIST__->isEmpty()}
    <div class="loadmore loadmore-line loadmore-nodata"><span class="loadmore-tips">暂无更多数据</span></div>
{else /}
    <div class="text-center">
        <a href="?page={:$__PAGELIST__->getNextPage()}" data-page="{:$__PAGELIST__->getNextPage()}" class="btn btn-default my-4 px-4 btn-loadmore">加载更多</a>
    </div>
{/if}

如何启用Xunsearch全文搜索？

CMS从1.1.14版本才支持整合Xunsearch全文搜索，如果你是旧版本，需要更新版本后才支持，更新后可以在后台管理->插件管理->配置中切换搜索方式为Xunsearch全文搜索。Xunsearch全文搜索只支持Linux，且配置较为复杂，可以参考Xunsearch全文搜索插件文档进行配置。https://doc.fastadmin.net/xunsearch

如何启用百度收录主动推送？

CMS从1.1.14版本才支持整合百度主动推送插件，如果你是旧版本，需要更新版本后才支持，同时你需要在插件市场安装百度主动推送，并在插件管理中配置好相关参数，同时在CMS配置中开启百度推送功能即可。
配置好了以后，我们在内容管理中发布文章时会将链接推送到百度收录和快速收录。

启用二级域名后CMS登录状态丢失？

这是因为你绑定二级域名后，Cookie域不同了，可以通过以下修改来实现同域。可以参考：https://ask.fastadmin.net/question/17420.html 进行修改。

升级失败导致前后台都无法打开时该如何操作？

在升级前我们都建议备份所有代码和数据库，如果在升级新版本时导致了前后台都无法打开，可以进行以下几个操作。
首先尝试在命令行执行php think clear，这句话用于清除缓存，一般情况下执行了此操作都可以正常打开前后台
如果无法在命令行执行以上命令，可以手动清除runtime目录中的cache、log和temp这三个目录，清除后再进行尝试。
如果升级后未能正确升级配置导致配置缺少，请下载最新版本CMS，对比addons/cms/config.php，补全缺失的配置。
如果以上两个方法都无法打开前后台，请尝试开启调试模式，查看下具体的错误信息，如果自己无法解答，请将错误信息反馈到CMS问答专区：https://ask.fastadmin.net/zone/cms.html

打开统计控制台时报sql_mode=only_full_group_by错误？

这是由于你的Mysql配置中设置了only_full_group_by导致的错误，需要你修改你的Mysql配置，首先需要找到你的Mysql的my.cnf，找到其中的mysqld，修改sql_mode，移除ONLY_FULL_GROUP_BY，如

[mysqld]  
sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

然后重启Mysql服务即可。

为什么升级到1.2.0以后没有统计控制台？

因为1.2.0版本有新增菜单，所以你需要手动添加规则菜单，添加方法：打开权限管理->菜单规则，添加以下规则cms/statistics和cms/statistics/index，cms/statistics为cms/statistics/index上级，如图：

为什么CMS后台修改了数据前台不生效？

因为前台CMS会有缓存，请尝试在后台管理->右上角->清除缓存后再重试。

为什么前台投稿时自定义字段显示时不生效？

因为前台在投稿时是需要先确定投稿的栏目才知道对的模型，所以暂无法动态控制允许主表的投稿字段，你可以手动修改addons/cms/view/hook/user_sidenav_after.html，把发布文章修改为

发布新闻：https://www.yoursite.com/index/cms.archives/post.html?model_id=1
发布产品：https://www.yoursite.com/index/cms.archives/post.html?model_id=2
发布软件：https://www.yoursite.com/index/cms.archives/post.html?model_id=3

其中model_id=1的值为后台模型的ID，这样用户在点进进入以后就可以控制主表的投稿字段了。

如何添加付费文档？

请在后台CMS管理->内容管理->添加编辑文档时设定价格即可。

CMS小程序中的数据是否同PC端网站的数据为同一数据源？

是的，均采用同一数据源

为什么在CMS小程序中详情的图片不显示？

这是由于富文本中使用的是相对地址，而小程序中只支持使用绝对路径，如果你有使用云存储插件，直接配置好云存储插件即可，如果未使用云存储，请修改application/extra/upload.php中的cdnurl，如修改成https://www.yoursite.com即可。

为什么在后台发布内容时没有富文本编辑器？

CMS默认不包含富文本编辑器，你可以在插件市场安装任意一款免费或付费的富文本编辑器即可。下载地址：https://www.fastadmin.net/store.html?category=16&pay=all&order=default 如果你安装了多个富文本编辑器，注意只保留一个启用。

为什么在后台发布内容时栏目不可以选择？

这是由于你在栏目管理中添加栏目时，栏目类型选择了频道，如果是频道类型，是不可以添加内容的，请选择栏目类型为列表。

为什么PC端分享功能在Https访问时无法使用？

由于CMS的PC端使用了百度分享的接口，而百度分享不直接https请求，所以无法在https下访问，此时我们可以参考：https://github.com/hrwhisper/baiduShare 进行修改。注意百度分享的代码位于addons/cms/assets/js/common.js中，修改后重启插件并清除缓存即可。

为什么子管理员在内容管理页面没有栏目列表和文档？

由于默认开启了栏目授权功能，需要为管理员授权指定的栏目后才可以管理相关的内容，具体修改方法是找到CMS管理->栏目管理->栏目授权->给指定的管理员进行授权后即可。
如果不希望使用栏目授权功能，请在站点配置中将栏目授权功能关闭即可。

为什么提交的富文本内容视频video标签会被过滤转义？

这是由于富文本采用了框架内置的安全过滤规则，其中的video标签会被过滤，如果你需要允许video标签，请自行修改application/common/library/Security.php大概第647行，移除相关的标签即可，但为了安全，强烈不建议这样进行操作。

为什么升级CMS以后发布和编辑内容时没有内容框？

这是由于CMS从1.5.5版本开始新增了配置后台发布字段的功能，因此旧版本升级后请到模型管理->字段列表中开启是否后台发布即可。

如何添加轮播图？

请在后台->CMS管理->区块管理中添加即可，特别注意的是不同版本添加时请使用不同的名称，如下：

1.5.13+已经支持在后台直接选择添加常用名称。
栏目频道页的轮播图调用的是文档标志含有焦点的缩略图。

官网升级高级授权后已安装标准版的如何升级？

如果你最开始购买的标准授权，安装CMS成功后，又在官网升级到了高级授权。此时因为高级授权代码有变动，此时需要重新安装CMS(卸载重新安装)，重新安装CMS前必须做好全站备份(代码+数据库等)。
如果你的代码有做二次开发，请自行做好代码对比和恢复。

如何配置百度云内容审核？

请前往百度云控制台https://ai.baidu.com/censoring 创建应用，并获取应用的appid、apikey和secretkey，然后填写到后台配置中，同时开启审核方式为百度云即可。

如何绑定到首页(移除URL中的/cms)？

很多时候我们需要将CMS内容管理系统的首页作为网站的首页，默认都是有/cms/这个层级，如果需要移除URL中这个/cms/这个目录层级，我们需要在后台CMS管理->站点配置->伪静态配置，移除伪静态一栏值中的/cms即可。
详细请参考：https://ask.fastadmin.net/article/1638.html

为什么arclist标签无法调用显示副栏目下的相关数据？

目前副栏目只支持在栏目列表页调用显示，不支持arclist标签。

启用文档ID加密后无效的问题？

当站点配置中配置了是否启用文档ID加密后，前台CMS的URL链接中的ID仍然无法，此时我们需要检查我们的伪静态配置，若启用文档ID加密，要求伪静态键archives/index对应的值中必须存在[:eid]，如下图：

CMS大数据有什么优化建议？

如果CMS有较大数据，建议开启后台站点配置中的缓存列表页总数选项，其次建议可以采用CDN缓存(由云服务商提供)或增加服务器配置。

如何整合和使用VIP会员插件？

CMS支持整合VIP会员插件(需安装VIP会员插件)，如果添加栏目时设定了VIP限制，则该栏目下的所有文章查看权限，对拥有对应VIP或高于对应VIP的用户均可查看，低于或不是VIP的用户无法查看。

如何启用首页和列表页下拉滚动条底部自动加载？

在首页和列表页默认下拉滚动条到底部时不会启用自动加载功能，除了修改后台站点配置中的加载模式为无限加载模式外，还需要修改模板视图index.html或list_xxx.html的模板，找到{include file="common/pageinfo" /}分页模板标签，添加autoload="true"属性即可，如{include file="common/pageinfo" autoload="true" /}

如何自定义404页面？

在CMS中默认找不到文章或栏目时提示的是未找到指定文章或未找到指定栏目，如果我们希望找不到文章或栏目时自定义404页面，可以修改addons/cms/controller/Archives.php和addons/cms/controller/Channel.php中的$this->error(__('No specified article found'));或$this->error(__('No specified channel found'));，改成abort(404,'页面不存在');，然后参考FastAdmin文档自定义404页面显示模板的配置修改即可，文档：https://doc.fastadmin.net/doc/faq.html#toc-51

为什么前台顶部导航只显示二级导航？

这是由于默认模板中默认为二级导航，如有多级导航，可修改addons/cms/view/default/common/layout.html大概第63-73行之间，将

{cms:channellist id="nav" type="top" condition="1=isnav"}
...省略
{/cms:channellist}

替换为

{cms:nav maxlevel="4" cache="86400" /}

其中maxlevel为需要显示的导航栏目层级数

为什么升级到V2.x.x版本后没有原生小程序的功能？

从V2.0.0版本开始已经移除原生小程序，如需使用原生小程序，请下载使用V1.x.x版本

为什么后台内容管理没有副表数据管理按钮？

从V2.0.0版本开始已经移除副表数据管理功能，副表数据统一整合到内容管理列表，更快捷的管理数据，当左侧栏目只选中一项或选中的多项属于同一模型时，此时右侧将显示副表列，当左侧选中多项属于不同模型时，将只显示主表字段

为什么CMS后台没有自定义主表字段功能？

自定义主表字段功能从V2.0.0版本开始新增。

V2.0.0版本的数据表结构对比V1.5.23有什么变更？

请参考SQL：

ALTER TABLE `fa_cms_archives` CHANGE `status` `status` ENUM('normal','hidden','draft','prepare','rejected','pulloff')  CHARACTER SET utf8mb4  COLLATE utf8mb4_general_ci  NOT NULL  DEFAULT 'normal'  COMMENT '状态';
ALTER TABLE `fa_cms_fields` ADD COLUMN  `favisible` varchar(1500) DEFAULT '' COMMENT '显示条件' AFTER `setting`;

升级到v2.0.x版本后备案信息不显示？

CMS 2.0.2默认模板通过区块调用beian名称进行显示备案信息，请在区块管理中添加一个名称为beian的记录，内容输入相应的文字和链接即可，请参考演示站：https://cms.demo.fastadmin.net/admin.php/cms/block?ref=addtabs

微信小程序端是否支持video视频和audio音频标签？

video支持
audio不支持

如何修改CMS PC版前端默认模板页面CSS样式？

CMS PC版前端默认模板页面样式使用/assets/addons/cms/css/common.css样式文件，修改后请注意清缓浏览器缓存。

如何关闭PC前台右下角浮动按钮？

PC前台右下角浮动按钮，除了可以修改模板addons/cms/view/default/common/layout.html来移除外，还可以按以下方式进行关闭。

为什么前台下载详情页下载按钮不显示 ？

前台默认下载模板中下载按钮调用的是下载模型中的自定义字段下载地址(downloadurl)，请检查对应内容的下载地址(downloadurl)字段是否录入数据。
默认下载地址中的来源列支持以下类型数据

你也可以在站点配置->下载类型字典中自定义下载类型

为什么前台产品详情页轮播图片不显示？

前台默认产品(图片)模板中的轮播图调用的是产品模型中的自定义字段产品列表(productdata)，而不是调用的组图(images)字段，因此请检查对应内容的产品列表(productdata)字段数据是否录入数据。

为什么使用百度云进行内容审核时始终是待审核状态？

正常情况下，配置百度云审核后可以正常调用百度云API接口进行审核判断，百度云控制台也有相应的数据，如果使用百度云进行内容审核时始终是待审核状态，建议按以下进行排查：

如果以上都排查正确，请前往百度云内容审核平台找到文本进行在线测试是否正常：https://ai.baidu.com/censoring#/audit/online

如何在CMS前台页面向自定义表单提交数据？

由于CMS中自定义表单使用了大量的自定义组件，因为无法直接在CMS其它页面(如首页、文章详情页)引用，如果我们需要创建自定义表单，页面及组件需自行设计，然后将自定义表单的数据提交到{:addon_url('cms/diyform/post')}即可，示例如下：

<form action="{:addon_url('cms/diyform/post')}" method="POST">
        <input type="hidden" name="__diyname__" value="message">
        {:token()}
        
        名称：<input type="text" name="row[name]" />
        内容：<textarea name="row[content]"></textarea>
        更多字段...
        
        以下是验证码相关，如果自定义表单未启用验证码则无需使用
        <input type="text" name="captcha" />
        <img src="{:captcha_src()}" width="100" height="31" onclick="this.src = '{:captcha_src()}?r=' + Math.random();"/>
        
        <button type="submit">提交</button>
</form>

其中__diyname__的值为自定义表单的自定义名称
其中row[name]和row[content]为自定义字段的名称，名称必须使用row[]包裹，如：row[名称]
其中captcha的值为验证码的值，如果自定义表单未启用验证码则无需使用

为什么自定义字段没有动态显示功能？

动态显示功能是2.0.0+版本新增功能，请做好备份更新升级至新版本重试。

CMS的favicon图标如何修改？

CMS中默认模板布局模板中引用的是__CDN__/assets/img/favicon.ico文件，如需修改，请自行修改public/assets/img/favicon.ico即可。

如何关闭前台会员中心用户投稿功能？

1、如果你需要完全关闭会员中心，请参考FastAdmin框架文档：https://doc.fastadmin.net/doc/faq.html#toc-42
2、如果你仅需要关闭会员中心的发布文档边栏选项，请在后台CMS管理->站点配置->会员中心边栏模块关闭即可，注意此时只是会员中心移除边栏链接，链接仍可以访问，如果希望完全移除会员中心发布文档的功能，你可以自行二次开发修改或移除application/index/controller/cms/Archives.php中的post方法。
3、如果是Uniapp版本，还需要修改或移除addons/cms/controller/api/Archives.php中的archives_post方法。

文档定时发布功能设定为定时任务模式时为何不生效？

从2.0.0版本开始新增定时发布文档功能，后台配置支持修改定时发布判断模式，如果此时修改为定时任务模式时，还需要添加定时任务才会生效。
如果使用宝塔面板，请添加定时任务，类型为shell脚本，脚本内容为：

sudo -u www /usr/bin/php /www/wwwroot/www.example.com/public/index.php /addons/cms/autotask/index

如果使用Linux的Crontab定时任务，请添加以下定时任务。

* * * * * sudo -u www /usr/bin/php /www/wwwroot/www.example.com/public/index.php /addons/cms/autotask/index > /dev/null  2>&1 &

为何2.0.0+版本，在文档数量过多时会出现打开响应慢？

这是由于从2.0.0版本开始新增文档定时发布功能，默认检测模式为前台用户模式，也就是前台每次页面的打开都会去判断是否需要发布定时文档，如果不需要定时发布或暂时关闭定时发布，请在后台配置->定时发布判断模式为定时任务模式即可。

关于频道页焦点图显示被放大裁切的原因和解决办法

在CMS中的频道页焦点图默认模板调用的是添加了标志为焦点的文档的缩略图，为了保证在显示时图片比例不被压缩，通过CSS采用了放大裁切的方式在铺满显示区域，当上传的缩略图不是16:9时就会被放大和裁切。解决方案：
1、在后台CMS模型管理中自定义主表字段，添加一个自定义字段，如名称：focusimage、标题：焦点图、字段类型：图片，专门用于存储文档焦点图
2、修改前台频道页模板，找到addons/cms/views/default/所有以channel开头的模板，将大概第29行的{$item.image|htmlentities}修改为{$item.focusimage|cdnurl|htmlentities}
3、在后台添加和编辑文档时在焦点图一栏上传16:9的图片即可。

为什么详情页点击用户头像无法打开对应链接？

如果在内容详情页点击用户头像报错：模块不存在:u时，通常是由于我们修改了后台CMS管理->站点配置->伪静态中user/index对应的规则导致。默认情况下user/index对应的是/u/[:id]。
解决办法有两种：
1、还原伪静态配置中user/index对应的伪静态规则为/u/[:id]。
2、如果想自定义user/index的规则，除了修改后台伪静态配置外，还需要修改application/common/model/User.php中getUrlAttr方法中对应的链接。

CMS目前微信支付使用的是V2支付还是V3支付接口？

CMS目前使用的是V2接口，暂不支持切换微信V3支付。请在《微信支付宝整合插件》配置中填写微信支付商户API密钥V2即可。

站点配置中点击确定按钮报错？

如果在CMS管理->站点配置中点击确定按钮报错，请检查addons/cms/config.php文件是否有读写权限，点击确定会保存配置，如果相应的文件没有读写权限，则会导致报错。

CMS前台PC端顶部的搜索如何限制栏目或限制模型搜索？

默认模板中顶部搜索的是全部文档，如果需要限制栏目或限制模型来搜索，可以参考以下方式修改搜索表单action的值。