<h2>File Contents: /home/planet5/public_html/wp-content/plugins/wordpress-seo/src/surfaces/values/meta.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-content/plugins/wordpress-seo/src/surfaces/values/meta.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

namespace Yoast\WP\SEO\Surfaces\Values;

use WPSEO_Replace_Vars;
use Yoast\WP\SEO\Context\Meta_Tags_Context;
use Yoast\WP\SEO\Exceptions\Forbidden_Property_Mutation_Exception;
use Yoast\WP\SEO\Integrations\Front_End_Integration;
use Yoast\WP\SEO\Models\Indexable;
use Yoast\WP\SEO\Presenters\Abstract_Indexable_Presenter;
use Yoast\WP\SEO\Presenters\Rel_Next_Presenter;
use Yoast\WP\SEO\Presenters\Rel_Prev_Presenter;
use Yoast\WP\SEO\Surfaces\Helpers_Surface;
use YoastSEO_Vendor\Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * Meta value object.
 *
 * @property array       $breadcrumbs                       The breadcrumbs array for the current page.
 * @property string      $canonical                         The canonical URL for the current page.
 * @property string      $company_name                      The company name from the Knowledge graph settings.
 * @property int         $company_logo_id                   The attachment ID for the company logo.
 * @property string      $description                       The meta description for the current page, if set.
 * @property int         $estimated_reading_time_minutes    The estimated reading time in minutes for posts.
 * @property Indexable   $indexable                         The indexable object.
 * @property string      $main_schema_id                    Schema ID that points to the main Schema thing on the page, usually the webpage or article Schema piece.
 * @property string      $meta_description                  The meta description for the current page, if set.
 * @property string      $open_graph_article_author         The article:author value.
 * @property string      $open_graph_article_modified_time  The article:modified_time value.
 * @property string      $open_graph_article_published_time The article:published_time value.
 * @property string      $open_graph_article_publisher      The article:publisher value.
 * @property string      $open_graph_description            The og:description.
 * @property bool        $open_graph_enabled                Whether OpenGraph is enabled on this site.
 * @property string      $open_graph_fb_app_id              The Facebook App ID.
 * @property array       $open_graph_images                 The array of images we have for this page.
 * @property string      $open_graph_locale                 The og:locale for the current page.
 * @property string      $open_graph_publisher              The OpenGraph publisher reference.
 * @property string      $open_graph_site_name              The og:site_name.
 * @property string      $open_graph_title                  The og:title.
 * @property string      $open_graph_type                   The og:type.
 * @property string      $open_graph_url                    The og:url.
 * @property string      $page_type                         The Schema page type.
 * @property array       $robots                            An array of the robots values set for the current page.
 * @property string      $rel_next                          The next page in the series, if any.
 * @property string      $rel_prev                          The previous page in the series, if any.
 * @property array       $schema                            The entire Schema array for the current page.
 * @property string      $schema_page_type                  The Schema page type.
 * @property string      $site_name                         The site name from the Yoast SEO settings.
 * @property string      $site_represents                   Whether the site represents a &#039;person&#039; or a &#039;company&#039;.
 * @property array|false $site_represents_reference         The schema reference ID for what this site represents.
 * @property string      $site_url                          The site&#039;s main URL.
 * @property int         $site_user_id                      If the site represents a &#039;person&#039;, this is the ID of the accompanying user profile.
 * @property string      $title                             The SEO title for the current page.
 * @property string      $twitter_card                      The Twitter card type for the current page.
 * @property string      $twitter_creator                   The Twitter card author for the current page.
 * @property string      $twitter_description               The Twitter card description for the current page.
 * @property string      $twitter_image                     The Twitter card image for the current page.
 * @property string      $twitter_site                      The Twitter card site reference for the current page.
 * @property string      $twitter_title                     The Twitter card title for the current page.
 * @property string      $wordpress_site_name               The site name from the WordPress settings.
 */
class Meta {

	/**
	 * The container.
	 *
	 * @var ContainerInterface
	 */
	protected $container;

	/**
	 * The meta tags context.
	 *
	 * @var Meta_Tags_Context
	 */
	protected $context;

	/**
	 * The front end integration.
	 *
	 * @var Front_End_Integration
	 */
	protected $front_end;

