TGM插件激活

要求和推荐WordPress主题插件(以及其他插件)的最佳方式。

常见问题

问题索引

如何将TGMPA添加到我的主题/插件?

遵循安装配置说明。

返回页首

如何升级TGMPA?

如果您已经在主题或插件中使用TGMPA,并希望升级到新版本,请按照以下说明进行操作:

  1. 下载最新版本。
  2. 阅读变更日志查看新版本中已修复/更改/改进的内容。
  3. 替换旧的类文件class-tgm-插件激活.php使用新版本。
  4. 仔细检查示例.php新的或更改的选项和代码的版本中包含的文件,并在必要时相应地调整现有功能。以下页面将始终包含当前配置选项.
  5. 发布主题/插件的更新版本。

返回页首

如何从我的主题/插件中删除TGMPA?

如果您的主题或插件不再需要TGM插件激活(TGMPA)支持,那么您需要采取以下步骤来删除TGMPA。根据主题或插件作者添加它的方式,可能需要一些主动性,并且假设您可以根据需要编辑PHP文件/FTP。

  1. 查找并删除插件注册功能。它看起来像:
    <?php(电话)
    /***必需和推荐的插件*/
    功能 前缀_寄存器_插件() {
    
    	/***插件数组的数组。必需的键是名称和slug。*如果来源不是来自.org repo,那么来源也是必需的。*/
    	$个插件 = 阵列(
    
    		//WordPress搜索引擎优化		阵列(
    			“名称”     => 'Yoast的WordPress SEO',
    			“鼻涕虫”     => “wordpress-seo”,
    			“必需” => ,
    		),
    		...
    	);
    
    	tgmpa(千兆帕)( $个插件 );
    }
    添加操作(_A)( “tgmpa_register”, '前缀_register_plugins' );
    
    应该只有一个实例tgmpa(千兆帕)(tgmpa寄存器在你的主题或插件中(除了TGMPA类文件),所以搜索一下。注册功能可能包含其他代码函数.php,初始化.php或单独的文件,例如包括/tgmpa.php或其他文件。
  2. 查找并删除require_once()引用TGMPA类文件的调用:
    <?php(电话)
    /***包括TGM_Plugin_Activation类。*/
    需要一次 目录名( __文件__ ) . “/class-tgm-plugin-activation.php”;
    
    文件名几乎可以肯定是唯一的,因此请搜索您的主题或插件。主题或插件作者可能使用过要求,包括包含一次(_O)而不是需要一次,他们可能已经添加了额外的( )围绕文件路径。
  3. 查找并删除TGMPA类文件。由于不再引用类文件class-tgm-插件激活.php文件(或重命名后的等效文件)可以从主题或插件中删除。

随着插件注册、类文件引用和类文件本身都被删除,您的主题或插件将不再使用TGMPA。

返回页首

如果我包括TGMPA,我的主题就无法通过主题审查。我该如何解决这个问题?

如果您向wordpress.org或商业主题库(如ThemeForest)提交主题,您的主题将在被接受之前进行审查主题检查插件是这些审查中使用的工具之一。

  1. 如果包括TGMPA,您可能会看到的典型审查反馈是:

    必需:path/to/class-tgm-plugin-activation.php。主题应使用add_theme_page()添加管理页面。

    警告:此主题中使用了多个文本域。这意味着主题将与WordPress.org语言包不兼容。找到的域是您的文本域,tgmpa

    解决方案:要解决此问题,请使用自定义生成器并指示您的分销渠道以获得将通过主题检查规则的正确版本。

  2. 对于旧版本的TGMPA,您可能还会收到来自Theme Check的以下反馈:

    警告:发现翻译函数缺少文本域。函数_n_noop,带参数…

    必需:在文件class-tgm-plugin-activation.php中找到screen_icon()。自版本3.8以来已弃用。

    解决方案:这两个问题都表明您正在使用非常旧版本的TGMPA,您应该升级到最新版本.

  3. 如果您通过ThemeForest发布主题,您可能会遇到的最后一个问题是以下内容的反馈:

    所有已翻译的字符串都必须转义。

    让我们向您保证:所有TGMPA输出字符串逃脱。

    大多数字符串都是延迟转义的,即在它们被回显的位置转义,因为只有在那时您才知道字符串的使用上下文。这意味着您将经常无法找到逃逸调用和翻译调用。这是正确的,不用担心。

返回页首

如何从“.pot”文件中排除TGMPA文本字符串?

由于TGMPA(自2.6.0版起)自带翻译文件,您可以通过从您的.锅文件。

警告:只有在您使用主题/插件分发TGMPA翻译文件时才可以这样做!换句话说:do如果你通过wordpress.org发布你的主题,请这样做!

最简单的设置方法是使用程序Poedit公司。所以,如果你还没有安装,请先安装它。

  1. 打开您的.锅Poedit中的文件。
  2. 使用顶部的菜单转到目录属性或者只需按组合键Alt+Enter。
  3. 转到第二个选项卡源路径.
  4. 在此屏幕底部,您可以添加生成或更新时要排除的文件或文件夹.锅文件:

    屏幕截图1

    您可以排除整个目录…

    屏幕截图2

    …或从分析中排除单个文件.锅发电机。

    屏幕截图3

  5. 完成后,单击好 啊然后使用目录从源更新更新您的.锅文件和TGMPA字符串将不再包含在内。

返回页首

我的主题/插件包括最新版本的TGMPA,但似乎使用了较旧版本的TGMP。什么给你?

使用TGMPA的WordPress安装中可能有更多的主题/插件处于活动状态。将使用TGMPA WordPress遭遇战的第一个版本。这可能不是您的主题/插件中包含的版本。

如果您或您的最终用户遇到了在最新版本的TGMPA中已经解决的错误,请尝试找出安装了包括TGMPA在内的其他主题/插件,并联系主题/插件作者,敦促他们升级TGMPA版本。

仅供参考-WordPress中的加载顺序如下:

  1. 必须按字母顺序使用插件
  2. 插件
  3. 活动主题

返回页首

我如何知道使用的是什么版本的TGMPA?

对于TGMPA2.5及以上版本,您将在TGMPA页面的右下角看到所使用的版本。

对于早期版本,您必须检查实际的TGMPA文件,并在文件头中查找版本号。请记住上述加载顺序,搜索您的WP安装,看看是否有几个版本的TGMPA正在使用,并检查所有版本号。

返回页首

一个插件说它需要更新,但当我尝试更新时,它说“插件是最新版本'.

一些插件(尤其是商业插件)将包含自己的升级例程,这些例程可能会推翻TGMPA升级指令。在尝试更新之前,请尝试停用插件。如果在插件被停用时升级有效,那么以上就是更新之前无法正常运行的原因。

如果更新仍然不起作用,请将此报告为错误.

返回页首

我将插件的新版本与我的主题捆绑在一起。为什么TGMPA没有显示有可用的更新?

只有在设置文件中设置插件的最低版本(版本数组键),才能使用捆绑插件进行更新。将此设置为更新的捆绑插件的版本号,一切正常。

TGMPA无法获取捆绑插件本身的版本号信息,因此它依赖于您在设置文件中提供的信息来确定是否有更新。

返回页首

我将新版本的Visual Composer与我的主题捆绑在一起。为什么通过TGMPA更新不起作用?

只有当您作为主题开发人员拥有Visual Composer的开发人员许可证,允许您将其与主题一起发布时,才会出现这种特殊情况。

Visual Composer(按设计)查看Envato Market place服务器,查看是否有插件可用的更新。如果您将更新作为与主题捆绑在一起的zip文件发布,Visual Composer中的更新例程将否决您的捆绑更新,从而导致更新失败。

要解决此问题,请将下面的代码行添加到函数.php要在Visual Composer中禁用外部更新程序,请执行以下操作:

vc_set_as_theme();

有关更多信息,请参阅Visual Composer开发人员文档.

返回页首

我收到一个致命的PHP错误'从无效上下文调用受保护的TGM_Plugin_Activation::__construction()'. 救命啊!

此问题已在TGMPA v2.5.2中修复。您的WP安装中至少有两个TGMPA副本处于活动状态,并且它们都已过时。请联系使用旧版本TGMPA的主题/插件作者,并敦促他们升级所包含的TGMPA版本。

返回页首

我收到一个致命的PHP错误'找不到TGM_Bulk_Installer类'. 救命啊!

此错误已在TGMPA v2.4.2中修复。请升级您的TGMPA版本,或使用旧版TGMPA联系主题/插件所有者,并敦促他们升级所包含的版本。

返回页首