khaihihi

wp-content/plugins/wordpress-seo/vendor/yoast/i18n-module/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/) 
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## 3.1.1
+
+### Fixed
+- Reverts the capitalization of the class names.
+
+## 3.1.0
+
+### Fixed
+- Fixes a bug where a 'You're using WordPress in a language we don't support yet.' notice would be shown for formal and informal locales when the locale actually was supported.
+
+## 3.0.0
+
+### Added
+- Added functionality to handle how the i18n-promobox notification is displayed.
+
+### Changed
+- [DEPRECATION] Postfix all classes with _v3. This prevents autoload collisions with 2.0 versions.
+
+## 2.0.0
+
+### Added
+- Add native support for WordPress.org
+
+### Changed
+- [DEPRECATION] Postfix all classes with _v2. This prevents autoload collisions with 1.0 versions. 
+
+## 1.2.1
+
+### Removed
+- Remove backwards incompatible changes. These are only backwards incompatible in a WordPress context, but this is the target audience.
+
+## 1.2.0
+
+### Added
+- Add native support for WordPress.org
+
+## 1.1.0
+
+### Changed
+- Use the user locale for deciding whether to display the message to the user.
+
+## 1.0.1
+
+### Fixed
+- Fix issue where a notice would be shown if the API response had no wp_locale.
+
+## 1.0.0
+
+### Added
+- Initial release of the i18n module to show the user a notice about their
+language not having been translated to 100%.

wp-content/plugins/wordpress-seo/vendor/yoast/i18n-module/src/i18n-v3.php

