Yoast\WP\SEO\AI\Content_Planner\Application

Content_Outline_Command_Handler{} │ Yoast 1.0

Handles the content outline command.

Хуков нет.

Использование

$Content_Outline_Command_Handler = new Content_Outline_Command_Handler();
// use class methods

Методы

1. public __construct(
2. public handle(
3. private build_outline( Response $response )

Код Content_Outline_Command_Handler{} Content Outline Command Handler{} ^{Yoast 27.7}

class Content_Outline_Command_Handler {

	/**
	 * The recent content collector.
	 *
	 * @var Recent_Content_Collector
	 */
	private $recent_content_collector;

	/**
	 * The token manager.
	 *
	 * @var Token_Manager
	 */
	private $token_manager;

	/**
	 * The request handler.
	 *
	 * @var Request_Handler
	 */
	private $request_handler;

	/**
	 * The consent handler.
	 *
	 * @var Consent_Handler
	 */
	private $consent_handler;

	/**
	 * The constructor.
	 *
	 * @param Recent_Content_Collector $recent_content_collector The recent content collector.
	 * @param Token_Manager            $token_manager            The token manager.
	 * @param Request_Handler          $request_handler          The request handler.
	 * @param Consent_Handler          $consent_handler          The consent handler.
	 */
	public function __construct(
		Recent_Content_Collector $recent_content_collector,
		Token_Manager $token_manager,
		Request_Handler $request_handler,
		Consent_Handler $consent_handler
	) {
		$this->recent_content_collector = $recent_content_collector;
		$this->token_manager            = $token_manager;
		$this->request_handler          = $request_handler;
		$this->consent_handler          = $consent_handler;
	}

	/**
	 * Handles the content outline command by collecting recent content and requesting an outline from the AI API.
	 *
	 * @param Content_Outline_Command $command               The content outline command.
	 * @param bool                    $retry_on_unauthorized Whether to retry on unauthorized response.
	 *
	 * @throws Unauthorized_Exception When the API returns an unauthorized response and retry is exhausted.
	 * @throws Forbidden_Exception    When consent has been revoked.
	 *
	 * @return Section_List A list of outline sections.
	 */
	public function handle(
		Content_Outline_Command $command,
		bool $retry_on_unauthorized = true
	): Section_List {
		$recent_content = $this->recent_content_collector->collect( $command->get_post_type() );
		$about_page     = $this->recent_content_collector->collect_about_page( $command->get_post_type() );
		$token          = $this->token_manager->get_or_request_access_token( $command->get_user() );
		$recent_content = $recent_content->to_array();

		$existing_posts = \array_map(
			static function ( $post ) {
				return [
					'title'       => $post['title'],
					'description' => $post['description'],
				];
			},
			$recent_content,
		);

		$content = [
			'new_post_metadata' => [
				'title'            => $command->get_title(),
				'intent'           => $command->get_intent(),
				'explanation'      => $command->get_explanation(),
				'keyphrase'        => $command->get_keyphrase(),
				'meta_description' => $command->get_meta_description(),
				'category'         => $command->get_category()->to_array(),
			],
			'existing_posts'    => $existing_posts,
		];
		if ( $about_page ) {
			$content['about_page'] = $about_page;
		}

		$request_body = [
			'subject' => [
				'language' => $command->get_language(),
				'content'  => $content,
			],
		];

		$request_headers = [
			'Authorization' => "Bearer $token",
			'X-Yst-Cohort'  => $command->get_editor(),
		];

		try {
			$response = $this->request_handler->handle( new Request( '/content-planner/next-post-outline', $request_body, $request_headers ) );
		} catch ( Unauthorized_Exception $exception ) {
			// Delete the stored JWT tokens, as they appear to be no longer valid.
			$this->token_manager->clear_tokens( (string) $command->get_user()->ID );

			if ( ! $retry_on_unauthorized ) {
				throw $exception;
			}

			// Try again once more by fetching a new set of tokens and trying the outline endpoint again.
			return $this->handle( $command, false );
		} catch ( Forbidden_Exception $exception ) {
			// Follow the API in the consent being revoked (Use case: user sent an e-mail to revoke?).
			// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- false positive.
			$this->consent_handler->revoke_consent( $command->get_user()->ID );
			throw new Forbidden_Exception( 'CONSENT_REVOKED', $exception->getCode() );
			// phpcs:enable WordPress.Security.EscapeOutput.ExceptionNotEscaped
		}

		return $this->build_outline( $response );
	}

	/**
	 * Builds a list of outline sections from the API response.
	 *
	 * @param Response $response The API response.
	 *
	 * @return Section_List The list of outline sections.
	 */
	private function build_outline( Response $response ): Section_List {
		$section_list = new Section_List();
		$json         = \json_decode( $response->get_body() );

		if ( $json === null || ! isset( $json->choices ) ) {
			return $section_list;
		}
		foreach ( $json->choices as $choice ) {
			$section_list->add(
				new Section(
					( $choice->content_notes ?? [] ),
					( $choice->subheading_text ?? null ),
				),
			);
		}

		return $section_list;
	}
}