id = absint( $product ); $this->post = get_post( $this->id ); } elseif ( $product instanceof WC_Product ) { $this->id = absint( $product->id ); $this->post = $product; } elseif ( $product instanceof WP_Post || isset( $product->ID ) ) { $this->id = absint( $product->ID ); $this->post = $product; } } /** * __isset function. * * @access public * @param mixed $key * @return bool */ public function __isset( $key ) { return metadata_exists( 'post', $this->id, '_' . $key ); } /** * __get function. * * @access public * @param mixed $key * @return mixed */ public function __get( $key ) { // Get values or default if not set if ( in_array( $key, array( 'downloadable', 'virtual', 'backorders', 'manage_stock', 'featured', 'sold_individually' ) ) ) { $value = ( $value = get_post_meta( $this->id, '_' . $key, true ) ) ? $value : 'no'; } elseif ( in_array( $key, array( 'product_attributes', 'crosssell_ids', 'upsell_ids' ) ) ) { $value = ( $value = get_post_meta( $this->id, '_' . $key, true ) ) ? $value : array(); } elseif ( 'visibility' == $key ) { $value = ( $value = get_post_meta( $this->id, '_visibility', true ) ) ? $value : 'hidden'; } elseif ( 'stock' == $key ) { $value = ( $value = get_post_meta( $this->id, '_stock', true ) ) ? $value : 0; } elseif ( 'stock_status' == $key ) { $value = ( $value = get_post_meta( $this->id, '_stock_status', true ) ) ? $value : 'instock'; } elseif ( 'tax_status' == $key ) { $value = ( $value = get_post_meta( $this->id, '_tax_status', true ) ) ? $value : 'taxable'; } else { $value = get_post_meta( $this->id, '_' . $key, true ); } return $value; } /** * Get the product's post data. * * @access public * @return object */ public function get_post_data() { return $this->post; } /** * get_gallery_attachment_ids function. * * @access public * @return array */ public function get_gallery_attachment_ids() { if ( ! isset( $this->product_image_gallery ) ) { // Backwards compat $attachment_ids = get_posts( 'post_parent=' . $this->id . '&numberposts=-1&post_type=attachment&orderby=menu_order&order=ASC&post_mime_type=image&fields=ids&meta_key=_woocommerce_exclude_image&meta_value=0' ); $attachment_ids = array_diff( $attachment_ids, array( get_post_thumbnail_id( $this->id ) ) ); $this->product_image_gallery = implode( ',', $attachment_ids ); } return apply_filters( 'woocommerce_product_gallery_attachment_ids', array_filter( (array) explode( ',', $this->product_image_gallery ) ), $this ); } /** * Wrapper for get_permalink * @return string */ public function get_permalink() { return get_permalink( $this->id ); } /** * Get SKU (Stock-keeping unit) - product unique ID. * * @return string */ public function get_sku() { return apply_filters( 'woocommerce_get_sku', $this->sku, $this ); } /** * Returns number of items available for sale. * * @access public * @return int */ public function get_stock_quantity() { return $this->managing_stock() ? wc_stock_amount( $this->stock ) : ''; } /** * Get total stock. * * @access public * @return int */ public function get_total_stock() { return $this->get_stock_quantity(); } /** * Check if the stock status needs changing */ protected function check_stock_status() { // Update stock status if ( ! $this->backorders_allowed() && $this->get_total_stock() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { $this->set_stock_status( 'outofstock' ); } elseif ( $this->backorders_allowed() || $this->get_total_stock() > get_option( 'woocommerce_notify_no_stock_amount' ) ) { $this->set_stock_status( 'instock' ); } } /** * Set stock level of the product. * * Uses queries rather than update_post_meta so we can do this in one query (to avoid stock issues). * We cannot rely on the original loaded value in case another order was made since then. * * @param int $amount (default: null) * @param string $mode can be set, add, or subtract * @return int new stock level */ public function set_stock( $amount = null, $mode = 'set' ) { global $wpdb; if ( ! is_null( $amount ) && $this->managing_stock() ) { // Update stock in DB directly switch ( $mode ) { case 'add' : $wpdb->query( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value + {$amount} WHERE post_id = {$this->id} AND meta_key='_stock'" ); break; case 'subtract' : $wpdb->query( "UPDATE {$wpdb->postmeta} SET meta_value = meta_value - {$amount} WHERE post_id = {$this->id} AND meta_key='_stock'" ); break; default : $wpdb->query( "UPDATE {$wpdb->postmeta} SET meta_value = {$amount} WHERE post_id = {$this->id} AND meta_key='_stock'" ); break; } // Clear caches wp_cache_delete( $this->id, 'post_meta' ); // Stock status $this->check_stock_status(); // Trigger action do_action( 'woocommerce_product_set_stock', $this ); } return $this->get_stock_quantity(); } /** * Reduce stock level of the product. * * @param int $amount (default: 1) Amount to reduce by. * @return int new stock level */ public function reduce_stock( $amount = 1 ) { return $this->set_stock( $amount, 'subtract' ); } /** * Increase stock level of the product. * * @param int $amount (default: 1) Amount to increase by * @return int new stock level */ public function increase_stock( $amount = 1 ) { return $this->set_stock( $amount, 'add' ); } /** * set_stock_status function. * * @access public * @return void */ public function set_stock_status( $status ) { $status = ( 'outofstock' === $status ) ? 'outofstock' : 'instock'; // Sanity check if ( $this->managing_stock() ) { if ( ! $this->backorders_allowed() && $this->get_stock_quantity() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { $status = 'outofstock'; } } if ( update_post_meta( $this->id, '_stock_status', $status ) ) { do_action( 'woocommerce_product_set_stock_status', $this->id, $status ); } } /** * Checks the product type. * * Backwards compat with downloadable/virtual. * * @access public * @param mixed $type Array or string of types * @return bool */ public function is_type( $type ) { return ( $this->product_type == $type || ( is_array( $type ) && in_array( $this->product_type, $type ) ) ) ? true : false; } /** * Checks if a product is downloadable * * @access public * @return bool */ public function is_downloadable() { return $this->downloadable == 'yes' ? true : false; } /** * Check if downloadable product has a file attached. * * @since 1.6.2 * * @access public * @param string $download_id file identifier * @return bool Whether downloadable product has a file attached. */ public function has_file( $download_id = '' ) { return ( $this->is_downloadable() && $this->get_file( $download_id ) ) ? true : false; } /** * Gets an array of downloadable files for this product. * * @since 2.1.0 * * @return array */ public function get_files() { $downloadable_files = array_filter( isset( $this->downloadable_files ) ? (array) maybe_unserialize( $this->downloadable_files ) : array() ); if ( $downloadable_files ) { foreach ( $downloadable_files as $key => $file ) { if ( ! is_array( $file ) ) { $downloadable_files[ $key ] = array( 'file' => $file, 'name' => '' ); } // Set default name if ( empty( $file['name'] ) ) { $downloadable_files[ $key ]['name'] = wc_get_filename_from_url( $file['file'] ); } // Filter URL $downloadable_files[ $key ]['file'] = apply_filters( 'woocommerce_file_download_path', $downloadable_files[ $key ]['file'], $this, $key ); } } return apply_filters( 'woocommerce_product_files', $downloadable_files, $this ); } /** * Get a file by $download_id * * @param string $download_id file identifier * @return array|false if not found */ public function get_file( $download_id = '' ) { $files = $this->get_files(); if ( '' === $download_id ) { $file = sizeof( $files ) ? current( $files ) : false; } elseif ( isset( $files[ $download_id ] ) ) { $file = $files[ $download_id ]; } else { $file = false; } // allow overriding based on the particular file being requested return apply_filters( 'woocommerce_product_file', $file, $this, $download_id ); } /** * Get file download path identified by $download_id * * @param string $download_id file identifier * @return string */ public function get_file_download_path( $download_id ) { $files = $this->get_files(); if ( isset( $files[ $download_id ] ) ) { $file_path = $files[ $download_id ]['file']; } else { $file_path = ''; } // allow overriding based on the particular file being requested return apply_filters( 'woocommerce_product_file_download_path', $file_path, $this, $download_id ); } /** * Checks if a product is virtual (has no shipping). * * @access public * @return bool */ public function is_virtual() { return $this->virtual == 'yes' ? true : false; } /** * Checks if a product needs shipping. * * @access public * @return bool */ public function needs_shipping() { return apply_filters( 'woocommerce_product_needs_shipping', $this->is_virtual() ? false : true, $this ); } /** * Check if a product is sold individually (no quantities) * * @access public * @return bool */ public function is_sold_individually() { $return = false; if ( 'yes' == $this->sold_individually || ( ! $this->backorders_allowed() && $this->get_stock_quantity() == 1 ) ) { $return = true; } return apply_filters( 'woocommerce_is_sold_individually', $return, $this ); } /** * get_children function. * * @access public * @return array */ public function get_children() { return array(); } /** * Returns whether or not the product has any child product. * * @access public * @return bool */ public function has_child() { return false; } /** * Returns whether or not the product post exists. * * @access public * @return bool */ public function exists() { return empty( $this->post ) ? false : true; } /** * Returns whether or not the product is taxable. * * @access public * @return bool */ public function is_taxable() { $taxable = $this->tax_status == 'taxable' && get_option( 'woocommerce_calc_taxes' ) == 'yes' ? true : false; return apply_filters( 'woocommerce_product_is_taxable', $taxable, $this ); } /** * Returns whether or not the product shipping is taxable. * * @access public * @return bool */ public function is_shipping_taxable() { return $this->tax_status=='taxable' || $this->tax_status=='shipping' ? true : false; } /** * Get the title of the post. * * @access public * @return string */ public function get_title() { return apply_filters( 'woocommerce_product_title', $this->post->post_title, $this ); } /** * Get the parent of the post. * * @access public * @return int */ public function get_parent() { return apply_filters( 'woocommerce_product_parent', absint( $this->post->post_parent ), $this ); } /** * Get the add to url used mainly in loops. * * @access public * @return string */ public function add_to_cart_url() { return apply_filters( 'woocommerce_product_add_to_cart_url', get_permalink( $this->id ), $this ); } /** * Get the add to cart button text for the single page * * @access public * @return string */ public function single_add_to_cart_text() { return apply_filters( 'woocommerce_product_single_add_to_cart_text', __( 'Add to cart', 'woocommerce' ), $this ); } /** * Get the add to cart button text * * @access public * @return string */ public function add_to_cart_text() { return apply_filters( 'woocommerce_product_add_to_cart_text', __( 'Read more', 'woocommerce' ), $this ); } /** * Returns whether or not the product is stock managed. * * @access public * @return bool */ public function managing_stock() { return ( ! isset( $this->manage_stock ) || $this->manage_stock == 'no' || get_option( 'woocommerce_manage_stock' ) !== 'yes' ) ? false : true; } /** * Returns whether or not the product is in stock. * * @access public * @return bool */ public function is_in_stock() { if ( $this->managing_stock() && $this->backorders_allowed() ) { return true; } elseif ( $this->managing_stock() && $this->get_total_stock() <= get_option( 'woocommerce_notify_no_stock_amount' ) ) { return false; } else { return $this->stock_status === 'instock'; } } /** * Returns whether or not the product can be backordered. * * @access public * @return bool */ public function backorders_allowed() { return apply_filters( 'woocommerce_product_backorders_allowed', $this->backorders === 'yes' || $this->backorders === 'notify' ? true : false, $this->id ); } /** * Returns whether or not the product needs to notify the customer on backorder. * * @access public * @return bool */ public function backorders_require_notification() { return $this->managing_stock() && $this->backorders === 'notify' ? true : false; } /** * is_on_backorder function. * * @access public * @param int $qty_in_cart (default: 0) * @return bool */ public function is_on_backorder( $qty_in_cart = 0 ) { return $this->managing_stock() && $this->backorders_allowed() && ( $this->get_total_stock() - $qty_in_cart ) < 0 ? true : false; } /** * Returns whether or not the product has enough stock for the order. * * @access public * @param mixed $quantity * @return bool */ public function has_enough_stock( $quantity ) { return ! $this->managing_stock() || $this->backorders_allowed() || $this->stock >= $quantity ? true : false; } /** * Returns the availability of the product. * * @access public * @return string */ public function get_availability() { $availability = $class = ""; if ( $this->managing_stock() ) { if ( $this->is_in_stock() ) { if ( $this->get_total_stock() > get_option( 'woocommerce_notify_no_stock_amount' ) ) { switch ( get_option( 'woocommerce_stock_format' ) ) { case 'no_amount' : $availability = __( 'In stock', 'woocommerce' ); break; case 'low_amount' : $low_amount = get_option( 'woocommerce_notify_low_stock_amount' ); $availability = $this->get_total_stock() <= $low_amount ? sprintf( __( 'Only %s left in stock', 'woocommerce' ), $this->get_total_stock() ) : __( 'In stock', 'woocommerce' ); break; default : $availability = sprintf( __( '%s in stock', 'woocommerce' ), $this->get_total_stock() ); break; } if ( $this->backorders_allowed() && $this->backorders_require_notification() ) { $availability .= ' ' . __( '(backorders allowed)', 'woocommerce' ); } } elseif ( $this->backorders_allowed() ) { if ( $this->backorders_require_notification() ) { $availability = __( 'Available on backorder', 'woocommerce' ); $class = 'available-on-backorder'; } else { $availability = __( 'In stock', 'woocommerce' ); } } else { $availability = __( 'Out of stock', 'woocommerce' ); $class = 'out-of-stock'; } } elseif ( $this->backorders_allowed() ) { $availability = __( 'Available on backorder', 'woocommerce' ); $class = 'available-on-backorder'; } else { $availability = __( 'Out of stock', 'woocommerce' ); $class = 'out-of-stock'; } } elseif ( ! $this->is_in_stock() ) { $availability = __( 'Out of stock', 'woocommerce' ); $class = 'out-of-stock'; } return apply_filters( 'woocommerce_get_availability', array( 'availability' => $availability, 'class' => $class ), $this ); } /** * Returns whether or not the product is featured. * * @access public * @return bool */ public function is_featured() { return $this->featured === 'yes' ? true : false; } /** * Returns whether or not the product is visible. * * @access public * @return bool */ public function is_visible() { $visible = true; // Out of stock visibility if ( get_option( 'woocommerce_hide_out_of_stock_items' ) === 'yes' && ! $this->is_in_stock() ) { $visible = false; // visibility setting } elseif ( $this->visibility === 'hidden' ) { $visible = false; } elseif ( $this->visibility === 'visible' ) { $visible = true; // Visibility in loop } elseif ( $this->visibility === 'search' && is_search() ) { $visible = true; } elseif ( $this->visibility === 'search' && ! is_search() ) { $visible = false; } elseif ( $this->visibility === 'catalog' && is_search() ) { $visible = false; } elseif ( $this->visibility === 'catalog' && ! is_search() ) { $visible = true; } return apply_filters( 'woocommerce_product_is_visible', $visible, $this->id ); } /** * Returns whether or not the product is on sale. * * @access public * @return bool */ public function is_on_sale() { return ( $this->get_sale_price() != $this->get_regular_price() && $this->get_sale_price() == $this->get_price() ); } /** * Returns the product's weight. * * @access public * @return string */ public function get_weight() { return ( $this->weight ) ? $this->weight : ''; } /** * Returns false if the product cannot be bought. * * @access public * @return bool */ public function is_purchasable() { $purchasable = true; // Products must exist of course if ( ! $this->exists() ) { $purchasable = false; // Other products types need a price to be set } elseif ( $this->get_price() === '' ) { $purchasable = false; // Check the product is published } elseif ( $this->post->post_status !== 'publish' && ! current_user_can( 'edit_post', $this->id ) ) { $purchasable = false; } return apply_filters( 'woocommerce_is_purchasable', $purchasable, $this ); } /** * Set a products price dynamically. * * @access public * @param float $price Price to set. * @return void */ public function set_price( $price ) { $this->price = $price; } /** * Adjust a products price dynamically. * * @access public * @param mixed $price * @return void */ public function adjust_price( $price ) { $this->price = $this->price + $price; } /** * Returns the product's sale price. * * @return string price */ public function get_sale_price() { return apply_filters( 'woocommerce_get_sale_price', $this->sale_price, $this ); } /** * Returns the product's regular price. * * @return string price */ public function get_regular_price() { return apply_filters( 'woocommerce_get_regular_price', $this->regular_price, $this ); } /** * Returns the product's active price. * * @return string price */ public function get_price() { return apply_filters( 'woocommerce_get_price', $this->price, $this ); } /** * Returns the price (including tax). Uses customer tax rates. Can work for a specific $qty for more accurate taxes. * * @access public * @param string $price to calculdate, left blank to just use get_price() * @return string */ public function get_price_including_tax( $qty = 1, $price = '' ) { if ( ! $price ) { $price = $this->get_price(); } if ( $this->is_taxable() ) { if ( get_option('woocommerce_prices_include_tax') === 'no' ) { $tax_rates = WC_Tax::get_rates( $this->get_tax_class() ); $taxes = WC_Tax::calc_tax( $price * $qty, $tax_rates, false ); $tax_amount = WC_Tax::get_tax_total( $taxes ); $price = round( $price * $qty + $tax_amount, absint( get_option( 'woocommerce_price_num_decimals' ) ) ); } else { $tax_rates = WC_Tax::get_rates( $this->get_tax_class() ); $base_tax_rates = WC_Tax::get_shop_base_rate( $this->tax_class ); if ( ! empty( WC()->customer ) && WC()->customer->is_vat_exempt() ) { $base_taxes = WC_Tax::calc_tax( $price * $qty, $base_tax_rates, true ); $base_tax_amount = array_sum( $base_taxes ); $price = round( $price * $qty - $base_tax_amount, absint( get_option( 'woocommerce_price_num_decimals' ) ) ); } elseif ( $tax_rates !== $base_tax_rates ) { $base_taxes = WC_Tax::calc_tax( $price * $qty, $base_tax_rates, true ); $modded_taxes = WC_Tax::calc_tax( ( $price * $qty ) - array_sum( $base_taxes ), $tax_rates, false ); $price = round( ( $price * $qty ) - array_sum( $base_taxes ) + array_sum( $modded_taxes ), absint( get_option( 'woocommerce_price_num_decimals' ) ) ); } else { $price = $price * $qty; } } } else { $price = $price * $qty; } return apply_filters( 'woocommerce_get_price_including_tax', $price, $qty, $this ); } /** * Returns the price (excluding tax) - ignores tax_class filters since the price may *include* tax and thus needs subtracting. * Uses store base tax rates. Can work for a specific $qty for more accurate taxes. * * @access public * @param string $price to calculdate, left blank to just use get_price() * @return string */ public function get_price_excluding_tax( $qty = 1, $price = '' ) { if ( ! $price ) { $price = $this->get_price(); } if ( $this->is_taxable() && get_option('woocommerce_prices_include_tax') === 'yes' ) { $tax_rates = WC_Tax::get_shop_base_rate( $this->tax_class ); $taxes = WC_Tax::calc_tax( $price * $qty, $tax_rates, true ); $price = WC_Tax::round( $price * $qty - array_sum( $taxes ) ); } else { $price = $price * $qty; } return apply_filters( 'woocommerce_get_price_excluding_tax', $price, $qty, $this ); } /** * Get the suffix to display after prices > 0 * @return string */ public function get_price_suffix() { $price_display_suffix = get_option( 'woocommerce_price_display_suffix' ); if ( $price_display_suffix ) { $price_display_suffix = ' ' . $price_display_suffix . ''; $find = array( '{price_including_tax}', '{price_excluding_tax}' ); $replace = array( wc_price( $this->get_price_including_tax() ), wc_price( $this->get_price_excluding_tax() ) ); $price_display_suffix = str_replace( $find, $replace, $price_display_suffix ); } return apply_filters( 'woocommerce_get_price_suffix', $price_display_suffix, $this ); } /** * Returns the price in html format. * * @access public * @param string $price (default: '') * @return string */ public function get_price_html( $price = '' ) { $tax_display_mode = get_option( 'woocommerce_tax_display_shop' ); $display_price = $tax_display_mode == 'incl' ? $this->get_price_including_tax() : $this->get_price_excluding_tax(); $display_regular_price = $tax_display_mode == 'incl' ? $this->get_price_including_tax( 1, $this->get_regular_price() ) : $this->get_price_excluding_tax( 1, $this->get_regular_price() ); $display_sale_price = $tax_display_mode == 'incl' ? $this->get_price_including_tax( 1, $this->get_sale_price() ) : $this->get_price_excluding_tax( 1, $this->get_sale_price() ); if ( $this->get_price() > 0 ) { if ( $this->is_on_sale() && $this->get_regular_price() ) { $price .= $this->get_price_html_from_to( $display_regular_price, $display_price ) . $this->get_price_suffix(); $price = apply_filters( 'woocommerce_sale_price_html', $price, $this ); } else { $price .= wc_price( $display_price ) . $this->get_price_suffix(); $price = apply_filters( 'woocommerce_price_html', $price, $this ); } } elseif ( $this->get_price() === '' ) { $price = apply_filters( 'woocommerce_empty_price_html', '', $this ); } elseif ( $this->get_price() == 0 ) { if ( $this->is_on_sale() && $this->get_regular_price() ) { $price .= $this->get_price_html_from_to( $display_regular_price, __( 'Free!', 'woocommerce' ) ); $price = apply_filters( 'woocommerce_free_sale_price_html', $price, $this ); } else { $price = __( 'Free!', 'woocommerce' ); $price = apply_filters( 'woocommerce_free_price_html', $price, $this ); } } return apply_filters( 'woocommerce_get_price_html', $price, $this ); } /** * Functions for getting parts of a price, in html, used by get_price_html. * * @return string */ public function get_price_html_from_text() { return '' . _x( 'From:', 'min_price', 'woocommerce' ) . ' '; } /** * Functions for getting parts of a price, in html, used by get_price_html. * * @param mixed $from String or float to wrap with 'from' text * @param mixed $to String or float to wrap with 'to' text * @return string */ public function get_price_html_from_to( $from, $to ) { return '' . ( ( is_numeric( $from ) ) ? wc_price( $from ) : $from ) . ' ' . ( ( is_numeric( $to ) ) ? wc_price( $to ) : $to ) . ''; } /** * Returns the tax class. * * @access public * @return string */ public function get_tax_class() { return apply_filters( 'woocommerce_product_tax_class', $this->tax_class, $this ); } /** * Returns the tax status. * * @access public * @return string */ public function get_tax_status() { return $this->tax_status; } /** * get_average_rating function. * * @access public * @return string */ public function get_average_rating() { if ( false === ( $average_rating = get_transient( 'wc_average_rating_' . $this->id ) ) ) { global $wpdb; $average_rating = ''; $count = $this->get_rating_count(); if ( $count > 0 ) { $ratings = $wpdb->get_var( $wpdb->prepare(" SELECT SUM(meta_value) FROM $wpdb->commentmeta LEFT JOIN $wpdb->comments ON $wpdb->commentmeta.comment_id = $wpdb->comments.comment_ID WHERE meta_key = 'rating' AND comment_post_ID = %d AND comment_approved = '1' AND meta_value > 0 ", $this->id ) ); $average_rating = number_format( $ratings / $count, 2 ); } set_transient( 'wc_average_rating_' . $this->id, $average_rating, YEAR_IN_SECONDS ); } return $average_rating; } /** * get_rating_count function. * * @access public * @return int */ public function get_rating_count() { if ( false === ( $count = get_transient( 'wc_rating_count_' . $this->id ) ) ) { global $wpdb; $count = $wpdb->get_var( $wpdb->prepare(" SELECT COUNT(meta_value) FROM $wpdb->commentmeta LEFT JOIN $wpdb->comments ON $wpdb->commentmeta.comment_id = $wpdb->comments.comment_ID WHERE meta_key = 'rating' AND comment_post_ID = %d AND comment_approved = '1' AND meta_value > 0 ", $this->id ) ); set_transient( 'wc_rating_count_' . $this->id, $count, YEAR_IN_SECONDS ); } return $count; } /** * Returns the product rating in html format. * * @access public * @param string $rating (default: '') * @return string */ public function get_rating_html( $rating = null ) { if ( ! is_numeric( $rating ) ) { $rating = $this->get_average_rating(); } if ( $rating > 0 ) { $rating_html = '
'; $rating_html .= '' . $rating . ' ' . __( 'out of 5', 'woocommerce' ) . ''; $rating_html .= '
'; return $rating_html; } return ''; } /** * Returns the upsell product ids. * * @access public * @return array */ public function get_upsells() { return (array) maybe_unserialize( $this->upsell_ids ); } /** * Returns the cross sell product ids. * * @access public * @return array */ public function get_cross_sells() { return (array) maybe_unserialize( $this->crosssell_ids ); } /** * Returns the product categories. * * @access public * @param string $sep (default: ') * @param mixed ' * @param string $before (default: '') * @param string $after (default: '') * @return string */ public function get_categories( $sep = ', ', $before = '', $after = '' ) { return get_the_term_list( $this->id, 'product_cat', $before, $sep, $after ); } /** * Returns the product tags. * * @access public * @param string $sep (default: ', ') * @param string $before (default: '') * @param string $after (default: '') * @return array */ public function get_tags( $sep = ', ', $before = '', $after = '' ) { return get_the_term_list( $this->id, 'product_tag', $before, $sep, $after ); } /** * Returns the product shipping class. * * @access public * @return string */ public function get_shipping_class() { if ( ! $this->shipping_class ) { $classes = get_the_terms( $this->id, 'product_shipping_class' ); if ( $classes && ! is_wp_error( $classes ) ) { $this->shipping_class = current( $classes )->slug; } else { $this->shipping_class = ''; } } return $this->shipping_class; } /** * Returns the product shipping class ID. * * @access public * @return int */ public function get_shipping_class_id() { if ( ! $this->shipping_class_id ) { $classes = get_the_terms( $this->id, 'product_shipping_class' ); if ( $classes && ! is_wp_error( $classes ) ) { $this->shipping_class_id = current( $classes )->term_id; } else { $this->shipping_class_id = 0; } } return absint( $this->shipping_class_id ); } /** * Get and return related products. * * @access public * @param int $limit (default: 5) * @return array Array of post IDs */ public function get_related( $limit = 5 ) { global $wpdb; // Related products are found from category and tag $tags_array = array(0); $cats_array = array(0); // Get tags $terms = wp_get_post_terms( $this->id, 'product_tag' ); foreach ( $terms as $term ) { $tags_array[] = $term->term_id; } // Get categories $terms = wp_get_post_terms( $this->id, 'product_cat' ); foreach ( $terms as $term ) { $cats_array[] = $term->term_id; } // Don't bother if none are set if ( sizeof( $cats_array ) == 1 && sizeof( $tags_array ) == 1 ) { return array(); } // Sanitize $cats_array = array_map( 'absint', $cats_array ); $tags_array = array_map( 'absint', $tags_array ); $exclude_ids = array_map( 'absint', array_merge( array( 0, $this->id ), $this->get_upsells() ) ); // Generate query $query['fields'] = "SELECT DISTINCT ID FROM {$wpdb->posts} p"; $query['join'] = " INNER JOIN {$wpdb->postmeta} pm ON ( pm.post_id = p.ID AND pm.meta_key='_visibility' )"; $query['join'] .= " INNER JOIN {$wpdb->term_relationships} tr ON (p.ID = tr.object_id)"; $query['join'] .= " INNER JOIN {$wpdb->term_taxonomy} tt ON (tr.term_taxonomy_id = tt.term_taxonomy_id)"; $query['join'] .= " INNER JOIN {$wpdb->terms} t ON (t.term_id = tt.term_id)"; if ( get_option( 'woocommerce_hide_out_of_stock_items' ) === 'yes' ) { $query['join'] .= " INNER JOIN {$wpdb->postmeta} pm2 ON ( pm2.post_id = p.ID AND pm2.meta_key='_stock_status' )"; } $query['where'] = " WHERE 1=1"; $query['where'] .= " AND p.post_status = 'publish'"; $query['where'] .= " AND p.post_type = 'product'"; $query['where'] .= " AND p.ID NOT IN ( " . implode( ',', $exclude_ids ) . " )"; $query['where'] .= " AND pm.meta_value IN ( 'visible', 'catalog' )"; if ( get_option( 'woocommerce_hide_out_of_stock_items' ) === 'yes' ) { $query['where'] .= " AND pm2.meta_value = 'instock'"; } if ( apply_filters( 'woocommerce_product_related_posts_relate_by_category', true, $this->id ) ) { $query['where'] .= " AND ( tt.taxonomy = 'product_cat' AND t.term_id IN ( " . implode( ',', $cats_array ) . " ) )"; $andor = 'OR'; } else { $andor = 'AND'; } // when query is OR - need to check against excluded ids again if ( apply_filters( 'woocommerce_product_related_posts_relate_by_tag', true, $this->id ) ) { $query['where'] .= " {$andor} ( ( tt.taxonomy = 'product_tag' AND t.term_id IN ( " . implode( ',', $tags_array ) . " ) )"; $query['where'] .= " AND p.ID NOT IN ( " . implode( ',', $exclude_ids ) . " ) )"; } $query['orderby'] = " ORDER BY RAND()"; $query['limits'] = " LIMIT " . absint( $limit ) . " "; // Get the posts $related_posts = $wpdb->get_col( implode( ' ', apply_filters( 'woocommerce_product_related_posts_query', $query, $this->id ) ) ); return $related_posts; } /** * Returns a single product attribute. * * @access public * @param mixed $attr * @return string */ public function get_attribute( $attr ) { $attributes = $this->get_attributes(); $attr = sanitize_title( $attr ); if ( isset( $attributes[ $attr ] ) || isset( $attributes[ 'pa_' . $attr ] ) ) { $attribute = isset( $attributes[ $attr ] ) ? $attributes[ $attr ] : $attributes[ 'pa_' . $attr ]; if ( $attribute['is_taxonomy'] ) { return implode( ', ', wc_get_product_terms( $this->id, $attribute['name'], array( 'fields' => 'names' ) ) ); } else { return $attribute['value']; } } return ''; } /** * Returns product attributes. * * @access public * @return array */ public function get_attributes() { return (array) maybe_unserialize( $this->product_attributes ); } /** * Returns whether or not the product has any attributes set. * * @access public * @return mixed */ public function has_attributes() { if ( sizeof( $this->get_attributes() ) > 0 ) { foreach ( $this->get_attributes() as $attribute ) { if ( isset( $attribute['is_visible'] ) && $attribute['is_visible'] ) { return true; } } } return false; } /** * Returns whether or not we are showing dimensions on the product page. * * @access public * @return bool */ public function enable_dimensions_display() { return apply_filters( 'wc_product_enable_dimensions_display', true ); } /** * Returns whether or not the product has dimensions set. * * @access public * @return bool */ public function has_dimensions() { return $this->get_dimensions() ? true : false; } /** * Returns whether or not the product has weight set. * * @access public * @return bool */ public function has_weight() { return $this->get_weight() ? true : false; } /** * Returns dimensions. * * @access public * @return string */ public function get_dimensions() { if ( ! $this->dimensions ) { $dimensions = array(); if ( $this->length ) { $dimensions[] = $this->length; } if ( $this->width ) { $dimensions[] = $this->width; } if ( $this->height ){ $dimensions[] = $this->height; } $this->dimensions = implode( ' x ', $dimensions ); if ( ! empty( $this->dimensions ) ) { $this->dimensions .= ' ' . get_option( 'woocommerce_dimension_unit' ); } } return $this->dimensions; } /** * Lists a table of attributes for the product page. * * @access public * @return void */ public function list_attributes() { wc_get_template( 'single-product/product-attributes.php', array( 'product' => $this ) ); } /** * Gets the main product image ID. * @return int */ public function get_image_id() { if ( has_post_thumbnail( $this->id ) ) { $image_id = get_post_thumbnail_id( $this->id ); } elseif ( ( $parent_id = wp_get_post_parent_id( $this->id ) ) && has_post_thumbnail( $parent_id ) ) { $image_id = get_post_thumbnail_id( $parent_id ); } else { $image_id = 0; } return $image_id; } /** * Returns the main product image * * @access public * @param string $size (default: 'shop_thumbnail') * @return string */ public function get_image( $size = 'shop_thumbnail', $attr = array() ) { $image = ''; if ( has_post_thumbnail( $this->id ) ) { $image = get_the_post_thumbnail( $this->id, $size, $attr ); } elseif ( ( $parent_id = wp_get_post_parent_id( $this->id ) ) && has_post_thumbnail( $parent_id ) ) { $image = get_the_post_thumbnail( $parent_id, $size, $attr ); } else { $image = wc_placeholder_img( $size ); } return $image; } /** * Get product name with SKU or ID. Used within admin. * * @access public * @param mixed $product * @return string Formatted product name */ public function get_formatted_name() { if ( $this->get_sku() ) { $identifier = $this->get_sku(); } else { $identifier = '#' . $this->id; } return sprintf( __( '%s – %s', 'woocommerce' ), $identifier, $this->get_title() ); } }