| @@ -1,7 +1,7 @@ | ||
| 1 | 1 | <?php |
| 2 | 2 | /** |
| 3 | - * MainWP compatible legacy functions. | |
| 3 | + * MainWP compatible functions. | |
| 4 | 4 | * |
| 5 | 5 | * @package MainWP/Dashboard |
| 6 | 6 | */ |
| 7 | 7 | |
| @@ -6,183 +6,151 @@ | ||
| 6 | 6 | */ |
| 7 | 7 | |
| 8 | 8 | // phpcs:disable -- legacy functions for backwards compatibility. Required. |
| 9 | 9 | |
| 10 | -// Exit if accessed directly. | |
| 11 | -if ( ! defined( 'ABSPATH' ) ) { | |
| 12 | - exit; | |
| 13 | -} | |
| 14 | - | |
| 15 | 10 | if ( ! class_exists( 'MainWP_DB' ) ) { |
| 16 | 11 | |
| 17 | - /** | |
| 18 | - * MainWP Database Compatible class. | |
| 19 | - */ | |
| 20 | - class MainWP_DB { // phpcs:ignore Generic.Classes.OpeningBraceSameLine.ContentAfterBrace -- NOSONAR. | |
| 12 | + /** | |
| 13 | + * MainWP Database Compatible class. | |
| 14 | + */ | |
| 15 | + class MainWP_DB { | |
| 21 | 16 | |
| 22 | - /** | |
| 23 | - * Private static variable to hold the single instance of the class. | |
| 24 | - * | |
| 25 | - * @var mixed Default null | |
| 26 | - */ | |
| 27 | - private static $instance = null; | |
| 17 | + /** | |
| 18 | + * Private static variable to hold the single instance of the class. | |
| 19 | + * | |
| 20 | + * @var mixed Default null | |
| 21 | + */ | |
| 22 | + private static $instance = null; | |
| 28 | 23 | |
| 29 | - /** | |
| 30 | - * Create public static instance. | |
| 31 | - * | |
| 32 | - * @return MainWP_DB | |
| 33 | - */ | |
| 34 | - public static function instance() { | |
| 35 | - if ( null === static::$instance ) { | |
| 36 | - static::$instance = new self(); | |
| 37 | - } | |
| 38 | - return static::$instance; | |
| 39 | - } | |
| 24 | + /** | |
| 25 | + * Create public static instance. | |
| 26 | + * | |
| 27 | + * @return MainWP_DB | |
| 28 | + */ | |
| 29 | + public static function instance() { | |
| 30 | + if ( null == self::$instance ) { | |
| 31 | + self::$instance = new self(); | |
| 32 | + } | |
| 33 | + return self::$instance; | |
| 34 | + } | |
| 40 | 35 | |
| 41 | - /** | |
| 42 | - * Get child site by ID. | |
| 43 | - * | |
| 44 | - * @param int $id Child site ID. | |
| 45 | - * @param array $selectGroups Select groups. | |
| 46 | - * | |
| 47 | - * @return object|null Database query results or null on failure. | |
| 48 | - * | |
| 49 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::get_website_by_id() | |
| 50 | - */ | |
| 51 | - public function getWebsiteById( $id, $selectGroups = false ) { | |
| 52 | - return MainWP\Dashboard\MainWP_DB::instance()->get_website_by_id( $id, $selectGroups ); | |
| 53 | - } | |
| 36 | + /** | |
| 37 | + * Get child site by ID. | |
| 38 | + * | |
| 39 | + * @param int $id Child site ID. | |
| 40 | + * @param array $selectGroups Select groups. | |
| 41 | + * | |
| 42 | + * @return object|null Database query results or null on failure. | |
| 43 | + */ | |
| 44 | + public function getWebsiteById( $id, $selectGroups = false ) { | |
| 45 | + return MainWP\Dashboard\MainWP_DB::instance()->get_website_by_id( $id, $selectGroups ); | |
| 46 | + } | |
| 54 | 47 | |
| 55 | - /** | |
| 56 | - * Get child sites by child site IDs. | |
| 57 | - * | |
| 58 | - * @param array $ids Child site IDs. | |
| 59 | - * @param int $userId User ID. | |
| 60 | - * | |
| 61 | - * @return object|null Database uery result or null on failure. | |
| 62 | - * | |
| 63 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::get_website_by_ids() | |
| 64 | - */ | |
| 65 | - public function getWebsitesByIds( $ids, $userId = null ) { | |
| 66 | - return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_ids( $ids, $userId ); | |
| 67 | - } | |
| 48 | + /** | |
| 49 | + * Get child sites by child site IDs. | |
| 50 | + * | |
| 51 | + * @param array $ids Child site IDs. | |
| 52 | + * @param int $userId User ID. | |
| 53 | + * | |
| 54 | + * @return object|null Database uery result or null on failure. | |
| 55 | + */ | |
| 56 | + public function getWebsitesByIds( $ids, $userId = null ) { | |
| 57 | + return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_ids( $ids, $userId ); | |
| 58 | + } | |
| 68 | 59 | |
| 69 | - /** | |
| 70 | - * Get child sites by groups IDs. | |
| 71 | - * | |
| 72 | - * @param array $ids Groups IDs. | |
| 73 | - * @param int $userId User ID. | |
| 74 | - * | |
| 75 | - * @return object|null Database uery result or null on failure. | |
| 76 | - * | |
| 77 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::get_websites_by_group_ids() | |
| 78 | - */ | |
| 79 | - public function getWebsitesByGroupIds( $ids, $userId = null ) { | |
| 80 | - return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_group_ids( $ids, $userId ); | |
| 81 | - } | |
| 60 | + /** | |
| 61 | + * Get child sites by groups IDs. | |
| 62 | + * | |
| 63 | + * @param array $ids Groups IDs. | |
| 64 | + * @param int $userId User ID. | |
| 65 | + * | |
| 66 | + * @return object|null Database uery result or null on failure. | |
| 67 | + */ | |
| 68 | + public function getWebsitesByGroupIds( $ids, $userId = null ) { | |
| 69 | + return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_group_ids( $ids, $userId ); | |
| 70 | + } | |
| 82 | 71 | |
| 83 | - /** | |
| 84 | - * Get sites by user ID. | |
| 85 | - * | |
| 86 | - * @param int $userid User ID. | |
| 87 | - * @param bool $selectgroups Selected groups. | |
| 88 | - * @param null $search_site Site search field value. | |
| 89 | - * @param string $orderBy Order list by. Default: URL. | |
| 90 | - * | |
| 91 | - * @return object|null Database query results or null on failure. | |
| 92 | - * | |
| 93 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::get_websites_by_user_id() | |
| 94 | - */ | |
| 95 | - public function getWebsitesByUserId( $userid, $selectgroups = false, $search_site = null, $orderBy = 'wp.url' ) { | |
| 96 | - return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_user_id( $userid, $selectgroups, $search_site, $orderBy ); | |
| 97 | - } | |
| 72 | + /** | |
| 73 | + * Get sites by user ID. | |
| 74 | + * | |
| 75 | + * @param int $userid User ID. | |
| 76 | + * @param bool $selectgroups Selected groups. | |
| 77 | + * @param null $search_site Site search field value. | |
| 78 | + * @param string $orderBy Order list by. Default: URL. | |
| 79 | + * | |
| 80 | + * @return object|null Database query results or null on failure. | |
| 81 | + */ | |
| 82 | + public function getWebsitesByUserId( $userid, $selectgroups = false, $search_site = null, $orderBy = 'wp.url' ) { | |
| 83 | + return MainWP\Dashboard\MainWP_DB::instance()->get_websites_by_user_id( $userid, $selectgroups, $search_site, $orderBy ); | |
| 84 | + } | |
| 98 | 85 | |
| 99 | - /** | |
| 100 | - * Get Child site wp_options database table. | |
| 101 | - * | |
| 102 | - * @param array $website Child Site array. | |
| 103 | - * @param mixed $option Child Site wp_options table name. | |
| 104 | - * | |
| 105 | - * @return string|null Database query result (as string), or null on failure. | |
| 106 | - * | |
| 107 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::get_website_option() | |
| 108 | - */ | |
| 109 | - public function getWebsiteOption( $website, $option ) { | |
| 110 | - return MainWP\Dashboard\MainWP_DB::instance()->get_website_option( $website, $option ); | |
| 111 | - } | |
| 86 | + /** | |
| 87 | + * Get Child site wp_options database table. | |
| 88 | + * | |
| 89 | + * @param array $website Child Site array. | |
| 90 | + * @param mixed $option Child Site wp_options table name. | |
| 91 | + * | |
| 92 | + * @return string|null Database query result (as string), or null on failure. | |
| 93 | + */ | |
| 94 | + public function getWebsiteOption( $website, $option ) { | |
| 95 | + return MainWP\Dashboard\MainWP_DB::instance()->get_website_option( $website, $option ); | |
| 96 | + } | |
| 112 | 97 | |
| 113 | - /** | |
| 114 | - * Update child site options. | |
| 115 | - * | |
| 116 | - * @param object $website Child site object. | |
| 117 | - * @param mixed $option Option to update. | |
| 118 | - * @param mixed $value Value to update with. | |
| 119 | - * | |
| 120 | - * @uses \MainWP\Dashboard\MainWP_DB::instance()::update_website_option() | |
| 121 | - */ | |
| 122 | - public function updateWebsiteOption( $website, $option, $value ) { | |
| 123 | - return MainWP\Dashboard\MainWP_DB::instance()->update_website_option( $website, $option, $value ); | |
| 124 | - } | |
| 125 | - } | |
| 98 | + /** | |
| 99 | + * Update child site options. | |
| 100 | + * | |
| 101 | + * @param object $website Child site object. | |
| 102 | + * @param mixed $option Option to update. | |
| 103 | + * @param mixed $value Value to update with. | |
| 104 | + */ | |
| 105 | + public function updateWebsiteOption( $website, $option, $value ) { | |
| 106 | + return MainWP\Dashboard\MainWP_DB::instance()->update_website_option( $website, $option, $value ); | |
| 107 | + } | |
| 108 | + } | |
| 126 | 109 | } |
| 127 | 110 | |
| 128 | 111 | if ( ! class_exists( 'MainWP_System' ) ) { |
| 129 | 112 | |
| 130 | - /** | |
| 131 | - * MainWP System Compatible class | |
| 132 | - * | |
| 133 | - * @internal | |
| 134 | - */ | |
| 135 | - class MainWP_System { // phpcs:ignore Generic.Classes.OpeningBraceSameLine.ContentAfterBrace -- NOSONAR. | |
| 113 | + /** | |
| 114 | + * MainWP System Compatible class | |
| 115 | + * | |
| 116 | + * @internal | |
| 117 | + */ | |
| 118 | + class MainWP_System { | |
| 136 | 119 | |
| 137 | - /** | |
| 138 | - * Public static variable to hold the current plugin version. | |
| 139 | - * | |
| 140 | - * @var string Current plugin version. | |
| 141 | - */ | |
| 142 | - public static $version = '4.0.7.2'; // NOSONAR - not IP. | |
| 120 | + /** | |
| 121 | + * Public static variable to hold the current plugin version. | |
| 122 | + * | |
| 123 | + * @var string Current plugin version. | |
| 124 | + */ | |
| 125 | + public static $version = '4.0.7.2'; | |
| 143 | 126 | |
| 144 | - /** | |
| 145 | - * Create public static instance. | |
| 146 | - * | |
| 147 | - * @return MainWP_System | |
| 148 | - */ | |
| 149 | - public static function Instance() { | |
| 150 | - return MainWP\Dashboard\Instance(); | |
| 151 | - } | |
| 152 | - } | |
| 127 | + /** | |
| 128 | + * Create public static instance. | |
| 129 | + * | |
| 130 | + * @return MainWP_System | |
| 131 | + */ | |
| 132 | + static function Instance() { | |
| 133 | + return MainWP\Dashboard\Instance(); | |
| 134 | + } | |
| 135 | + } | |
| 153 | 136 | } |
| 154 | 137 | |
| 155 | 138 | if ( ! class_exists( 'MainWP_Extensions_View' ) ) { |
| 156 | 139 | |
| 157 | - /** | |
| 158 | - * MainWP Extensions View Compatible class. | |
| 159 | - * | |
| 160 | - * @uses \MainWP\Dashboard\MainWP_Extensions_View::get_available_extensions() | |
| 161 | - */ | |
| 162 | - class MainWP_Extensions_View { // phpcs:ignore Generic.Classes.OpeningBraceSameLine.ContentAfterBrace -- NOSONAR. | |
| 140 | + /** | |
| 141 | + * MainWP Extensions View Compatible class. | |
| 142 | + */ | |
| 143 | + class MainWP_Extensions_View { | |
| 163 | 144 | |
| 164 | - /** | |
| 165 | - * Get all available extensions. | |
| 166 | - * | |
| 167 | - * @return array Available extensions. | |
| 168 | - * | |
| 169 | - * @devtodo Move to MainWP Server via an XML file. | |
| 170 | - */ | |
| 171 | - public static function getAvailableExtensions() { | |
| 172 | - return MainWP\Dashboard\MainWP_Extensions_View::get_available_extensions(); | |
| 173 | - } | |
| 174 | - } | |
| 175 | -} | |
| 176 | - | |
| 177 | - | |
| 178 | -/** | |
| 179 | - * To compatible with php version < 7.3.0. | |
| 180 | - */ | |
| 181 | -if ( ! function_exists( 'array_key_first' ) ) { | |
| 182 | - function array_key_first( array $arr ) { | |
| 183 | - foreach ( $arr as $key => $unused ) { | |
| 184 | - return $key; | |
| 185 | - } | |
| 186 | - return null; | |
| 187 | - } | |
| 145 | + /** | |
| 146 | + * Get all available extensions. | |
| 147 | + * | |
| 148 | + * @return array Available extensions. | |
| 149 | + * | |
| 150 | + * @todo Move to MainWP Server via an XML file. | |
| 151 | + */ | |
| 152 | + public static function getAvailableExtensions() { | |
| 153 | + return MainWP\Dashboard\MainWP_Extensions_View::get_available_extensions(); | |
| 154 | + } | |
| 155 | + } | |
| 188 | 156 | } |