WP_REST_Attachments_Controller::get_edit_media_item_args() │ protected │ WP 5.5.0

Gets the request args for the edit item route.

Метод класса: WP_REST_Attachments_Controller{}

Хуков нет.

Возвращает

Массив.

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

// protected - в коде основоного (родительского) или дочернего класса
$result = $this->get_edit_media_item_args();

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

Код WP_REST_Attachments_Controller::get_edit_media_item_args() WP REST Attachments Controller::get edit media item args ^{WP 6.5.2}

protected function get_edit_media_item_args() {
	return array(
		'src'       => array(
			'description' => __( 'URL to the edited image file.' ),
			'type'        => 'string',
			'format'      => 'uri',
			'required'    => true,
		),
		'modifiers' => array(
			'description' => __( 'Array of image edits.' ),
			'type'        => 'array',
			'minItems'    => 1,
			'items'       => array(
				'description' => __( 'Image edit.' ),
				'type'        => 'object',
				'required'    => array(
					'type',
					'args',
				),
				'oneOf'       => array(
					array(
						'title'      => __( 'Rotation' ),
						'properties' => array(
							'type' => array(
								'description' => __( 'Rotation type.' ),
								'type'        => 'string',
								'enum'        => array( 'rotate' ),
							),
							'args' => array(
								'description' => __( 'Rotation arguments.' ),
								'type'        => 'object',
								'required'    => array(
									'angle',
								),
								'properties'  => array(
									'angle' => array(
										'description' => __( 'Angle to rotate clockwise in degrees.' ),
										'type'        => 'number',
									),
								),
							),
						),
					),
					array(
						'title'      => __( 'Crop' ),
						'properties' => array(
							'type' => array(
								'description' => __( 'Crop type.' ),
								'type'        => 'string',
								'enum'        => array( 'crop' ),
							),
							'args' => array(
								'description' => __( 'Crop arguments.' ),
								'type'        => 'object',
								'required'    => array(
									'left',
									'top',
									'width',
									'height',
								),
								'properties'  => array(
									'left'   => array(
										'description' => __( 'Horizontal position from the left to begin the crop as a percentage of the image width.' ),
										'type'        => 'number',
									),
									'top'    => array(
										'description' => __( 'Vertical position from the top to begin the crop as a percentage of the image height.' ),
										'type'        => 'number',
									),
									'width'  => array(
										'description' => __( 'Width of the crop as a percentage of the image width.' ),
										'type'        => 'number',
									),
									'height' => array(
										'description' => __( 'Height of the crop as a percentage of the image height.' ),
										'type'        => 'number',
									),
								),
							),
						),
					),
				),
			),
		),
		'rotation'  => array(
			'description'      => __( 'The amount to rotate the image clockwise in degrees. DEPRECATED: Use `modifiers` instead.' ),
			'type'             => 'integer',
			'minimum'          => 0,
			'exclusiveMinimum' => true,
			'maximum'          => 360,
			'exclusiveMaximum' => true,
		),
		'x'         => array(
			'description' => __( 'As a percentage of the image, the x position to start the crop from. DEPRECATED: Use `modifiers` instead.' ),
			'type'        => 'number',
			'minimum'     => 0,
			'maximum'     => 100,
		),
		'y'         => array(
			'description' => __( 'As a percentage of the image, the y position to start the crop from. DEPRECATED: Use `modifiers` instead.' ),
			'type'        => 'number',
			'minimum'     => 0,
			'maximum'     => 100,
		),
		'width'     => array(
			'description' => __( 'As a percentage of the image, the width to crop the image to. DEPRECATED: Use `modifiers` instead.' ),
			'type'        => 'number',
			'minimum'     => 0,
			'maximum'     => 100,
		),
		'height'    => array(
			'description' => __( 'As a percentage of the image, the height to crop the image to. DEPRECATED: Use `modifiers` instead.' ),
			'type'        => 'number',
			'minimum'     => 0,
			'maximum'     => 100,
		),
	);
}