<h2>File Contents: /home/planet5/www/wp-content/plugins/google-site-kit/includes/Core/Email_Reporting/Content_Map.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/google-site-kit/includes/Core/Email_Reporting/Content_Map.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Class Google\Site_Kit\Core\Email_Reporting\Content_Map
 *
 * @package   Google\Site_Kit\Core\Email_Reporting
 * @copyright 2026 Google LLC
 * @license   https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @link      https://sitekit.withgoogle.com
 */

namespace Google\Site_Kit\Core\Email_Reporting;

use Google\Site_Kit\Core\Golinks\Golinks;

/**
 * Class for mapping email template content (titles and body).
 *
 * Provides centralized content for simple email templates,
 * used by both HTML and plain text renderers. Body paragraphs may
 * contain safe inline HTML (e.g. strong tags) which the HTML
 * renderer preserves via wp_kses() and the plain text renderer
 * strips via wp_strip_all_tags().
 *
 * @since 1.173.0
 */
class Content_Map {

	/**
	 * Gets the title for a template.
	 *
	 * @since 1.174.0
	 *
	 * @param string $template_name The template name.
	 * @return string The title string (may contain sprintf placeholders).
	 */
	public static function get_title( $template_name ) {
		$titles = self::get_all_titles();

		return $titles[ $template_name ] ?? &#039;&#039;;
	}

	/**
	 * Gets title with format arguments applied.
	 *
	 * @since 1.174.0
	 *
	 * @param string $template_name The template name.
	 * @param array  $args          Format arguments for sprintf substitution.
	 * @return string The resolved title string.
	 */
	public static function get_title_with_args( $template_name, $args = array() ) {
		$title = self::get_title( $template_name );

		if ( empty( $args ) || empty( $title ) ) {
			return $title;
		}

		return vsprintf( $title, $args );
	}

	/**
	 * Gets the email subject for a template.
	 *
	 * Falls back to the template&#039;s title when no subject is set.
	 *
	 * @since 1.186.0
	 *
	 * @param string $template_name The template name.
	 * @return string The subject string.
	 */
	public static function get_subject( $template_name ) {
		$subjects = self::get_templates_with_custom_subjects();

		return $subjects[ $template_name ] ?? self::get_title( $template_name );
	}

	/**
	 * Gets the body content for a template.
	 *
	 * @since 1.173.0
	 *
	 * @param string $template_name The template name.
	 * @return array Array of body paragraphs (may contain HTML).
	 */
	public static function get_body( $template_name ) {
		$bodies = self::get_all_bodies();

		return $bodies[ $template_name ] ?? array();
	}

	/**
	 * Gets body content with format arguments applied.
	 *
	 * Retrieves paragraphs for the given template and substitutes
	 * any sprintf-style placeholders with the provided arguments.
	 *
	 * @since 1.173.0
	 *
	 * @param string $template_name The template name.
	 * @param array  $args          Format arguments for vsprintf substitution.
	 * @return array Array of resolved body paragraphs (may contain HTML).
	 */
	public static function get_body_with_args( $template_name, $args = array() ) {
		$body = self::get_body( $template_name );

		if ( empty( $args ) ) {
			return $body;
		}

		return array_map(
			function ( $paragraph ) use ( $args ) {
				return vsprintf( $paragraph, $args );
			},
			$body
		);
	}

