WordPress插件描述在后台插件界面不显示问题求助

问题概述 #

开发的Tatata插件在WordPress后台「插件→已安装插件」页面中描述无法显示，其他插件正常；插件主PHP文件头部已添加描述信息，且仅在添加插件翻译后出现该问题，插件其余功能正常运行。

插件头部代码如下：

/**
 * Plugin Name: Tatata
 * Plugin URI: https://link
 * Description : it makes a b c d
 * Version: 0.1
 * Author: WebTips
 * Author URI: https://link
 * Text Domain: tata
 * Domain Path: languages/
**/

可能的原因及排查步骤 #

1. 插件头部注释格式错误 #

• Description :中冒号后多了空格，WordPress插件头部规范要求键名与值之间是键名:值（冒号后无空格），多余空格会导致WP解析元数据时出错。
• 注释块结尾应为*/而非**/，错误的注释闭合符可能导致WP无法完整解析整个头部信息，引入翻译后解析逻辑会更严格。

2. 翻译文件相关问题 #

• 检查翻译文件（.po/.mo）命名是否符合规范：需与Text Domain匹配，例如tata-zh_CN.po/tata-zh_CN.mo，且放置在指定的languages/目录下。
• 确认翻译文件中Plugin Description条目是否正确：原描述需与插件头部的Description内容完全一致，翻译内容不能为空，文件编码必须为UTF-8（非UTF-8编码会导致解析失败）。
• 检查是否正确加载文本域：插件初始化时需调用load_plugin_textdomain()函数，示例代码：

  add_action( 'plugins_loaded', 'tatata_load_textdomain' );
  function tatata_load_textdomain() {
      load_plugin_textdomain( 'tata', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
  }
  

  若未加载文本域，WP尝试读取翻译失败时可能无法回退到原描述。

3. 缓存问题 #

WordPress可能缓存了插件元数据，尝试清空后台缓存、服务器缓存，或临时禁用缓存插件后刷新「已安装插件」页面。

4. 服务器文件权限问题 #

确认languages/目录及翻译文件的权限是否允许WordPress读取（一般设置为755目录权限、644文件权限），权限不足会导致WP无法加载翻译文件，进而影响描述显示。

内容的提问来源于stack exchange，提问作者Sam94