$item ) { if ( 'edit.php?post_type=popup' === $item[2] ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited $menu[ $key ][0] .= $count ? ' ' : ''; } } } /** * Add translation request alert based on user's browser language preferences. * * @param array $alerts { * @type string $code Alert code. * @type string $message Alert message. * @type string $type Alert type. * @type string $html Optional. Alert HTML. * @type int $priority Optional. Alert priority. * @type mixed $dismissible Optional. Dismissible setting. * @type bool $global Optional. Global alert. * @type array $actions Optional. Alert actions. * } * * @return array * }> */ public static function translation_request( $alerts = [] ) { $version = explode( '.', Popup_Maker::$VER ); // Get only the major.minor version exclude the point releases. $version = $version[0] . '.' . $version[1]; $code = 'translation_request_' . $version; // Bail Early if they have already dismissed. if ( self::has_dismissed_alert( $code ) ) { return $alerts; } // Get locales based on the HTTP accept language header. $locales_from_header = PUM_Utils_I10n::get_http_locales(); // Abort early if no locales in header. if ( empty( $locales_from_header ) ) { return $alerts; } // Get acceptable non EN WordPress locales based on the HTTP accept language header. // Used when the current locale is EN only I believe. $non_en_locales_from_header = PUM_Utils_I10n::get_non_en_accepted_wp_locales_from_header(); // If no additional languages are supported abort if ( empty( $non_en_locales_from_header ) ) { return $alerts; } /** * Assume all at this point are possible polyglots. * * Viewing in English! * -- Translation available in one additional language! * ---- Show notice that there other language is available and we need help translating. * -- Translation available in more than one language! * ---- Show notice that their other languages are available and need help translating. * -- Translation not available! * ---- Show notice that plugin is not translated and we need help. * Else If translation for their language(s) exists, but isn't up to date! * -- Show notice that their language is available, but out of date and need help translating. * Else If translations for their language doesn't exist! * -- Show notice that plugin is not translated and we need help. */ $current_locale = function_exists( 'get_user_locale' ) ? get_user_locale() : get_locale(); // Get the active language packs of the plugin. $translation_status = PUM_Utils_I10n::translation_status(); // Retrieve all the WordPress locales in which the plugin is translated. $locales_with_translations = wp_list_pluck( $translation_status, 'language' ); $locale_translation_versions = wp_list_pluck( $translation_status, 'version' ); // Suggests existing langpacks $suggested_locales_with_langpack = array_values( array_intersect( $non_en_locales_from_header, $locales_with_translations ) ); $current_locale_is_suggested = in_array( $current_locale, $suggested_locales_with_langpack, true ); $current_locale_is_translated = in_array( $current_locale, $locales_with_translations, true ); // Last chance to abort early before querying all available languages. // We abort here if the user is already using a translated language that is up to date! if ( $current_locale_is_suggested && $current_locale_is_translated && version_compare( $locale_translation_versions[ $current_locale ], Popup_Maker::$VER, '>=' ) ) { return $alerts; } // Retrieve all the WordPress locales. $locales_supported_by_wordpress = PUM_Utils_I10n::available_locales(); // Get the native language names of the locales. $suggest_translated_locale_names = []; foreach ( $suggested_locales_with_langpack as $locale ) { $suggest_translated_locale_names[ $locale ] = $locales_supported_by_wordpress[ $locale ]['native_name']; } $suggest_string = ''; // If we get this far, they clearly have multiple language available // If current locale is english but they have others available, they are likely polyglots. $currently_in_english = strpos( $current_locale, 'en' ) === 0; // Currently in English. if ( $currently_in_english ) { // Only one locale suggestion. if ( 1 === count( $suggest_translated_locale_names ) ) { $language = current( $suggest_translated_locale_names ); $suggest_string = sprintf( /* translators: %s: native language name. */ __( 'This plugin is also available in %1$s. Help improve the translation!', 'popup-maker' ), $language, esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); // Multiple locale suggestions. } elseif ( ! empty( $suggest_translated_locale_names ) ) { $primary_language = current( $suggest_translated_locale_names ); array_shift( $suggest_translated_locale_names ); $other_suggest = ''; foreach ( $suggest_translated_locale_names as $language ) { $other_suggest .= $language . ', '; } $suggest_string = sprintf( /* translators: 1: native language name, 2: other native language names, comma separated */ __( 'This plugin is also available in %1$s (also: %2$s). Help improve the translation!', 'popup-maker' ), $primary_language, trim( $other_suggest, ' ,' ), esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); // Non-English locale in header, no translations. } elseif ( count( $non_en_locales_from_header ) ) { if ( 1 === count( $non_en_locales_from_header ) ) { $locale = reset( $non_en_locales_from_header ); $suggest_string = sprintf( /* translators: 1: native language name, 2: URL to translate.wordpress.org */ __( 'This plugin is not translated into %1$s yet. Help translate it!', 'popup-maker' ), $locales_supported_by_wordpress[ $locale ]['native_name'], esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); } else { $primary_locale = reset( $non_en_locales_from_header ); $primary_language = $locales_supported_by_wordpress[ $primary_locale ]['native_name']; array_shift( $non_en_locales_from_header ); $other_suggest = ''; foreach ( $non_en_locales_from_header as $locale ) { $other_suggest .= $locales_supported_by_wordpress[ $locale ]['native_name'] . ', '; } $suggest_string = sprintf( /* translators: 1: native language name, 2: other native language names, comma separated */ __( 'This plugin is also available in %1$s (also: %2$s). Help improve the translation!', 'popup-maker' ), $primary_language, trim( $other_suggest, ' ,' ), esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); } } // The plugin has no translation for the current locale. } elseif ( ! $current_locale_is_suggested && ! $current_locale_is_translated ) { $suggest_string = sprintf( /* translators: 1. Native language name, 2. URL to translation. */ __( 'This plugin is not translated into %1$s yet. Help translate it!', 'popup-maker' ), $locales_supported_by_wordpress[ $current_locale ]['native_name'], esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); // The plugin has translations for current locale, but they are out of date. } elseif ( $current_locale_is_suggested && $current_locale_is_translated && version_compare( $locale_translation_versions[ $current_locale ], Popup_Maker::$VER, '<' ) ) { $suggest_string = sprintf( /* translators: %s: native language name. */ __( 'This plugin\'s translation for %1$s is out of date. Help improve the translation!', 'popup-maker' ), $locales_supported_by_wordpress[ $current_locale ]['native_name'], esc_url( 'https://translate.wordpress.org/projects/wp-plugins/popup-maker' ) ); } if ( ! empty( $suggest_string ) ) { $alerts[] = [ 'code' => $code, 'message' => $suggest_string, 'type' => 'info', ]; } return $alerts; } /** * Add "What's New" alerts for major version updates. * * @param array $alerts { * @type string $code Alert code. * @type string $message Alert message. * @type string $type Alert type. * @type string $html Optional. Alert HTML. * @type int $priority Optional. Alert priority. * @type mixed $dismissible Optional. Dismissible setting. * @type bool $global Optional. Global alert. * @type array $actions Optional. Alert actions. * } * * @return array * }> */ public static function whats_new_alerts( $alerts = [] ) { $upgraded_from = PUM_Utils_Upgrades::$upgraded_from; if ( version_compare( $upgraded_from, '0.0.0', '>' ) ) { if ( version_compare( $upgraded_from, '1.8.0', '<' ) ) { $alerts[] = [ 'code' => 'whats_new_1_8_0', 'type' => 'success', 'message' => sprintf( /* translators: 1. Version number, 2. URL to changelog, 3. closing HTML tag. */ '' . esc_html__( 'See whats new in v%1$s - (%2$sview all changes%3$s)', 'popup-maker' ) . '', '1.8.0', '', '' ), 'html' => "", 'priority' => 100, ]; } } return $alerts; } /** * Add alerts for available plugin integrations based on detected plugins. * * @param array $alerts { * @type string $code Alert code. * @type string $message Alert message. * @type string $type Alert type. * @type string $html Optional. Alert HTML. * @type int $priority Optional. Alert priority. * @type mixed $dismissible Optional. Dismissible setting. * @type bool $global Optional. Global alert. * @type array $actions Optional. Alert actions. * } * * @return array * }> */ public static function integration_alerts( $alerts = [] ) { $integrations = [ 'buddypress' => [ // phpcs:ignore WordPress.WP.I18n.TextDomainMismatch 'label' => __( 'BuddyPress', 'buddypress' ), 'learn_more_url' => 'https://wppopupmaker.com/social-integrations/buddypress/', 'conditions' => ! class_exists( 'PUM_BuddyPress' ) && ( function_exists( 'buddypress' ) || class_exists( 'BuddyPress' ) ), 'slug' => 'popup-maker-buddypress-integration', 'name' => 'Popup Maker - BuddyPress Integration', 'free' => true, ], ]; foreach ( $integrations as $key => $integration ) { if ( $integration['conditions'] ) { $path = "{$integration['slug']}/{$integration['slug']}.php"; $plugin_data = file_exists( WP_PLUGIN_DIR . '/' . $path ) ? get_plugin_data( WP_PLUGIN_DIR . '/' . $path, false, false ) : false; $installed = $plugin_data && ! empty( $plugin_data['Name'] ) && $plugin_data['Name'] === $integration['name']; $text = $installed ? __( 'activate it now', 'popup-maker' ) : __( 'install it now', 'popup-maker' ); $url = $installed ? esc_url( wp_nonce_url( admin_url( 'plugins.php?action=activate&plugin=' . $path ), 'activate-plugin_' . $path ) ) : esc_url( wp_nonce_url( self_admin_url( 'update.php?action=install-plugin&plugin=popup-maker-buddypress-integration' ), 'install-plugin_popup-maker-buddypress-integration' ) ); $alerts[] = [ 'code' => $key . '_integration_available', 'message' => sprintf( /* translators: 1. Opening HTML tag, 2. Closing HTML tag, 3. Integration name, 4. Learn more URL, 5. Opening HTML tag, 6. Closing HTML tag, 7. Activate/Install URL, 8. Activate/Install text. */ __( '%1$sDid you know:%2$s Popup Maker has custom integrations with %3$s, %4$slearn more%5$s or %6$s%7$s%8$s!', 'popup-maker' ), '', '', $integration['label'], '', '', '', $text, '' ), 'dismissible' => true, 'global' => false, 'type' => $installed ? 'warning' : 'info', ]; } } return $alerts; } /** * Hook into relevant WP actions for displaying admin notices. * * @return void */ public static function hooks() { if ( is_admin() && current_user_can( 'edit_posts' ) ) { add_action( 'admin_notices', [ __CLASS__, 'admin_notices' ] ); add_action( 'network_admin_notices', [ __CLASS__, 'admin_notices' ] ); add_action( 'user_admin_notices', [ __CLASS__, 'admin_notices' ] ); } } /** * @return bool */ public static function should_show_alerts() { return in_array( true, [ pum_is_admin_page(), count( self::get_global_alerts() ) > 0, ], true ); } /** * Allow additional style properties for notice alerts. * * @param string[] $styles Array of allowed style properties. * @return string[] */ public static function allow_inline_styles( $styles ) { $styles[] = 'display'; $styles[] = 'list-style'; $styles[] = 'margin'; $styles[] = 'padding'; $styles[] = 'margin-left'; $styles[] = 'margin-right'; $styles[] = 'margin-top'; $styles[] = 'margin-bottom'; return $styles; } /** * Return array of allowed html tags for wp_kses. * * @return array> */ public static function allowed_tags() { return array_merge_recursive( wp_kses_allowed_html( 'post' ), // Allow script tags with type="" attribute. [ 'script' => [ 'type' => true ], 'progress' => [ 'class' => true, 'max' => true, 'min' => true, ], 'input' => [ 'type' => true, 'class' => true, 'id' => true, 'name' => true, 'value' => true, 'checked' => true, ], 'button' => [ 'type' => true, 'class' => true, 'id' => true, 'name' => true, 'value' => true, ], 'fieldset' => [ 'class' => true, 'id' => true, 'name' => true, ], 'legend' => [ 'class' => true, 'id' => true, 'name' => true, ], 'div' => [ 'class' => true, 'id' => true, 'name' => true, ], 'span' => [ 'class' => true, 'id' => true, 'name' => true, ], 'ul' => [ 'class' => true, 'id' => true, 'name' => true, ], 'li' => [ 'class' => true, 'id' => true, 'name' => true, ], 'label' => [ 'class' => true, 'id' => true, 'name' => true, 'for' => true, ], 'select' => [ 'class' => true, 'id' => true, 'name' => true, 'for' => true, ], 'option' => [ 'class' => true, 'id' => true, 'name' => true, 'for' => true, ], 'form' => [ 'action' => true, 'method' => true, 'id' => true, 'class' => true, 'style' => true, 'data-*' => true, ], 'img' => [ 'class' => true, 'id' => true, 'name' => true, 'src' => true, 'alt' => true, 'width' => true, 'height' => true, ], ] ); } /** * Render admin alerts if available. * * @return void */ public static function admin_notices() { if ( ! self::should_show_alerts() ) { return; } $global_only = ! pum_is_admin_page(); $alerts = $global_only ? self::get_global_alerts() : self::get_alerts(); $count = count( $alerts ); if ( ! $count ) { return; } wp_enqueue_script( 'pum-admin-general' ); wp_enqueue_style( 'pum-admin-general' ); $nonce = wp_create_nonce( 'pum_alerts_action' ); ?>

' . esc_html( (string) $count ) . '' ); ?>

$nonce, 'code' => $alert['code'], 'pum_dismiss_alert' => 'dismiss', 'expires' => $expires, ] ); ?>

    ' . esc_html( $action['text'] ) . '' : esc_html( $action['text'] ); if ( 'link' === $action['type'] ) { $url = $action['href'] ?? '#'; $attributes = 'target="_blank" rel="noreferrer noopener"'; } else { $url = add_query_arg( [ 'nonce' => $nonce, 'code' => $alert['code'], 'pum_dismiss_alert' => $action['action'], 'expires' => $expires, ] ); $attributes = 'class="pum-dismiss"'; } ?>
  • >
