Yoast\WP\SEO\Routes

Settings_Introduction_Route{}Yoast 1.0

Устарела с версии 20.7. Больше не поддерживается и может быть удалена. Рекомендуется заменить эту функцию на аналог.

Settings_Introduction_Route class.

Хуков нет.

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

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

Методы

  1. public __construct( Settings_Introduction_Action $settings_introduction_action )
  2. public static get_conditionals()
  3. public get_show()
  4. public get_wistia_embed_permission()
  5. public static permission_manage_options()
  6. public register_routes()
  7. public set_show( WP_REST_Request $request )
  8. public set_wistia_embed_permission( WP_REST_Request $request )

Список изменений

Устарела с 20.7

Код Settings_Introduction_Route{} Yoast 22.3

class Settings_Introduction_Route implements Route_Interface {

	/**
	 * Represents the Settings_Introduction_Route prefix.
	 *
	 * @var string
	 */
	public const ROUTE_PREFIX = '/settings_introduction';

	/**
	 * Represents the Wistia embed permission.
	 *
	 * @var string
	 */
	public const WISTIA_EMBED_PERMISSION = self::ROUTE_PREFIX . '/wistia_embed_permission';

	/**
	 * Represents showing the introduction.
	 *
	 * @var string
	 */
	public const SHOW = self::ROUTE_PREFIX . '/show';

	/**
	 * Holds the Settings_Introduction_Action.
	 *
	 * @var Settings_Introduction_Action
	 */
	private $settings_introduction_action;

	/**
	 * Constructs Settings_Introduction_Route.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @param Settings_Introduction_Action $settings_introduction_action The $settings_introduction_action.
	 */
	public function __construct( Settings_Introduction_Action $settings_introduction_action ) {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		$this->settings_introduction_action = $settings_introduction_action;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 */
	public static function get_conditionals() {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		return [ Settings_Conditional::class ];
	}

	/**
	 * Permission callback.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @return bool True when user has 'wpseo_manage_options' permission.
	 */
	public static function permission_manage_options() {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		return \current_user_can( 'wpseo_manage_options' );
	}

	/**
	 * Registers routes with WordPress.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @return void
	 */
	public function register_routes() {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		\register_rest_route(
			Main::API_V1_NAMESPACE,
			self::WISTIA_EMBED_PERMISSION,
			[
				[
					'methods'             => 'GET',
					'callback'            => [ $this, 'get_wistia_embed_permission' ],
					'permission_callback' => [ $this, 'permission_manage_options' ],
				],
				[
					'methods'             => 'POST',
					'callback'            => [ $this, 'set_wistia_embed_permission' ],
					'permission_callback' => [ $this, 'permission_manage_options' ],
					'args'                => [
						'value' => [
							'required' => true,
							'type'     => 'bool',
						],
					],
				],
			]
		);

		\register_rest_route(
			Main::API_V1_NAMESPACE,
			self::SHOW,
			[
				[
					'methods'             => 'GET',
					'callback'            => [ $this, 'get_show' ],
					'permission_callback' => [ $this, 'permission_manage_options' ],
				],
				[
					'methods'             => 'POST',
					'callback'            => [ $this, 'set_show' ],
					'permission_callback' => [ $this, 'permission_manage_options' ],
					'args'                => [
						'value' => [
							'required' => true,
							'type'     => 'bool',
						],
					],
				],
			]
		);
	}

	/**
	 * Gets the value of the wistia embed permission.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @return WP_REST_Response|WP_Error The response, or an error.
	 */
	public function get_wistia_embed_permission() {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		try {
			$value = $this->settings_introduction_action->get_wistia_embed_permission();
		} catch ( Exception $exception ) {
			return new WP_Error(
				'wpseo_settings_introduction_error',
				$exception->getMessage(),
				(object) []
			);
		}

		return new WP_REST_Response(
			[
				'json' => (object) [
					'value' => $value,
				],
			]
		);
	}

	/**
	 * Sets the value of the wistia embed permission.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @param WP_REST_Request $request The request object.
	 *
	 * @return WP_REST_Response|WP_Error The success or failure response.
	 */
	public function set_wistia_embed_permission( WP_REST_Request $request ) {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		$params = $request->get_json_params();
		$value  = \boolval( $params['value'] );

		try {
			$result = $this->settings_introduction_action->set_wistia_embed_permission( $value );
		} catch ( Exception $exception ) {
			return new WP_Error(
				'wpseo_settings_introduction_error',
				$exception->getMessage(),
				(object) []
			);
		}

		return new WP_REST_Response(
			[
				'json' => (object) [
					'success' => $result,
				],
			],
			( $result ) ? 200 : 400
		);
	}

	/**
	 * Gets the value of show.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @return WP_REST_Response|WP_Error The response, or an error.
	 */
	public function get_show() {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		try {
			$value = $this->settings_introduction_action->get_show();
		} catch ( Exception $exception ) {
			return new WP_Error(
				'wpseo_settings_introduction_error',
				$exception->getMessage(),
				(object) []
			);
		}

		return new WP_REST_Response(
			[
				'json' => (object) [
					'value' => $value,
				],
			]
		);
	}

	/**
	 * Sets the value of show.
	 *
	 * @deprecated 20.7
	 * @codeCoverageIgnore
	 *
	 * @param WP_REST_Request $request The request object.
	 *
	 * @return WP_REST_Response|WP_Error The success or failure response.
	 */
	public function set_show( WP_REST_Request $request ) {
		\_deprecated_function( __METHOD__, 'Yoast SEO 20.7' );

		$params = $request->get_json_params();
		$value  = \boolval( $params['value'] );

		try {
			$result = $this->settings_introduction_action->set_show( $value );
		} catch ( Exception $exception ) {
			return new WP_Error(
				'wpseo_settings_introduction_error',
				$exception->getMessage(),
				(object) []
			);
		}

		return new WP_REST_Response(
			[
				'json' => (object) [
					'success' => $result,
				],
			],
			( $result ) ? 200 : 400
		);
	}
}