	/**
	 * Gets the graphic configuration for a template.
	 *
	 * Returns layout and rendering config for the graphic/icon used in
	 * simple email templates. The config controls the asset slug, position
	 * within the content card, dimensions, and title escape strategy.
	 *
	 * @since 1.176.0
	 *
	 * @param string $template_name The original template name (e.g. &#039;invitation-email&#039;).
	 * @return array {
	 *     Graphic configuration array, or empty array if unknown template.
	 *
	 *     @type string $slug         Asset slug for get_asset_url().
	 *     @type string $position     Position within card: &#039;top-center&#039;, &#039;top-left&#039;, or &#039;bottom-center&#039;.
	 *     @type int    $width        Image width in pixels.
	 *     @type int    $height       Image height in pixels.
	 *     @type string $title_escape Title escape strategy: &#039;raw&#039; (pre-escaped HTML) or &#039;esc_html&#039;.
	 * }
	 */
	public static function get_graphic_config( $template_name ) {
		$configs = array(
			&#039;invitation-email&#039;          =&gt; array(
				&#039;slug&#039;         =&gt; &#039;invitation-envelope-graphic&#039;,
				&#039;position&#039;     =&gt; &#039;bottom-center&#039;,
				&#039;width&#039;        =&gt; 209,
				&#039;height&#039;       =&gt; 163,
				&#039;title_escape&#039; =&gt; &#039;raw&#039;,
			),
			&#039;subscription-confirmation&#039; =&gt; array(
				&#039;slug&#039;         =&gt; &#039;subscription-envelope-graphic&#039;,
				&#039;position&#039;     =&gt; &#039;top-center&#039;,
				&#039;width&#039;        =&gt; 177,
				&#039;height&#039;       =&gt; 143,
				&#039;title_escape&#039; =&gt; &#039;esc_html&#039;,
			),
			&#039;error-email&#039;               =&gt; array(
				&#039;slug&#039;         =&gt; &#039;warning-icon&#039;,
				&#039;position&#039;     =&gt; &#039;top-left&#039;,
				&#039;width&#039;        =&gt; 32,
				&#039;height&#039;       =&gt; 32,
				&#039;title_escape&#039; =&gt; &#039;esc_html&#039;,
			),
		);

		return $configs[ $template_name ] ?? array();
	}

	/**
	 * Gets all template title mappings.
	 *
	 * @since 1.174.0
	 *
	 * @return array Mapping of template names to title strings.
	 */
	protected static function get_all_titles() {
		return array(
			/* translators: 1: opening anchor tag with mailto link, 2: inviter email address, 3: closing anchor tag */
			&#039;invitation-email&#039;                       =&gt; __( &#039;%1$s%2$s%3$s invited you to receive periodic performance reports&#039;, &#039;google-site-kit&#039; ),
			&#039;subscription-confirmation&#039;              =&gt; __( &#039;Success! You’re subscribed to Site Kit reports&#039;, &#039;google-site-kit&#039; ),
			&#039;error-email&#039;                            =&gt; __( &#039;Email reports are failing to send&#039;, &#039;google-site-kit&#039; ),
			&#039;error-email-permissions-search-console&#039; =&gt; __( &#039;Action needed: your Site Kit report couldn’t be generated&#039;, &#039;google-site-kit&#039; ),
			&#039;error-email-permissions-analytics-4&#039;    =&gt; __( &#039;Action needed: your Site Kit report couldn’t be generated&#039;, &#039;google-site-kit&#039; ),
			&#039;error-email-report-search-console&#039;      =&gt; __( &#039;Action needed: your Site Kit report couldn’t be generated&#039;, &#039;google-site-kit&#039; ),
			&#039;error-email-report-analytics-4&#039;         =&gt; __( &#039;Action needed: your Site Kit report couldn’t be generated&#039;, &#039;google-site-kit&#039; ),
		);
	}

	/**
	 * Get a mapping of all templates with custom subjects (eg. ones
	 * that differ from their title).
	 *
	 * Templates not in this mapping use `get_title()` as their subject.
	 *
	 * @since 1.186.0
	 *
	 * @return array Mapping of template names to subject strings.
	 */
	protected static function get_templates_with_custom_subjects() {
		return array(
			&#039;error-email&#039; =&gt; __( &#039;Action needed: your Site Kit report couldn’t be generated&#039;, &#039;google-site-kit&#039; ),
		);
	}

	/**
	 * Gets all template body content mappings.
	 *
	 * @since 1.173.0
	 *
	 * @return array Mapping of template names to body paragraph arrays.
	 */
	protected static function get_all_bodies() {
		return array(
			&#039;invitation-email&#039;                       =&gt; array(
				__( &#039;Receive the most important insights about your site’s performance, key trends, and tailored metrics, powered by Site Kit, directly in your inbox.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;You can unsubscribe or change how often emails are sent anytime from your Site Kit dashboard.&#039;, &#039;google-site-kit&#039; ),
			),
			&#039;subscription-confirmation&#039;              =&gt; array(
				__( &#039;You’re all set to receive your site performance reports.&#039;, &#039;google-site-kit&#039; ),
				/* translators: %1$s: frequency (e.g., &quot;monthly&quot;) wrapped in strong tags, %2$s: first report date wrapped in strong tags */
				__( &#039;You’ve successfully set your frequency to &lt;strong&gt;%1$s&lt;/strong&gt;, and you can expect to receive your first report on &lt;strong&gt;%2$s&lt;/strong&gt;.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;You can manage your subscription settings or change the report frequency anytime in your Site Kit dashboard.&#039;, &#039;google-site-kit&#039; ),
			),
			&#039;error-email&#039;                            =&gt; array(
				__( &#039;We were unable to generate your report due to a server error. To fix this, contact your host. Report delivery will automatically resume once the issue is resolved.&#039;, &#039;google-site-kit&#039; ),
			),
			// Opening/closing tag placeholders keep inline styles and HTML
			// out of translation strings.
			&#039;error-email-permissions-search-console&#039; =&gt; array(
				/* translators: 1: help link URL, 2: help link style CSS */
				__( &#039;We were unable to generate your reports due to insufficient permissions in Search Console. To fix this, contact your administrator or &lt;a class=&quot;link&quot; href=&quot;%1$s&quot; style=&quot;%2$s&quot;&gt;get help&lt;/a&gt;.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;Report delivery will automatically resume once the issue is resolved.&#039;, &#039;google-site-kit&#039; ),
			),
			&#039;error-email-permissions-analytics-4&#039;    =&gt; array(
				/* translators: 1: help link URL, 2: help link style CSS */
				__( &#039;We were unable to generate your reports due to insufficient permissions in Analytics. To fix this, contact your administrator or &lt;a class=&quot;link&quot; href=&quot;%1$s&quot; style=&quot;%2$s&quot;&gt;get help&lt;/a&gt;.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;Report delivery will automatically resume once the issue is resolved.&#039;, &#039;google-site-kit&#039; ),
			),
			&#039;error-email-report-search-console&#039;      =&gt; array(
				/* translators: 1: Search Console settings link URL, 2: Search Console settings link style CSS, 3: help link URL, 4: help link style CSS */
				__( &#039;We were unable to generate your report because data loading failed for Search Console. To fix this, go to &lt;a class=&quot;link&quot; href=&quot;%1$s&quot; style=&quot;%2$s&quot;&gt;Search Console settings&lt;/a&gt; in Site Kit or &lt;a class=&quot;link&quot; href=&quot;%3$s&quot; style=&quot;%4$s&quot;&gt;get help&lt;/a&gt;.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;Report delivery will automatically resume once the issue is resolved.&#039;, &#039;google-site-kit&#039; ),
			),
			&#039;error-email-report-analytics-4&#039;         =&gt; array(
				/* translators: 1: Analytics settings link URL, 2: Analytics settings link style CSS, 3: help link URL, 4: help link style CSS */
				__( &#039;We were unable to generate your report because data loading failed for Analytics. To fix this, go to &lt;a class=&quot;link&quot; href=&quot;%1$s&quot; style=&quot;%2$s&quot;&gt;Analytics settings&lt;/a&gt; in Site Kit or &lt;a class=&quot;link&quot; href=&quot;%3$s&quot; style=&quot;%4$s&quot;&gt;get help&lt;/a&gt;.&#039;, &#039;google-site-kit&#039; ),
				__( &#039;Report delivery will automatically resume once the issue is resolved.&#039;, &#039;google-site-kit&#039; ),
			),
		);
	}

	/**
	 * Gets sprintf arguments for body placeholders.
	 *
	 * Maps each template name to the styled anchor tags that fill its
	 * `%s` / `%1$s` / `%2$s` placeholders. Keys without placeholders
	 * return an empty array.
	 *
	 * @since 1.176.0
	 *
	 * @param string  $template_name Template name (e.g. &#039;error-email-report-analytics-4&#039;).
	 * @param Golinks $golinks     Golinks instance for building URLs.
	 * @return array Ordered sprintf arguments for the body paragraphs.
	 */
	public static function get_body_args( $template_name, Golinks $golinks ) {
		$link_style        = &#039;text-decoration:underline;&#039;;
		$email_support_url = &#039;https://sitekit.withgoogle.com/support/?doc=email-reporting-module-issues&#039;;

		switch ( $template_name ) {
			case &#039;error-email-report-search-console&#039;:
				$settings_url = add_query_arg( &#039;module&#039;, &#039;search-console&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) );
				return array(
					$settings_url,
					$link_style,
					$email_support_url,
					$link_style,
				);

			case &#039;error-email-report-analytics-4&#039;:
				$settings_url = add_query_arg( &#039;module&#039;, &#039;analytics-4&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) );
				return array(
					$settings_url,
					$link_style,
					$email_support_url,
					$link_style,
				);

			case &#039;error-email-permissions-search-console&#039;:
				return array(
					&#039;https://sitekit.withgoogle.com/support/?error_id=search-console_insufficient_permissions&#039;,
					$link_style,
				);

			case &#039;error-email-permissions-analytics-4&#039;:
				return array(
					&#039;https://sitekit.withgoogle.com/support/?error_id=analytics-4_insufficient_permissions&#039;,
					$link_style,
				);

			default:
				return array();
		}
	}

	/**
	 * Gets the primary call-to-action for a template.
	 *
	 * @since 1.186.0
	 *
	 * @param string  $template_name Template name (e.g. &#039;error-email-report-analytics-4&#039;).
	 * @param Golinks $golinks       Golinks instance for building URLs.
	 * @return array {
	 *     CTA configuration array, or an empty array if the given template has no associated CTA.
	 *
	 *     @type string $label CTA button label.
	 *     @type string $url   CTA destination URL.
	 * }
	 */
	public static function get_cta( $template_name, Golinks $golinks ) {
		switch ( $template_name ) {
			case &#039;error-email-permissions-search-console&#039;:
				return array(
					&#039;label&#039; =&gt; __( &#039;Request access&#039;, &#039;google-site-kit&#039; ),
					&#039;url&#039;   =&gt; add_query_arg( &#039;module&#039;, &#039;search-console&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) ),
				);

			case &#039;error-email-permissions-analytics-4&#039;:
				return array(
					&#039;label&#039; =&gt; __( &#039;Request access&#039;, &#039;google-site-kit&#039; ),
					&#039;url&#039;   =&gt; add_query_arg( &#039;module&#039;, &#039;analytics-4&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) ),
				);

			case &#039;error-email-report-search-console&#039;:
				return array(
					&#039;label&#039; =&gt; __( &#039;Go to settings&#039;, &#039;google-site-kit&#039; ),
					&#039;url&#039;   =&gt; add_query_arg( &#039;module&#039;, &#039;search-console&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) ),
				);

			case &#039;error-email-report-analytics-4&#039;:
				return array(
					&#039;label&#039; =&gt; __( &#039;Go to settings&#039;, &#039;google-site-kit&#039; ),
					&#039;url&#039;   =&gt; add_query_arg( &#039;module&#039;, &#039;analytics-4&#039;, $golinks-&gt;get_url( &#039;settings&#039; ) ),
				);

			default:
				return array();
		}
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fgoogle-site-kit%2Fincludes%2FCore%2FEmail_Reporting'>⬅ Back to Directory</a>