Automattic\WooCommerce\Internal\ProductFeed\Mapping

UcpProductMapper::build_variants │ private │ WC 1.0

Build variants from product, bounded by the per-product cap.

The loop stops at the cap rather than building everything and slicing, so variations past it are never loaded. Named variations go first, so the cap can only drop variants nobody asked for by id.

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

Хуков нет.

Возвращает

array.

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

// private - только в коде основоного (родительского) класса
$result = $this->build_variants( $product, $item, $currency, $required_variation_ids, $only_required, ?array $candidates ): array;
$product(WC_Product) (обязательный)
WooCommerce product.
$item(массив) (обязательный)
Its Store API item response.
$currency(строка) (обязательный)
ISO 4217 currency code.
$required_variation_ids(массив) (обязательный)
Variation ids the request named directly.
$only_required(true|false) (обязательный)
Build nothing beyond $required_variation_ids.
?array $candidates(обязательный)
.

Код UcpProductMapper::build_variants() WC 11.3.0

private function build_variants( \WC_Product $product, array $item, string $currency, array $required_variation_ids, bool $only_required, ?array $candidates ): array {
	if ( ! $product instanceof \WC_Product_Variable ) {
		return array( $this->build_simple_variant( $item, $currency ) );
	}

	$children = array_map( 'intval', null === $candidates ? $product->get_visible_children() : $candidates );
	$required = array_values( array_intersect( $children, array_map( 'intval', $required_variation_ids ) ) );
	$options  = $this->variation_options_by_id( $item );

	if ( $only_required && ! empty( $required ) ) {
		// Bounded by the request's own id cap; nothing left out, nothing to
		// disclose.
		$variants              = $this->build_variation_list( $required, $options, $currency );
		$this->variant_budget -= count( $variants );

		return $variants;
	}

	$required_first = array_merge( $required, array_values( array_diff( $children, $required ) ) );

	// The floor keeps named variations and at least one variant: an empty
	// `variants` array would violate the schema's `minItems: 1`.
	$floor    = max( 1, count( $required ) );
	$cap      = max( $floor, min( self::MAX_VARIANTS_PER_PRODUCT, $this->variant_budget ) );
	$variants = $this->build_variation_list( $required_first, $options, $currency, $cap );

	$this->variant_budget -= count( $variants );

	$this->record_truncation( $item, count( $variants ), count( $children ) );

	return $variants;
}