WC_API_Products::create_product_attribute_term() │ public │ WC 2.5.0

Create a new product attribute term.

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

Возвращает

Массив|WP_Error.

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

$WC_API_Products = new WC_API_Products();
$WC_API_Products->create_product_attribute_term( $attribute_id, $data );

$attribute_id(int) (обязательный)

Attribute ID.

$data(массив) (обязательный)

Posted data.

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

Код WC_API_Products::create_product_attribute_term() WC API Products::create product attribute term ^{WC 8.7.0}

public function create_product_attribute_term( $attribute_id, $data ) {
	global $wpdb;

	try {
		if ( ! isset( $data['product_attribute_term'] ) ) {
			throw new WC_API_Exception( 'woocommerce_api_missing_product_attribute_term_data', sprintf( __( 'No %1$s data specified to create %1$s', 'woocommerce' ), 'product_attribute_term' ), 400 );
		}

		$data = $data['product_attribute_term'];

		// Check permissions.
		if ( ! current_user_can( 'manage_product_terms' ) ) {
			throw new WC_API_Exception( 'woocommerce_api_user_cannot_create_product_attribute', __( 'You do not have permission to create product attributes', 'woocommerce' ), 401 );
		}

		$taxonomy = wc_attribute_taxonomy_name_by_id( $attribute_id );

		if ( ! $taxonomy ) {
			throw new WC_API_Exception( 'woocommerce_api_invalid_product_attribute_id', __( 'A product attribute with the provided ID could not be found', 'woocommerce' ), 404 );
		}

		$data = apply_filters( 'woocommerce_api_create_product_attribute_term_data', $data, $this );

		// Check if attribute term name is specified.
		if ( ! isset( $data['name'] ) ) {
			throw new WC_API_Exception( 'woocommerce_api_missing_product_attribute_term_name', sprintf( __( 'Missing parameter %s', 'woocommerce' ), 'name' ), 400 );
		}

		$args = array();

		// Set the attribute term slug.
		if ( isset( $data['slug'] ) ) {
			$args['slug'] = sanitize_title( wp_unslash( $data['slug'] ) );
		}

		$term = wp_insert_term( $data['name'], $taxonomy, $args );

		// Checks for an error in the term creation.
		if ( is_wp_error( $term ) ) {
			throw new WC_API_Exception( 'woocommerce_api_cannot_create_product_attribute', $term->get_error_message(), 400 );
		}

		$id = $term['term_id'];

		do_action( 'woocommerce_api_create_product_attribute_term', $id, $data );

		$this->server->send_status( 201 );

		return $this->get_product_attribute_term( $attribute_id, $id );
	} catch ( WC_API_Exception $e ) {
		return new WP_Error( $e->getErrorCode(), $e->getMessage(), array( 'status' => $e->getCode() ) );
	}
}