Typecho 文章标签选择器插件 🏷️

✨ 让 Typecho 文章标签管理变得前所未有的直观高效，极大提升写作体验！

📋 目录导航

🎯 插件介绍
✨ 功能特点
📥 安装方法
- 🌐 方法一：官方下载
- ⚙️ 方法二：手动创建
🔧 使用方法
🛠️ 自定义配置
❓ 常见问题
🔄 更新日志

🎯 插件介绍

TagsHelper 是一款专为 Typecho 设计的实用型插件，它在文章编辑页面添加了一个直观的标签选择面板，彻底改变了传统手动输入标签的方式。无论你是个人博主还是内容创作团队，这个插件都能显著提升你的内容管理效率！

✨ 功能特点

• 🎯 可视化标签管理 - 以直观面板形式展示所有现有标签，告别记忆负担
• ⚡ 一键快速添加 - 点击即可将标签添加到文章，减少打字错误和重复劳动
• 🎨 智能排序系统 - 支持按使用频率或字母顺序排列，快速找到所需标签
• 📊 热门标签突出 - 常用标签自动前置，提高内容标签一致性
• 🔧 高度可定制 - 可调整显示标签数量和排序方式，满足个性化需求
• 💻 轻量级设计 - 不影响后台加载速度，无缝集成Typecho编辑界面
• 🆓 完全开源 - 基于MIT协议开源，可自由使用和修改

📥 安装方法

🌐 方法一：官方下载（推荐）

访问官方页面获取插件
- 中文介绍页：https://typecho.work/archives/tagshelper.html
- GitHub 仓库：https://github.com/typecho-fans/plugins/tree/master/tagshelper

下载并安装插件

# 进入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插件并点击”启用”

⚙️ 方法二：手动创建

如果无法从官方下载，可以手动创建插件文件：

创建插件目录和文件

# 创建插件目录
mkdir -p /path/to/your/typecho/usr/plugins/tagshelper

# 创建主插件文件
touch /path/to/your/typecho/usr/plugins/tagshelper/Plugin.php

编辑Plugin.php文件内容

<?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）
- ✅ 与官方编辑器和其他常用插件兼容