is_purchasable() ? __( 'Select options', 'woocommerce' ) : __( 'Read more', 'woocommerce' ), $this ); } /** * 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. * * @param bool $include_taxes Should taxes be included in the prices. * @return array() Array of RAW prices, regular prices, and sale prices with keys set to variation ID. */ public function get_variation_prices( $include_taxes = false ) { $data_store = $this->get_data_store(); return $data_store->read_price_data( $this, $include_taxes ); } /** * Get the min or max variation regular price. * * @param string $min_or_max Min or max price. * @param boolean $include_taxes Should the price include taxes? * @return string */ public function get_variation_regular_price( $min_or_max = 'min', $include_taxes = false ) { $prices = $this->get_variation_prices( $include_taxes ); $price = 'min' === $min_or_max ? current( $prices['regular_price'] ) : end( $prices['regular_price'] ); return apply_filters( 'woocommerce_get_variation_regular_price', $price, $this, $min_or_max, $include_taxes ); } /** * Get the min or max variation sale price. * * @param string $min_or_max Min or max price. * @param boolean $include_taxes Should the price include taxes? * @return string */ public function get_variation_sale_price( $min_or_max = 'min', $include_taxes = false ) { $prices = $this->get_variation_prices( $include_taxes ); $price = 'min' === $min_or_max ? current( $prices['sale_price'] ) : end( $prices['sale_price'] ); return apply_filters( 'woocommerce_get_variation_sale_price', $price, $this, $min_or_max, $include_taxes ); } /** * Get the min or max variation (active) price. * * @param string $min_or_max Min or max price. * @param boolean $include_taxes Should the price include taxes? * @return string */ public function get_variation_price( $min_or_max = 'min', $include_taxes = false ) { $prices = $this->get_variation_prices( $include_taxes ); $price = 'min' === $min_or_max ? current( $prices['price'] ) : end( $prices['price'] ); return apply_filters( 'woocommerce_get_variation_price', $price, $this, $min_or_max, $include_taxes ); } /** * Returns the price in html format. * * @param string $price (default: '') * @return string */ public function get_price_html( $price = '' ) { $prices = $this->get_variation_prices( true ); if ( empty( $prices['price'] ) ) { return apply_filters( 'woocommerce_variable_empty_price_html', '', $this ); } $min_price = current( $prices['price'] ); $max_price = end( $prices['price'] ); if ( $min_price !== $max_price ) { $price = apply_filters( 'woocommerce_variable_price_html', wc_format_price_range( $min_price, $max_price ), $this ); } else { $price = apply_filters( 'woocommerce_variable_price_html', wc_price( $min_price ) . $this->get_price_suffix(), $this ); } return apply_filters( 'woocommerce_get_price_html', $price, $this ); } /** * Return a products child ids. * * @return array Children ids */ public function get_children( $visible_only = '' ) { if ( is_bool( $visible_only ) ) { wc_deprecated_argument( 'visible_only', '2.7', 'WC_Product_Variable::get_visible_children' ); return $visible_only ? $this->get_visible_children() : $this->get_children(); } return apply_filters( 'woocommerce_get_children', $this->children, $this, false ); } /** * Return a products child ids - visible only. * * @since 2.7.0 * @return array Children ids */ public function get_visible_children() { return apply_filters( 'woocommerce_get_children', $this->visible_children, $this, true ); } /** * Return an array of attributes used for variations, as well as their possible values. * * @return array Attributes and their available values */ public function get_variation_attributes() { return $this->variation_attributes; } /** * If set, get the default attributes for a variable product. * * @param string $attribute_name * @return string */ public function get_variation_default_attribute( $attribute_name ) { $defaults = $this->get_default_attributes(); $attribute_name = sanitize_title( $attribute_name ); return isset( $defaults[ $attribute_name ] ) ? $defaults[ $attribute_name ] : ''; } /** * Variable products themselves cannot be downloadable. */ public function get_downloadable( $context = 'view' ) { return false; } /** * Variable products themselves cannot be virtual. */ public function get_virtual( $context = 'view' ) { return false; } /** * Get an array of available variations for the current product. * * @return array */ public function get_available_variations() { $available_variations = array(); foreach ( $this->get_children() as $child_id ) { $variation = wc_get_product( $child_id ); // Hide out of stock variations if 'Hide out of stock items from the catalog' is checked if ( ! $variation->exists() || ( 'yes' === get_option( 'woocommerce_hide_out_of_stock_items' ) && ! $variation->is_in_stock() ) ) { continue; } // Filter 'woocommerce_hide_invisible_variations' to optionally hide invisible variations (disabled variations and variations with empty price) if ( apply_filters( 'woocommerce_hide_invisible_variations', false, $this->get_id(), $variation ) && ! $variation->variation_is_visible() ) { continue; } $available_variations[] = $this->get_available_variation( $variation ); } return $available_variations; } /** * Returns an array of data for a variation. Used in the add to cart form. * @since 2.4.0 * @param WC_Product $variation Variation product object or ID * @return array */ public function get_available_variation( $variation ) { if ( is_numeric( $variation ) ) { $variation = wc_get_product( $variation ); } return apply_filters( 'woocommerce_available_variation', array_merge( $variation->get_data(), array( 'attributes' => $variation->get_variation_attributes(), 'image' => wc_get_product_attachment_props( $variation->get_image_id() ), 'weight_html' => wc_format_weight( $variation->get_weight() ), 'dimensions_html' => wc_format_dimensions( $variation->get_dimensions( false ) ), 'price_html' => apply_filters( 'woocommerce_show_variation_price', $variation->get_price() === "" || $this->get_variation_price( 'min' ) !== $this->get_variation_price( 'max' ), $this, $variation ) ? '' . $variation->get_price_html() . '' : '', 'availability_html' => wc_get_stock_html( $variation ), 'variation_id' => $variation->get_id(), 'variation_is_visible' => $variation->variation_is_visible(), 'variation_is_active' => $variation->variation_is_active(), 'is_purchasable' => $variation->is_purchasable(), 'display_price' => wc_get_price_to_display( $variation ), 'display_regular_price' => wc_get_price_to_display( $variation, array( 'price' => $variation->get_regular_price() ) ), 'dimensions' => wc_format_dimensions( $variation->get_dimensions( false ) ), 'min_qty' => 1, 'max_qty' => $variation->backorders_allowed() ? '' : $variation->get_stock_quantity(), 'backorders_allowed' => $variation->backorders_allowed(), 'is_in_stock' => $variation->is_in_stock(), 'is_downloadable' => $variation->is_downloadable(), 'is_virtual' => $variation->is_virtual(), 'is_sold_individually' => $variation->is_sold_individually() ? 'yes' : 'no', 'variation_description' => $variation->get_description(), ) ), $this, $variation ); } /* |-------------------------------------------------------------------------- | Setters |-------------------------------------------------------------------------- */ /** * Sets an array of variation attributes. * * @since 2.7.0 * @param array */ public function set_variation_attributes( $variation_attributes ) { $this->variation_attributes = $variation_attributes; } /** * Sets an array of children for the product. * * @since 2.7.0 * @param array */ public function set_children( $children ) { $this->children = array_filter( wp_parse_id_list( (array) $children ) ); } /** * Sets an array of visible children only. * * @since 2.7.0 * @param array */ public function set_visible_children( $visible_children ) { $this->visible_children = array_filter( wp_parse_id_list( (array) $visible_children ) ); } /* |-------------------------------------------------------------------------- | CRUD methods |-------------------------------------------------------------------------- */ /** * Ensure properties are set correctly before save. * @since 2.7.0 */ public function validate_props() { // Before updating, ensure stock props are all aligned. Qty and backorders are not needed if not stock managed. if ( ! $this->get_manage_stock() ) { $this->set_stock_quantity( '' ); $this->set_backorders( 'no' ); // If we are stock managing and we don't have stock, force out of stock status. } elseif ( $this->get_stock_quantity() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { $this->set_stock_status( 'outofstock' ); // If the stock level is changing and we do now have enough, force in stock status. } elseif ( $this->get_stock_quantity() > get_option( 'woocommerce_notify_no_stock_amount' ) && array_key_exists( 'stock_quantity', $this->get_changes() ) ) { $this->set_stock_status( 'instock' ); // Otherwise revert to status the children have. } else { $this->set_stock_status( $this->child_is_in_stock() ? 'instock' : 'outofstock' ); } } /** * Save data (either create or update depending on if we are working on an existing product). * * @since 2.7.0 */ public function save() { $this->validate_props(); if ( $this->data_store ) { // Trigger action before saving to the DB. Allows you to adjust object props before save. do_action( 'woocommerce_before_' . $this->object_type . '_object_save', $this, $this->data_store ); // Get names before save. $previous_name = $this->data['name']; $new_name = $this->get_name( 'edit' ); if ( $this->get_id() ) { $this->data_store->update( $this ); } else { $this->data_store->create( $this ); } $this->data_store->sync_variation_names( $this, $previous_name, $new_name ); $this->data_store->sync_managed_variation_stock_status( $this ); return $this->get_id(); } } /* |-------------------------------------------------------------------------- | Conditionals |-------------------------------------------------------------------------- */ /** * Returns whether or not the product is on sale. * * @param string $context What the value is for. Valid values are view and edit. * @return bool */ public function is_on_sale( $context = 'view' ) { $prices = $this->get_variation_prices(); $on_sale = $prices['regular_price'] !== $prices['sale_price'] && $prices['sale_price'] === $prices['price']; return 'view' === $context ? apply_filters( 'woocommerce_product_is_on_sale', $on_sale, $this ) : $on_sale; } /** * Is a child in stock? * @return boolean */ public function child_is_in_stock() { $transient_name = 'wc_child_is_in_stock_' . $this->get_id(); $in_stock = get_transient( $transient_name ); if ( false === $in_stock ) { $in_stock = $this->data_store->child_is_in_stock( $this ); set_transient( $transient_name, $in_stock, DAY_IN_SECONDS * 30 ); } return (bool) $in_stock; } /** * Does a child have a weight set? * @return boolean */ public function child_has_weight() { $transient_name = 'wc_child_has_weight_' . $this->get_id(); $has_weight = get_transient( $transient_name ); if ( false === $has_weight ) { $has_weight = $this->data_store->child_has_weight( $this ); set_transient( $transient_name, $has_weight, DAY_IN_SECONDS * 30 ); } return (bool) $has_weight; } /** * Does a child have dimensions set? * @return boolean */ public function child_has_dimensions() { $transient_name = 'wc_child_has_dimensions_' . $this->get_id(); $has_dimension = get_transient( $transient_name ); if ( false === $has_dimension ) { $has_dimension = $this->data_store->child_has_dimensions( $this ); set_transient( $transient_name, $has_dimension, DAY_IN_SECONDS * 30 ); } return (bool) $has_dimension; } /** * Returns whether or not the product has dimensions set. * * @return bool */ public function has_dimensions() { return parent::has_dimensions() || $this->child_has_dimensions(); } /** * Returns whether or not the product has weight set. * * @return bool */ public function has_weight() { return parent::has_weight() || $this->child_has_weight(); } /* |-------------------------------------------------------------------------- | Sync with child variations. |-------------------------------------------------------------------------- */ /** * Sync a variable product with it's children. These sync functions sync * upwards (from child to parent) when the variation is saved. * * @param WC_Product|int $product Product object or ID for which you wish to sync. * @param bool $save If true, the prouduct object will be saved to the DB before returning it. * @return WC_Product Synced product object. */ public static function sync( $product, $save = true ) { if ( ! is_a( $product, 'WC_Product' ) ) { $product = wc_get_product( $product ); } if ( is_a( $product, 'WC_Product_Variable' ) ) { $data_store = WC_Data_Store::load( 'product-' . $product->get_type() ); $data_store->sync_price( $product ); $data_store->sync_stock_status( $product ); self::sync_attributes( $product ); // Legacy update of attributes. do_action( 'woocommerce_variable_product_sync', $product->get_id(), $product->get_visible_children(), $save ); if ( $save ) { $product->save(); } } return $product; } /** * Sync parent stock status with the status of all children and save. * * @param WC_Product|int $product Product object or ID for which you wish to sync. * @param bool $save If true, the prouduct object will be saved to the DB before returning it. * @return WC_Product Synced product object. */ public static function sync_stock_status( $product, $save = true ) { if ( ! is_a( $product, 'WC_Product' ) ) { $product = wc_get_product( $product ); } if ( is_a( $product, 'WC_Product_Variable' ) ) { $data_store = WC_Data_Store::load( 'product-' . $product->get_type() ); $data_store->sync_stock_status( $product ); if ( $save ) { $product->save(); } } return $product; } }