克微 App 首页轮播图设置教程

轮播只出现在 首页 →「推荐」Tab 下方；未配置或全部清空后，App 不显示轮播。

一、前提条件

1. 站点已安装并启用 克微 APP 插件（emlog_client，建议 ≥ 1.2.3版本）
2. 插件目录含 app/home_banner/（有「首页轮播」Tab）
3. App 已配置api地址（API_PROXY_URL），能正常拉推荐流

二、后台入口

1. 登录 emlog 后台
2. 打开 插件 → 克微 APP / emlog_client → 设置
3. 点顶部 Tab：首页轮播

地址类似：

/admin/plugin.php?plugin=emlog_client&setting=1&bridge_tab=home_banner

三、添加一张轮播

1. 点 「+ 添加轮播」
2. 填写字段：

3. 可继续添加多张（最多 10 张）
4. 点 「保存」

保存成功后会提示已保存 N 张；App 下次进入「推荐」或下拉刷新即可看到。

四、图片怎么准备

推荐做法

1. 在 emlog 后台 媒体库 / 写文章上传图片，上传轮播图
2. 复制图片的公开访问地址，粘贴到「图片地址」

格式要求

• https://www.你的域名.com/.../banner.jpg（推荐）
• 或 /content/uploadfile/.../banner.jpg（以 / 开头的站内路径，插件会自动拼站点域名）

尺寸建议（经验值）

• 宽约 750～1125px，比例约 16:9 或 2.5:1，
• 文件尽量压缩，避免首屏加载慢

五、跳转链接怎么填

六、修改 / 删除 / 清空

• 改内容：改对应行的图片/链接/描述 → 保存
• 删一张：点该行 「删除」 → 保存
• 整页不显示轮播：删掉所有行（或全部留空）→ 保存；提示清空后，App 不再显示轮播

七、在 App 里怎么确认

1. 打开克微 App → 底部 首页
2. 切到顶部 「推荐」（不是「最新 / 关注 / 排行榜」）
3. 信息流上方应出现轮播；多图会自动滑动，底部有圆点
4. 若刚改过后台：在推荐页 下拉刷新，或杀进程重进

注意：轮播 只在「推荐」Tab 显示，其它 Tab 看不到是正常的。

八、常见问题

Q：保存了但 App 没有？

• 是否在「推荐」Tab
• 插件版本是否含 home_banner
• 图片地址能否在手机浏览器直接打开（防盗链 / 404）
• App 是否连的是同一站点桥接

Q：图裂了？

• 地址必须是 App 能访问的公网 URL
• 不要用需登录才能看的后台私有地址

Q：点了没反应？

• 「点击跳转」是否留空
• 链接是否合法（须 http:// / https:// 或 / 开头站内路径）

Q：最多几张？

• 10 张；超出保存会报错