	/**
	 * The helpers surface.
	 *
	 * @var Helpers_Surface
	 */
	protected $helpers;

	/**
	 * The replace vars helper
	 *
	 * @var WPSEO_Replace_Vars
	 */
	protected $replace_vars;

	/**
	 * Collection of properties dynamically set via the magic __get() method.
	 *
	 * @var array&lt;string, mixed&gt; Key is the property name.
	 */
	private $properties_bin = [];

	/**
	 * Create a meta value object.
	 *
	 * @param Meta_Tags_Context  $context   The indexable presentation.
	 * @param ContainerInterface $container The DI container.
	 */
	public function __construct( Meta_Tags_Context $context, ContainerInterface $container ) {
		$this-&gt;container = $container;
		$this-&gt;context   = $context;

		$this-&gt;helpers      = $this-&gt;container-&gt;get( Helpers_Surface::class );
		$this-&gt;replace_vars = $this-&gt;container-&gt;get( WPSEO_Replace_Vars::class );
		$this-&gt;front_end    = $this-&gt;container-&gt;get( Front_End_Integration::class );
	}

	/**
	 * Returns the output as would be presented in the head.
	 *
	 * @return object The HTML and JSON presentation of the head metadata.
	 */
	public function get_head() {
		$presenters = $this-&gt;get_presenters();

		/** This filter is documented in src/integrations/front-end-integration.php */
		$presentation = \apply_filters( &#039;wpseo_frontend_presentation&#039;, $this-&gt;context-&gt;presentation, $this-&gt;context );

		$html_output      = &#039;&#039;;
		$json_head_fields = [];

		foreach ( $presenters as $presenter ) {
			$presenter-&gt;presentation = $presentation;
			$presenter-&gt;replace_vars = $this-&gt;replace_vars;
			$presenter-&gt;helpers      = $this-&gt;helpers;

			$html_output .= $this-&gt;create_html_presentation( $presenter );
			$json_field   = $this-&gt;create_json_field( $presenter );

			// Only use the output of presenters that could successfully present their data.
			if ( $json_field !== null &amp;&amp; ! empty( $json_field-&gt;key ) ) {
				$json_head_fields[ $json_field-&gt;key ] = $json_field-&gt;value;
			}
		}
		$html_output = \trim( $html_output );

		return (object) [
			&#039;html&#039; =&gt; $html_output,
			&#039;json&#039; =&gt; $json_head_fields,
		];
	}

	/**
	 * Magic getter for presenting values through the appropriate presenter, if it exists.
	 *
	 * @param string $name The property to get.
	 *
	 * @return mixed The value, as presented by the appropriate presenter.
	 */
	public function __get( $name ) {
		if ( \array_key_exists( $name, $this-&gt;properties_bin ) ) {
			return $this-&gt;properties_bin[ $name ];
		}

		/** This filter is documented in src/integrations/front-end-integration.php */
		$presentation = \apply_filters( &#039;wpseo_frontend_presentation&#039;, $this-&gt;context-&gt;presentation, $this-&gt;context );

		if ( ! isset( $presentation-&gt;{$name} ) ) {
			if ( isset( $this-&gt;context-&gt;{$name} ) ) {
				$this-&gt;properties_bin[ $name ] = $this-&gt;context-&gt;{$name};
				return $this-&gt;properties_bin[ $name ];
			}
			return null;
		}

		$presenter_namespace = &#039;Yoast\WP\SEO\Presenters\\&#039;;
		$parts               = \explode( &#039;_&#039;, $name );
		if ( $parts[0] === &#039;twitter&#039; ) {
			$presenter_namespace .= &#039;Twitter\\&#039;;
			$parts                = \array_slice( $parts, 1 );
		}
		elseif ( $parts[0] === &#039;open&#039; &amp;&amp; $parts[1] === &#039;graph&#039; ) {
			$presenter_namespace .= &#039;Open_Graph\\&#039;;
			$parts                = \array_slice( $parts, 2 );
		}

		$presenter_class = $presenter_namespace . \implode( &#039;_&#039;, \array_map( &#039;ucfirst&#039;, $parts ) ) . &#039;_Presenter&#039;;

		if ( \class_exists( $presenter_class ) ) {
			/**
			 * The indexable presenter.
			 *
			 * @var Abstract_Indexable_Presenter $presenter
			 */
			$presenter               = new $presenter_class();
			$presenter-&gt;presentation = $presentation;
			$presenter-&gt;helpers      = $this-&gt;helpers;
			$presenter-&gt;replace_vars = $this-&gt;replace_vars;
			$value                   = $presenter-&gt;get();
		}
		else {
			$value = $presentation-&gt;{$name};
		}

		$this-&gt;properties_bin[ $name ] = $value;
		return $this-&gt;properties_bin[ $name ];
	}

	/**
	 * Magic isset for ensuring properties on the presentation are recognised.
	 *
	 * @param string $name The property to get.
	 *
	 * @return bool Whether or not the requested property exists.
	 */
	public function __isset( $name ) {
		if ( \array_key_exists( $name, $this-&gt;properties_bin ) ) {
			return true;
		}

		return isset( $this-&gt;context-&gt;presentation-&gt;{$name} );
	}

	/**
	 * Prevents setting dynamic properties and overwriting the value of declared properties
	 * from an inaccessible context.
	 *
	 * @param string $name  The property name.
	 * @param mixed  $value The property value.
	 *
	 * @return void
	 *
	 * @throws Forbidden_Property_Mutation_Exception Set is never meant to be called.
	 */
	public function __set( $name, $value ) { // @phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed -- __set must have a name and value - PHPCS #3715.
		throw Forbidden_Property_Mutation_Exception::cannot_set_because_property_is_immutable( $name );
	}

	/**
	 * Prevents unsetting dynamic properties and unsetting declared properties
	 * from an inaccessible context.
	 *
	 * @param string $name The property name.
	 *
	 * @return void
	 *
	 * @throws Forbidden_Property_Mutation_Exception Unset is never meant to be called.
	 */
	public function __unset( $name ) {
		throw Forbidden_Property_Mutation_Exception::cannot_unset_because_property_is_immutable( $name );
	}

	/**
	 * Strips all nested dependencies from the debug info.
	 *
	 * @return array
	 */
	public function __debugInfo() {
		return [ &#039;context&#039; =&gt; $this-&gt;context ];
	}

	/**
	 * Returns all presenters.
	 *
	 * @return Abstract_Indexable_Presenter[]
	 */
	protected function get_presenters() {
		$presenters = $this-&gt;front_end-&gt;get_presenters( $this-&gt;context-&gt;page_type, $this-&gt;context );

		if ( $this-&gt;context-&gt;page_type === &#039;Date_Archive&#039; ) {
			/**
			 * Define a filter that removes objects of type Rel_Next_Presenter or Rel_Prev_Presenter from a list.
			 *
			 * @param object $presenter The presenter to verify.
			 *
			 * @return bool True if the presenter is not a Rel_Next or Rel_Prev presenter.
			 */
			$callback   = static function ( $presenter ) {
				return ! \is_a( $presenter, Rel_Next_Presenter::class )
					&amp;&amp; ! \is_a( $presenter, Rel_Prev_Presenter::class );
			};
			$presenters = \array_filter( $presenters, $callback );
		}

		return $presenters;
	}

	/**
	 * Uses the presenter to create a line of HTML.
	 *
	 * @param Abstract_Indexable_Presenter $presenter The presenter.
	 *
	 * @return string
	 */
	protected function create_html_presentation( $presenter ) {
		$presenter_output = $presenter-&gt;present();
		if ( ! empty( $presenter_output ) ) {
			return $presenter_output . \PHP_EOL;
		}
		return &#039;&#039;;
	}

	/**
	 * Converts a presenter&#039;s key and value to JSON.
	 *
	 * @param Abstract_Indexable_Presenter $presenter The presenter whose key and value are to be converted to JSON.
	 *
	 * @return object|null
	 */
	protected function create_json_field( $presenter ) {
		if ( $presenter-&gt;get_key() === &#039;NO KEY PROVIDED&#039; ) {
			return null;
		}

		$value = $presenter-&gt;get();
		if ( empty( $value ) ) {
			return null;
		}

		return (object) [
			&#039;key&#039;   =&gt; $presenter-&gt;escape_key(),
			&#039;value&#039; =&gt; $value,
		];
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-content%2Fplugins%2Fwordpress-seo%2Fsrc%2Fsurfaces%2Fvalues'>⬅ Back to Directory</a>