PHP Class WC_Product_Variable

The WooCommerce product class handles individual product data.
Author: WooThemes
Inheritance: extends WC_Product
Afficher le fichier Open project: woocommerce/woocommerce Class Usage Examples

Protected Properties

Свойство Type Description
$extra_data array Stores product data.

Méthodes publiques

Méthode Description
__construct ( integer | WC_Product | object $product ) Merges variable product data into the parent object.
add_to_cart_text ( ) : string Get the add to cart button text.
child_has_dimensions ( ) : boolean Does a child have dimensions set?
child_has_weight ( ) : boolean Does a child have a weight set?
child_is_in_stock ( ) : boolean Is a child in stock?
get_available_variation ( WC_Product $variation ) : array Returns an array of data for a variation. Used in the add to cart form.
get_available_variations ( ) : array Get an array of available variations for the current product.
get_children ( string $context = 'view' ) : array Return a products child ids.
get_downloadable ( $context = 'view' ) Variable products themselves cannot be downloadable.
get_price_html ( string $price = '' ) : string Returns the price in html format.
get_type ( ) : string Get internal type.
get_variation_attributes ( string $context = 'view' ) : array Return an array of attributes used for variations, as well as their possible values.
get_variation_default_attribute ( string $attribute_name ) : string If set, get the default attributes for a variable product.
get_variation_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string Get the min or max variation (active) price.
get_variation_prices ( string $context = 'view' ) : array() Get an array of all sale and regular prices from all variations. This is used for example when displaying the price range at variable product level or seeing if the variable product is on sale.
get_variation_prices_including_taxes ( string $context = 'view' ) : array() Get an array of all sale and regular prices from all variations, includes taxes.
get_variation_regular_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string Get the min or max variation regular price.
get_variation_sale_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string Get the min or max variation sale price.
get_virtual ( $context = 'view' ) Variable products themselves cannot be virtual.
get_visible_children ( string $context = 'view' ) : array Return a products child ids - visible only.
has_dimensions ( ) : boolean Returns whether or not the product has dimensions set.
has_weight ( ) : boolean Returns whether or not the product has weight set.
is_on_sale ( ) : boolean Returns whether or not the product is on sale.
save ( ) Save data (either create or update depending on if we are working on an existing product).
set_children ( $children ) Sets an array of children for the product.
set_variation_attributes ( $variation_attributes ) Sets an array of variation attributes
set_variation_prices ( $variation_prices ) Sets an array of variation prices.
set_variation_prices_including_taxes ( $variation_prices_including_taxes ) Sets an array of variation prices, including taxes.
set_visible_children ( $visible_children ) Sets an array of visible children only.
sync ( WC_Product | integer $product, boolean $save = true ) : WC_Product Sync a variable product with it's children. These sync functions sync upwards (from child to parent) when the variation is saved.
sync_stock_status ( WC_Product | integer $product, boolean $save = true ) : WC_Product Sync parent stock status with the status of all children and save.
validate_props ( ) Ensure properties are set correctly before save.

Method Details

__construct() public méthode

Merges variable product data into the parent object.
public __construct ( integer | WC_Product | object $product )
$product integer | WC_Product | object Product to init.

add_to_cart_text() public méthode

Get the add to cart button text.
public add_to_cart_text ( ) : string
Résultat string

child_has_dimensions() public méthode

Does a child have dimensions set?
public child_has_dimensions ( ) : boolean
Résultat boolean

child_has_weight() public méthode

Does a child have a weight set?
public child_has_weight ( ) : boolean
Résultat boolean

child_is_in_stock() public méthode

Is a child in stock?
public child_is_in_stock ( ) : boolean
Résultat boolean

get_available_variation() public méthode

Returns an array of data for a variation. Used in the add to cart form.
Since: 2.4.0
public get_available_variation ( WC_Product $variation ) : array
$variation WC_Product Variation product object or ID
Résultat array

get_available_variations() public méthode

Get an array of available variations for the current product.
public get_available_variations ( ) : array
Résultat array

get_children() public méthode

Return a products child ids.
public get_children ( string $context = 'view' ) : array
$context string
Résultat array Children ids

get_downloadable() public méthode