* }> */ public static function get_global_alerts() { $alerts = self::get_alerts(); $global_alerts = []; foreach ( $alerts as $alert ) { if ( $alert['global'] ) { $global_alerts[] = $alert; } } return $global_alerts; } /** * Get all alerts with defaults applied and filtered by dismissal status. * * @return array * }> */ public static function get_alerts() { static $alert_list; if ( ! isset( $alert_list ) ) { $alert_list = apply_filters( 'pum_alert_list', [] ); } $alerts = []; foreach ( $alert_list as $alert ) { // Ignore dismissed alerts. if ( self::has_dismissed_alert( $alert['code'] ) ) { continue; } $alerts[] = wp_parse_args( $alert, [ 'code' => 'default', 'priority' => 10, 'message' => '', 'type' => 'info', 'html' => '', 'dismissible' => true, 'global' => false, ] ); } // Sort alerts by priority, highest to lowest. $alerts = PUM_Utils_Array::sort( $alerts, 'priority', true ); return $alerts; } /** * Handles alert dismissal via AJAX. * * @return void */ public static function ajax_handler() { if ( ! isset( $_REQUEST['nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_REQUEST['nonce'] ) ), 'pum_alerts_action' ) ) { wp_send_json_error(); } $args = wp_parse_args( $_REQUEST, [ 'code' => '', 'expires' => '', 'pum_dismiss_alert' => '', ] ); $results = self::action_handler( $args['code'], $args['pum_dismiss_alert'], $args['expires'] ); if ( true === $results ) { wp_send_json_success(); } else { wp_send_json_error(); } } /** * Handles alert dismissal by page reload instead of AJAX. * * @since 1.11.0 * @return void */ public static function php_handler() { if ( ! isset( $_REQUEST['pum_dismiss_alert'] ) ) { return; } if ( ! isset( $_REQUEST['nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_REQUEST['nonce'] ) ), 'pum_alerts_action' ) ) { return; } $args = wp_parse_args( $_REQUEST, [ 'code' => '', 'expires' => '', 'pum_dismiss_alert' => '', ] ); self::action_handler( $args['code'], $args['pum_dismiss_alert'], $args['expires'] ); } /** * Handles the action taken on the alert. * * @param string $code The specific alert. * @param string $action Which action was taken * @param string $expires When the dismissal expires, if any. * * @return bool * @uses PUM_Utils_Logging::instance * @uses PUM_Utils_Logging::log * @since 1.11.0 */ public static function action_handler( $code, $action, $expires ) { if ( empty( $action ) || 'dismiss' === $action ) { try { $dismissed_alerts = self::dismissed_alerts(); $dismissed_alerts[ $code ] = ! empty( $expires ) ? strtotime( '+' . $expires ) : true; $user_id = get_current_user_id(); update_user_meta( $user_id, '_pum_dismissed_alerts', $dismissed_alerts ); return true; } catch ( Exception $e ) { pum_log_message( 'Error dismissing alert. Exception: ' . $e->getMessage() ); return false; } } do_action( 'pum_alert_dismissed', $code, $action ); return true; } /** * @param string $code * * @return bool */ public static function has_dismissed_alert( $code = '' ) { $dimissed_alerts = self::dismissed_alerts(); $alert_dismissed = array_key_exists( $code, $dimissed_alerts ); // If the alert was dismissed and has a non true type value, it is an expiry time. if ( $alert_dismissed && true !== $dimissed_alerts[ $code ] ) { return strtotime( 'now' ) < $dimissed_alerts[ $code ]; } return $alert_dismissed; } /** * Returns an array of dismissed alert groups. * * @return array */ public static function dismissed_alerts() { $user_id = get_current_user_id(); $dismissed_alerts = get_user_meta( $user_id, '_pum_dismissed_alerts', true ); if ( ! is_array( $dismissed_alerts ) ) { $dismissed_alerts = []; update_user_meta( $user_id, '_pum_dismissed_alerts', $dismissed_alerts ); } return $dismissed_alerts; } }