Puput 侧边栏小部件定制指南热门文章、标签云与归档一网打尽【免费下载链接】puputA Django blog app implemented in Wagtail项目地址: https://gitcode.com/gh_mirrors/pu/puputPuput 是一个基于 Wagtail 构建的 Django 博客应用开箱即用地提供搜索框、最新文章、热门文章、分类、标签云与日期归档等完整侧边栏小部件。本文是一份面向新手的 Puput 侧边栏小部件定制指南手把手教你用最快方法开关小部件、调整显示数量、理解热门文章与标签云背后的排序逻辑让你的 Wagtail 博客侧边栏既好看又好用。Puput 侧边栏有哪些内置小部件默认情况下Puput 博客的右侧栏模板位于 base.html从上到下依次渲染站内搜索框基于 Wagtail 全文搜索无需额外配置最新文章Last Entries按发布日期倒序展示最近文章热门文章Popular Entries按评论数与日期综合排序分类列表Categories展示一级分类标签云Tags按使用频率排序的标签列表日期归档Archive按年份、月份折叠展示每个小部件的显示开关、标题和排序逻辑都对应 abstracts.py 中的display_*字段改动非常灵活。最快配置方法后台一键开关小部件Puput 把侧边栏开关集中放进了 Wagtail 后台无需改一行代码进入 Wagtail 管理后台打开你的 BlogPage 编辑页切换到「Settings」选项卡找到Widgets小部件分组勾选或取消勾选Display categories、Display tags、Display popular entries、Display last entries、Display archive五个开关保存并发布侧边栏立即生效 ✅这些开关的定义见 abstracts.py默认值全部为True即「全开」。调整热门文章数量Parameters 参数面板觉得侧边栏太挤可以控制每个小部件显示多少条Last entries limit最新文章显示条数默认 3Popular entries limit热门文章显示条数默认 3同样在后台 BlogPage 的 Settings →Parameters分组修改即可。字段定义见 abstracts.py改完保存就生效非常方便。热门文章是怎样排名的热门文章的排序逻辑藏在模板标签 puput_tags.py 的popular_entries中按 num_comments 降序排列评论数相同时按日期倒序也就是说评论越多越靠前文章热度与评论数直接挂钩。这个机制很适合引导读者参与讨论——只要文章评论区活跃它就会自然「上热门」。与之对应最新文章recent_entries则单纯按date倒序见 puput_tags.py。标签云与分类列表的排序逻辑标签云调用 managers.py 的TagManager.most_common按标签关联文章数num_times降序排列使用最多的标签排最前分类列表通过CategoryManager.with_uses过滤出「确实有文章」的分类避免空分类占位见 managers.py点击标签或分类会进入对应的归档页面路由定义在 routes.py例如标签页 URL 形如/tag/xxx/分类页为/category/xxx/。归档小部件年月折叠导航归档小部件archives_list.html按「年份 → 月份」两级折叠展示点击年份展开该年的月份列表再点击月份即可查看当月全部文章。路由同样由 routes.py 提供支持年、年/月、年/月/日三种粒度的日期归档 URL非常适合文章量大的博客做历史沉淀导航。进阶定制改模板与换样式如果默认样式不够个性可以覆盖模板文件列表样式修改 entries_list.html控制文章标题、作者、日期、评论数等元信息的展示标签样式修改 tags_list.html整体布局直接重写 base.html 中的.blog_sidebar区块Puput 所有模板标签都集中在 puput_tags.py通过{% recent_entries %}、{% popular_entries %}、{% tags_list %}、{% archives_list %}等标签即可在任意位置复用二次开发非常轻松。小结Puput 的侧边栏小部件设计得相当克制又实用后台开关 数量参数覆盖 90% 的定制需求标签与模板系统则留给高级玩家无限可能。无论你是想快速上线一个 Wagtail 博客还是想把侧边栏调教得个性十足按照本指南都能在几分钟内搞定热门文章、标签云与归档列表的定制 【免费下载链接】puputA Django blog app implemented in Wagtail项目地址: https://gitcode.com/gh_mirrors/pu/puput创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Puput 侧边栏小部件定制指南：热门文章、标签云与归档一网打尽
Puput 侧边栏小部件定制指南热门文章、标签云与归档一网打尽【免费下载链接】puputA Django blog app implemented in Wagtail项目地址: https://gitcode.com/gh_mirrors/pu/puputPuput 是一个基于 Wagtail 构建的 Django 博客应用开箱即用地提供搜索框、最新文章、热门文章、分类、标签云与日期归档等完整侧边栏小部件。本文是一份面向新手的 Puput 侧边栏小部件定制指南手把手教你用最快方法开关小部件、调整显示数量、理解热门文章与标签云背后的排序逻辑让你的 Wagtail 博客侧边栏既好看又好用。Puput 侧边栏有哪些内置小部件默认情况下Puput 博客的右侧栏模板位于 base.html从上到下依次渲染站内搜索框基于 Wagtail 全文搜索无需额外配置最新文章Last Entries按发布日期倒序展示最近文章热门文章Popular Entries按评论数与日期综合排序分类列表Categories展示一级分类标签云Tags按使用频率排序的标签列表日期归档Archive按年份、月份折叠展示每个小部件的显示开关、标题和排序逻辑都对应 abstracts.py 中的display_*字段改动非常灵活。最快配置方法后台一键开关小部件Puput 把侧边栏开关集中放进了 Wagtail 后台无需改一行代码进入 Wagtail 管理后台打开你的 BlogPage 编辑页切换到「Settings」选项卡找到Widgets小部件分组勾选或取消勾选Display categories、Display tags、Display popular entries、Display last entries、Display archive五个开关保存并发布侧边栏立即生效 ✅这些开关的定义见 abstracts.py默认值全部为True即「全开」。调整热门文章数量Parameters 参数面板觉得侧边栏太挤可以控制每个小部件显示多少条Last entries limit最新文章显示条数默认 3Popular entries limit热门文章显示条数默认 3同样在后台 BlogPage 的 Settings →Parameters分组修改即可。字段定义见 abstracts.py改完保存就生效非常方便。热门文章是怎样排名的热门文章的排序逻辑藏在模板标签 puput_tags.py 的popular_entries中按 num_comments 降序排列评论数相同时按日期倒序也就是说评论越多越靠前文章热度与评论数直接挂钩。这个机制很适合引导读者参与讨论——只要文章评论区活跃它就会自然「上热门」。与之对应最新文章recent_entries则单纯按date倒序见 puput_tags.py。标签云与分类列表的排序逻辑标签云调用 managers.py 的TagManager.most_common按标签关联文章数num_times降序排列使用最多的标签排最前分类列表通过CategoryManager.with_uses过滤出「确实有文章」的分类避免空分类占位见 managers.py点击标签或分类会进入对应的归档页面路由定义在 routes.py例如标签页 URL 形如/tag/xxx/分类页为/category/xxx/。归档小部件年月折叠导航归档小部件archives_list.html按「年份 → 月份」两级折叠展示点击年份展开该年的月份列表再点击月份即可查看当月全部文章。路由同样由 routes.py 提供支持年、年/月、年/月/日三种粒度的日期归档 URL非常适合文章量大的博客做历史沉淀导航。进阶定制改模板与换样式如果默认样式不够个性可以覆盖模板文件列表样式修改 entries_list.html控制文章标题、作者、日期、评论数等元信息的展示标签样式修改 tags_list.html整体布局直接重写 base.html 中的.blog_sidebar区块Puput 所有模板标签都集中在 puput_tags.py通过{% recent_entries %}、{% popular_entries %}、{% tags_list %}、{% archives_list %}等标签即可在任意位置复用二次开发非常轻松。小结Puput 的侧边栏小部件设计得相当克制又实用后台开关 数量参数覆盖 90% 的定制需求标签与模板系统则留给高级玩家无限可能。无论你是想快速上线一个 Wagtail 博客还是想把侧边栏调教得个性十足按照本指南都能在几分钟内搞定热门文章、标签云与归档列表的定制 【免费下载链接】puputA Django blog app implemented in Wagtail项目地址: https://gitcode.com/gh_mirrors/pu/puput创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考