-
Notifications
You must be signed in to change notification settings - Fork 138
/
titan-framework-checker.php
146 lines (124 loc) · 4.34 KB
/
titan-framework-checker.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
<?php
/**
* This script is not used within Titan Framework itself.
*
* This script is meant to be used with your Titan Framework-dependent theme or plugin,
* so that your theme/plugin can verify whether the framework is installed.
*
* If Titan is not installed, then the script will display a notice with a link to
* Titan. If Titan is installed but not activated, it will display the appropriate notice as well.
*
* To use this script, just copy it into your theme/plugin directory then add this in the main file of your project:
*
* require_once( 'titan-framework-checker.php' );
*
* Changelog:
* v1.9
* * Simplified class
* v1.7.4
* * Now integrates with TGM Plugin Activation - uses TGM instead of displaying
* our own admin notice
* v1.7.7
* * Added filters to notices
*
* @package Titan Framework
*/
if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly.
}
if ( ! class_exists( 'TitanFrameworkChecker' ) ) {
/**
* Titan Framework Checker.
*
* @since 1.6
*/
class TitanFrameworkChecker {
const SEARCH_REGEX = '/titan-framework.php/i';
const TITAN_CLASS = 'TitanFramework';
const PLUGIN_SLUG = 'titan-framework';
/**
* Constructor, add hooks for checking for Titan Framework.
*
* @since 1.6
*/
function __construct() {
add_action( 'admin_notices', array( $this, 'display_install_or_active_notice' ), 2 );
add_action( 'tgmpa_register', array( $this, 'tgm_plugin_activation_include' ) );
}
/**
* Checks the existence of Titan Framework and prompts the display of a notice.
*
* @since 1.6
*/
public function display_install_or_active_notice() {
// Check for TGM use, if used, let TGM do the notice.
// We do this here since perform_check() is too early.
if ( function_exists( 'tgmpa' ) ) {
return;
}
// If the plugin does not exist, throw admin notice to install.
if ( ! $this->plugin_exists() ) {
echo "<div class='error'><p><strong>"
. esc_html( apply_filters( 'titan_checker_installation_notice', __( 'Titan Framework needs to be installed.', 'default' ) ) )
. sprintf( " <a href='%s'>%s</a>",
esc_url( admin_url( 'plugin-install.php?tab=search&type=term&s=titan+framework' ) ),
esc_html( apply_filters( 'titan_checker_search_plugin_notice', __( 'Click here to search for the plugin.', 'default' ) ) )
)
. '</strong></p></div>';
// If the class doesn't exist, the plugin is inactive. Throw admin notice to activate plugin.
} else if ( ! class_exists( apply_filters( 'tf_framework_checker_titan_class', self::TITAN_CLASS ) ) ) {
echo "<div class='error'><p><strong>"
. esc_html( apply_filters( 'titan_checker_activation_notice', __( 'Titan Framework needs to be activated.', 'default' ) ) )
. sprintf( " <a href='%s'>%s</a>",
esc_url( admin_url( 'plugins.php' ) ),
esc_html( apply_filters( 'titan_checker_activate_plugin_notice', __( 'Click here to go to the plugins page and activate it.', 'default' ) ) )
)
. '</strong></p></div>';
}
}
/**
* Checks the existence of Titan Framework in the list of plugins.
* It uses the slug path of the plugin for checking.
*
* @since 1.6
*
* @return boolean True if Titan Framework is installed (even if not activated).
*/
public function plugin_exists() {
// Required function as it is only loaded in admin pages.
require_once ABSPATH . 'wp-admin/includes/plugin.php';
// Get all plugins, activated or not.
$plugins = get_plugins();
// Check plugin existence by checking if the name is registered as an array key. get_plugins collects all plugin path into arrays.
foreach ( $plugins as $slug => $plugin ) {
$search_regex = apply_filters( 'tf_framework_checker_regex', self::SEARCH_REGEX );
if ( preg_match( $search_regex, $slug, $matches ) ) {
return true;
}
}
return false;
}
/**
* Includes Titan Framework in TGM Plugin Activation if it's available.
*
* @since 1.7.4
*
* @return void
*
* @see http://tgmpluginactivation.com/
*
* @codeCoverageIgnore
*/
public function tgm_plugin_activation_include() {
if ( function_exists( 'tgmpa' ) ) {
tgmpa( array(
array(
'name' => 'Titan Framework',
'slug' => self::PLUGIN_SLUG,
'required' => true,
),
) );
}
}
}
new TitanFrameworkChecker();
}