书城配置管理使用说明

入口

App管理 - Android/iOS配置 - 包列表 - 书城配置

功能概述

书城配置管理页面用于配置应用书城的展示内容，包括书城、男生、女生三个个分类的模块配置，新增支持导入导出配置功能。

页面功能

1. 其他配置

基础配置选项

• 排行榜： 设置ios书城排行榜的数据来源

2. 书城配置详情

配置结构

页面包含三个主要分类：

• 书城： 通用书城页面配置
• 男： 男生分类页面配置
• 女： 女生分类页面配置

每个分类包含7个模块，每个模块可独立配置以下参数：

模块配置参数

基础信息

• 标签名： 模块显示的标题名称
• 小标签： 模块的副标题或描述文字

样式配置

• 样式： 选择模块的展示样式类型
  • 不同样式对应不同的UI布局和展示效果
  • 书单样式必须配置书单源

数据配置

• 来源： 选择数据来源类型
  • 不同来源对应不同的数据获取方式
• 数据： 根据来源选择具体的数据类型
  • 选择来源后会自动更新可用的数据类型选项，推荐使用本地App、起点、掌阅、番茄、追书神器数据源，后面四个数据源可以在书籍管理-排行列表-各大排行榜处查看具体的书籍和更新时间。其余数据源目前不能自动更新。
    
• 条数： 设置该模块显示的书籍数量（默认6条）

功能配置

• 查看更多： 是否显示”查看更多”按钮
  • 开启：显示查看更多功能
  • 关闭：隐藏查看更多功能

推荐书籍

• 推荐书籍： 手动指定该模块显示的书籍ID
  • 多个书籍ID用逗号分隔
  • 留空则使用数据来源的自动推荐

使用流程

1. 配置书城模块

1. 选择要配置的分类（书城/男/女）
2. 为每个模块配置以下参数：
   • 输入标签名和小标签
   • 选择模块样式
   • 选择数据来源和数据类型
   • 设置显示条数
   • 配置查看更多功能
   • 输入推荐书籍ID（可选）

2. 保存配置

1. 检查所有配置项
2. 点击”提交”按钮保存配置
3. 等待10分钟，确认配置生效

3. 导入导出配置

导出配置

1. 点击”导出配置”按钮
2. 系统自动生成JSON格式配置文件
3. 文件自动下载到本地

导入配置

1. 点击”导入配置”按钮
2. 选择之前导出的JSON配置文件
3. 系统自动填充所有配置项
4. 检查配置是否正确
5. 点击”提交”保存配置

配置说明

数据来源类型

• 不同数据来源对应不同的数据获取逻辑
• 选择数据来源后，数据类型选项会自动更新
• 常见数据来源包括：热门推荐、最新更新、分类推荐等
• 书单来源的样式必须也是书单

样式类型

• 不同样式对应不同的UI展示效果
• 样式影响模块的布局、图片大小、文字排列等
• 根据内容类型选择合适的样式

推荐书籍配置

• 手动指定书籍ID可以精确控制模块内容
• 多个书籍ID用逗号分隔，如：123,456,789
• 留空则使用数据来源的自动推荐算法

模块数量限制

• 每个分类最多支持7个模块
• 模块按顺序从上到下显示
• 可以根据需要启用或禁用某些模块

注意事项

1. 配置保存： 修改配置后必须点击”提交”按钮保存
2. 数据来源选择： 选择数据来源后会自动更新数据类型选项
3. 书籍ID格式： 推荐书籍ID必须用逗号分隔，不能有空格
4. 条数限制： 显示条数建议不超过10条，避免页面加载过慢
5. 样式选择： 根据内容类型选择合适的样式，确保最佳展示效果
6. 导入配置： 导入的配置文件必须是之前导出的JSON格式
7. 模块顺序： 模块按配置顺序显示，注意调整重要模块的位置
8. 数据一致性： 确保数据来源和数据类型的选择合理匹配

常见问题

Q: 如何为不同分类配置不同的内容？
A: 在页面中分别配置书城、男、女三个分类的模块，每个分类可以有不同的标签名、数据来源和推荐书籍。

Q: 如何设置推荐书籍？
A: 在”推荐书籍”字段中输入书籍ID，多个ID用逗号分隔，例如：123,456,789

Q: 如何在书城显示书单？
A: 样式选择书单、数据来源也选择本地数据-app 书单，推荐ID输入对应书单的ID。

Q: 如何导出当前配置？
A: 点击页面顶部的”导出配置”按钮，系统会自动下载JSON格式的配置文件。

Q: 如何导入之前的配置？
A: 点击”导入配置”按钮，选择之前导出的JSON文件，系统会自动填充所有配置项。

Q: 如何设置模块的显示顺序？
A: 模块按配置顺序从上到下显示，可以通过调整配置顺序来控制显示顺序。

Q: 如何隐藏某个模块？
A: 可以将该模块的标签名清空，或者将条数设置为0。

Q: 配置保存后多久生效？
A: 配置保存后通常需要10分钟才会生效，如果有cdn可能需要更长时间。

Q: 如何备份配置？
A: 定期使用”导出配置”功能备份当前配置，以便需要时恢复。