<h2>File Contents: /home/planet5/www/wp-content/plugins/wordpress-seo-premium/frontend/schema/class-schema-howto.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/wordpress-seo-premium/frontend/schema/class-schema-howto.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Frontend\Schema
 */

/**
 * Returns schema HowTo data.
 *
 * @since 11.5
 */
class WPSEO_Schema_HowTo implements WPSEO_Graph_Piece {

	/**
	 * Determine whether this graph piece is needed or not.
	 *
	 * Always false, because this graph piece adds itself using the filter API.
	 *
	 * @var bool
	 */
	private $is_needed = false;

	/**
	 * The HowTo blocks count on the current page.
	 *
	 * @var int
	 */
	private $counter;

	/**
	 * A value object with context variables.
	 *
	 * @var WPSEO_Schema_Context
	 */
	private $context;

	/**
	 * Holds the allowed HTML tags for the jsonText.
	 *
	 * @var string
	 */
	private $allowed_json_text_tags = &#039;&lt;h1&gt;&lt;h2&gt;&lt;h3&gt;&lt;h4&gt;&lt;h5&gt;&lt;h6&gt;&lt;br&gt;&lt;ol&gt;&lt;ul&gt;&lt;li&gt;&lt;a&gt;&lt;p&gt;&lt;b&gt;&lt;strong&gt;&lt;i&gt;&lt;em&gt;&#039;;

