<h2>File Contents: /home/planet5/www/wp-content/plugins/wordpress-seo-premium/vendor/yoast/i18n-module/src/i18n-v3.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/wordpress-seo-premium/vendor/yoast/i18n-module/src/i18n-v3.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Yoast I18n module.
 *
 * @package Yoast\I18n-module
 */

/**
 * This class defines a promo box and checks your translation site&#039;s API for stats about it,
 * then shows them to the user.
 */
class Yoast_I18n_v3 {

	/**
	 * Your translation site&#039;s logo.
	 *
	 * @var string
	 */
	private $glotpress_logo;

	/**
	 * Your translation site&#039;s name.
	 *
	 * @var string
	 */
	private $glotpress_name;

	/**
	 * Your translation site&#039;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&#039;s locale.
	 *
	 * @access private
	 * @var string
	 */
	private $locale;

	/**
	 * Will contain the locale&#039;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&#039;s a translation available at all.
	 *
	 * @access private
	 * @var bool
	 */
	private $translation_exists;

	/**
	 * Indicates whether the translation&#039;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-&gt;locale = $this-&gt;get_admin_locale();

		if ( $this-&gt;is_default_language( $this-&gt;locale ) ) {
			return;
		}

		$this-&gt;init( $args );

		if ( $show_translation_box ) {
			add_action( $this-&gt;hook, array( $this, &#039;promo&#039; ) );
		}
	}

	/**
	 * 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 &#039;en_US&#039; === $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&#039;s language, with a fallback to the site&#039;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( &#039;get_user_locale&#039; ) ) {
			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 =&gt; $arg ) {
			$this-&gt;$key = $arg;
		}
	}

	/**
	 * Check whether the promo should be hidden or not.
	 *
	 * @access private
	 *
	 * @return bool
	 */
	private function hide_promo() {
		$hide_promo = get_transient( &#039;yoast_i18n_&#039; . $this-&gt;project_slug . &#039;_promo_hide&#039; );
		if ( ! $hide_promo ) {
			if ( filter_input( INPUT_GET, &#039;remove_i18n_promo&#039;, FILTER_VALIDATE_INT ) === 1 ) {
				// No expiration time, so this would normally not expire, but it wouldn&#039;t be copied to other sites etc.
				set_transient( &#039;yoast_i18n_&#039; . $this-&gt;project_slug . &#039;_promo_hide&#039;, true );
				$hide_promo = true;
			}
		}
		return $hide_promo;
	}

	/**
	 * Returns the i18n_promo message from the i18n_module. Returns en empty string if the promo shouldn&#039;t be shown.
	 *
	 * @access public
	 *
	 * @return string The i18n promo message.
	 */
	public function get_promo_message() {
		if ( ! $this-&gt;is_default_language( $this-&gt;locale ) &amp;&amp; ! $this-&gt;hide_promo() ) {
			return $this-&gt;promo_message();
		}

		return &#039;&#039;;
	}

	/**
	 * Generates a promo message.
	 *
	 * @access private
	 *
	 * @return bool|string $message
	 */
	private function promo_message() {

		$this-&gt;translation_details();

		$message = false;

		if ( $this-&gt;translation_exists &amp;&amp; $this-&gt;translation_loaded &amp;&amp; $this-&gt;percent_translated &lt; 90 ) {
			/* translators: 1: language name; 3: completion percentage; 4: link to translation platform. */
			$message = __( &#039;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!&#039;, $this-&gt;textdomain );
		}
		elseif ( ! $this-&gt;translation_loaded &amp;&amp; $this-&gt;translation_exists ) {
			/* translators: 1: language name; 2: plugin name; 3: completion percentage; 4: link to translation platform. */
			$message = __( &#039;You\&#039;re using WordPress in %1$s. While %2$s has been translated to %1$s for %3$d%%, it\&#039;s not been shipped with the plugin yet. You can help! Register at %4$s to help complete the translation to %1$s!&#039;, $this-&gt;textdomain );
		}
		elseif ( ! $this-&gt;translation_exists ) {
			/* translators: 2: plugin name; 4: link to translation platform. */
			$message = __( &#039;You\&#039;re using WordPress in a language we don\&#039;t support yet. We\&#039;d love for %2$s to be translated in that language too, but unfortunately, it isn\&#039;t right now. You can change that! Register at %4$s to help translate it!&#039;, $this-&gt;textdomain );
		}

		$registration_link = sprintf(
			&#039;&lt;a href=&quot;%1$s&quot;&gt;%2$s&lt;/a&gt;&#039;,
			esc_url( $this-&gt;register_url ),
			esc_html( $this-&gt;glotpress_name )
		);

		$message = sprintf(
			esc_html( $message ),
			esc_html( $this-&gt;locale_name ),
			esc_html( $this-&gt;plugin_name ),
			(int) $this-&gt;percent_translated,
			$registration_link
		);

		if ( $message ) {
			$message = &#039;&lt;p&gt;&#039; . $message . &#039;&lt;/p&gt;&lt;p&gt;&lt;a href=&quot;&#039; . esc_url( $this-&gt;register_url ) . &#039;&quot;&gt;&#039; . esc_html__( &#039;Register now &amp;raquo;&#039;, $this-&gt;textdomain ) . &#039;&lt;/a&gt;&lt;/p&gt;&#039;;
		}

		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__( &#039;%1$sPlease don\&#039;t show me this notification anymore%2$s&#039;, $this-&gt;textdomain ),
			&#039;&lt;a class=&quot;button&quot; href=&quot;&#039; . esc_url( add_query_arg( array( &#039;remove_i18n_promo&#039; =&gt; &#039;1&#039; ) ) ) . &#039;&quot;&gt;&#039;,
			&#039;&lt;/a&gt;&#039;
		);
	}

	/**
	 * Outputs a promo box.
	 *
	 * @access public
	 */
	public function promo() {
		$message = $this-&gt;get_promo_message();

		if ( $message ) {
			echo &#039;&lt;div id=&quot;i18n_promo_box&quot; style=&quot;border:1px solid #ccc;background-color:#fff;padding:10px;max-width:650px; overflow: hidden;&quot;&gt;&#039;;
			echo &#039;&lt;a href=&quot;&#039; . esc_url( add_query_arg( array( &#039;remove_i18n_promo&#039; =&gt; &#039;1&#039; ) ) ) . &#039;&quot; style=&quot;color:#333;text-decoration:none;font-weight:bold;font-size:16px;border:1px solid #ccc;padding:1px 4px;&quot; class=&quot;alignright&quot;&gt;X&lt;/a&gt;&#039;;

			echo &#039;&lt;div&gt;&#039;;
			/* translators: %s: plugin name. */
			echo &#039;&lt;h2&gt;&#039; . sprintf( esc_html__( &#039;Translation of %s&#039;, $this-&gt;textdomain ), esc_html( $this-&gt;plugin_name ) ) . &#039;&lt;/h2&gt;&#039;;
			if ( isset( $this-&gt;glotpress_logo ) &amp;&amp; is_string( $this-&gt;glotpress_logo ) &amp;&amp; &#039;&#039; !== $this-&gt;glotpress_logo ) {
				echo &#039;&lt;a href=&quot;&#039; . esc_url( $this-&gt;register_url ) . &#039;&quot;&gt;&lt;img class=&quot;alignright&quot; style=&quot;margin:0 5px 5px 5px;max-width:200px;&quot; src=&quot;&#039; . esc_url( $this-&gt;glotpress_logo ) . &#039;&quot; alt=&quot;&#039; . esc_attr( $this-&gt;glotpress_name ) . &#039;&quot;/&gt;&lt;/a&gt;&#039;;
			}
			// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- correctly escaped in promo_message() method.
			echo $message;
			echo &#039;&lt;/div&gt;&#039;;
			echo &#039;&lt;/div&gt;&#039;;
		}
	}

	/**
	 * 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( &#039;yoast_i18n_&#039; . $this-&gt;project_slug . &#039;_&#039; . $this-&gt;locale );

		if ( ! $set ) {
			$set = $this-&gt;retrieve_translation_details();
			set_transient( &#039;yoast_i18n_&#039; . $this-&gt;project_slug . &#039;_&#039; . $this-&gt;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-&gt;find_or_initialize_translation_details();

		$this-&gt;translation_exists = ! is_null( $set );
		$this-&gt;translation_loaded = is_textdomain_loaded( $this-&gt;textdomain );

		$this-&gt;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-&gt;api_url = $api_url;
	}

	/**
	 * Returns the API URL to use when requesting translation information.
	 *
	 * @return string
	 */
	private function get_api_url() {
		if ( empty( $this-&gt;api_url ) ) {
			$this-&gt;api_url = trailingslashit( $this-&gt;glotpress_url ) . &#039;api/projects/&#039; . $this-&gt;project_slug;
		}

		return $this-&gt;api_url;
	}

	/**
	 * Retrieve the translation details from Yoast Translate.
	 *
	 * @access private
	 *
	 * @return object|null
	 */
	private function retrieve_translation_details() {
		$api_url = $this-&gt;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-&gt;translation_sets ) ) {
				return null;
			}
			foreach ( $body-&gt;translation_sets as $set ) {
				if ( ! property_exists( $set, &#039;wp_locale&#039; ) ) {
					continue;
				}

				// For informal and formal locales, we have to complete the locale code by concatenating the slug (&#039;formal&#039; or &#039;informal&#039;) to the xx_XX part.
				if ( $set-&gt;slug !== &#039;default&#039; &amp;&amp; strtolower( $this-&gt;locale ) === strtolower( $set-&gt;wp_locale . &#039;_&#039; . $set-&gt;slug ) ) {
					return $set;
				}

				if ( $this-&gt;locale === $set-&gt;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-&gt;translation_exists &amp;&amp; is_object( $set ) ) {
			$this-&gt;locale_name        = $set-&gt;name;
			$this-&gt;percent_translated = $set-&gt;percent_translated;
		}
		else {
			$this-&gt;locale_name        = &#039;&#039;;
			$this-&gt;percent_translated = &#039;&#039;;
		}
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fwordpress-seo-premium%2Fvendor%2Fyoast%2Fi18n-module%2Fsrc'>⬅ Back to Directory</a>