@@ -0,0 +1,418 @@
+<?php
+/**
+ * Yoast I18n module.
+ *
+ * @package Yoast\I18n-module
+ */
+
+/**
+ * This class defines a promo box and checks your translation site's API for stats about it,
+ * then shows them to the user.
+ */
+class Yoast_I18n_v3 {
+
+	/**
+	 * Your translation site's logo.
+	 *
+	 * @var string
+	 */
+	private $glotpress_logo;
+
+	/**
+	 * Your translation site's name.
+	 *
+	 * @var string
+	 */
+	private $glotpress_name;
+
+	/**
+	 * Your translation site's URL.
+	 *
+	 * @var string
+	 */
+	private $glotpress_url;
+
+	/**
+	 * The URL to actually do the API request to.
+	 *
+	 * @var string
+	 */
+	private $api_url;
+
+	/**
+	 * Hook where you want to show the promo box.
+	 *
+	 * @var string
+	 */
+	private $hook;
+
+	/**
+	 * Will contain the site's locale.
+	 *
+	 * @access private
+	 * @var string
+	 */
+	private $locale;
+
+	/**
+	 * Will contain the locale's name, obtained from your translation site.
+	 *
+	 * @access private
+	 * @var string
+	 */
+	private $locale_name;
+
+	/**
+	 * Will contain the percentage translated for the plugin translation project in the locale.
+	 *
+	 * @access private
+	 * @var int
+	 */
+	private $percent_translated;
+
+	/**
+	 * Name of your plugin.
+	 *
+	 * @var string
+	 */
+	private $plugin_name;
+
+	/**
+	 * Project slug for the project on your translation site.
+	 *
+	 * @var string
+	 */
+	private $project_slug;
+
+	/**
+	 * URL to point to for registration links.
+	 *
+	 * @var string
+	 */
+	private $register_url;
+
+	/**
+	 * Your plugins textdomain.
+	 *
+	 * @var string
+	 */
+	private $textdomain;
+
+	/**
+	 * Indicates whether there's a translation available at all.
+	 *
+	 * @access private
+	 * @var bool
+	 */
+	private $translation_exists;
+
+	/**
+	 * Indicates whether the translation's loaded.
+	 *
+	 * @access private
+	 * @var bool
+	 */
+	private $translation_loaded;
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param array $args                 Contains the settings for the class.
+	 * @param bool  $show_translation_box Whether the translation box should be shown.
+	 */
+	public function __construct( $args, $show_translation_box = true ) {
+		if ( ! is_admin() ) {
+			return;
+		}
+
+		$this->locale = $this->get_admin_locale();
+
+		if ( $this->is_default_language( $this->locale ) ) {
+			return;
+		}
+
+		$this->init( $args );
+
+		if ( $show_translation_box ) {
+			add_action( $this->hook, array( $this, 'promo' ) );
+		}
+	}
+
+	/**
+	 * Returns whether the language is en_US.
+	 *
+	 * @param string $language The language to check.
+	 *
+	 * @return bool Returns true if the language is en_US.
+	 */
+	protected function is_default_language( $language ) {
+		return 'en_US' === $language;
+	}
+
+	/**
+	 * Returns the locale used in the admin.
+	 *
+	 * WordPress 4.7 introduced the ability for users to specify an Admin language
+	 * different from the language used on the front end. This checks if the feature
+	 * is available and returns the user's language, with a fallback to the site's language.
+	 * Can be removed when support for WordPress 4.6 will be dropped, in favor
+	 * of WordPress get_user_locale() that already fallbacks to the site’s locale.
+	 *
+	 * @returns string The locale.
+	 */
+	private function get_admin_locale() {
+		if ( function_exists( 'get_user_locale' ) ) {
+			return get_user_locale();
+		}
+
+		return get_locale();
+	}
+
+	/**
+	 * This is where you decide where to display the messages and where you set the plugin specific variables.
+	 *
+	 * @access private
+	 *
+	 * @param array $args Contains the settings for the class.
+	 */
+	private function init( $args ) {
+		foreach ( $args as $key => $arg ) {
+			$this->$key = $arg;
+		}
+	}
+
+	/**
+	 * Check whether the promo should be hidden or not.
+	 *
+	 * @access private
+	 *
+	 * @return bool
+	 */
+	private function hide_promo() {
+		$hide_promo = get_transient( 'yoast_i18n_' . $this->project_slug . '_promo_hide' );
+		if ( ! $hide_promo ) {
+			if ( filter_input( INPUT_GET, 'remove_i18n_promo', FILTER_VALIDATE_INT ) === 1 ) {
+				// No expiration time, so this would normally not expire, but it wouldn't be copied to other sites etc.
+				set_transient( 'yoast_i18n_' . $this->project_slug . '_promo_hide', true );
+				$hide_promo = true;
+			}
+		}
+		return $hide_promo;
+	}
+
+	/**
+	 * Returns the i18n_promo message from the i18n_module. Returns en empty string if the promo shouldn't be shown.
+	 *
+	 * @access public
+	 *
+	 * @return string The i18n promo message.
+	 */
+	public function get_promo_message() {
+		if ( ! $this->is_default_language( $this->locale ) && ! $this->hide_promo() ) {
+			return $this->promo_message();
+		}
+
+		return '';
+	}
+
+	/**
+	 * Generates a promo message.
+	 *
+	 * @access private
+	 *
+	 * @return bool|string $message
+	 */
+	private function promo_message() {
+
+		$this->translation_details();
+
+		$message = false;
+
+		if ( $this->translation_exists && $this->translation_loaded && $this->percent_translated < 90 ) {
+			/* translators: 1: language name; 3: completion percentage; 4: link to translation platform. */
+			$message = __( 'As you can see, there is a translation of this plugin in %1$s. This translation is currently %3$d%% complete. We need your help to make it complete and to fix any errors. Please register at %4$s to help complete the translation to %1$s!', $this->textdomain );
+		}
+		elseif ( ! $this->translation_loaded && $this->translation_exists ) {
+			/* translators: 1: language name; 2: plugin name; 3: completion percentage; 4: link to translation platform. */
+			$message = __( 'You\'re using WordPress in %1$s. While %2$s has been translated to %1$s for %3$d%%, it\'s not been shipped with the plugin yet. You can help! Register at %4$s to help complete the translation to %1$s!', $this->textdomain );
+		}
+		elseif ( ! $this->translation_exists ) {
+			/* translators: 2: plugin name; 4: link to translation platform. */
+			$message = __( 'You\'re using WordPress in a language we don\'t support yet. We\'d love for %2$s to be translated in that language too, but unfortunately, it isn\'t right now. You can change that! Register at %4$s to help translate it!', $this->textdomain );
+		}
+
+		$registration_link = sprintf(
+			'<a href="%1$s">%2$s</a>',
+			esc_url( $this->register_url ),
+			esc_html( $this->glotpress_name )
+		);
+
+		$message = sprintf(
+			esc_html( $message ),
+			esc_html( $this->locale_name ),
+			esc_html( $this->plugin_name ),
+			(int) $this->percent_translated,
+			$registration_link
+		);
+
+		if ( $message ) {
+			$message = '<p>' . $message . '</p><p><a href="' . esc_url( $this->register_url ) . '">' . esc_html__( 'Register now &raquo;', $this->textdomain ) . '</a></p>';
+		}
+
+		return $message;
+	}
+
+	/**
+	 * Returns a button that can be used to dismiss the i18n-message.
+	 *
+	 * @access private
+	 *
+	 * @return string
+	 */
+	public function get_dismiss_i18n_message_button() {
+		return sprintf(
+			/* translators: %1$s is the notification dismissal link start tag, %2$s is the link closing tag. */
+			esc_html__( '%1$sPlease don\'t show me this notification anymore%2$s', $this->textdomain ),
+			'<a class="button" href="' . esc_url( add_query_arg( array( 'remove_i18n_promo' => '1' ) ) ) . '">',
+			'</a>'
+		);
+	}
+
+	/**
+	 * Outputs a promo box.
+	 *
+	 * @access public
+	 */
+	public function promo() {
+		$message = $this->get_promo_message();
+
+		if ( $message ) {
+			echo '<div id="i18n_promo_box" style="border:1px solid #ccc;background-color:#fff;padding:10px;max-width:650px; overflow: hidden;">';
+			echo '<a href="' . esc_url( add_query_arg( array( 'remove_i18n_promo' => '1' ) ) ) . '" style="color:#333;text-decoration:none;font-weight:bold;font-size:16px;border:1px solid #ccc;padding:1px 4px;" class="alignright">X</a>';
+
+			echo '<div>';
+			/* translators: %s: plugin name. */
+			echo '<h2>' . sprintf( esc_html__( 'Translation of %s', $this->textdomain ), esc_html( $this->plugin_name ) ) . '</h2>';
+			if ( isset( $this->glotpress_logo ) && is_string( $this->glotpress_logo ) && '' !== $this->glotpress_logo ) {
+				echo '<a href="' . esc_url( $this->register_url ) . '"><img class="alignright" style="margin:0 5px 5px 5px;max-width:200px;" src="' . esc_url( $this->glotpress_logo ) . '" alt="' . esc_attr( $this->glotpress_name ) . '"/></a>';
+			}
+			// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- correctly escaped in promo_message() method.
+			echo $message;
+			echo '</div>';
+			echo '</div>';
+		}
+	}
+
+	/**
+	 * Try to find the transient for the translation set or retrieve them.
+	 *
+	 * @access private
+	 *
+	 * @return object|null
+	 */
+	private function find_or_initialize_translation_details() {
+		$set = get_transient( 'yoast_i18n_' . $this->project_slug . '_' . $this->locale );
+
+		if ( ! $set ) {
+			$set = $this->retrieve_translation_details();
+			set_transient( 'yoast_i18n_' . $this->project_slug . '_' . $this->locale, $set, DAY_IN_SECONDS );
+		}
+
+		return $set;
+	}
+
+	/**
+	 * Try to get translation details from cache, otherwise retrieve them, then parse them.
+	 *
+	 * @access private
+	 */
+	private function translation_details() {
+		$set = $this->find_or_initialize_translation_details();
+
+		$this->translation_exists = ! is_null( $set );
+		$this->translation_loaded = is_textdomain_loaded( $this->textdomain );
+
+		$this->parse_translation_set( $set );
+	}
+
+	/**
+	 * The API URL to use when requesting translation information.
+	 *
+	 * @param string $api_url The new API URL.
+	 */
+	public function set_api_url( $api_url ) {
+		$this->api_url = $api_url;
+	}
+
+	/**
+	 * Returns the API URL to use when requesting translation information.
+	 *
+	 * @return string
+	 */
+	private function get_api_url() {
+		if ( empty( $this->api_url ) ) {
+			$this->api_url = trailingslashit( $this->glotpress_url ) . 'api/projects/' . $this->project_slug;
+		}
+
+		return $this->api_url;
+	}
+
+	/**
+	 * Retrieve the translation details from Yoast Translate.
+	 *
+	 * @access private
+	 *
+	 * @return object|null
+	 */
+	private function retrieve_translation_details() {
+		$api_url = $this->get_api_url();
+
+		$resp = wp_remote_get( $api_url );
+		if ( is_wp_error( $resp ) || wp_remote_retrieve_response_code( $resp ) !== 200 ) {
+			return null;
+		}
+		$body = wp_remote_retrieve_body( $resp );
+		unset( $resp );
+
+		if ( $body ) {
+			$body = json_decode( $body );
+			if ( empty( $body->translation_sets ) ) {
+				return null;
+			}
+			foreach ( $body->translation_sets as $set ) {
+				if ( ! property_exists( $set, 'wp_locale' ) ) {
+					continue;
+				}
+
+				// For informal and formal locales, we have to complete the locale code by concatenating the slug ('formal' or 'informal') to the xx_XX part.
+				if ( $set->slug !== 'default' && strtolower( $this->locale ) === strtolower( $set->wp_locale . '_' . $set->slug ) ) {
+					return $set;
+				}
+
+				if ( $this->locale === $set->wp_locale ) {
+					return $set;
+				}
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Set the needed private variables based on the results from Yoast Translate.
+	 *
+	 * @param object $set The translation set.
+	 *
+	 * @access private
+	 */
+	private function parse_translation_set( $set ) {
+		if ( $this->translation_exists && is_object( $set ) ) {
+			$this->locale_name        = $set->name;
+			$this->percent_translated = $set->percent_translated;
+		}
+		else {
+			$this->locale_name        = '';
+			$this->percent_translated = '';
+		}
+	}
+}

wp-content/plugins/wordpress-seo/vendor/yoast/i18n-module/src/i18n-wordpressorg-v3.php

@@ -0,0 +1,93 @@
+<?php
+/**
+ * Yoast I18n module.
+ *
+ * @package Yoast\I18n-module
+ */
+
+/**
+ * The Yoast i18n module with a connection to WordPress.org.
+ */
+class Yoast_I18n_WordPressOrg_v3 {
+
+	/**
+	 * The i18n object that presents the user with the notification.
+	 *
+	 * @var yoast_i18n_v3
+	 */
+	protected $i18n;
+
+	/**
+	 * Constructs the i18n module for wordpress.org.
+	 *
+	 * Required fields are the 'textdomain', 'plugin_name' and 'hook'.
+	 *
+	 * @param array $args                 The settings for the i18n module.
+	 * @param bool  $show_translation_box Whether the translation box should be shown.
+	 */
+	public function __construct( $args, $show_translation_box = true ) {
+		$args = $this->set_defaults( $args );
+
+		$this->i18n = new Yoast_I18n_v3( $args, $show_translation_box );
+		$this->set_api_url( $args['textdomain'] );
+	}
+
+	/**
+	 * Returns the i18n_promo message from the i18n_module.
+	 *
+	 * @access public
+	 *
+	 * @return string The i18n promo message or an empty string if the promo shouldn't be shown.
+	 */
+	public function get_promo_message() {
+		return $this->i18n->get_promo_message();
+	}
+
+	/**
+	 * Returns a button that can be used to dismiss the i18n-message.
+	 *
+	 * @access private
+	 *
+	 * @return string
+	 */
+	public function get_dismiss_i18n_message_button() {
+		return $this->i18n->get_dismiss_i18n_message_button();
+	}
+
+	/**
+	 * Sets the default values for wordpress.org
+	 *
+	 * @param array $args The arguments to set defaults for.
+	 *
+	 * @return array The arguments with the arguments set.
+	 */
+	private function set_defaults( $args ) {
+
+		if ( ! isset( $args['glotpress_logo'] ) ) {
+			$args['glotpress_logo'] = 'https://plugins.svn.wordpress.org/' . $args['textdomain'] . '/assets/icon-128x128.png';
+		}
+
+		if ( ! isset( $args['register_url'] ) ) {
+			$args['register_url'] = 'https://translate.wordpress.org/projects/wp-plugins/' . $args['textdomain'] . '/';
+		}
+
+		if ( ! isset( $args['glotpress_name'] ) ) {
+			$args['glotpress_name'] = 'Translating WordPress';
+		}
+
+		if ( ! isset( $args['project_slug'] ) ) {
+			$args['project_slug'] = $args['textdomain'];
+		}
+
+		return $args;
+	}
+
+	/**
+	 * Set the API URL on the i18n object.
+	 *
+	 * @param string $textdomain The textdomain to use for the API URL.
+	 */
+	private function set_api_url( $textdomain ) {
+		$this->i18n->set_api_url( 'https://translate.wordpress.org/api/projects/wp-plugins/' . $textdomain . '/stable/' );
+	}
+}