650 lines
17 KiB
PHP
650 lines
17 KiB
PHP
<?php
|
|
|
|
namespace MailPoet\WP;
|
|
|
|
use Plugin_Upgrader;
|
|
use WP_Ajax_Upgrader_Skin;
|
|
use WP_Error;
|
|
|
|
class Functions {
|
|
|
|
static private $instance;
|
|
|
|
/**
|
|
* @return Functions
|
|
*/
|
|
public static function get() {
|
|
if (self::$instance === null) {
|
|
self::$instance = new Functions;
|
|
}
|
|
return self::$instance;
|
|
}
|
|
|
|
public static function set(Functions $instance) {
|
|
self::$instance = $instance;
|
|
}
|
|
|
|
/**
|
|
* @param string $tag
|
|
* @param mixed ...$args
|
|
* @return mixed
|
|
*/
|
|
public function doAction($tag, ...$args) {
|
|
return call_user_func_array('do_action', func_get_args());
|
|
}
|
|
|
|
/**
|
|
* @param string $tag
|
|
* @param mixed ...$args
|
|
* @return mixed
|
|
*/
|
|
public function applyFilters($tag, ...$args) {
|
|
return call_user_func_array('apply_filters', func_get_args());
|
|
}
|
|
|
|
/**
|
|
* @param string $tag
|
|
* @param callable $functionToAdd
|
|
* @param int $priority
|
|
* @param int $acceptedArgs
|
|
* @return boolean
|
|
*/
|
|
public function addAction($tag, $functionToAdd, $priority = 10, $acceptedArgs = 1) {
|
|
return call_user_func_array('add_action', func_get_args());
|
|
}
|
|
|
|
public function __($text, $domain = 'default') {
|
|
return __($text, $domain);
|
|
}
|
|
|
|
public function _e($text, $domain = 'default') {
|
|
return _e($text, $domain);
|
|
}
|
|
|
|
public function _n($single, $plural, $number, $domain = 'default') {
|
|
return _n($single, $plural, $number, $domain);
|
|
}
|
|
|
|
public function _x($text, $context, $domain = 'default') {
|
|
return _x($text, $context, $domain);
|
|
}
|
|
|
|
public function addCommentMeta($commentId, $metaKey, $metaValue, $unique = false) {
|
|
return add_comment_meta($commentId, $metaKey, $metaValue, $unique);
|
|
}
|
|
|
|
public function addFilter($tag, callable $functionToAdd, $priority = 10, $acceptedArgs = 1) {
|
|
return add_filter($tag, $functionToAdd, $priority, $acceptedArgs);
|
|
}
|
|
|
|
/**
|
|
* @param bool|array $crop
|
|
*/
|
|
public function addImageSize($name, $width = 0, $height = 0, $crop = false) {
|
|
return add_image_size($name, $width, $height, $crop);
|
|
}
|
|
|
|
public function addMenuPage($pageTitle, $menuTitle, $capability, $menuSlug, callable $function = null, $iconUrl = '', $position = null) {
|
|
if (is_null($function)) {
|
|
$function = function () {
|
|
};
|
|
}
|
|
return add_menu_page($pageTitle, $menuTitle, $capability, $menuSlug, $function, $iconUrl, $position);
|
|
}
|
|
|
|
public function addQueryArg($key, $value = false, $url = false) {
|
|
return add_query_arg($key, $value, $url);
|
|
}
|
|
|
|
public function addScreenOption($option, $args = []) {
|
|
return add_screen_option($option, $args);
|
|
}
|
|
|
|
public function addShortcode($tag, callable $callback) {
|
|
return add_shortcode($tag, $callback);
|
|
}
|
|
|
|
public function addSubmenuPage($parentSlug, $pageTitle, $menuTitle, $capability, $menuSlug, callable $function) {
|
|
return add_submenu_page($parentSlug, $pageTitle, $menuTitle, $capability, $menuSlug, $function);
|
|
}
|
|
|
|
public function adminUrl($path = '', $scheme = 'admin') {
|
|
return admin_url($path, $scheme);
|
|
}
|
|
|
|
public function currentFilter() {
|
|
return current_filter();
|
|
}
|
|
|
|
public function currentTime($type, $gmt = false) {
|
|
return current_time($type, $gmt);
|
|
}
|
|
|
|
public function currentUserCan($capability) {
|
|
return current_user_can($capability);
|
|
}
|
|
|
|
public function dateI18n($dateformatstring, $timestampWithOffset = false, $gmt = false) {
|
|
return date_i18n($dateformatstring, $timestampWithOffset, $gmt);
|
|
}
|
|
|
|
public function deleteCommentMeta($commentId, $metaKey, $metaValue = '') {
|
|
return delete_comment_meta($commentId, $metaKey, $metaValue);
|
|
}
|
|
|
|
public function deleteOption($option) {
|
|
return delete_option($option);
|
|
}
|
|
|
|
public function doShortcode($content, $ignoreHtml = false) {
|
|
return do_shortcode($content, $ignoreHtml);
|
|
}
|
|
|
|
public function escAttr($text) {
|
|
return esc_attr($text);
|
|
}
|
|
|
|
public function escHtml($text) {
|
|
return esc_html($text);
|
|
}
|
|
|
|
public function escSql($sql) {
|
|
return esc_sql($sql);
|
|
}
|
|
|
|
public function getBloginfo($show = '', $filter = 'raw') {
|
|
return get_bloginfo($show, $filter);
|
|
}
|
|
|
|
public function getCategories($args = '') {
|
|
return get_categories($args);
|
|
}
|
|
|
|
public function getComment($comment = null, $output = OBJECT) {
|
|
return get_comment($comment, $output);
|
|
}
|
|
|
|
public function getCommentMeta($commentId, $key = '', $single = false) {
|
|
return get_comment_meta($commentId, $key, $single);
|
|
}
|
|
|
|
public function getCurrentScreen() {
|
|
return get_current_screen();
|
|
}
|
|
|
|
public function getCurrentUserId() {
|
|
return get_current_user_id();
|
|
}
|
|
|
|
public function getDateFromGmt($string, $format = 'Y-m-d H:i:s') {
|
|
return get_date_from_gmt($string, $format);
|
|
}
|
|
|
|
public function getEditProfileUrl($userId = 0, $scheme = 'admin') {
|
|
return get_edit_profile_url($userId, $scheme);
|
|
}
|
|
|
|
public function getEditableRoles() {
|
|
return get_editable_roles();
|
|
}
|
|
|
|
public function getLocale() {
|
|
return get_locale();
|
|
}
|
|
|
|
public function getObjectTaxonomies($object, $output = 'names') {
|
|
return get_object_taxonomies($object, $output);
|
|
}
|
|
|
|
public function getOption($option, $default = false) {
|
|
return get_option($option, $default);
|
|
}
|
|
|
|
public function getPages($args = []) {
|
|
return get_pages($args);
|
|
}
|
|
|
|
public function getPermalink($post, $leavename = false) {
|
|
return get_permalink($post, $leavename);
|
|
}
|
|
|
|
public function getPluginPageHook($pluginPage, $parentPage) {
|
|
return get_plugin_page_hook($pluginPage, $parentPage);
|
|
}
|
|
|
|
public function getPluginUpdates() {
|
|
return get_plugin_updates();
|
|
}
|
|
|
|
public function getPlugins($pluginFolder = '') {
|
|
return get_plugins($pluginFolder);
|
|
}
|
|
|
|
public function getPost($post = null, $output = OBJECT, $filter = 'raw') {
|
|
return get_post($post, $output, $filter);
|
|
}
|
|
|
|
public function getPostThumbnailId($post = null) {
|
|
return get_post_thumbnail_id($post);
|
|
}
|
|
|
|
public function getPostTypes($args = [], $output = 'names', $operator = 'and') {
|
|
return get_post_types($args, $output, $operator);
|
|
}
|
|
|
|
public function getPosts(array $args = null) {
|
|
return get_posts($args);
|
|
}
|
|
|
|
public function getRole($role) {
|
|
return get_role($role);
|
|
}
|
|
|
|
public function getSiteOption($option, $default = false, $deprecated = true) {
|
|
return get_site_option($option, $default, $deprecated);
|
|
}
|
|
|
|
public function getSiteUrl($blogId = null, $path = '', $scheme = null) {
|
|
return get_site_url($blogId, $path, $scheme);
|
|
}
|
|
|
|
public function getTemplatePart($slug, $name = null) {
|
|
return get_template_part($slug, $name);
|
|
}
|
|
|
|
/**
|
|
* @param string|array $args
|
|
* @param string|array $deprecated
|
|
* @return array|int|WP_Error
|
|
*/
|
|
public function getTerms($args = [], $deprecated = '') {
|
|
return get_terms($args, $deprecated);
|
|
}
|
|
|
|
/**
|
|
* @param int|false $userId
|
|
*/
|
|
public function getTheAuthorMeta($field = '', $userId = false) {
|
|
return get_the_author_meta($field, $userId);
|
|
}
|
|
|
|
/**
|
|
* @param int|\WP_User $userId
|
|
*/
|
|
public function getUserLocale($userId = 0) {
|
|
return get_user_locale($userId);
|
|
}
|
|
|
|
public function getUserMeta($userId, $key = '', $single = false) {
|
|
return get_user_meta($userId, $key, $single);
|
|
}
|
|
|
|
public function getUserdata($userId) {
|
|
return get_userdata($userId);
|
|
}
|
|
|
|
public function getUserBy($field, $value) {
|
|
return get_user_by($field, $value);
|
|
}
|
|
|
|
public function hasFilter($tag, $functionToCheck = false) {
|
|
return has_filter($tag, $functionToCheck);
|
|
}
|
|
|
|
public function homeUrl($path = '', $scheme = null) {
|
|
return home_url($path, $scheme);
|
|
}
|
|
|
|
public function includesUrl($path = '', $scheme = null) {
|
|
return includes_url($path, $scheme);
|
|
}
|
|
|
|
public function isAdmin() {
|
|
return is_admin();
|
|
}
|
|
|
|
public function isEmail($email, $deprecated = false) {
|
|
return is_email($email, $deprecated);
|
|
}
|
|
|
|
public function isMultisite() {
|
|
return is_multisite();
|
|
}
|
|
|
|
public function isPluginActive($plugin) {
|
|
return is_plugin_active($plugin);
|
|
}
|
|
|
|
public function isRtl() {
|
|
return is_rtl();
|
|
}
|
|
|
|
public function isSerialized($data, $strict = true) {
|
|
return is_serialized($data, $strict);
|
|
}
|
|
|
|
public function isUserLoggedIn() {
|
|
return is_user_logged_in();
|
|
}
|
|
|
|
/**
|
|
* @param string|false $deprecated
|
|
* @param string|false $pluginRelPath
|
|
*/
|
|
public function loadPluginTextdomain($domain, $deprecated = false, $pluginRelPath = false) {
|
|
return load_plugin_textdomain($domain, $deprecated, $pluginRelPath);
|
|
}
|
|
|
|
public function loadTextdomain($domain, $mofile) {
|
|
return load_textdomain($domain, $mofile);
|
|
}
|
|
|
|
public function numberFormatI18n($number, $decimals = 0) {
|
|
return number_format_i18n($number, $decimals);
|
|
}
|
|
|
|
public function pluginBasename($file) {
|
|
return plugin_basename($file);
|
|
}
|
|
|
|
public function pluginsUrl($path = '', $plugin = '') {
|
|
return plugins_url($path, $plugin);
|
|
}
|
|
|
|
public function registerActivationHook($file, $function) {
|
|
return register_activation_hook($file, $function);
|
|
}
|
|
|
|
public function registerPostType($postType, $args = []) {
|
|
return register_post_type($postType, $args);
|
|
}
|
|
|
|
public function registerWidget($widget) {
|
|
return register_widget($widget);
|
|
}
|
|
|
|
/**
|
|
* @param string $tag
|
|
* @param callable $functionToRemove
|
|
* @param int $priority
|
|
*/
|
|
public function removeAction($tag, $functionToRemove, $priority = 10) {
|
|
return remove_action($tag, $functionToRemove, $priority);
|
|
}
|
|
|
|
public function removeAllActions($tag, $priority = false) {
|
|
return remove_all_actions($tag, $priority);
|
|
}
|
|
|
|
public function removeAllFilters($tag, $priority = false) {
|
|
return remove_all_filters($tag, $priority);
|
|
}
|
|
|
|
public function removeFilter($tag, callable $functionToRemove, $priority = 10) {
|
|
return remove_filter($tag, $functionToRemove, $priority);
|
|
}
|
|
|
|
public function removeShortcode($tag) {
|
|
return remove_shortcode($tag);
|
|
}
|
|
|
|
public function selfAdminUrl($path = '', $scheme = 'admin') {
|
|
return self_admin_url($path, $scheme);
|
|
}
|
|
|
|
public function setTransient($transient, $value, $expiration) {
|
|
return set_transient($transient, $value, $expiration);
|
|
}
|
|
|
|
public function getTransient($transient) {
|
|
return get_transient($transient);
|
|
}
|
|
|
|
public function deleteTransient($transient) {
|
|
return delete_transient($transient);
|
|
}
|
|
|
|
public function singlePostTitle($prefix = '', $display = true) {
|
|
return single_post_title($prefix, $display);
|
|
}
|
|
|
|
public function siteUrl($path = '', $scheme = null) {
|
|
return site_url($path, $scheme);
|
|
}
|
|
|
|
public function statusHeader($code, $description = '') {
|
|
return status_header($code, $description);
|
|
}
|
|
|
|
public function stripslashesDeep($value) {
|
|
return stripslashes_deep($value);
|
|
}
|
|
|
|
public function translate($text, $domain = 'default') {
|
|
return translate($text, $domain);
|
|
}
|
|
|
|
public function unloadTextdomain($domain) {
|
|
return unload_textdomain($domain);
|
|
}
|
|
|
|
public function updateOption($option, $value, $autoload = null) {
|
|
return update_option($option, $value, $autoload);
|
|
}
|
|
|
|
public function wpAddInlineScript($handle, $data, $position = 'after') {
|
|
return wp_add_inline_script($handle, $data, $position);
|
|
}
|
|
|
|
public function wpCreateNonce($action = -1) {
|
|
return wp_create_nonce($action);
|
|
}
|
|
|
|
public function wpDequeueScript($handle) {
|
|
return wp_dequeue_script($handle);
|
|
}
|
|
|
|
public function wpDequeueStyle($handle) {
|
|
return wp_dequeue_style($handle);
|
|
}
|
|
|
|
public function wpEncodeEmoji($content) {
|
|
return wp_encode_emoji($content);
|
|
}
|
|
|
|
public function wpEnqueueMedia(array $args = []) {
|
|
return wp_enqueue_media($args);
|
|
}
|
|
|
|
public function wpEnqueueScript($handle, $src = '', array $deps = [], $ver = false, $inFooter = false) {
|
|
return wp_enqueue_script($handle, $src, $deps, $ver, $inFooter);
|
|
}
|
|
|
|
public function wpEnqueueStyle($handle, $src = '', array $deps = [], $ver = false, $media = 'all') {
|
|
return wp_enqueue_style($handle, $src, $deps, $ver, $media);
|
|
}
|
|
|
|
public function wpGetAttachmentImageSrc($attachmentId, $size = 'thumbnail', $icon = false) {
|
|
return wp_get_attachment_image_src($attachmentId, $size, $icon);
|
|
}
|
|
|
|
public function wpGetCurrentUser() {
|
|
return wp_get_current_user();
|
|
}
|
|
|
|
public function wpGetPostTerms($postId, $taxonomy = 'post_tag', array $args = []) {
|
|
return wp_get_post_terms($postId, $taxonomy, $args);
|
|
}
|
|
|
|
public function wpGetReferer() {
|
|
return wp_get_referer();
|
|
}
|
|
|
|
public function wpGetTheme($stylesheet = null, $themeRoot = null) {
|
|
return wp_get_theme($stylesheet, $themeRoot);
|
|
}
|
|
|
|
public function wpInsertPost(array $postarr, $wpError = false) {
|
|
return wp_insert_post($postarr, $wpError);
|
|
}
|
|
|
|
public function wpJsonEncode($data, $options = 0, $depth = 512) {
|
|
return wp_json_encode($data, $options, $depth);
|
|
}
|
|
|
|
public function wpLocalizeScript($handle, $objectName, array $l10n) {
|
|
return wp_localize_script($handle, $objectName, $l10n);
|
|
}
|
|
|
|
public function wpLoginUrl($redirect = '', $forceReauth = false) {
|
|
return wp_login_url($redirect, $forceReauth);
|
|
}
|
|
|
|
public function wpParseArgs($args, $defaults = '') {
|
|
return wp_parse_args($args, $defaults);
|
|
}
|
|
|
|
public function wpParseUrl($url, $component = -1) {
|
|
return wp_parse_url($url, $component);
|
|
}
|
|
|
|
public function wpSpecialcharsDecode($string, $quoteStyle = ENT_NOQUOTES ) {
|
|
return wp_specialchars_decode($string, $quoteStyle);
|
|
}
|
|
|
|
public function wpPrintScripts($handles = false) {
|
|
return wp_print_scripts($handles);
|
|
}
|
|
|
|
public function wpRemoteGet($url, array $args = []) {
|
|
return wp_remote_get($url, $args);
|
|
}
|
|
|
|
public function wpRemotePost($url, array $args = []) {
|
|
return wp_remote_post($url, $args);
|
|
}
|
|
|
|
public function wpRemoteRetrieveBody($response) {
|
|
return wp_remote_retrieve_body($response);
|
|
}
|
|
|
|
public function wpRemoteRetrieveResponseCode($response) {
|
|
return wp_remote_retrieve_response_code($response);
|
|
}
|
|
|
|
public function wpRemoteRetrieveResponseMessage($response) {
|
|
return wp_remote_retrieve_response_message($response);
|
|
}
|
|
|
|
public function wpSafeRedirect($location, $status = 302) {
|
|
return wp_safe_redirect($location, $status);
|
|
}
|
|
|
|
public function wpSetCurrentUser($id, $name = '') {
|
|
return wp_set_current_user($id, $name);
|
|
}
|
|
|
|
public function wpStaticizeEmoji($text) {
|
|
return wp_staticize_emoji($text);
|
|
}
|
|
|
|
public function wpTrimWords($text, $numWords = 55, $more = null) {
|
|
return wp_trim_words($text, $numWords, $more);
|
|
}
|
|
|
|
public function wpUploadDir($time = null, $createDir = true, $refreshCache = false) {
|
|
return wp_upload_dir($time, $createDir, $refreshCache);
|
|
}
|
|
|
|
public function wpVerifyNonce($nonce, $action = -1) {
|
|
return wp_verify_nonce($nonce, $action);
|
|
}
|
|
|
|
public function wpautop($pee, $br = true) {
|
|
return wpautop($pee, $br);
|
|
}
|
|
|
|
/**
|
|
* @param string $action
|
|
* @param array|object $args
|
|
* @return object|array|WP_Error
|
|
*/
|
|
public function pluginsApi($action, $args = []) {
|
|
require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
|
|
return plugins_api($action, $args);
|
|
}
|
|
|
|
/**
|
|
* @param string $package
|
|
* @param array $args
|
|
* @return bool|WP_Error
|
|
*/
|
|
public function installPlugin($package, $args = []) {
|
|
require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
|
|
require_once ABSPATH . 'wp-admin/includes/class-plugin-upgrader.php';
|
|
require_once ABSPATH . 'wp-admin/includes/class-wp-ajax-upgrader-skin.php';
|
|
$upgrader = new Plugin_Upgrader(new WP_Ajax_Upgrader_Skin());
|
|
return $upgrader->install($package, $args);
|
|
}
|
|
|
|
/**
|
|
* @param string $plugin
|
|
* @param string $redirect
|
|
* @param bool $networkWide
|
|
* @param bool $silent
|
|
* @return WP_Error|null
|
|
*/
|
|
public function activatePlugin($plugin, $redirect = '', $networkWide = false, $silent = false) {
|
|
return activate_plugin($plugin, $redirect, $networkWide, $silent);
|
|
}
|
|
|
|
/**
|
|
* @param string $host
|
|
* @return array|bool
|
|
*/
|
|
public function parseDbHost($host) {
|
|
global $wpdb;
|
|
if (method_exists($wpdb, 'parse_db_host')) {
|
|
return $wpdb->parse_db_host($host);
|
|
} else {
|
|
// Backward compatibility for WP 4.7 and 4.8
|
|
$port = null;
|
|
$socket = null;
|
|
$isIpv6 = false;
|
|
|
|
// First peel off the socket parameter from the right, if it exists.
|
|
$socketPos = strpos( $host, ':/' );
|
|
if ($socketPos !== false) {
|
|
$socket = substr($host, $socketPos + 1);
|
|
$host = substr($host, 0, $socketPos);
|
|
}
|
|
|
|
// We need to check for an IPv6 address first.
|
|
// An IPv6 address will always contain at least two colons.
|
|
if (substr_count( $host, ':' ) > 1) {
|
|
$pattern = '#^(?:\[)?(?P<host>[0-9a-fA-F:]+)(?:\]:(?P<port>[\d]+))?#';
|
|
$isIpv6 = true;
|
|
} else {
|
|
// We seem to be dealing with an IPv4 address.
|
|
$pattern = '#^(?P<host>[^:/]*)(?::(?P<port>[\d]+))?#';
|
|
}
|
|
|
|
$matches = [];
|
|
$result = preg_match($pattern, $host, $matches);
|
|
if (1 !== $result) {
|
|
// Couldn't parse the address, bail.
|
|
return false;
|
|
}
|
|
|
|
$host = '';
|
|
foreach (['host', 'port'] as $component) {
|
|
if (!empty($matches[$component])) {
|
|
$$component = $matches[$component];
|
|
}
|
|
}
|
|
return [$host, $port, $socket, $isIpv6];
|
|
}
|
|
}
|
|
|
|
}
|