苹果CMS熊掌号适配完整实操配置指南 新手零门槛一步落地

前置准备工作

你需要提前准备好以下内容，避免操作中途卡壳：

• 已经部署完成、可正常访问的苹果CMS程序（本文以主流的V10版本为例，V8版本操作逻辑完全一致）
• 已经通过百度熊掌号资质审核，获取到熊掌号ID、APPID和站点验证代码
• 拥有网站服务器的文件修改权限，可通过FTP、主机面板或宝塔面板修改模板与配置文件

第一步：添加熊掌号基础配置项

找到核心配置文件

通过文件管理工具打开苹果CMS根目录下的application/config.php文件，在文件末尾的返回数组之前，也就是return [之后，添加以下配置代码，直接替换占位内容即可：

``` // 熊掌号基础配置 'xiongzhang_id' => '替换成你的熊掌号ID', 'xiongzhang_appid' => '替换成你的熊掌号APPID', ```

修改完成后保存配置文件，上传覆盖原文件即可，这一步是为后续结构化数据输出提供基础信息。

第二步：添加熊掌号站点授权标识

修改模板公共头部文件

苹果CMS的公共头部文件存放在当前使用的模板目录中，路径为：template/你的当前模板名称/header.html，打开该文件后，在标签内部任意位置，添加以下代码，替换对应内容：

``` ```

保存文件后覆盖上传，这一步用于完成百度熊掌号对你网站的所有权验证。

第三步：添加熊掌号要求的结构化数据

在内容页模板插入JSON-LD代码

熊掌号要求内容页必须添加符合Schema规范的结构化数据，才能被正常收录，操作如下：

如果你是视频站，打开当前模板的内容播放页文件，路径为：template/你的模板名/movie/play.html；如果你是文章站，打开文章内容页文件，路径为：template/你的模板名/article/show.html。找到文件末尾标签之前的位置，添加对应代码：

视频模型使用以下代码，可直接复制：

``` ```

文章模型使用以下代码，可直接复制：

``` ```

添加完成后保存文件，覆盖上传即可，所有新发布的内容会自动输出结构化数据，不需要重复修改。

第四步：配置URL规则适配熊掌号收录

登录你的苹果CMS后台，访问路径为你的域名/admin.php，依次点击系统 -> 系统配置 -> URL设置，勾选“启用伪静态”选项，保存配置。

根据你的服务器类型，添加对应的伪静态规则：

Nginx服务器规则

打开宝塔面板的站点配置文件，在server块中添加以下规则，保存后重启Nginx：

``` location / { if (!-e $request_filename){ rewrite ^/index.php(.)$ $1 break; rewrite ^/(.)$ /index.php/$1 last; } } ```

Apache服务器规则

确认网站根目录下存在.htaccess文件，如果不存在，新建文件后复制以下内容保存即可：

``` RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.)$ index.php/$1 [QSA,PT,L] ```

第五步：熊掌号后台提交适配验证

完成上述代码配置后，登录百度搜索资源平台进入你的熊掌号管理后台，按以下步骤操作：

• 进入设置 -> 站点验证，确认验证方式为HTML标签验证，复制验证代码，替换第二步你添加到header.html中的meta标签content内容，保存后重新提交验证
• 验证通过后，进入内容适配 -> URL适配，添加适配规则，示例：如果你的内容页URL格式为https://你的域名/play/123.html，那原站URL规则填写https://你的域名/play/，熊掌号URL格式填写https://xiongzhang.baidu.com/s?wd=
• 提交适配规则后，等待百度审核即可，一般1-3个工作日即可完成审核。

常见问题排查

1. 站点验证不通过

检查meta标签是否放在head标签内部，有没有被注释，验证代码有没有多复制空格或者符号，修改后等待10分钟再重新提交即可。

2. 结构化数据检测不通过

打开内容页查看网页源代码，确认JSON-LD代码已经正常输出，没有出现变量乱码或者格式错误，我们提供的代码已经做好格式处理，不要随意修改引号和括号即可。

3. 适配提交后长期不生效

检查伪静态配置是否正确，确保内容页可以直接通过静态URL访问，不需要跳转，你可以在搜索资源平台主动提交sitemap，加快百度抓取适配进度，一般7-15天即可完全生效。

完成以上所有步骤后，你的苹果CMS就完成了全量熊掌号适配，所有新发布的内容都会自动符合熊掌号的收录要求，不需要额外操作。