首页是用户访问你网站时看到的第一屏，它的表现直接决定了用户是否愿意留下来继续浏览。MiPlus 的首页采用模块化设计，你可以像搭积木一样自由组合各种功能模块。但模块多了，配置选项也多了，你可能会问：”这么多设置项，到底该怎么搭配才能发挥最大效果？”别急，下面我们一步步来拆解。
1. 首页侧边栏
在开始配置首页模块之前，你需要先做一个重要决定：是否启用首页侧边栏。
在”首页设置”面板的最上方，你会看到”首页侧边栏”这个开关，默认是关闭状态。你可能会问：”开启侧边栏有什么好处？”开启后，首页主内容的右侧会多出一块侧边栏区域，你可以在这里展示积分打卡排行、最新注册用户、实时动态、热门文章等信息。这些动态内容能让你的首页看起来更有活力，用户一进来就能感受到社区的活跃氛围。
但开启侧边栏也有代价——它会占用首页的横向空间，导致主内容区域的宽度变窄。所以你需要根据网站类型来决定。比如资源分享站，用户更关注内容本身，侧边栏可能会分散注意力；而社区类网站，侧边栏的互动信息反而能促进用户参与。
开启侧边栏后，你需要到后台”外观 → 小工具”中，找到”首页主侧边栏”这个区域，把想要展示的小工具拖拽进去。系统提供了积分打卡、最新注册、实时动态、文章作者等多种小工具供你选择。
这里有一个非常重要的注意事项：积分打卡、最新注册、实时动态这三个小工具，在模块小工具和首页主侧边栏中只能分别启用一个，不能同时出现在两个地方。什么意思呢？比如你的首页有一个文章模块开启了模块小工具，并且在这个模块小工具中放了积分打卡，那么首页主侧边栏中就不能再放积分打卡了。这一点一定要记住，否则会导致显示异常。
2. 首页模块缓存
缓存是提升首页加载速度的关键手段，但很多开发者往往忽略了它的重要性。你可能会问：”我的网站访问量不大，有必要开缓存吗？”其实缓存不仅仅是为了应对高并发，它还能显著提升用户体验——页面加载速度每快一秒，用户留存率就提升一大截。
2.1 首页模块缓存开关
在”首页设置”面板中，第一个选项就是”首页模块缓存”，默认是开启状态。建议你保持开启，不要关闭。
开启后，系统会自动缓存每个首页模块的渲染结果。当用户访问首页时，直接从缓存中读取数据，不再需要查询数据库，加载速度会大幅提升。特别是对于文章模块这种需要查询数据库的模块，缓存的效果尤为明显。
2.2 清除首页所有模块缓存
当你修改了首页模块的内容后（比如新增了文章、调整了模块配置），前端可能不会立即看到变化，因为缓存还在生效。这时候你需要手动清除缓存。
在”首页设置”面板中，找到”清除首页所有模块缓存”这个开关，把它打开，然后保存设置。系统会自动清除所有首页模块的缓存。清除完成后，建议你再把这个开关关闭，避免每次保存都触发清除操作。
2.3 缓存的工作原理
你可能会好奇：”这个缓存到底是怎么工作的？”让我给你简单解释一下。
MiPlus 的缓存系统支持两种模式：对象缓存和 Transient 缓存。
如果你的服务器安装了 Redis 或 Memcached 这类对象缓存插件，系统会自动检测到并使用对象缓存。对象缓存的优势在于：它存储在内存中，读写速度极快，而且支持批量获取和按组清除。系统会使用以下四个缓存组来管理首页数据：
mi_index：首页整体缓存，存储首页的完整渲染结果。
mi_module_posts：文章模块缓存，存储每个文章模块的文章数据。
mi_module_categories：分类模块缓存，存储分类模块的分类数据。
mi_module_tags：标签模块缓存，存储标签相关的数据。
如果服务器没有安装对象缓存插件，系统会自动降级为 WordPress 的 Transient 机制。Transient 存储在数据库中，速度虽然不如 Redis，但相比直接查询文章表还是要快得多。
所以，如果你想获得最佳的首页加载速度，强烈建议你安装 Redis 对象缓存插件。安装后，系统会自动切换使用 Redis，你不需要做任何额外的配置。
2.4 缓存与 WebP 图片的配合
在”全局设置”中有一个 WebP 图片质量的设置项。当你调整了 WebP 质量后，需要清除首页缓存才能看到效果。操作步骤是：先设置好 WebP 质量，然后到首页设置中开启”清除首页所有模块缓存”，刷新首页页面确认效果，最后再关闭清除缓存开关。
3. 首页模块管理
首页模块是首页的核心组成部分。在”首页设置”面板中，找到”首页模块”区域，点击”添加首页模块”按钮，就可以开始创建模块了。你可以添加任意数量的模块，每个模块都可以独立配置。
3.1 模块通用设置
每个模块都包含以下通用设置项，无论你选择什么类型的内容，这些设置都会出现。
模块标题：给这个模块起个名字。比如你添加一个文章模块，可以取名为”最新资讯”或”热门推荐”。在某些模块样式下，这个标题会显示在模块顶部。
模块Key：给这个模块起一个唯一的标识。这个值必须使用纯小写英文字母，不要有空格或特殊字符。比如你可以用”zixun”或”tuijian”这样的值。这个 Key 非常重要，因为它和模块对应的小工具挂钩。即使你调整了模块的顺序，只要 Key 不变，小工具的设置就不会丢失。但如果你修改了 Key，对应的小工具就需要重新设置了。同时，这个 Key 也控制着排版比例的大小，所以建议一开始就想好，后续不要随意改动。
模块描述：一段简短的描述文字，在某些模块样式下会显示在标题下方，用来补充说明模块的内容方向。
是否显示模块描述：默认开启。开启后，模块描述会显示在标题下方。
是否新窗口打开：默认关闭。如果开启，点击模块中的链接会在新标签页中打开。如果你的网站链接到外部站点，建议开启这个选项。
3.2 调用内容类型
每个模块最关键的设置就是”调用内容”，它决定了这个模块展示什么类型的内容。系统提供了六种类型供你选择。
幻灯片：在首页顶部展示轮播幻灯片，适合展示精选内容或重要公告。选择后会出现幻灯样式、幻灯信息、幻灯片高度等专属设置。
自定义：通过自定义 HTML 或 PHP 代码来展示任意内容，灵活性最高。适合放置广告、自定义横幅等。
专题：展示专题分类下的文章集合，适合做内容聚合，比如”精选合集”、”热门推荐”等。
文章：按分类展示文章列表，这是最常用的模块类型。提供丰富的样式和排序选项。
分类：展示分类目录导航，方便用户浏览不同分类。
搜索：展示搜索横幅，帮助用户快速找到内容。
当你选择不同的调用内容时，下方的配置选项会自动切换，只显示与当前类型相关的设置项。下面我们分别来看每种类型的详细配置。
3.3 幻灯片模块配置
幻灯片是首页最显眼的位置，用于展示你最重要的内容。选择”幻灯片”作为调用内容后，你会看到以下设置项。
幻灯样式：系统提供了五种不同的幻灯样式，每种样式都有独特的视觉效果。你可以通过图片选择的方式直观地看到每种样式的预览图。
样式一：经典轮播式幻灯片，每次显示一张大图，自动轮播切换。适合展示高质量的图片内容。
样式二：多图组合式幻灯片，主图突出显示，辅图以缩略图形式排列。适合展示多篇重要内容。
样式三：卡片式幻灯片，以卡片形式展示内容，信息密度较高。
样式四：全幅宽屏幻灯片，图片铺满整个屏幕宽度，视觉冲击力最强。
样式五：独特布局的幻灯片，适合有特定设计需求的网站。
如果你不确定选哪个，可以先使用默认的样式一，后续随时可以切换。
幻灯信息：这是幻灯片的核心内容设置。点击”添加幻灯”按钮，你可以添加多张幻灯片。每张幻灯片包含以下设置。
链接调用方式：选择点击幻灯片时跳转到哪里。有两种方式可选。
自定义链接：点击后跳转到你指定的任意网址。选择后需要填写标题和自定义链接地址。
文章ID：点击后跳转到指定的文章页面。选择后需要填写文章ID编号。
幻灯图片：上传幻灯片的展示图片。建议使用高质量的宽幅图片。
根据你选择的幻灯样式，需要添加的幻灯数量也不同。一般来说，建议添加至少6个幻灯，否则某些样式可能显示不全。
幻灯文章信息：这是一个开关，默认关闭。开启后，幻灯片上会显示文章的作者、标题和发布时间等信息。
幻灯片的高度：默认为450px。你只需要填写数字即可，不需要带px单位。比如你觉得450px太矮了，可以试试600或700。
3.4 文章模块配置
文章模块是首页最常用的模块类型，选择”文章”作为调用内容后，你会看到丰富的配置选项。
列表样式：系统提供了五种不同的文章列表样式，每种样式都有预览图供你参考。
样式一：普通卡片式排版。最经典的文章展示方式，每篇文章以卡片形式呈现，包含缩略图、标题和摘要。适合大多数网站类型。
样式二：瀑布流卡片式排版。卡片高度不固定，以瀑布流形式排列，视觉效果灵动自然。适合图片类、设计类网站。
样式三：列表文章排版。文章以列表形式排列，缩略图在左侧，文字在右侧。信息密度高，适合资讯类网站。
样式四：图片背景流排版。卡片以图片为背景，文字叠加在图片上，视觉效果更加突出。
样式五：文字流文章排版。纯文字形式的卡片，不显示缩略图，加载速度最快。
样式六：另一种图片背景流排版，与样式四类似但布局不同。
排序方式：选择文章在模块中的排列顺序。
最新文章：按发布时间从新到旧排列，让用户第一时间看到最新内容。
浏览最多文章：按阅读量从高到低排列，展示最受欢迎的内容。
评论最多文章：按评论数从高到低排列，展示讨论最热烈的内容。
是否显示文章类别：默认开启。开启后，文章卡片上会显示文章的类型标签，分为三种：下载、图文、视频。这样用户在点击之前就能知道这篇文章是什么类型。
每行显示的数量：默认为4。设置每行显示的文章数量，系统会以此为基础进行排版计算。比如你填写5，实际计算后的排版可能会显示4个，这是为了保持布局的美观性。
文章描述显示的行数：默认为1。设置文章摘要显示的行数，超过行数的内容会被截断。
文章数量：默认为8。设置模块中显示的文章总数。
缩略图比例：默认为16/9。设置文章缩略图的宽高比例。你可以填写16/9、4/3、1/0.618等比例值。需要注意的是，如果缩略图设置为高度自适应，这个比例就不生效了。对于列表布局（样式三），建议填写2/1。
显示分类：选择要展示哪些分类下的文章。这是一个多选下拉框，支持搜索和拖拽排序。如果不选择，则显示全部分类的文章。需要注意的是，分类别名请勿使用中文，否则可能无法正确加载文章。
是否显示文章摘要：默认开启。开启后，文章卡片上会显示文章摘要内容。
3.5 专题模块配置
专题模块用于展示专题分类下的文章集合，适合做内容聚合。
列表样式：系统提供了两种专题列表样式。
样式一：大图加文章卡片式排版。上方显示专题的大图，下方显示该专题下的文章列表。
样式二：大图加三小图排版。上方显示专题的大图，下方以三张小图展示文章。
显示专题：选择要展示哪些专题分类。这是一个多选下拉框，支持搜索和拖拽排序。同样需要注意，专题分类别名请勿使用中文。
每行显示的专题：默认为4。设置每行显示多少个专题。
专题显示的文章数量：默认为5。设置每个专题下显示多少篇文章。如果你选择了样式一（大图加文章卡片式），这个参数是必填的。
缩略图比例：默认为16/9。设置专题缩略图的宽高比例。
3.6 分类模块配置
分类模块用于展示分类目录导航，方便用户浏览不同分类下的内容。
分类样式：系统提供了两种分类展示样式。
样式一：标准分类卡片式，以卡片形式展示每个分类。
样式二：另一种分类卡片布局，展示方式略有不同。
显示分类：选择要展示哪些分类。这是一个多选下拉框，支持搜索和拖拽排序。
分类每行显示数量：默认为5。这里有一个需要注意的地方：当启用了首页侧边栏时，实际显示的行数量是当前值减2；否则是当前值加1。系统会自动计算，你不用担心。
缩略图比例：默认为3/4。设置分类缩略图的宽高比例。
3.7 自定义模块配置
自定义模块给了你最大的自由度。选择”自定义”作为调用内容后，会出现一个”自定义代码内容”文本框。你可以在这里输入任意的 HTML 或 PHP 代码。
默认的示例代码是一个图片广告容器，点击跳转到指定链接。你可以把它替换成自己的广告代码、自定义 HTML 结构，甚至是 PHP 代码。如果填入 PHP 代码，请不要忘记加上 <?php 和 ?> 符号。
图片可以在媒体库中选择上传，然后复制图片链接地址填入代码中。
3.8 搜索模块配置
选择”搜索”作为调用内容后，模块会显示一个搜索横幅。这个搜索横幅的配置和”是否启用大图搜索”是独立的，你可以同时使用两个搜索功能，也可以只用一个。
搜索模块的配置项和大图搜索类似，包括搜索标题、描述、背景图片、搜索分类和热门标签等。具体配置方法可以参考搜索横幅的详细文档。
3.9 模块小工具
对于”文章”类型的模块，你还可以开启小工具功能。这是一个开关，默认关闭。
你可能会问：”模块小工具和首页主侧边栏有什么区别？”区别在于位置。首页主侧边栏是固定在首页右侧的，所有页面共享。而模块小工具是嵌入在文章模块内部的，只在该模块区域内显示。
开启模块小工具后，保存设置，然后去后台”外观 → 小工具”中，你会看到一个名为”首页模块: [你的模块标题]”的小工具区域。你可以在这里添加各种小工具，它们会显示在该文章模块的右侧或内部。
需要注意的是，模块小工具对幻灯片类型无效。而且前面提到过，积分打卡、最新注册、实时动态这三个小工具在模块小工具和首页主侧边栏中只能分别启用一个。
3.10 模块排序建议
通过拖拽模块卡片，你可以自由调整各模块在首页的显示顺序。下面给你一些常见的排序方案。
资讯博客：幻灯片 → 文章模块（最新文章排序）→ 分类模块。幻灯片吸引眼球，最新文章展示内容，分类模块方便导航。
资源分享站：幻灯片 → 文章模块（浏览最多排序）→ 专题模块。幻灯片展示精选资源，浏览最多展示热门资源，专题模块做内容聚合。
个人博客：文章模块（列表样式）→ 自定义模块。列表样式信息密度高，自定义模块可以放个人介绍或广告。
图片或设计站：文章模块（瀑布流样式）→ 专题模块。瀑布流展示图片效果最好。
综合门户：幻灯片 → 多个文章模块（不同分类）→ 热门推荐专题。多个分类模块覆盖不同内容领域。
首页模块建议不要开启太多，三到五个模块最为合适。过多会影响页面加载速度，也会让用户感到眼花缭乱。
4. 搜索横幅
搜索横幅是首页顶部的一个大型搜索区域，它独立于首页模块，是一个全局功能。
4.1 开启搜索横幅
在”首页设置”面板中，找到”是否启用大图搜索”选项，默认是关闭状态。开启后，搜索横幅会显示在首页所有模块的最上方，作为一个独立的搜索区域。
4.2 搜索标题设置
开启搜索横幅后，你可以设置搜索框上方显示的大标题。默认的标题是”MiPlus·模块化构建”。你可以把它改成符合你网站风格的标题文字，比如”发现你需要的资源”或”探索无限可能”。标题会以大号字体居中显示在搜索框上方，建议文字简洁有力，控制在十个字以内。
4.3 搜索描述内容
在标题下方，你还可以添加一段描述文字。默认的描述是”礁不是障碍，而是提醒你：真正的航道，需要慢下来才能看清。”这段描述文字会以较小的字体显示在标题下方，用来补充说明你的网站定位或品牌理念。
4.4 搜索背景图片
你可以为搜索横幅设置一张背景图片。建议使用宽幅图片，分辨率在1920×1080以上，避免在高分辨率屏幕上出现拉伸或模糊。背景图的风格最好与网站的整体色调协调。
4.5 搜索分类设置
你可以设置搜索框的搜索范围。这是一个多选下拉框，支持搜索和拖拽排序。如果不选择任何分类，搜索范围默认为全站内容。如果选择了特定分类，搜索框将只在这些分类范围内进行搜索。
4.6 热门标签设置
搜索框下方可以显示一些热门搜索标签，帮助用户快速了解网站的热门内容。这是一个多选下拉框，你可以从已有的标签中选择想要展示的热门标签。开启后，这些标签会以按钮形式显示在搜索框下方，用户点击标签即可快速搜索相关内容。热门标签数量建议设置六到十个。
5. 首页侧边栏与模块侧边栏的搭配使用
这是很多开发者容易混淆的地方，我们来详细说明一下。
5.1 两种侧边栏的区别
首页侧边栏（首页主侧边栏）：位于首页右侧的固定区域，通过”首页设置”中的”首页侧边栏”开关控制。开启后，到”外观 → 小工具”中的”首页主侧边栏”区域添加小工具。
模块侧边栏（模块小工具）：嵌入在文章模块内部的侧边栏，通过每个文章模块的”小工具”开关控制。开启后，到”外观 → 小工具”中对应的”首页模块: [模块标题]”区域添加小工具。
5.2 搭配方案
方案一：只开启首页侧边栏，不开启模块小工具。
适合内容类型单一的网站，比如纯资讯博客。所有小工具统一显示在首页右侧，管理起来也方便。
方案二：只开启模块小工具，不开启首页侧边栏。
适合希望首页主内容区域更宽的网站。比如资源分享站，用户更关注内容列表，侧边栏信息放在文章模块内部即可。
方案三：同时开启首页侧边栏和模块小工具。
适合内容丰富的大型网站。首页侧边栏展示全局信息（如积分打卡、最新注册），模块小工具展示与当前模块相关的信息（如该分类下的热门文章）。
方案四：都不开启。
适合极简风格的网站，或者首页只放幻灯片和自定义模块的网站。
5.3 注意事项
积分打卡、最新注册、实时动态这三个小工具，在模块小工具和首页主侧边栏中只能分别启用一个。也就是说，如果你在首页主侧边栏中放了积分打卡，那么所有模块小工具中都不能再放积分打卡了。
模块小工具只对”文章”类型的模块有效，幻灯片、自定义、专题、分类、搜索类型的模块不支持模块小工具。
当你调整了模块的顺序或修改了模块 Key 后，记得检查对应的小工具设置是否还需要调整。
6. 首页配置的完整流程
说了这么多，你可能觉得有点乱。没关系，下面给你一个完整的配置流程，按照这个步骤来操作，就不会出错了。
第一步：确定首页布局方案。先想清楚你的网站类型是什么，需要展示哪些内容，要不要侧边栏。
第二步：配置基础设置。到”首页设置”面板中，先设置好首页侧边栏开关和缓存开关。
第三步：添加首页模块。点击”添加首页模块”按钮，按照你的布局方案依次添加各个模块。
第四步：配置每个模块。为每个模块设置标题、Key、调用内容类型，以及该类型下的专属配置。
第五步：配置搜索横幅。如果需要搜索横幅，开启”是否启用大图搜索”并设置相关参数。
第六步：配置小工具。根据你的侧边栏方案，到”外观 → 小工具”中为首页主侧边栏和模块小工具添加对应的小工具。
第七步：检查效果。保存所有设置后，访问首页前端查看效果。如果发现内容没有更新，到首页设置中开启”清除首页所有模块缓存”再保存一次。
第八步：持续优化。首页配置不是一次性的工作，你需要根据网站的运营数据和用户反馈，持续调整模块的组合和排序，找到最适合你网站的方案。
7. 常见问题
问：我修改了首页模块的内容，但前端没有变化，怎么办？
答：到”首页设置”中，开启”清除首页所有模块缓存”开关，保存设置。等前端刷新确认内容更新后，再关闭这个开关。
问：首页侧边栏和模块小工具都开启了，但某些小工具显示不正常，怎么办？
答：检查是否在首页主侧边栏和模块小工具中同时使用了积分打卡、最新注册或实时动态。这三个小工具不能同时出现在两个地方。
问：我修改了模块的 Key，之前的小工具设置还在吗？
答：不在了。修改模块 Key 后，对应的小工具区域会变成一个新的区域，之前的小工具设置需要重新添加。所以建议模块 Key 设置好后不要随意改动。
问：幻灯片显示不全，怎么办？
答：检查幻灯片的数量是否足够。根据你选择的幻灯样式，可能需要至少6张幻灯片才能完整显示。另外，检查幻灯片图片的分辨率是否足够，建议使用1920×1080以上的图片。
问：文章模块的分类选择器中找不到我的分类，怎么办？
答：检查分类的别名是否使用了中文。如果使用了中文别名，请修改为英文别名，否则可能无法正确加载。
问：安装了 Redis 插件后，首页缓存会自动使用 Redis 吗？
答：是的。MiPlus 的缓存系统会自动检测服务器是否安装了对象缓存插件（如 Redis、Memcached），如果检测到，会自动切换使用对象缓存，不需要你做任何额外的配置。
