<h2>File Contents: /home/planet5/.trash/wordpress-seo-premium/src/routes/prominent-words-route.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/.trash/wordpress-seo-premium/src/routes/prominent-words-route.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

namespace Yoast\WP\SEO\Premium\Routes;

use Exception;
use WP_Error;
use WP_REST_Request;
use WP_REST_Response;
use Yoast\WP\SEO\Actions\Indexing\Indexation_Action_Interface;
use Yoast\WP\SEO\Conditionals\No_Conditionals;
use Yoast\WP\SEO\Config\Indexing_Reasons;
use Yoast\WP\SEO\Helpers\Indexing_Helper;
use Yoast\WP\SEO\Main;
use Yoast\WP\SEO\Premium\Actions\Prominent_Words\Complete_Action;
use Yoast\WP\SEO\Premium\Actions\Prominent_Words\Content_Action;
use Yoast\WP\SEO\Premium\Actions\Prominent_Words\Save_Action;
use Yoast\WP\SEO\Routes\Abstract_Indexation_Route;

/**
 * Class Prominent_Words_Route.
 */
class Prominent_Words_Route extends Abstract_Indexation_Route {

	use No_Conditionals;

	/**
	 * Feature namespace for the REST endpoint.
	 *
	 * @var string
	 */
	const FEATURE_NAMESPACE = &#039;prominent_words&#039;;

	/**
	 * The get content route constant.
	 *
	 * @var string
	 */
	const GET_CONTENT_ROUTE = self::FEATURE_NAMESPACE . &#039;/get_content&#039;;

	/**
	 * The full content route constant.
	 *
	 * @var string
	 */
	const FULL_GET_CONTENT_ROUTE = Main::API_V1_NAMESPACE . &#039;/&#039; . self::GET_CONTENT_ROUTE;

	/**
	 * The route for saving the prominent words.
	 *
	 * @var string
	 */
	const SAVE_ROUTE = self::FEATURE_NAMESPACE . &#039;/save&#039;;

	/**
	 * The full namespaced route for saving the prominent words.
	 *
	 * @var string
	 */
	const FULL_SAVE_ROUTE = Main::API_V1_NAMESPACE . &#039;/&#039; . self::SAVE_ROUTE;

	/**
	 * The posts data route constant.
	 *
	 * @var string
	 */
	const COMPLETE_ROUTE = self::FEATURE_NAMESPACE . &#039;/complete&#039;;

	/**
	 * The full post data route constant.
	 *
	 * @var string
	 */
	const FULL_COMPLETE_ROUTE = Main::API_V1_NAMESPACE . &#039;/&#039; . self::COMPLETE_ROUTE;

	/**
	 * Represents that action that retrieves the content to index.
	 *
	 * @var Content_Action
	 */
	protected $content_action;

	/**
	 * The action to complete the prominent words indexing.
	 *
	 * @var Complete_Action
	 */
	protected $complete_action;

	/**
	 * The action for saving prominent words to an indexable.
	 *
	 * @var Save_Action
	 */
	protected $save_action;

	/**
	 * The indexing helper.
	 *
	 * @var Indexing_Helper
	 */
	protected $indexing_helper;

	/**
	 * Prominent_Words_Route constructor.
	 *
	 * @param Content_Action  $content_action  The content action.
	 * @param Save_Action     $save_action     The save action.
	 * @param Complete_Action $complete_action The complete action.
	 * @param Indexing_Helper $indexing_helper The indexing helper.
	 */
	public function __construct(
		Content_Action $content_action,
		Save_Action $save_action,
		Complete_Action $complete_action,
		Indexing_Helper $indexing_helper
	) {
		$this-&gt;content_action  = $content_action;
		$this-&gt;save_action     = $save_action;
		$this-&gt;complete_action = $complete_action;
		$this-&gt;indexing_helper = $indexing_helper;
	}

