<h2>File Contents: /home/planet5/public_html/wp-content/plugins/amp/src/Optimizer/Transformer/DetermineHeroImages.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-content/plugins/amp/src/Optimizer/Transformer/DetermineHeroImages.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Class DetermineHeroImages.
 *
 * @package AmpProject\AmpWP
 */

namespace AmpProject\AmpWP\Optimizer\Transformer;

use AmpProject\Dom\Document;
use AmpProject\Dom\Element;
use AmpProject\Html\Attribute;
use AmpProject\Optimizer\ErrorCollection;
use AmpProject\Optimizer\ImageDimensions;
use AmpProject\Optimizer\Transformer;

/**
 * Determine the images to flag with data-hero-candidate so the Optimizer can prerender them.
 *
 * This transformer checks for the following images in the given order:
 * 1. Header images (including Custom Logo and Custom Header)
 * 2. Image which is descendant of first child of first entry content
 *
 * @package AmpProject\AmpWP
 * @since   2.1
 * @internal
 */
final class DetermineHeroImages implements Transformer {

	/**
	 * XPath query to find preceding images which are not lazy-loaded.
	 *
	 * @var string
	 */
	const PRECEDING_NON_LAZY_IMAGE_XPATH_QUERY = &quot;preceding::amp-img[ not( @data-hero ) ][ not( noscript/img/@loading ) or noscript/img/@loading != &#039;lazy&#039; ]&quot;;

	/**
	 * XPath query to find the first entry-content.
	 *
	 * Note that the &#039;entry-content&#039; class name is the classic form for what the h-entry spec now has as &#039;e-content&#039;.
	 * The &#039;amp-wp-article-content&#039; class name is used in legacy Reader templates. Note that &#039;entry-content&#039; isn&#039;t
	 * simply just added to templates/single.php and templates/page.php because these templates are frequently forked.
	 *
	 * @link https://microformats.org/wiki/h-entry
	 * @var string
	 */
	const FIRST_ENTRY_CONTENT_XPATH_QUERY = &quot;
		.//*[ @class ][
			contains( concat( &#039; &#039;, normalize-space( @class ), &#039; &#039; ), &#039; entry-content &#039; )
			or
			contains( concat( &#039; &#039;, normalize-space( @class ), &#039; &#039; ), &#039; e-content &#039; )
			or
			contains( concat( &#039; &#039;, normalize-space( @class ), &#039; &#039; ), &#039; amp-wp-article-content &#039; )
		]
	&quot;;

	/**
	 * XPath query to find an image at the beginning of entry content (including nested inside of another block).
	 *
	 * @var string
	 */
	const INITIAL_CONTENT_IMAGE_XPATH_QUERY = &#039;./*[1]//amp-img[ not( @data-hero ) ]&#039;;

	/**
	 * Apply transformations to the provided DOM document.
	 *
	 * @param Document        $document DOM document to apply the
	 *                                  transformations to.
	 * @param ErrorCollection $errors   Collection of errors that are collected
	 *                                  during transformation.
	 * @return void
	 */
	public function transform( Document $document, ErrorCollection $errors ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
		$hero_image_elements = [];

		foreach ( [ &#039;header_images&#039;, &#039;initial_content_image&#039; ] as $hero_image_source ) {
			$candidate = null;

			switch ( $hero_image_source ) {
				case &#039;header_images&#039;:
					$candidate = $this-&gt;get_header_images( $document );
					break;
				case &#039;initial_content_image&#039;:
					$candidate = $this-&gt;get_initial_content_image( $document );
					break;
			}

			if ( $candidate instanceof Element ) {
				$hero_image_elements[ spl_object_hash( $candidate ) ] = $candidate;
			} elseif ( is_array( $candidate ) ) {
				foreach ( $candidate as $hero_image_element ) {
					$hero_image_elements[ spl_object_hash( $hero_image_element ) ] = $hero_image_element;
				}
			}
		}

		$this-&gt;add_data_hero_candidate_attribute(
			array_values( $hero_image_elements )
		);
	}

	/**
	 * Retrieve the images in the header.
	 *
	 * This returns all non-tiny images which occur before the main content, or else a tiny image that has `logo` in the
	 * class name.
	 *
	 * Note that the `HeroCandidateFiltering` service will have already identified the Header Image and Custom Logo for
	 * any theme using the standard `the_header_image_tag()` and `the_custom_logo()` template tags, respectively. This
	 * remains for here as a fallback to identify Header Images and Custom Logos being rendered via non-standard
	 * template tags.
	 *
	 * @see \AmpProject\AmpWP\Optimizer\HeroCandidateFiltering::add_custom_logo_data_hero_candidate_attribute()
	 * @see \AmpProject\AmpWP\Optimizer\HeroCandidateFiltering::filter_header_image_tag()
	 *
	 * @param Document $document Document to retrieve the header images from.
	 * @return Element[] Header images.
	 */
	private function get_header_images( Document $document ) {
		// Note that 3,508 out of 3,923 themes on WP.org  (89%) use the &lt;main&gt; element.
		$after_header_element = $document-&gt;getElementsByTagName( &#039;main&#039; )-&gt;item( 0 );

		// If a theme happens to not use the &lt;main&gt; element, then fall back to using the first entry-content.
		if ( ! $after_header_element instanceof Element ) {
			$after_header_element = $this-&gt;get_first_entry_content( $document );
		}

		if ( ! $after_header_element instanceof Element ) {
			return [];
		}

		$query = $document-&gt;xpath-&gt;query(
			self::PRECEDING_NON_LAZY_IMAGE_XPATH_QUERY,
			$after_header_element
		);

		return array_filter(
			iterator_to_array( $query ),
			static function ( Element $element ) {
				// A custom logo may in fact be tiny and yet since it is in the header it should be prerendered.
				// Note that a theme may not be using `the_custom_logo()` template tag and that is why the `custom-logo`
				// class is not being checked for specifically.
				if (
					$element-&gt;hasAttribute( Attribute::CLASS_ )
					&amp;&amp;
					false !== strpos( $element-&gt;getAttribute( Attribute::CLASS_ ), &#039;logo&#039; )
				) {
					return true;
				}

				return ! ( new ImageDimensions( $element ) )-&gt;isTiny();
			}
		);
	}

	/**
	 * Retrieve the first entry content.
	 *
	 * @param Document $document Document to retrieve the first entry content from.
	 * @return Element|null First entry content element.
	 */
	private function get_first_entry_content( Document $document ) {
		$query = $document-&gt;xpath-&gt;query(
			self::FIRST_ENTRY_CONTENT_XPATH_QUERY,
			$document-&gt;body
		);

		$entry_content = $query-&gt;item( 0 );
		return $entry_content instanceof Element ? $entry_content : null;
	}

	/**
	 * Retrieve the first image that is in the first position in content.
	 *
	 * @param Document $document Document to retrieve the image from.
	 * @return Element|null Image at the beginning of the first entry content.
	 */
	private function get_initial_content_image( Document $document ) {
		$entry_content = $this-&gt;get_first_entry_content( $document );
		if ( ! $entry_content instanceof Element ) {
			return null;
		}

		$query = $document-&gt;xpath-&gt;query(
			self::INITIAL_CONTENT_IMAGE_XPATH_QUERY,
			$entry_content
		);

		$image = $query-&gt;item( 0 );
		if ( $image instanceof Element &amp;&amp; ! ( new ImageDimensions( $image ) )-&gt;isTiny() ) {
			return $image;
		}

		return null;
	}

	/**
	 * Add the data-hero attribute to viable hero images.
	 *
	 * @param Element[] $hero_image_elements Elements that are viable hero images.
	 */
	private function add_data_hero_candidate_attribute( $hero_image_elements ) {
		foreach ( $hero_image_elements as $hero_image_element ) {
			$hero_image_element-&gt;setAttribute( Attribute::DATA_HERO_CANDIDATE, null );
		}
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-content%2Fplugins%2Famp%2Fsrc%2FOptimizer%2FTransformer'>⬅ Back to Directory</a>