主题并不意味着具有功能性,但作为主题开发人员,我们主要需要包含一些功能以使我们的主题更好一点,并且具有功能性。
在本教程中,我们将了解“插件领域”一词,并学习使用 Thomas Griffin 编写的出色工具:TGM 插件激活库。
主题功能:入侵插件领地
主题旨在改变您的 WordPress 网站的设计。理想情况下,它应该是视觉。但在 WordPress 的黄金时代,主题开发人员经常在其主题中包含功能特性,以保持市场竞争力。本来应该如此,但事实却如此。
这是对插件领地的入侵。我们可以用简单的术语来定义“插件领域”:代码的功能部分位于该领域的边界内。改变网站功能的每一段代码都需要作为插件提供(如果尚未在 WordPress 核心中提供)。
在我之前的一篇文章(“制作完美的 WordPress 主题”系列中)中,我提到了“插件领域”的经验法则:
如果该功能与网站的视觉外观有关,则应位于主题中,但如果与网站的功能有关,则应在主题中应作为单独的插件包含在内。
很简单,对吧?
尽管人们仍然倾向于将功能位硬编码到他们的主题中,但主题目录(如 WordPress.org 和 ThemeForest)不接受侵入“插件领域”的主题。因此,提供带有主题的功能就成了一个问题。
幸运的是,有一个相当简单的解决方案,并且它不违反“插件领域”规则。
介绍 TGM 插件激活库
TGM Plugin Activation 是一个轻量级库,旨在将主题与插件捆绑在一起。这个想法很简单:当用户安装您的主题时,它会让用户安装来自 WordPress.org、外部网站或主题文件夹的插件。以下是该库的创建者 Thomas Griffin 对这个方便的小工具的定义:
TGM 插件激活 是一个 PHP 库,可让您轻松地为您的 WordPress 主题(和插件)请求或推荐插件。它允许您的用户使用本机 WordPress 类、函数和接口以单一或批量方式安装甚至自动激活插件。您可以引用预打包的插件、WordPress 插件存储库中的插件,甚至是互联网上其他地方托管的插件。
这可能是解决“插件领地入侵”问题的最明智的解决方案。而且申请也很容易。
我们来看看吧!
安装 TGM 插件激活
安装 TGM 插件激活非常简单。只需按照以下步骤操作:
从页面的“下载”部分下载 TGM 插件激活库。
打开 zip 文件并将 class-tgm-plugin-activation.php 解压到您的主题文件夹(任何您喜欢的位置)。
打开主题的 functions.php 文件并使用 require_once() 函数在主题中(一次)请求类文件。
创建一个函数来配置 TGM 插件激活,并通过 add_action() 函数将其挂钩到 tgmpa_register。
完成!
这非常简单,您甚至不需要复杂的 PHP 代码来要求或推荐插件。看一下下面的代码:
<?php require_once dirname( __FILE__ ) . '/class-tgm-plugin-activation.php'; add_action( 'tgmpa_register', 'mytheme_require_plugins' ); function mytheme_require_plugins() { $plugins = array( ); $config = array( ); tgmpa( $plugins, $config ); } ?>
从现在开始,您可以通过在刚刚创建的函数中设置 $plugins 变量来让用户安装新插件。
让我们看看它是如何完成的。
通过 TGM 插件激活安装插件
从上面可以看出,$plugins 变量是一个数组。要定义要安装的插件,您需要在该数组中创建数组(以便您可以设置自己的参数)。听起来很难,但事实并非如此:
<?php $plugins = array( array( ), array( ), array( ), // ... array( ) ); ?>
有几个参数可供使用:
name(字符串,必需)- 插件的名称。
slug (字符串,必需)- 插件的 slug(通常是其文件夹的名称)。
required (布尔值,必需) - 如果设置为 true,您的主题将“需要”该插件。如果false,主题将“推荐”它。
source (字符串,有时需要)- 插件的源。如果是 WordPress.org 插件,则不应使用此参数;否则,这是必需的。
version (字符串,可选) - 插件所需的最低版本。例如;如果主题用户已经安装了所需的插件,但没有达到您指定的最低版本号,TGM 插件激活会警告用户进行更新。
force_activation (布尔值,可选) - 如果设置为 true,当您的主题处于活动状态时,用户将无法停用插件。有点烦人,但在某些情况下可能是必要的。
force_deactivation (布尔值,可选) - 如果设置为 true,一旦用户切换主题,插件将被停用。
external_url (字符串,可选) - 如果设置,插件的名称将链接到插件要求通知中的此地址。
您可以通过三个选项让您的用户通过 TGM 插件激活安装插件:您可以从 WordPress 插件目录、外部源(例如您自己的服务器或 CDN)或您的主题文件夹(例如/my-theme/plugins/shortcodes.zip)。
需要 WordPress.org 的插件
<?php $plugins = array( array( 'name' => 'BuddyPress', 'slug' => 'buddypress', 'required' => false, // this plugin is recommended ) ); ?>
从外部源请求插件
<?php $plugins = array( array( 'name' => 'My Awesome Plugin', 'slug' => 'my-awesome-plugin', 'source' => 'http://files.my-website.com/my-awesome-plugin.zip', 'required' => true, // this plugin is required 'external_url' => 'http://my-website.com/introducing-my-awesome-plugin', // page of my plugin 'force_deactivation' => true, // deactivate this plugin when the user switches to another theme ) ); ?>
从主题目录中获取插件
<?php $plugins = array( array( 'name' => 'My Super Sleek Slider', 'slug' => 'my-super-sleek-slider', 'source' => get_stylesheet_directory() . '/lib/plugins/my-super-sleek-slider.zip', // The "internal" source of the plugin. 'required' => true, // this plugin is required 'version' => '1.2', // the user must use version 1.2 (or higher) of this plugin 'force_activation' => false, // this plugin is going to stay activated unless the user switches to another theme ) ); ?>
配置 TGM 插件激活
注意到示例代码末尾带有两个参数的 tgmpa() 函数了吗?第二个参数是 $config 变量,它也恰好是一个数组,就像 $plugins 参数一样。顾名思义,您可以使用此数组配置 TGM 插件激活库。它还有自己的一组选项需要设置:
id(字符串) - 您在主题中实现的 TGM 插件激活库的唯一 ID。这实际上非常重要:如果另一个插件也使用 TGM 插件激活,则不同的 ID 可以防止冲突。
default_path (string) - 主题内插件的默认绝对路径。设置此选项后,您可以使用 ZIP 文件的名称作为插件的 source 参数。
menu (字符串) - 插件安装页面的菜单项。
has_notices (boolean) - 如果设置为 true,则会显示必需/推荐插件的管理员通知。
dismissible (boolean) - 如果设置为 true,用户可以“忽略”通知。
dismiss_msg (string) - 如果 dismissable 选项设置为 false,则此消息将显示在管理通知上方。
is_automatic (boolean) - 如果设置为 true,插件将在用户同意安装后激活。
message (string) - 在插件表之前显示的可选 HTML。
strings (array) - 另一个 array 包含要显示的消息。您也可以将它们设置为可翻译字符串。查看 example.php 文件以查看消息字符串的完整列表。
<?php $config = array( 'id' => 'mytheme-tgmpa', // your unique TGMPA ID 'default_path' => get_stylesheet_directory() . '/lib/plugins/', // default absolute path 'menu' => 'mytheme-install-required-plugins', // menu slug 'has_notices' => true, // Show admin notices 'dismissable' => false, // the notices are NOT dismissable 'dismiss_msg' => 'I really, really need you to install these plugins, okay?', // this message will be output at top of nag 'is_automatic' => true, // automatically activate plugins after installation 'message' => '<!--Hey there.-->', // message to output right before the plugins table 'strings' => array(); // The array of message strings that TGM Plugin Activation uses ); ?>
总结一切
正如您所看到的,通过 WordPress 主题提供功能并非不可能 - 您只需考虑用户从您的主题切换到另一个主题时的情况。 TGM 插件激活库提供了一种非常聪明的按书本操作的方法。
您觉得这个工具怎么样?您曾经使用过它,或者您打算将来使用它吗?请在下面发表评论,告诉我们您的想法。如果您喜欢这篇文章,请不要忘记与您的朋友分享!
以上就是在您的主题中利用 TGM 插件激活库的强大功能的详细内容,更多请关注本网内其它相关文章!