	/**
	 * Registers routes with WordPress.
	 *
	 * @return void
	 */
	public function register_routes() {
		\register_rest_route(
			Main::API_V1_NAMESPACE,
			self::GET_CONTENT_ROUTE,
			[
				&#039;methods&#039;             =&gt; &#039;POST&#039;,
				&#039;callback&#039;            =&gt; [ $this, &#039;run_content_action&#039; ],
				&#039;permission_callback&#039; =&gt; [ $this, &#039;can_retrieve_data&#039; ],
			]
		);

		\register_rest_route(
			Main::API_V1_NAMESPACE,
			self::COMPLETE_ROUTE,
			[
				&#039;methods&#039;             =&gt; &#039;POST&#039;,
				&#039;callback&#039;            =&gt; [ $this, &#039;run_complete_action&#039; ],
				&#039;permission_callback&#039; =&gt; [ $this, &#039;can_retrieve_data&#039; ],
			]
		);

		$route_args = [
			&#039;methods&#039;             =&gt; &#039;POST&#039;,
			&#039;args&#039;                =&gt; [
				&#039;data&#039; =&gt; [
					&#039;type&#039;     =&gt; &#039;array&#039;,
					&#039;required&#039; =&gt; false,
					&#039;items&#039;    =&gt; [
						&#039;type&#039;       =&gt; &#039;object&#039;,
						&#039;properties&#039; =&gt; [
							&#039;object_id&#039;       =&gt; [
								&#039;type&#039;     =&gt; &#039;number&#039;,
								&#039;required&#039; =&gt; true,
							],
							&#039;prominent_words&#039; =&gt; [
								&#039;type&#039;     =&gt; &#039;object&#039;,
								&#039;required&#039; =&gt; false,
							],
						],
					],
				],
			],
			&#039;callback&#039;            =&gt; [ $this, &#039;run_save_action&#039; ],
			&#039;permission_callback&#039; =&gt; [ $this, &#039;can_retrieve_data&#039; ],
		];

		\register_rest_route( Main::API_V1_NAMESPACE, self::SAVE_ROUTE, $route_args );
	}

	/**
	 * Retrieves the content that needs to be analyzed for prominent words.
	 *
	 * @return WP_REST_Response Response with the content that needs to be analyzed for prominent words.
	 */
	public function run_content_action() {
		return $this-&gt;run_indexation_action( $this-&gt;content_action, self::FULL_GET_CONTENT_ROUTE );
	}

	/**
	 * Marks the indexing of prominent words as completed.
	 *
	 * @return WP_REST_Response Response with empty data.
	 */
	public function run_complete_action() {
		$this-&gt;complete_action-&gt;complete();

		return $this-&gt;respond_with( [], false );
	}

	/**
	 * Saves the prominent words for the indexables.
	 *
	 * The request should have the parameters:
	 *  - **data**:              The data array containing:
	 *    - **object_id**:       The ID of the object (post-id, term-id, etc.).
	 *    - **prominent_words**: The map of `&#039;stem&#039; =&gt; weight` key-value pairs,
	 *                           e.g. the stems of the prominent words and their weights.
	 *                           Leave this out when the indexable has no prominent words.
	 *
	 * @param WP_REST_Request $request The request to handle.
	 *
	 * @return WP_REST_Response The response to give.
	 */
	public function run_save_action( WP_REST_Request $request ) {
		$this-&gt;save_action-&gt;save( $request-&gt;get_param( &#039;data&#039; ) );

		return new WP_REST_Response(
			[ &#039;message&#039; =&gt; &#039;The words have been successfully saved for the given indexables.&#039; ]
		);
	}

	/**
	 * Determines if the current user is allowed to use this endpoint.
	 *
	 * @return bool
	 */
	public function can_retrieve_data() {
		return \current_user_can( &#039;edit_posts&#039; );
	}

	/**
	 * Runs an indexing action and returns the response.
	 *
	 * @param Indexation_Action_Interface $indexation_action The indexing action.
	 * @param string                      $url               The url of the indexing route.
	 *
	 * @return WP_REST_Response|WP_Error The response, or an error when running the indexing action failed.
	 */
	protected function run_indexation_action( Indexation_Action_Interface $indexation_action, $url ) {
		try {
			return parent::run_indexation_action( $indexation_action, $url );
		} catch ( Exception $exception ) {
			$this-&gt;indexing_helper-&gt;set_reason( Indexing_Reasons::REASON_INDEXING_FAILED );

			return new WP_Error( &#039;wpseo_error_indexing&#039;, $exception-&gt;getMessage() );
		}
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2F.trash%2Fwordpress-seo-premium%2Fsrc%2Froutes'>⬅ Back to Directory</a>