mainwp / includes / functions.php

functions.php in MainWP Dashboard: Self-hosted WordPress Management for Agencies 6.1, at includes/functions.php

161 lines 4.6 KB

Raw Download Zip

1	<?php
2	/**
3	* MainWP Base Functions.
4	*
5	* Grab MainWP Directory and check for permissions.
6	*
7	* @package MainWP/Dashboard
8	*/
9
10	// Exit if accessed directly.
11	if ( ! defined( 'ABSPATH' ) ) {
12	exit;
13	}
14
15	if ( ! defined( 'FILTER_SANITIZE_STRING_COMPATIBLE' ) ) { // to compatible.
16	define( 'FILTER_SANITIZE_STRING_COMPATIBLE', 513 );
17	}
18
19	if ( ! function_exists( 'mainwpdir' ) ) {
20
21	/**
22	* Grab MainWP Directory
23	*
24	* @return string
25	*/
26	function mainwpdir() {
27	return WP_PLUGIN_DIR . DIRECTORY_SEPARATOR . dirname( plugin_basename( __FILE__ ) ) . DIRECTORY_SEPARATOR . 'libs' . DIRECTORY_SEPARATOR;
28	}
29	}
30
31
32	if ( ! function_exists( '\mainwp_do_not_have_permissions' ) ) {
33
34	/**
35	* Detect permission level & display message to end user.
36	*
37	* @param string $where User's location.
38	* @param bool $echo_out Defines weather or not to echo error message.
39	* @return string\|bool $msg\|false
40	*/
41	function mainwp_do_not_have_permissions( $where = '', $echo_out = true ) {
42	/* translators: %s: Page or section name where access was denied */
43	$msg = sprintf( esc_html__( 'You do not have sufficient permissions to access this page (%s).', 'mainwp' ), ucwords( $where ) );
44	if ( $echo_out ) {
45	echo '<div class="mainwp-permission-error"><p>' . esc_html( $msg ) . '</p>If you need access to this page please contact the dashboard administrator.</div>';
46	} else {
47	return $msg;
48	}
49
50	return false;
51	}
52	}
53
54	if ( ! function_exists( 'mainwp_current_user_can' ) ) {
55
56	/**
57	* Check permission level.
58	*
59	* To compatible with extensions.
60	*
61	* @param string $cap_type Group or type of capabilities.
62	* @param string $cap Capabilities for current user.
63	*
64	* @return bool true\|false
65	*/
66	function mainwp_current_user_can( $cap_type = '', $cap = '' ) {
67	if ( function_exists( 'MainWP\Dashboard\mainwp_current_user_have_right' ) ) {
68	return MainWP\Dashboard\mainwp_current_user_have_right( $cap_type, $cap );
69	}
70	return true;
71	}
72	}
73
74	if ( ! function_exists( 'mainwp_get_actions_handler_instance' ) ) {
75
76	/**
77	* Function to get mainwp actions handler instance.
78	*
79	* @return bool true\|false
80	*/
81	function mainwp_get_actions_handler_instance() {
82	return \MainWP\Dashboard\MainWP_Actions_Handler::instance();
83	}
84	}
85
86	if ( ! function_exists( 'mainwp_send_json_output' ) ) {
87	/**
88	* Handle send json output.
89	*
90	* @param array $output Array output.
91	*/
92	function mainwp_send_json_output( $output ) {
93	if ( is_array( $output ) ) {
94	$output['execute_time'] = \MainWP\Dashboard\MainWP_Execution_Helper::get_run_time();
95	}
96	wp_send_json( $output );
97	}
98	}
99
100
101	if ( ! function_exists( 'mainwp_modules_is_enabled' ) ) {
102
103	/**
104	* Check if module is enable.
105	*
106	* @param string $module module slug.
107	*
108	* @return bool true\|false
109	*/
110	function mainwp_modules_is_enabled( $module ) {
111	$enable_mainwp_modules = array(
112	'logs' => defined( 'MAINWP_MODULE_LOG_ENABLED' ) && MAINWP_MODULE_LOG_ENABLED ? true : false,
113	'cost-tracker' => defined( 'MAINWP_MODULE_COST_TRACKER_ENABLED' ) && MAINWP_MODULE_COST_TRACKER_ENABLED ? true : false,
114	'api-backups' => defined( 'MAINWP_MODULE_API_BACKUPS_ENABLED' ) && MAINWP_MODULE_API_BACKUPS_ENABLED ? true : false,
115	);
116	return ! empty( $enable_mainwp_modules[ $module ] ) ? true : false;
117	}
118	}
119
120	if ( ! function_exists( 'mainwp_get_timestamp' ) ) {
121
122	/**
123	* Function mainwp_get_timestamp.
124	*
125	* @param int $add_time add time.
126	* @return int
127	*/
128	function mainwp_get_timestamp( $add_time = 0 ) {
129	return (int) $add_time + (int) \MainWP\Dashboard\MainWP_Utility::get_timestamp();
130	}
131
132
133	}
134
135	if ( ! function_exists( 'mainwp_get_current_utc_datetime_db' ) ) {
136	/**
137	* Function mainwp_get_current_utc_datetime_db.
138	*
139	* @param bool $get_db_datetime To get db datetime.
140	*
141	* @return int
142	*/
143	function mainwp_get_current_utc_datetime_db( $get_db_datetime = true ) {
144	$utcTime = new \DateTime( 'now', new \DateTimeZone( 'UTC' ) );
145	return $get_db_datetime ? $utcTime->format( 'Y-m-d H:i:s' ) : $utcTime->getTimestamp(); // Outputs: YYYY-MM-DD HH:MM:SS.
146	}
147	}
148
149	if ( ! function_exists( 'mainwp_secure_request' ) ) {
150
151	/**
152	* Function mainwp_secure_request.
153	*
154	* @param string $action request action.
155	* @return void
156	*/
157	function mainwp_secure_request( $action ) {
158	\MainWP\Dashboard\MainWP_Post_Handler::instance()->secure_request( $action );
159	}
160	}
161