Featured image of post Typecho 文章标签选择器插件 🏷️

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

Typecho 文章标签选择器插件 🏷️ ✨ 让 Typecho 文章标签管理变得前所未有的直观高效,极大提Õ

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

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


📋 目录导航


🎯 插件介绍

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


✨ 功能特点

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


📥 安装方法

🌐 方法一:官方下载(推荐)

  1. 访问官方页面获取插件

  2. 下载并安装插件

     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
    
  3. 启用插件

    • 登录Typecho后台,进入"控制台" → “插件”
    • 找到TagsHelper插件并点击"启用"

⚙️ 方法二:手动创建

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

  1. 创建插件目录和文件

    1
    2
    3
    4
    5
    
    # 创建插件目录
    mkdir -p /path/to/your/typecho/usr/plugins/tagshelper
    
    # 创建主插件文件
    touch /path/to/your/typecho/usr/plugins/tagshelper/Plugin.php
    
  2. 编辑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
      }
    }
    ?>
    

🔧 使用方法

  1. 启用插件后

    • 创建或编辑文章时,滚动到标签输入框下方
    • 即可看到标签选择面板
  2. 使用标签选择器

    • 📌 点击面板中的任意标签即可添加到当前文章
    • 🔍 面板默认显示最常用的200个标签
    • 🏷️ 已添加的标签会正常显示在标签输入框中
  3. 与传统方式结合

    • 你仍然可以手动输入标签
    • 选择器只是提供了更直观的添加方式


🛠️ 自定义配置

插件提供以下配置选项(通过插件设置界面调整):

配置选项 说明 默认值
显示标签数量 控制标签面板中最多显示多少个标签 200
排序方式 支持按使用次数降序或按字母顺序排列 按使用次数

配置示例:

  • 如果你有大量标签,可以增加显示数量到500
  • 如果希望按字母顺序查找,可以切换排序方式

❓ 常见问题

  1. ❓ 插件启用后没有显示标签面板?

    • ✅ 确保插件已正确上传到 /usr/plugins/tagshelper/ 目录
    • ✅ 检查文件权限是否正确(通常755对于目录,644对于文件)
    • ✅ 清除浏览器缓存后重试(Ctrl+F5强制刷新)
  2. ❓ 点击标签没有反应?

    • ✅ 确保页面已完全加载JavaScript资源
    • ✅ 检查浏览器控制台是否有错误信息(F12打开开发者工具)
    • ✅ 确认没有与其他插件或主题的JavaScript冲突
  3. ❓ 如何修改标签面板的样式?

    • ✅ 编辑Plugin.php文件中的CSS部分
    • ✅ 可以根据需要调整颜色、大小、边框等样式
    • ✅ 建议保留基本的交互逻辑不变
  4. ❓ 标签显示不全怎么办?

    • ✅ 在插件设置中增加"显示标签数量"的值
    • ✅ 确保你的标签数量没有超过设置的限制
    • ✅ 检查是否有标签包含特殊字符导致显示问题
  5. ❓ 插件兼容性如何?

    • ✅ 兼容Typecho 1.0及以上版本
    • ✅ 支持大多数现代浏览器(Chrome、Firefox、Safari、Edge)
    • ✅ 与官方编辑器和其他常用插件兼容

🔄 更新日志

v1.1 (当前版本)

  • ✨ 增加标签面板滚动功能,支持大量标签显示
  • 🐛 修复特殊字符标签的显示问题
  • 🎨 优化面板样式和用户体验

v1.0 (初始版本)

  • 🚀 首次发布,基本标签选择功能
  • ✅ 支持点击添加标签到文章

💡 提示建议:定期关注官方GitHub页面获取更新版本,以确保获得最新功能和安全修复。如果你是开发者,欢迎贡献代码或提出改进建议!

🐛 发现问题?请在GitHub仓库提交Issue: https://github.com/typecho-fans/plugins/issues

如果觉得这个插件有用,请给个Star支持一下!

最后更新于 2025-09-28