-
Notifications
You must be signed in to change notification settings - Fork 1
/
require-plugins.php
169 lines (162 loc) · 8.68 KB
/
require-plugins.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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<?php
add_action( 'tgmpa_register', function() {
/*
* Array of plugin arrays. Required keys are name and slug.
* If the source is NOT from the .org repo, then source is also required.
*/
$plugins = array(
// This is an example of how to include a plugin bundled with a theme.
// array(
// 'name' => 'TGM Example Plugin', // The plugin name.
// 'slug' => 'tgm-example-plugin', // The plugin slug (typically the folder name).
// 'source' => get_stylesheet_directory() . '/lib/plugins/tgm-example-plugin.zip', // The plugin source.
// 'required' => true, // If false, the plugin is only 'recommended' instead of required.
// 'version' => '', // E.g. 1.0.0. If set, the active plugin must be this version or higher. If the plugin version is higher than the plugin version installed, the user will be notified to update the plugin.
// 'force_activation' => false, // If true, plugin is activated upon theme activation and cannot be deactivated until theme switch.
// 'force_deactivation' => false, // If true, plugin is deactivated upon theme switch, useful for theme-specific plugins.
// 'external_url' => '', // If set, overrides default API URL and points to an external URL.
// 'is_callable' => '', // If set, this callable will be be checked for availability to determine if a plugin is active.
// ),
// // This is an example of how to include a plugin from an arbitrary external source in your theme.
// array(
// 'name' => '', // The plugin name.
// 'slug' => '', // The plugin slug (typically the folder name).
// 'source' => '', // The plugin source.
// 'required' => true, // If false, the plugin is only 'recommended' instead of required.
// 'version' => ''
// // 'external_url' => 'https://github.com/thomasgriffin/New-Media-Image-Uploader', // If set, overrides default API URL and points to an external URL.
// ),
// // This is an example of how to include a plugin from a GitHub repository in your theme.
// // This presumes that the plugin code is based in the root of the GitHub repository
// // and not in a subdirectory ('/src') of the repository.
// array(
// 'name' => 'Adminbar Link Comments to Pending',
// 'slug' => 'adminbar-link-comments-to-pending',
// 'source' => 'https://github.com/jrfnl/WP-adminbar-comments-to-pending/archive/master.zip',
// ),
// // This is an example of how to include a plugin from the WordPress Plugin Repository.
array(
'name' => 'Simple History',
'slug' => 'simple-history',
'required' => true,
),
array(
'name' => 'What the File',
'slug' => 'what-the-file',
'required' => true,
),
array(
'name' => 'Mailgun',
'slug' => 'mailgun',
'required' => true,
),
// // This is an example of the use of 'is_callable' functionality. A user could - for instance -
// // have Yoast SEO installed *or* Yoast SEO Premium. The slug would in that last case be different, i.e.
// // 'wordpress-seo-premium'.
// // By setting 'is_callable' to either a function from that plugin or a class method
// // `array( 'class', 'method' )` similar to how you hook in to actions and filters, TGMPA can still
// // recognize the plugin as being installed.
// array(
// 'name' => 'Yoast SEO',
// 'slug' => 'wordpress-seo',
// 'is_callable' => 'wpseo_init',
// ),
);
/*
* Array of configuration settings. Amend each line as needed.
*
* TGMPA will start providing localized text strings soon. If you already have translations of our standard
* strings available, please help us make TGMPA even better by giving us access to these translations or by
* sending in a pull-request with .po file(s) with the translations.
*
* Only uncomment the strings in the config array if you want to customize the strings.
*/
$config = array(
'id' => 'mapi-tgmpa', // Unique ID for hashing notices for multiple instances of TGMPA.
'default_path' => '', // Default absolute path to bundled plugins.
'menu' => 'mapi-install-plugins', // Menu slug.
'parent_slug' => 'plugins.php', // Parent menu slug.
'capability' => 'edit_theme_options', // Capability needed to view plugin install page, should be a capability associated with the parent menu used.
'has_notices' => true, // Show admin notices or not.
'dismissable' => true, // If false, a user cannot dismiss the nag message.
'dismiss_msg' => '', // If 'dismissable' is false, this message will be output at top of nag.
'is_automatic' => false, // Automatically activate plugins after installation or not.
'message' => '', // Message to output right before the plugins table.
/*
'strings' => array(
'page_title' => __( 'Install Required Plugins', 'theme-slug' ),
'menu_title' => __( 'Install Plugins', 'theme-slug' ),
// translators: %s: plugin name.
'installing' => __( 'Installing Plugin: %s', 'theme-slug' ),
// translators: %s: plugin name.
'updating' => __( 'Updating Plugin: %s', 'theme-slug' ),
'oops' => __( 'Something went wrong with the plugin API.', 'theme-slug' ),
'notice_can_install_required' => _n_noop(
// translators: 1: plugin name(s).
'This theme requires the following plugin: %1$s.',
'This theme requires the following plugins: %1$s.',
'theme-slug'
),
'notice_can_install_recommended' => _n_noop(
// translators: 1: plugin name(s).
'This theme recommends the following plugin: %1$s.',
'This theme recommends the following plugins: %1$s.',
'theme-slug'
),
'notice_ask_to_update' => _n_noop(
// translators: 1: plugin name(s).
'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.',
'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.',
'theme-slug'
),
'notice_ask_to_update_maybe' => _n_noop(
// translators: 1: plugin name(s).
'There is an update available for: %1$s.',
'There are updates available for the following plugins: %1$s.',
'theme-slug'
),
'notice_can_activate_required' => _n_noop(
// translators: 1: plugin name(s).
'The following required plugin is currently inactive: %1$s.',
'The following required plugins are currently inactive: %1$s.',
'theme-slug'
),
'notice_can_activate_recommended' => _n_noop(
// translators: 1: plugin name(s).
'The following recommended plugin is currently inactive: %1$s.',
'The following recommended plugins are currently inactive: %1$s.',
'theme-slug'
),
'install_link' => _n_noop(
'Begin installing plugin',
'Begin installing plugins',
'theme-slug'
),
'update_link' => _n_noop(
'Begin updating plugin',
'Begin updating plugins',
'theme-slug'
),
'activate_link' => _n_noop(
'Begin activating plugin',
'Begin activating plugins',
'theme-slug'
),
'return' => __( 'Return to Required Plugins Installer', 'theme-slug' ),
'plugin_activated' => __( 'Plugin activated successfully.', 'theme-slug' ),
'activated_successfully' => __( 'The following plugin was activated successfully:', 'theme-slug' ),
// translators: 1: plugin name.
'plugin_already_active' => __( 'No action taken. Plugin %1$s was already active.', 'theme-slug' ),
// translators: 1: plugin name.
'plugin_needs_higher_version' => __( 'Plugin not activated. A higher version of %s is needed for this theme. Please update the plugin.', 'theme-slug' ),
// translators: 1: dashboard link.
'complete' => __( 'All plugins installed and activated successfully. %1$s', 'theme-slug' ),
'dismiss' => __( 'Dismiss this notice', 'theme-slug' ),
'notice_cannot_install_activate' => __( 'There are one or more required or recommended plugins to install, update or activate.', 'theme-slug' ),
'contact_admin' => __( 'Please contact the administrator of this site for help.', 'theme-slug' ),
'nag_type' => '', // Determines admin notice type - can only be one of the typical WP notice classes, such as 'updated', 'update-nag', 'notice-warning', 'notice-info' or 'error'. Some of which may not work as expected in older WP versions.
),
*/
);
tgmpa( $plugins, $config );
});