	/**
	 * WPSEO_Schema_HowTo constructor.
	 *
	 * @param WPSEO_Schema_Context $context A value object with context variables.
	 *
	 * @codeCoverageIgnore
	 */
	public function __construct( WPSEO_Schema_Context $context ) {
		$this-&gt;counter = 0;
		$this-&gt;context = $context;

		add_filter( &#039;wpseo_schema_block_yoast/how-to-block&#039;, [ $this, &#039;render&#039; ], 10, 2 );
	}

	/**
	 * Renders a list of questions, referencing them by ID.
	 *
	 * @return array $data Our Schema graph.
	 */
	public function generate() {
		return [];
	}

	/**
	 * Renders the How-To block into our graph.
	 *
	 * @param array $graph Our Schema data.
	 * @param array $block The How-To block content.
	 *
	 * @return mixed
	 */
	public function render( $graph, $block ) {
		$this-&gt;counter++;
		$data = [
			&#039;@type&#039;            =&gt; &#039;HowTo&#039;,
			&#039;@id&#039;              =&gt; $this-&gt;context-&gt;canonical . &#039;#howto-&#039; . $this-&gt;counter,
			&#039;name&#039;             =&gt; WPSEO_Schema_Utils::get_post_title_with_fallback( $this-&gt;context-&gt;id ),
			&#039;mainEntityOfPage&#039; =&gt; [ &#039;@id&#039; =&gt; $this-&gt;get_main_schema_id() ],
			&#039;description&#039;      =&gt; &#039;&#039;,
		];

		$json_description = strip_tags( $block[&#039;attrs&#039;][&#039;jsonDescription&#039;], &#039;&lt;h1&gt;&lt;h2&gt;&lt;h3&gt;&lt;h4&gt;&lt;h5&gt;&lt;h6&gt;&lt;br&gt;&lt;ol&gt;&lt;ul&gt;&lt;li&gt;&lt;a&gt;&lt;p&gt;&lt;b&gt;&lt;strong&gt;&lt;i&gt;&lt;em&gt;&#039; );

		if ( isset( $json_description ) ) {
			$data[&#039;description&#039;] = $json_description;
		}

		$this-&gt;add_duration( $data, $block[&#039;attrs&#039;] );
		$this-&gt;add_steps( $data, $block[&#039;attrs&#039;][&#039;steps&#039;] );
		$data = WPSEO_Schema_Utils::add_piece_language( $data );

		$graph[] = $data;

		return $graph;
	}

	/**
	 * Adds the duration of the task to the Schema.
	 *
	 * @param array $data       Our How-To schema data.
	 * @param array $attributes The block data attributes.
	 *
	 * @return array $data Our schema data.
	 */
	private function add_duration( &amp;$data, $attributes ) {
		if ( ! empty( $attributes[&#039;hasDuration&#039;] ) &amp;&amp; $attributes[&#039;hasDuration&#039;] ) {
			$days    = empty( $attributes[&#039;days&#039;] ) ? 0 : $attributes[&#039;days&#039;];
			$hours   = empty( $attributes[&#039;hours&#039;] ) ? 0 : $attributes[&#039;hours&#039;];
			$minutes = empty( $attributes[&#039;minutes&#039;] ) ? 0 : $attributes[&#039;minutes&#039;];

			if ( ( $days + $hours + $minutes ) &gt; 0 ) {
				$data[&#039;totalTime&#039;] = esc_attr( &#039;P&#039; . $days . &#039;DT&#039; . $hours . &#039;H&#039; . $minutes . &#039;M&#039; );
			}
		}

		return $data;
	}

	/**
	 * Determines whether we&#039;re part of an article or a webpage.
	 *
	 * @return string A reference URL.
	 */
	protected function get_main_schema_id() {
		if ( $this-&gt;context-&gt;site_represents !== false &amp;&amp; WPSEO_Schema_Article::is_article_post_type() ) {
			return $this-&gt;context-&gt;canonical . WPSEO_Schema_IDs::ARTICLE_HASH;
		}

		return $this-&gt;context-&gt;canonical . WPSEO_Schema_IDs::WEBPAGE_HASH;
	}

	/**
	 * Determines whether or not a piece should be added to the graph.
	 *
	 * @return bool
	 */
	public function is_needed() {
		return $this-&gt;is_needed;
	}

	/**
	 * Adds the steps to our How-To output.
	 *
	 * @param array $data  Our How-To schema data.
	 * @param array $steps Our How-To block&#039;s steps.
	 */
	private function add_steps( &amp;$data, $steps ) {
		foreach ( $steps as $step ) {
			$schema_id   = $this-&gt;context-&gt;canonical . &#039;#&#039; . esc_attr( $step[&#039;id&#039;] );
			$schema_step = [
				&#039;@type&#039; =&gt; &#039;HowToStep&#039;,
				&#039;url&#039;   =&gt; $schema_id,
			];

			$json_text = strip_tags( $step[&#039;jsonText&#039;], $this-&gt;allowed_json_text_tags );
			$json_name = wp_strip_all_tags( $step[&#039;jsonName&#039;] );

			if ( empty( $json_name ) ) {
				if ( empty( $step[&#039;text&#039;] ) ) {
					continue;
				}

				$schema_step[&#039;text&#039;] = &#039;&#039;;

				$this-&gt;add_step_image( $schema_step, $step );

				// If there is no text and no image, don&#039;t output the step.
				if ( empty( $json_text ) &amp;&amp; empty( $schema_step[&#039;image&#039;] ) ) {
					continue;
				}

				if ( ! empty( $json_text ) ) {
					$schema_step[&#039;text&#039;] = $json_text;
				}
			}

			elseif ( empty( $json_text ) ) {
				$schema_step[&#039;text&#039;] = $json_name;
			}
			else {
				$schema_step[&#039;name&#039;] = $json_name;

				$this-&gt;add_step_description( $schema_step, $step );
				$this-&gt;add_step_image( $schema_step, $step );
			}

			$data[&#039;step&#039;][] = $schema_step;
		}
	}

	/**
	 * Checks if we have a step description, if we do, add it.
	 *
	 * @param array $schema_step Our Schema output for the Step.
	 * @param array $step        The step block data.
	 */
	private function add_step_description( &amp;$schema_step, $step ) {
		$json_text = strip_tags( $step[&#039;jsonText&#039;], $this-&gt;allowed_json_text_tags );

		if ( empty( $json_text ) ) {
			return;
		}

		$schema_step[&#039;itemListElement&#039;] = [];

		$schema_step[&#039;itemListElement&#039;][] = [
			&#039;@type&#039; =&gt; &#039;HowToDirection&#039;,
			&#039;text&#039;  =&gt; $json_text,
		];
	}

	/**
	 * Checks if we have a step image, if we do, add it.
	 *
	 * @param array $schema_step Our Schema output for the Step.
	 * @param array $step        The step block data.
	 */
	private function add_step_image( &amp;$schema_step, $step ) {
		foreach ( $step[&#039;text&#039;] as $line ) {
			if ( is_array( $line ) &amp;&amp; isset( $line[&#039;type&#039;] ) &amp;&amp; $line[&#039;type&#039;] === &#039;img&#039; ) {
				$schema_step[&#039;image&#039;] = $this-&gt;get_image_schema( esc_url( $line[&#039;props&#039;][&#039;src&#039;] ) );
			}
		}
	}

	/**
	 * Generates the image schema from the attachment $url.
	 *
	 * @param string $url Attachment url.
	 *
	 * @return array Image schema.
	 *
	 * @codeCoverageIgnore
	 */
	protected function get_image_schema( $url ) {
		$image = new WPSEO_Schema_Image( $this-&gt;context-&gt;canonical . &#039;#schema-image-&#039; . md5( $url ) );

		return $image-&gt;generate_from_url( $url );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fwordpress-seo-premium%2Ffrontend%2Fschema'>⬅ Back to Directory</a>