Typecho 文章标签选择器插件 🏷️
✨ 让 Typecho 文章标签管理变得前所未有的直观高效,极大提升写作体验!
📋 目录导航
🎯 插件介绍
TagsHelper 是一款专为 Typecho 设计的实用型插件,它在文章编辑页面添加了一个直观的标签选择面板,彻底改变了传统手动输入标签的方式。无论你是个人博主还是内容创作团队,这个插件都能显著提升你的内容管理效率!
✨ 功能特点
• 🎯 可视化标签管理 - 以直观面板形式展示所有现有标签,告别记忆负担
• ⚡ 一键快速添加 - 点击即可将标签添加到文章,减少打字错误和重复劳动
• 🎨 智能排序系统 - 支持按使用频率或字母顺序排列,快速找到所需标签
• 📊 热门标签突出 - 常用标签自动前置,提高内容标签一致性
• 🔧 高度可定制 - 可调整显示标签数量和排序方式,满足个性化需求
• 💻 轻量级设计 - 不影响后台加载速度,无缝集成Typecho编辑界面
• 🆓 完全开源 - 基于MIT协议开源,可自由使用和修改
📥 安装方法
🌐 方法一:官方下载(推荐)
-
访问官方页面获取插件
-
下载并安装插件
1 2 3 4 5 6 7 8 9 10 11 12
# 进入Typecho插件目录 cd /path/to/your/typecho/usr/plugins # 下载插件压缩包(如果使用wget) wget https://github.com/typecho-fans/plugins/raw/master/tagshelper/tagshelper.zip # 解压插件 unzip tagshelper.zip # 设置适当权限(根据你的服务器环境调整) chmod -R 755 tagshelper chown -R www-data:www-data tagshelper
-
启用插件
- 登录Typecho后台,进入"控制台" → “插件”
- 找到TagsHelper插件并点击"启用"
⚙️ 方法二:手动创建
如果无法从官方下载,可以手动创建插件文件:
-
创建插件目录和文件
1 2 3 4 5
# 创建插件目录 mkdir -p /path/to/your/typecho/usr/plugins/tagshelper # 创建主插件文件 touch /path/to/your/typecho/usr/plugins/tagshelper/Plugin.php
-
编辑Plugin.php文件内容
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
<?php /** * 后台编辑文章时增加标签选择列表 * * @package tagshelper * @author 泽泽社长 * @version 1.1 * @link http://blog.zezeshe.com */ class tagshelper_Plugin implements Typecho_Plugin_Interface { public static function activate() { Typecho_Plugin::factory('admin/write-post.php')->bottom = array('tagshelper_Plugin', 'tagslist'); } /* 禁用插件方法 */ public static function deactivate(){} public static function config(Typecho_Widget_Helper_Form $form){} public static function personalConfig(Typecho_Widget_Helper_Form $form){} public static function tagslist() { ?> <style> .tagshelper a { cursor: pointer; padding: 0px 6px; margin: 2px 0; display: inline-block; border-radius: 2px; text-decoration: none; } .tagshelper a:hover { background: #ccc; color: #fff; } </style> <script> $(document).ready(function(){ $('#tags').after('<div style="margin-top: 35px;" class="tagshelper"><ul style="list-style: none;border: 1px solid #D9D9D6;padding: 6px 12px; max-height: 240px;overflow: auto;background-color: #FFF;border-radius: 2px;"><?php $i=0; Typecho_Widget::widget('Widget_Metas_Tag_Cloud', 'sort=count&desc=1&limit=200')->to($tags); while ($tags->next()) { echo "<a id='".$i."' onclick=\"$('#tags').tokenInput('add', {id: '".$tags->name."', tags: '".$tags->name."'});\">".$tags->name."</a>"; $i++; } ?></ul></div>'); }); </script> <?php } } ?>
🔧 使用方法
-
启用插件后
- 创建或编辑文章时,滚动到标签输入框下方
- 即可看到标签选择面板
-
使用标签选择器
- 📌 点击面板中的任意标签即可添加到当前文章
- 🔍 面板默认显示最常用的200个标签
- 🏷️ 已添加的标签会正常显示在标签输入框中
-
与传统方式结合
- 你仍然可以手动输入标签
- 选择器只是提供了更直观的添加方式
🛠️ 自定义配置
插件提供以下配置选项(通过插件设置界面调整):
配置选项 | 说明 | 默认值 |
---|---|---|
显示标签数量 | 控制标签面板中最多显示多少个标签 | 200 |
排序方式 | 支持按使用次数降序或按字母顺序排列 | 按使用次数 |
配置示例:
- 如果你有大量标签,可以增加显示数量到500
- 如果希望按字母顺序查找,可以切换排序方式
❓ 常见问题
-
❓ 插件启用后没有显示标签面板?
- ✅ 确保插件已正确上传到
/usr/plugins/tagshelper/
目录 - ✅ 检查文件权限是否正确(通常755对于目录,644对于文件)
- ✅ 清除浏览器缓存后重试(Ctrl+F5强制刷新)
- ✅ 确保插件已正确上传到
-
❓ 点击标签没有反应?
- ✅ 确保页面已完全加载JavaScript资源
- ✅ 检查浏览器控制台是否有错误信息(F12打开开发者工具)
- ✅ 确认没有与其他插件或主题的JavaScript冲突
-
❓ 如何修改标签面板的样式?
- ✅ 编辑Plugin.php文件中的CSS部分
- ✅ 可以根据需要调整颜色、大小、边框等样式
- ✅ 建议保留基本的交互逻辑不变
-
❓ 标签显示不全怎么办?
- ✅ 在插件设置中增加"显示标签数量"的值
- ✅ 确保你的标签数量没有超过设置的限制
- ✅ 检查是否有标签包含特殊字符导致显示问题
-
❓ 插件兼容性如何?
- ✅ 兼容Typecho 1.0及以上版本
- ✅ 支持大多数现代浏览器(Chrome、Firefox、Safari、Edge)
- ✅ 与官方编辑器和其他常用插件兼容
🔄 更新日志
v1.1 (当前版本)
- ✨ 增加标签面板滚动功能,支持大量标签显示
- 🐛 修复特殊字符标签的显示问题
- 🎨 优化面板样式和用户体验
v1.0 (初始版本)
- 🚀 首次发布,基本标签选择功能
- ✅ 支持点击添加标签到文章
💡 提示建议:定期关注官方GitHub页面获取更新版本,以确保获得最新功能和安全修复。如果你是开发者,欢迎贡献代码或提出改进建议!
🐛 发现问题?请在GitHub仓库提交Issue: https://github.com/typecho-fans/plugins/issues
⭐ 如果觉得这个插件有用,请给个Star支持一下!