Variable products themselves cannot be downloadable.
public get_downloadable ( $context = 'view' )

get_price_html() public méthode

Returns the price in html format.
public get_price_html ( string $price = '' ) : string
$price string (default: '')
Résultat string

get_type() public méthode

Get internal type.
public get_type ( ) : string
Résultat string

get_variation_attributes() public méthode

Return an array of attributes used for variations, as well as their possible values.
public get_variation_attributes ( string $context = 'view' ) : array
$context string
Résultat array Attributes and their available values

get_variation_default_attribute() public méthode

If set, get the default attributes for a variable product.
public get_variation_default_attribute ( string $attribute_name ) : string
$attribute_name string
Résultat string

get_variation_price() public méthode

Get the min or max variation (active) price.
public get_variation_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string
$min_or_max string Min or max price.
$include_taxes boolean Should the price include taxes?
Résultat string

get_variation_prices() public méthode

Get an array of all sale and regular prices from all variations. This is used for example when displaying the price range at variable product level or seeing if the variable product is on sale.
public get_variation_prices ( string $context = 'view' ) : array()
$context string
Résultat array()

get_variation_prices_including_taxes() public méthode

Get an array of all sale and regular prices from all variations, includes taxes.
Since: 2.7.0
public get_variation_prices_including_taxes ( string $context = 'view' ) : array()
$context string
Résultat array()

get_variation_regular_price() public méthode

Get the min or max variation regular price.
public get_variation_regular_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string
$min_or_max string Min or max price.
$include_taxes boolean Should the price include taxes?
Résultat string

get_variation_sale_price() public méthode

Get the min or max variation sale price.
public get_variation_sale_price ( string $min_or_max = 'min', boolean $include_taxes = false ) : string
$min_or_max string Min or max price.
$include_taxes boolean Should the price include taxes?
Résultat string

get_virtual() public méthode

Variable products themselves cannot be virtual.
public get_virtual ( $context = 'view' )

get_visible_children() public méthode

Return a products child ids - visible only.
Since: 2.7.0
public get_visible_children ( string $context = 'view' ) : array
$context string
Résultat array Children ids

has_dimensions() public méthode

Returns whether or not the product has dimensions set.
public has_dimensions ( ) : boolean
Résultat boolean

has_weight() public méthode

Returns whether or not the product has weight set.
public has_weight ( ) : boolean
Résultat boolean

is_on_sale() public méthode

Returns whether or not the product is on sale.
public is_on_sale ( ) : boolean
Résultat boolean

save() public méthode

Save data (either create or update depending on if we are working on an existing product).
Since: 2.7.0
public save ( )

set_children() public méthode

Sets an array of children for the product.
Since: 2.7.0
public set_children ( $children )

set_variation_attributes() public méthode

Sets an array of variation attributes
Since: 2.7.0
public set_variation_attributes ( $variation_attributes )

set_variation_prices() public méthode

Sets an array of variation prices.
Since: 2.7.0
public set_variation_prices ( $variation_prices )

set_variation_prices_including_taxes() public méthode

Sets an array of variation prices, including taxes.
Since: 2.7.0
public set_variation_prices_including_taxes ( $variation_prices_including_taxes )

set_visible_children() public méthode

Sets an array of visible children only.
Since: 2.7.0
public set_visible_children ( $visible_children )

sync() public static méthode

Sync a variable product with it's children. These sync functions sync upwards (from child to parent) when the variation is saved.
public static sync ( WC_Product | integer $product, boolean $save = true ) : WC_Product
$product WC_Product | integer Product object or ID for which you wish to sync.
$save boolean If true, the prouduct object will be saved to the DB before returning it.
Résultat WC_Product Synced product object.

sync_stock_status() public static méthode

Sync parent stock status with the status of all children and save.
public static sync_stock_status ( WC_Product | integer $product, boolean $save = true ) : WC_Product
$product WC_Product | integer Product object or ID for which you wish to sync.
$save boolean If true, the prouduct object will be saved to the DB before returning it.
Résultat WC_Product Synced product object.

validate_props() public méthode

Ensure properties are set correctly before save.
Since: 2.7.0
public validate_props ( )

Property Details

$extra_data protected_oe property

Stores product data.
protected array $extra_data
Résultat array