2011-08-09 15:16:18 +00:00
< ? php
/**
2012-11-22 10:22:18 +00:00
* Abstract Product Class
2012-08-06 23:33:52 +00:00
*
2011-08-10 17:11:11 +00:00
* The WooCommerce product class handles individual product data .
2011-08-09 15:16:18 +00:00
*
2012-01-27 16:38:39 +00:00
* @ class WC_Product
2013-09-24 12:31:15 +00:00
* @ version 2.1 . 0
2013-02-20 17:14:46 +00:00
* @ package WooCommerce / Abstracts
* @ category Abstract Class
2012-08-15 17:08:42 +00:00
* @ author WooThemes
2011-08-09 15:16:18 +00:00
*/
2013-02-12 12:15:44 +00:00
class WC_Product {
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/** @var int The product (post) ID. */
2012-12-20 11:54:38 +00:00
public $id ;
2012-08-15 17:08:42 +00:00
/** @var object The actual post object. */
2012-12-20 11:54:38 +00:00
public $post ;
2012-08-15 17:08:42 +00:00
/** @var string The product's type (simple, variable etc). */
2013-02-12 12:15:44 +00:00
public $product_type = null ;
2012-11-21 18:07:45 +00:00
2011-08-09 15:16:18 +00:00
/**
2014-04-25 09:18:57 +00:00
* Constructor gets the post object and sets the ID for the loaded product .
2012-11-27 16:22:47 +00:00
*
2012-11-21 18:07:45 +00:00
* @ access public
2014-04-25 11:33:14 +00:00
* @ param int | WC_Product | WP_Post $product Product ID , post object , or product object
2011-08-09 15:16:18 +00:00
*/
2012-12-19 23:04:25 +00:00
public function __construct ( $product ) {
2014-04-25 09:18:57 +00:00
if ( is_numeric ( $product ) ) {
$this -> id = absint ( $product );
$this -> post = get_post ( $this -> id );
2013-06-03 12:18:48 +00:00
} elseif ( $product instanceof WC_Product ) {
$this -> id = absint ( $product -> id );
$this -> post = $product ;
2014-04-25 09:18:57 +00:00
} elseif ( $product instanceof WP_Post || isset ( $product -> ID ) ) {
$this -> id = absint ( $product -> ID );
$this -> post = $product ;
2012-11-21 18:07:45 +00:00
}
2011-08-09 15:16:18 +00:00
}
2012-11-27 16:22:47 +00:00
2012-12-19 23:04:25 +00:00
/**
* __isset function .
*
* @ access public
* @ param mixed $key
* @ return bool
*/
public function __isset ( $key ) {
return metadata_exists ( 'post' , $this -> id , '_' . $key );
}
2012-11-27 16:22:47 +00:00
2012-11-21 18:07:45 +00:00
/**
2012-12-19 23:04:25 +00:00
* __get function .
2012-11-27 16:22:47 +00:00
*
2012-11-21 18:07:45 +00:00
* @ access public
2012-12-19 23:04:25 +00:00
* @ param mixed $key
* @ return mixed
2012-11-21 18:07:45 +00:00
*/
2012-12-19 23:04:25 +00:00
public function __get ( $key ) {
2012-12-20 11:54:38 +00:00
// Get values or default if not set
2013-11-24 10:42:36 +00:00
if ( in_array ( $key , array ( 'downloadable' , 'virtual' , 'backorders' , 'manage_stock' , 'featured' , 'sold_individually' ) ) ) {
2012-12-19 23:04:25 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_' . $key , true ) ) ? $value : 'no' ;
2012-12-20 11:54:38 +00:00
2013-11-24 10:42:36 +00:00
} elseif ( in_array ( $key , array ( 'product_attributes' , 'crosssell_ids' , 'upsell_ids' ) ) ) {
2012-12-20 11:54:38 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_' . $key , true ) ) ? $value : array ();
2013-11-24 10:42:36 +00:00
} elseif ( 'visibility' == $key ) {
2012-12-19 23:04:25 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_visibility' , true ) ) ? $value : 'hidden' ;
2012-12-20 11:54:38 +00:00
2013-11-24 10:42:36 +00:00
} elseif ( 'stock' == $key ) {
2012-12-19 23:04:25 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_stock' , true ) ) ? $value : 0 ;
2012-12-20 11:54:38 +00:00
2013-11-24 10:42:36 +00:00
} elseif ( 'stock_status' == $key ) {
2012-12-19 23:04:25 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_stock_status' , true ) ) ? $value : 'instock' ;
2012-12-20 11:54:38 +00:00
2013-11-24 10:42:36 +00:00
} elseif ( 'tax_status' == $key ) {
2012-12-20 11:30:27 +00:00
$value = ( $value = get_post_meta ( $this -> id , '_tax_status' , true ) ) ? $value : 'taxable' ;
2012-11-29 16:48:40 +00:00
2013-11-24 10:42:36 +00:00
} else {
2012-12-20 11:54:38 +00:00
$value = get_post_meta ( $this -> id , '_' . $key , true );
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
2012-12-19 23:04:25 +00:00
return $value ;
2012-11-21 18:07:45 +00:00
}
2012-11-27 16:22:47 +00:00
2013-01-11 18:30:05 +00:00
/**
* Get the product ' s post data .
*
* @ access public
* @ return object
*/
public function get_post_data () {
return $this -> post ;
}
2012-12-20 01:13:06 +00:00
/**
2012-12-20 10:53:34 +00:00
* get_gallery_attachment_ids function .
2012-12-20 01:13:06 +00:00
*
* @ access public
* @ return array
*/
2013-07-23 10:28:59 +00:00
public function get_gallery_attachment_ids () {
2012-12-20 01:13:06 +00:00
if ( ! isset ( $this -> product_image_gallery ) ) {
// Backwards compat
2013-05-08 11:29:21 +00:00
$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' );
2014-06-24 17:56:33 +00:00
$attachment_ids = array_diff ( $attachment_ids , array ( get_post_thumbnail_id ( $this -> id ) ) );
2012-12-20 01:13:06 +00:00
$this -> product_image_gallery = implode ( ',' , $attachment_ids );
}
2014-06-24 17:56:33 +00:00
2013-11-18 12:40:58 +00:00
return apply_filters ( 'woocommerce_product_gallery_attachment_ids' , array_filter ( ( array ) explode ( ',' , $this -> product_image_gallery ) ), $this );
2012-12-20 01:13:06 +00:00
}
2013-09-23 14:47:47 +00:00
/**
* Wrapper for get_permalink
* @ return string
*/
public function get_permalink () {
return get_permalink ( $this -> id );
}
2011-08-22 14:10:22 +00:00
/**
2014-02-07 17:31:25 +00:00
* Get SKU ( Stock - keeping unit ) - product unique ID .
*
* @ return string
*/
public function get_sku () {
2014-06-19 15:28:49 +00:00
return apply_filters ( 'woocommerce_get_sku' , $this -> sku , $this );
2014-02-07 17:31:25 +00:00
}
/**
* Returns number of items available for sale .
*
* @ access public
* @ return int
*/
public function get_stock_quantity () {
2014-06-25 10:25:28 +00:00
return $this -> managing_stock () ? wc_stock_amount ( $this -> stock ) : '' ;
2014-02-07 17:31:25 +00:00
}
/**
* Get total stock .
*
* @ access public
* @ return int
*/
public function get_total_stock () {
2012-11-21 18:07:45 +00:00
return $this -> get_stock_quantity ();
2014-02-07 17:31:25 +00:00
}
2012-08-06 23:33:52 +00:00
2012-12-28 09:59:20 +00:00
/**
2014-04-25 14:27:58 +00:00
* Check if the stock status needs changing
2012-12-28 09:59:20 +00:00
*/
2014-06-24 12:01:34 +00:00
protected function check_stock_status () {
2014-04-25 14:27:58 +00:00
// Update stock status
if ( ! $this -> backorders_allowed () && $this -> get_total_stock () <= get_option ( 'woocommerce_notify_no_stock_amount' ) ) {
$this -> set_stock_status ( 'outofstock' );
2012-12-28 09:59:20 +00:00
2014-04-25 14:27:58 +00:00
} elseif ( $this -> backorders_allowed () || $this -> get_total_stock () > get_option ( 'woocommerce_notify_no_stock_amount' ) ) {
$this -> set_stock_status ( 'instock' );
}
}
2013-08-13 15:56:09 +00:00
2014-04-25 14:27:58 +00:00
/**
* Set stock level of the product .
*
2014-06-24 17:56:33 +00:00
* Uses queries rather than update_post_meta so we can do this in one query ( to avoid stock issues ) .
2014-04-25 14:27:58 +00:00
* 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 ;
2013-11-24 10:42:36 +00:00
}
2012-12-28 09:59:20 +00:00
2014-04-25 14:27:58 +00:00
// Clear caches
wp_cache_delete ( $this -> id , 'post_meta' );
// Stock status
$this -> check_stock_status ();
2013-08-13 15:56:09 +00:00
// Trigger action
do_action ( 'woocommerce_product_set_stock' , $this );
2012-12-28 09:59:20 +00:00
}
2013-11-29 18:50:31 +00:00
2014-04-25 14:27:58 +00:00
return $this -> get_stock_quantity ();
2012-12-28 09:59:20 +00:00
}
2011-08-09 15:16:18 +00:00
/**
2014-06-24 17:56:33 +00:00
* Reduce stock level of the product .
2011-08-09 15:16:18 +00:00
*
2014-04-25 14:27:58 +00:00
* @ param int $amount ( default : 1 ) Amount to reduce by .
* @ return int new stock level
2011-08-09 15:16:18 +00:00
*/
2014-04-25 14:27:58 +00:00
public function reduce_stock ( $amount = 1 ) {
return $this -> set_stock ( $amount , 'subtract' );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2011-08-09 15:16:18 +00:00
/**
2012-08-15 17:08:42 +00:00
* Increase stock level of the product .
2011-08-09 15:16:18 +00:00
*
2014-04-25 14:27:58 +00:00
* @ param int $amount ( default : 1 ) Amount to increase by
* @ return int new stock level
2011-08-09 15:16:18 +00:00
*/
2014-04-25 14:27:58 +00:00
public function increase_stock ( $amount = 1 ) {
2014-06-24 17:56:33 +00:00
return $this -> set_stock ( $amount , 'add' );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-11-28 15:40:08 +00:00
/**
* set_stock_status function .
*
* @ access public
* @ return void
*/
2013-07-23 10:28:59 +00:00
public function set_stock_status ( $status ) {
2013-03-23 18:36:23 +00:00
$status = ( 'outofstock' === $status ) ? 'outofstock' : 'instock' ;
2012-11-28 15:40:08 +00:00
2014-06-24 12:01:34 +00:00
// Sanity check
if ( $this -> managing_stock () ) {
if ( ! $this -> backorders_allowed () && $this -> get_stock_quantity () <= get_option ( 'woocommerce_notify_no_stock_amount' ) ) {
$status = 'outofstock' ;
}
}
2014-02-12 14:38:56 +00:00
if ( update_post_meta ( $this -> id , '_stock_status' , $status ) ) {
2012-11-28 15:40:08 +00:00
do_action ( 'woocommerce_product_set_stock_status' , $this -> id , $status );
}
}
2011-08-09 15:16:18 +00:00
/**
2012-08-15 17:08:42 +00:00
* Checks the product type .
*
* Backwards compat with downloadable / virtual .
2011-11-17 10:40:32 +00:00
*
2012-08-15 17:08:42 +00:00
* @ access public
* @ param mixed $type Array or string of types
* @ return bool
2011-08-09 15:16:18 +00:00
*/
2013-07-23 10:28:59 +00:00
public function is_type ( $type ) {
2012-11-29 16:48:40 +00:00
return ( $this -> product_type == $type || ( is_array ( $type ) && in_array ( $this -> product_type , $type ) ) ) ? true : false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2011-11-05 19:03:03 +00:00
/**
* Checks if a product is downloadable
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ return bool
2011-11-05 19:03:03 +00:00
*/
2013-07-23 10:28:59 +00:00
public function is_downloadable () {
2012-11-21 18:07:45 +00:00
return $this -> downloadable == 'yes' ? true : false ;
2011-11-05 19:03:03 +00:00
}
2012-08-06 23:33:52 +00:00
2012-07-31 11:58:00 +00:00
/**
2012-08-04 08:28:39 +00:00
* Check if downloadable product has a file attached .
*
* @ since 1.6 . 2
*
2012-08-28 15:21:54 +00:00
* @ access public
* @ param string $download_id file identifier
2012-08-04 08:28:39 +00:00
* @ return bool Whether downloadable product has a file attached .
2012-07-31 11:58:00 +00:00
*/
2013-07-23 10:28:59 +00:00
public function has_file ( $download_id = '' ) {
2013-09-20 16:01:09 +00:00
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
2013-11-24 10:42:36 +00:00
if ( empty ( $file [ 'name' ] ) ) {
2014-01-20 01:21:50 +00:00
$downloadable_files [ $key ][ 'name' ] = wc_get_filename_from_url ( $file [ 'file' ] );
2013-11-24 10:42:36 +00:00
}
2013-09-20 16:01:09 +00:00
// Filter URL
2013-12-16 23:27:57 +00:00
$downloadable_files [ $key ][ 'file' ] = apply_filters ( 'woocommerce_file_download_path' , $downloadable_files [ $key ][ 'file' ], $this , $key );
2013-09-20 16:01:09 +00:00
}
}
2013-12-16 23:27:57 +00:00
return apply_filters ( 'woocommerce_product_files' , $downloadable_files , $this );
2013-09-20 16:01:09 +00:00
}
/**
* Get a file by $download_id
*
* @ param string $download_id file identifier
* @ return array | false if not found
*/
2014-04-24 15:00:35 +00:00
public function get_file ( $download_id = '' ) {
2013-09-20 16:01:09 +00:00
$files = $this -> get_files ();
2014-04-24 15:00:35 +00:00
if ( '' === $download_id ) {
$file = sizeof ( $files ) ? current ( $files ) : false ;
} elseif ( isset ( $files [ $download_id ] ) ) {
2013-09-20 16:01:09 +00:00
$file = $files [ $download_id ];
2013-11-24 10:42:36 +00:00
} else {
2013-09-20 16:01:09 +00:00
$file = false ;
2013-11-24 10:42:36 +00:00
}
2013-09-20 16:01:09 +00:00
// allow overriding based on the particular file being requested
2013-12-16 23:27:57 +00:00
return apply_filters ( 'woocommerce_product_file' , $file , $this , $download_id );
2012-07-31 11:58:00 +00:00
}
2012-11-27 16:22:47 +00:00
2012-08-28 15:21:54 +00:00
/**
* Get file download path identified by $download_id
2012-11-27 16:22:47 +00:00
*
2012-08-28 15:21:54 +00:00
* @ param string $download_id file identifier
2013-09-20 16:01:09 +00:00
* @ return string
2012-08-28 15:21:54 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_file_download_path ( $download_id ) {
2013-09-20 16:01:09 +00:00
$files = $this -> get_files ();
2012-11-27 16:22:47 +00:00
2013-11-24 10:42:36 +00:00
if ( isset ( $files [ $download_id ] ) ) {
2013-09-20 16:01:09 +00:00
$file_path = $files [ $download_id ][ 'file' ];
2013-11-24 10:42:36 +00:00
} else {
2012-11-21 18:07:45 +00:00
$file_path = '' ;
2013-11-24 10:42:36 +00:00
}
2012-08-28 15:21:54 +00:00
// allow overriding based on the particular file being requested
2013-12-16 23:27:57 +00:00
return apply_filters ( 'woocommerce_product_file_download_path' , $file_path , $this , $download_id );
2012-08-28 15:21:54 +00:00
}
2012-08-06 23:33:52 +00:00
2011-11-05 19:03:03 +00:00
/**
2012-08-15 17:08:42 +00:00
* Checks if a product is virtual ( has no shipping ) .
*
* @ access public
* @ return bool
2011-11-05 19:03:03 +00:00
*/
2013-07-23 10:28:59 +00:00
public function is_virtual () {
2012-11-21 18:07:45 +00:00
return $this -> virtual == 'yes' ? true : false ;
2011-11-05 19:03:03 +00:00
}
2012-08-06 23:33:52 +00:00
2011-11-05 19:03:03 +00:00
/**
2012-08-15 17:08:42 +00:00
* Checks if a product needs shipping .
*
* @ access public
* @ return bool
2011-11-05 19:03:03 +00:00
*/
2013-07-23 10:28:59 +00:00
public function needs_shipping () {
2013-08-14 09:53:08 +00:00
return apply_filters ( 'woocommerce_product_needs_shipping' , $this -> is_virtual () ? false : true , $this );
2012-04-20 11:09:49 +00:00
}
2012-11-27 16:22:47 +00:00
2012-04-20 11:09:49 +00:00
/**
* Check if a product is sold individually ( no quantities )
2012-08-06 23:33:52 +00:00
*
2012-04-20 11:09:49 +00:00
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_sold_individually () {
2012-04-20 11:09:49 +00:00
$return = false ;
2012-08-06 23:33:52 +00:00
2013-02-10 23:02:52 +00:00
if ( 'yes' == $this -> sold_individually || ( ! $this -> backorders_allowed () && $this -> get_stock_quantity () == 1 ) ) {
2012-04-20 11:09:49 +00:00
$return = true ;
}
2012-08-06 23:33:52 +00:00
2012-04-20 11:09:49 +00:00
return apply_filters ( 'woocommerce_is_sold_individually' , $return , $this );
2011-11-05 19:03:03 +00:00
}
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
/**
* get_children function .
2012-11-27 16:22:47 +00:00
*
2012-11-21 18:07:45 +00:00
* @ access public
2014-02-07 17:31:00 +00:00
* @ return array
2012-11-21 18:07:45 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_children () {
2012-11-21 18:07:45 +00:00
return array ();
}
2012-11-27 16:22:47 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product has any child product .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function has_child () {
2012-11-21 18:07:45 +00:00
return false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product post exists .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function exists () {
2012-11-29 16:48:40 +00:00
return empty ( $this -> post ) ? false : true ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is taxable .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_taxable () {
2014-02-22 20:15:41 +00:00
$taxable = $this -> tax_status == 'taxable' && get_option ( 'woocommerce_calc_taxes' ) == 'yes' ? true : false ;
return apply_filters ( 'woocommerce_product_is_taxable' , $taxable , $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product shipping is taxable .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_shipping_taxable () {
2012-11-21 18:07:45 +00:00
return $this -> tax_status == 'taxable' || $this -> tax_status == 'shipping' ? true : false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Get the title of the post .
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_title () {
2013-11-18 15:03:32 +00:00
return apply_filters ( 'woocommerce_product_title' , $this -> post -> post_title , $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Get the parent of the post .
*
* @ access public
* @ return int
*/
2013-07-23 10:28:59 +00:00
public function get_parent () {
2014-06-25 12:46:47 +00:00
return apply_filters ( 'woocommerce_product_parent' , absint ( $this -> post -> post_parent ), $this );
2012-03-12 13:11:08 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
2013-09-25 11:35:06 +00:00
* Get the add to url used mainly in loops .
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function add_to_cart_url () {
2013-09-25 11:35:06 +00:00
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 );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is stock managed .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function managing_stock () {
2014-03-05 00:19:12 +00:00
return ( ! isset ( $this -> manage_stock ) || $this -> manage_stock == 'no' || get_option ( 'woocommerce_manage_stock' ) !== 'yes' ) ? false : true ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is in stock .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_in_stock () {
2014-06-24 12:01:34 +00:00
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 ;
2012-11-29 16:48:40 +00:00
} else {
2014-06-24 12:01:34 +00:00
return $this -> stock_status === 'instock' ;
2012-11-29 16:48:40 +00:00
}
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product can be backordered .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function backorders_allowed () {
2014-05-04 21:29:43 +00:00
return apply_filters ( 'woocommerce_product_backorders_allowed' , $this -> backorders === 'yes' || $this -> backorders === 'notify' ? true : false , $this -> id );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product needs to notify the customer on backorder .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function backorders_require_notification () {
2014-03-05 00:19:12 +00:00
return $this -> managing_stock () && $this -> backorders === 'notify' ? true : false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-07-17 18:11:14 +00:00
/**
* is_on_backorder function .
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ param int $qty_in_cart ( default : 0 )
* @ return bool
2012-07-17 18:11:14 +00:00
*/
2013-07-23 10:28:59 +00:00
public function is_on_backorder ( $qty_in_cart = 0 ) {
2012-11-21 18:07:45 +00:00
return $this -> managing_stock () && $this -> backorders_allowed () && ( $this -> get_total_stock () - $qty_in_cart ) < 0 ? true : false ;
2012-07-17 18:11:14 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product has enough stock for the order .
*
* @ access public
* @ param mixed $quantity
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function has_enough_stock ( $quantity ) {
2012-11-21 18:07:45 +00:00
return ! $this -> managing_stock () || $this -> backorders_allowed () || $this -> stock >= $quantity ? true : false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the availability of the product .
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_availability () {
2012-11-29 16:48:40 +00:00
$availability = $class = " " ;
2012-08-06 23:33:52 +00:00
2012-11-29 16:48:40 +00:00
if ( $this -> managing_stock () ) {
if ( $this -> is_in_stock () ) {
2013-09-24 12:31:15 +00:00
if ( $this -> get_total_stock () > get_option ( 'woocommerce_notify_no_stock_amount' ) ) {
2012-08-06 23:33:52 +00:00
2014-06-27 13:46:35 +00:00
switch ( get_option ( 'woocommerce_stock_format' ) ) {
2012-04-24 18:15:56 +00:00
case 'no_amount' :
2014-06-27 13:46:35 +00:00
$availability = __ ( 'In stock' , 'woocommerce' );
2012-04-24 18:15:56 +00:00
break ;
case 'low_amount' :
2014-06-27 13:46:35 +00:00
$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' );
2012-04-24 18:15:56 +00:00
break ;
default :
2014-06-27 13:46:35 +00:00
$availability = sprintf ( __ ( '%s in stock' , 'woocommerce' ), $this -> get_total_stock () );
2012-04-24 18:15:56 +00:00
break ;
}
2012-08-06 23:33:52 +00:00
2013-11-24 10:42:36 +00:00
if ( $this -> backorders_allowed () && $this -> backorders_require_notification () ) {
2012-10-16 09:45:33 +00:00
$availability .= ' ' . __ ( '(backorders allowed)' , 'woocommerce' );
2013-11-24 10:42:36 +00:00
}
2012-08-06 23:33:52 +00:00
2014-06-27 13:46:35 +00:00
} elseif ( $this -> backorders_allowed () ) {
if ( $this -> backorders_require_notification () ) {
$availability = __ ( 'Available on backorder' , 'woocommerce' );
$class = 'available-on-backorder' ;
2012-11-29 16:48:40 +00:00
} else {
2014-06-27 13:46:35 +00:00
$availability = __ ( 'In stock' , 'woocommerce' );
2012-11-29 16:48:40 +00:00
}
2014-06-27 13:46:35 +00:00
} else {
$availability = __ ( 'Out of stock' , 'woocommerce' );
$class = 'out-of-stock' ;
2012-11-29 16:48:40 +00:00
}
} 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' ;
}
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
return apply_filters ( 'woocommerce_get_availability' , array ( 'availability' => $availability , 'class' => $class ), $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is featured .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_featured () {
2014-03-05 00:19:12 +00:00
return $this -> featured === 'yes' ? true : false ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is visible .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_visible () {
2012-08-06 23:33:52 +00:00
2012-01-03 15:55:05 +00:00
$visible = true ;
2012-08-06 23:33:52 +00:00
2011-08-18 23:14:35 +00:00
// Out of stock visibility
2014-03-05 00:19:12 +00:00
if ( get_option ( 'woocommerce_hide_out_of_stock_items' ) === 'yes' && ! $this -> is_in_stock () ) {
2013-11-24 10:42:36 +00:00
$visible = false ;
2012-08-06 23:33:52 +00:00
2011-08-18 23:14:35 +00:00
// visibility setting
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'hidden' ) {
2013-11-24 10:42:36 +00:00
$visible = false ;
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'visible' ) {
2013-11-24 10:42:36 +00:00
$visible = true ;
2012-08-06 23:33:52 +00:00
2011-11-24 15:32:57 +00:00
// Visibility in loop
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'search' && is_search () ) {
2013-11-24 10:42:36 +00:00
$visible = true ;
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'search' && ! is_search () ) {
2013-11-24 10:42:36 +00:00
$visible = false ;
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'catalog' && is_search () ) {
2013-11-24 10:42:36 +00:00
$visible = false ;
2014-03-05 00:19:12 +00:00
} elseif ( $this -> visibility === 'catalog' && ! is_search () ) {
2013-11-24 10:42:36 +00:00
$visible = true ;
}
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
return apply_filters ( 'woocommerce_product_is_visible' , $visible , $this -> id );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product is on sale .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function is_on_sale () {
return ( $this -> get_sale_price () != $this -> get_regular_price () && $this -> get_sale_price () == $this -> get_price () );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the product ' s weight .
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_weight () {
2013-12-03 14:11:01 +00:00
return ( $this -> weight ) ? $this -> weight : '' ;
2011-08-09 15:16:18 +00:00
}
2012-07-16 16:23:17 +00:00
2013-07-23 10:28:59 +00:00
/**
* Returns false if the product cannot be bought .
*
* @ access public
2014-03-21 21:37:26 +00:00
* @ return bool
2013-07-23 10:28:59 +00:00
*/
public function is_purchasable () {
$purchasable = true ;
// Products must exist of course
2013-11-24 10:42:36 +00:00
if ( ! $this -> exists () ) {
2013-07-23 10:28:59 +00:00
$purchasable = false ;
// Other products types need a price to be set
2013-11-24 10:42:36 +00:00
} elseif ( $this -> get_price () === '' ) {
2013-07-23 10:28:59 +00:00
$purchasable = false ;
// Check the product is published
2013-11-24 10:42:36 +00:00
} elseif ( $this -> post -> post_status !== 'publish' && ! current_user_can ( 'edit_post' , $this -> id ) ) {
2013-07-23 10:28:59 +00:00
$purchasable = false ;
2013-11-24 10:42:36 +00:00
}
2013-07-23 10:28:59 +00:00
return apply_filters ( 'woocommerce_is_purchasable' , $purchasable , $this );
}
2012-08-15 17:08:42 +00:00
/**
* Set a products price dynamically .
*
* @ access public
* @ param float $price Price to set .
* @ return void
*/
2013-07-23 10:28:59 +00:00
public function set_price ( $price ) {
2012-07-16 16:23:17 +00:00
$this -> price = $price ;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Adjust a products price dynamically .
*
* @ access public
2012-11-29 16:48:40 +00:00
* @ param mixed $price
2012-08-15 17:08:42 +00:00
* @ return void
*/
2013-07-23 10:28:59 +00:00
public function adjust_price ( $price ) {
2013-03-13 15:08:58 +00:00
$this -> price = $this -> price + $price ;
2011-11-06 13:45:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
2013-07-23 10:28:59 +00:00
* Returns the product ' s sale price .
2012-08-15 17:08:42 +00:00
*
2013-07-23 10:28:59 +00:00
* @ return string price
2012-08-15 17:08:42 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_sale_price () {
return apply_filters ( 'woocommerce_get_sale_price' , $this -> sale_price , $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
/**
2013-07-23 10:28:59 +00:00
* Returns the product ' s regular price .
2012-08-06 23:33:52 +00:00
*
2013-07-23 10:28:59 +00:00
* @ return string price
2012-08-06 23:33:52 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_regular_price () {
return apply_filters ( 'woocommerce_get_regular_price' , $this -> regular_price , $this );
2012-08-06 23:33:52 +00:00
}
2013-07-23 10:28:59 +00:00
/**
* Returns the product ' s active price .
*
* @ return string price
*/
public function get_price () {
return apply_filters ( 'woocommerce_get_price' , $this -> price , $this );
}
2012-08-15 17:08:42 +00:00
2012-12-03 16:36:54 +00:00
/**
* Returns the price ( including tax ) . Uses customer tax rates . Can work for a specific $qty for more accurate taxes .
*
* @ access public
2013-09-19 15:31:54 +00:00
* @ param string $price to calculdate , left blank to just use get_price ()
2012-12-03 16:36:54 +00:00
* @ return string
*/
2013-09-19 15:31:54 +00:00
public function get_price_including_tax ( $qty = 1 , $price = '' ) {
2013-11-24 10:42:36 +00:00
if ( ! $price ) {
2013-09-19 15:31:54 +00:00
$price = $this -> get_price ();
2013-11-24 10:42:36 +00:00
}
2012-12-03 16:36:54 +00:00
if ( $this -> is_taxable () ) {
2014-03-05 00:19:12 +00:00
if ( get_option ( 'woocommerce_prices_include_tax' ) === 'no' ) {
2012-12-03 16:36:54 +00:00
2014-06-12 15:47:43 +00:00
$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 );
2013-10-24 15:16:39 +00:00
$price = round ( $price * $qty + $tax_amount , absint ( get_option ( 'woocommerce_price_num_decimals' ) ) );
2012-12-03 16:36:54 +00:00
} else {
2014-06-12 15:47:43 +00:00
$tax_rates = WC_Tax :: get_rates ( $this -> get_tax_class () );
$base_tax_rates = WC_Tax :: get_shop_base_rate ( $this -> tax_class );
2012-12-03 16:36:54 +00:00
2013-11-13 16:59:42 +00:00
if ( ! empty ( WC () -> customer ) && WC () -> customer -> is_vat_exempt () ) {
2012-12-03 16:36:54 +00:00
2014-06-12 15:47:43 +00:00
$base_taxes = WC_Tax :: calc_tax ( $price * $qty , $base_tax_rates , true );
2012-12-03 16:36:54 +00:00
$base_tax_amount = array_sum ( $base_taxes );
2013-10-24 15:16:39 +00:00
$price = round ( $price * $qty - $base_tax_amount , absint ( get_option ( 'woocommerce_price_num_decimals' ) ) );
2012-12-03 16:36:54 +00:00
} elseif ( $tax_rates !== $base_tax_rates ) {
2014-06-12 15:47:43 +00:00
$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 );
2013-10-24 15:16:39 +00:00
$price = round ( ( $price * $qty ) - array_sum ( $base_taxes ) + array_sum ( $modded_taxes ), absint ( get_option ( 'woocommerce_price_num_decimals' ) ) );
2012-12-03 16:36:54 +00:00
} else {
$price = $price * $qty ;
}
}
} else {
$price = $price * $qty ;
}
return apply_filters ( 'woocommerce_get_price_including_tax' , $price , $qty , $this );
}
2012-08-15 17:08:42 +00:00
/**
* Returns the price ( excluding tax ) - ignores tax_class filters since the price may * include * tax and thus needs subtracting .
2012-12-03 16:36:54 +00:00
* Uses store base tax rates . Can work for a specific $qty for more accurate taxes .
2012-08-15 17:08:42 +00:00
*
* @ access public
2013-09-19 15:31:54 +00:00
* @ param string $price to calculdate , left blank to just use get_price ()
2012-08-15 17:08:42 +00:00
* @ return string
*/
2013-09-19 15:31:54 +00:00
public function get_price_excluding_tax ( $qty = 1 , $price = '' ) {
2012-08-06 23:33:52 +00:00
2013-11-24 10:42:36 +00:00
if ( ! $price ) {
2013-09-19 15:31:54 +00:00
$price = $this -> get_price ();
2013-11-24 10:42:36 +00:00
}
2011-08-09 15:16:18 +00:00
2014-03-05 00:19:12 +00:00
if ( $this -> is_taxable () && get_option ( 'woocommerce_prices_include_tax' ) === 'yes' ) {
2014-06-12 15:47:43 +00:00
$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 ) );
2012-12-03 16:36:54 +00:00
} else {
$price = $price * $qty ;
2012-11-29 16:48:40 +00:00
}
2012-08-06 23:33:52 +00:00
2012-12-03 16:36:54 +00:00
return apply_filters ( 'woocommerce_get_price_excluding_tax' , $price , $qty , $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2013-09-19 15:31:54 +00:00
/**
* 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 = ' <small class="woocommerce-price-suffix">' . $price_display_suffix . '</small>' ;
$find = array (
'{price_including_tax}' ,
'{price_excluding_tax}'
);
$replace = array (
2013-11-25 13:34:21 +00:00
wc_price ( $this -> get_price_including_tax () ),
wc_price ( $this -> get_price_excluding_tax () )
2013-09-19 15:31:54 +00:00
);
$price_display_suffix = str_replace ( $find , $replace , $price_display_suffix );
}
return apply_filters ( 'woocommerce_get_price_suffix' , $price_display_suffix , $this );
}
2012-08-15 17:08:42 +00:00
/**
* Returns the price in html format .
*
* @ access public
* @ param string $price ( default : '' )
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_price_html ( $price = '' ) {
2012-08-06 23:33:52 +00:00
2013-09-19 15:31:54 +00:00
$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 () );
2013-07-23 10:28:59 +00:00
2013-09-19 15:31:54 +00:00
if ( $this -> get_price () > 0 ) {
2012-08-06 23:33:52 +00:00
2013-07-23 10:28:59 +00:00
if ( $this -> is_on_sale () && $this -> get_regular_price () ) {
2013-09-19 15:31:54 +00:00
$price .= $this -> get_price_html_from_to ( $display_regular_price , $display_price ) . $this -> get_price_suffix ();
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
$price = apply_filters ( 'woocommerce_sale_price_html' , $price , $this );
2012-08-06 23:33:52 +00:00
2012-02-27 13:47:18 +00:00
} else {
2012-08-06 23:33:52 +00:00
2013-11-25 13:34:21 +00:00
$price .= wc_price ( $display_price ) . $this -> get_price_suffix ();
2012-02-27 13:23:03 +00:00
2012-11-21 18:07:45 +00:00
$price = apply_filters ( 'woocommerce_price_html' , $price , $this );
2012-08-06 23:33:52 +00:00
2012-10-08 11:51:00 +00:00
}
2012-08-06 23:33:52 +00:00
2013-09-19 15:31:54 +00:00
} elseif ( $this -> get_price () === '' ) {
$price = apply_filters ( 'woocommerce_empty_price_html' , '' , $this );
2013-07-23 10:28:59 +00:00
} elseif ( $this -> get_price () == 0 ) {
2012-02-25 08:03:00 +00:00
2013-07-23 10:28:59 +00:00
if ( $this -> is_on_sale () && $this -> get_regular_price () ) {
2012-08-06 23:33:52 +00:00
2013-09-19 15:31:54 +00:00
$price .= $this -> get_price_html_from_to ( $display_regular_price , __ ( 'Free!' , 'woocommerce' ) );
2012-02-25 08:03:00 +00:00
2012-11-21 18:07:45 +00:00
$price = apply_filters ( 'woocommerce_free_sale_price_html' , $price , $this );
2012-02-25 08:03:00 +00:00
2012-11-21 18:07:45 +00:00
} else {
2012-02-25 08:03:00 +00:00
2012-11-21 18:07:45 +00:00
$price = __ ( 'Free!' , 'woocommerce' );
2012-02-25 08:03:00 +00:00
2012-11-21 18:07:45 +00:00
$price = apply_filters ( 'woocommerce_free_price_html' , $price , $this );
2012-08-06 23:33:52 +00:00
2012-10-18 10:33:47 +00:00
}
}
2012-08-06 23:33:52 +00:00
2012-10-18 10:33:47 +00:00
return apply_filters ( 'woocommerce_get_price_html' , $price , $this );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Functions for getting parts of a price , in html , used by get_price_html .
2014-01-07 07:13:31 +00:00
*
2012-08-15 17:08:42 +00:00
* @ return string
*/
2013-12-05 01:46:12 +00:00
public function get_price_html_from_text () {
2013-07-23 10:28:59 +00:00
return '<span class="from">' . _x ( 'From:' , 'min_price' , 'woocommerce' ) . ' </span>' ;
2012-02-26 14:11:56 +00:00
}
2012-08-15 17:08:42 +00:00
/**
* Functions for getting parts of a price , in html , used by get_price_html .
*
2013-12-04 12:45:23 +00:00
* @ param mixed $from String or float to wrap with 'from' text
* @ param mixed $to String or float to wrap with 'to' text
2012-08-15 17:08:42 +00:00
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_price_html_from_to ( $from , $to ) {
2013-11-25 13:34:21 +00:00
return '<del>' . ( ( is_numeric ( $from ) ) ? wc_price ( $from ) : $from ) . '</del> <ins>' . ( ( is_numeric ( $to ) ) ? wc_price ( $to ) : $to ) . '</ins>' ;
2012-02-26 14:11:56 +00:00
}
2012-08-06 23:33:52 +00:00
2013-07-23 10:28:59 +00:00
/**
* 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 ;
}
2012-08-15 17:08:42 +00:00
/**
2013-01-12 10:53:24 +00:00
* get_average_rating function .
2012-08-15 17:08:42 +00:00
*
* @ access public
2013-11-27 18:20:31 +00:00
* @ return string
2012-08-15 17:08:42 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_average_rating () {
2013-01-12 10:53:24 +00:00
if ( false === ( $average_rating = get_transient ( 'wc_average_rating_' . $this -> id ) ) ) {
2012-08-06 23:33:52 +00:00
2013-01-12 10:53:24 +00:00
global $wpdb ;
2012-11-27 16:22:47 +00:00
2013-01-12 10:53:24 +00:00
$average_rating = '' ;
$count = $this -> get_rating_count ();
2011-10-31 14:49:30 +00:00
2013-01-12 10:53:24 +00:00
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'
2013-03-15 10:10:00 +00:00
AND meta_value > 0
2013-01-12 10:53:24 +00:00
" , $this->id ) );
$average_rating = number_format ( $ratings / $count , 2 );
}
2014-03-12 11:58:41 +00:00
set_transient ( 'wc_average_rating_' . $this -> id , $average_rating , YEAR_IN_SECONDS );
2013-01-12 10:53:24 +00:00
}
return $average_rating ;
}
/**
* get_rating_count function .
*
* @ access public
2013-11-27 18:20:31 +00:00
* @ return int
2013-01-12 10:53:24 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_rating_count () {
2013-01-12 10:53:24 +00:00
if ( false === ( $count = get_transient ( 'wc_rating_count_' . $this -> id ) ) ) {
2012-08-06 23:33:52 +00:00
2011-10-31 14:49:30 +00:00
global $wpdb ;
2012-10-18 13:37:04 +00:00
$count = $wpdb -> get_var ( $wpdb -> prepare ( "
2012-08-06 23:33:52 +00:00
SELECT COUNT ( meta_value ) FROM $wpdb -> commentmeta
2011-10-31 14:49:30 +00:00
LEFT JOIN $wpdb -> comments ON $wpdb -> commentmeta . comment_id = $wpdb -> comments . comment_ID
WHERE meta_key = 'rating'
2012-10-18 13:37:04 +00:00
AND comment_post_ID = % d
2011-10-31 14:49:30 +00:00
AND comment_approved = '1'
AND meta_value > 0
2012-12-12 10:27:58 +00:00
" , $this->id ) );
2012-08-06 23:33:52 +00:00
2014-03-12 11:58:41 +00:00
set_transient ( 'wc_rating_count_' . $this -> id , $count , YEAR_IN_SECONDS );
2013-01-12 10:53:24 +00:00
}
2012-08-06 23:33:52 +00:00
2013-01-12 10:53:24 +00:00
return $count ;
}
2012-08-06 23:33:52 +00:00
2013-01-12 10:53:24 +00:00
/**
2013-03-28 13:58:01 +00:00
* Returns the product rating in html format .
2013-01-12 10:53:24 +00:00
*
* @ access public
2013-03-28 13:58:01 +00:00
* @ param string $rating ( default : '' )
* @ return string
2013-01-12 10:53:24 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_rating_html ( $rating = null ) {
2013-01-12 10:53:24 +00:00
2013-11-24 10:42:36 +00:00
if ( ! is_numeric ( $rating ) ) {
2013-03-28 13:58:01 +00:00
$rating = $this -> get_average_rating ();
2013-11-24 10:42:36 +00:00
}
2013-01-12 10:53:24 +00:00
2013-03-28 13:58:01 +00:00
if ( $rating > 0 ) {
2013-01-12 10:53:24 +00:00
2013-03-28 13:58:01 +00:00
$rating_html = '<div class="star-rating" title="' . sprintf ( __ ( 'Rated %s out of 5' , 'woocommerce' ), $rating ) . '">' ;
2013-01-12 10:53:24 +00:00
2013-03-28 13:58:01 +00:00
$rating_html .= '<span style="width:' . ( ( $rating / 5 ) * 100 ) . '%"><strong class="rating">' . $rating . '</strong> ' . __ ( 'out of 5' , 'woocommerce' ) . '</span>' ;
2013-01-12 10:53:24 +00:00
$rating_html .= '</div>' ;
return $rating_html ;
}
2013-12-02 11:34:27 +00:00
return '' ;
2011-08-28 12:04:05 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the upsell product ids .
*
* @ access public
* @ return array
*/
2013-07-23 10:28:59 +00:00
public function get_upsells () {
2011-08-19 20:11:04 +00:00
return ( array ) maybe_unserialize ( $this -> upsell_ids );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
2013-03-03 17:07:31 +00:00
* Returns the cross sell product ids .
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ return array
*/
2013-07-23 10:28:59 +00:00
public function get_cross_sells () {
2011-08-19 20:11:04 +00:00
return ( array ) maybe_unserialize ( $this -> crosssell_ids );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the product categories .
*
* @ access public
* @ param string $sep ( default : ' )
* @ param mixed '
* @ param string $before ( default : '' )
* @ param string $after ( default : '' )
2013-09-04 13:57:07 +00:00
* @ return string
2012-08-15 17:08:42 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_categories ( $sep = ', ' , $before = '' , $after = '' ) {
2012-10-12 18:48:49 +00:00
return get_the_term_list ( $this -> id , 'product_cat' , $before , $sep , $after );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the product tags .
*
* @ access public
2013-01-31 11:45:05 +00:00
* @ param string $sep ( default : ', ' )
2012-08-15 17:08:42 +00:00
* @ param string $before ( default : '' )
* @ param string $after ( default : '' )
* @ return array
*/
2013-07-23 10:28:59 +00:00
public function get_tags ( $sep = ', ' , $before = '' , $after = '' ) {
2012-11-29 16:48:40 +00:00
return get_the_term_list ( $this -> id , 'product_tag' , $before , $sep , $after );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the product shipping class .
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_shipping_class () {
2012-11-21 18:07:45 +00:00
if ( ! $this -> shipping_class ) {
2011-12-02 20:48:07 +00:00
$classes = get_the_terms ( $this -> id , 'product_shipping_class' );
2013-11-24 10:42:36 +00:00
if ( $classes && ! is_wp_error ( $classes ) ) {
2012-11-27 16:22:47 +00:00
$this -> shipping_class = current ( $classes ) -> slug ;
2013-11-24 10:42:36 +00:00
} else {
2012-11-21 18:07:45 +00:00
$this -> shipping_class = '' ;
2013-11-24 10:42:36 +00:00
}
2012-11-21 18:07:45 +00:00
}
2011-12-02 20:48:07 +00:00
return $this -> shipping_class ;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the product shipping class ID .
*
* @ access public
* @ return int
*/
2013-07-23 10:28:59 +00:00
public function get_shipping_class_id () {
2012-11-29 16:48:40 +00:00
if ( ! $this -> shipping_class_id ) {
2012-05-31 10:05:00 +00:00
$classes = get_the_terms ( $this -> id , 'product_shipping_class' );
2013-11-24 10:42:36 +00:00
if ( $classes && ! is_wp_error ( $classes ) ) {
2012-08-06 23:33:52 +00:00
$this -> shipping_class_id = current ( $classes ) -> term_id ;
2013-11-24 10:42:36 +00:00
} else {
2012-06-03 12:12:08 +00:00
$this -> shipping_class_id = 0 ;
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
}
2012-11-19 14:05:03 +00:00
return absint ( $this -> shipping_class_id );
2012-05-31 10:05:00 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Get and return related products .
*
* @ access public
* @ param int $limit ( default : 5 )
* @ return array Array of post IDs
*/
2013-07-23 10:28:59 +00:00
public function get_related ( $limit = 5 ) {
2013-11-13 18:00:01 +00:00
global $wpdb ;
2011-08-09 15:16:18 +00:00
// Related products are found from category and tag
$tags_array = array ( 0 );
$cats_array = array ( 0 );
2012-08-06 23:33:52 +00:00
2011-08-09 15:16:18 +00:00
// Get tags
2014-03-05 00:19:12 +00:00
$terms = wp_get_post_terms ( $this -> id , 'product_tag' );
2014-02-07 17:35:45 +00:00
foreach ( $terms as $term ) {
$tags_array [] = $term -> term_id ;
}
2012-08-06 23:33:52 +00:00
2011-11-18 01:07:05 +00:00
// Get categories
2014-03-05 00:19:12 +00:00
$terms = wp_get_post_terms ( $this -> id , 'product_cat' );
2014-02-07 17:35:45 +00:00
foreach ( $terms as $term ) {
$cats_array [] = $term -> term_id ;
}
2012-08-06 23:33:52 +00:00
2011-11-18 01:07:05 +00:00
// Don't bother if none are set
2013-11-24 10:42:36 +00:00
if ( sizeof ( $cats_array ) == 1 && sizeof ( $tags_array ) == 1 ) {
2013-11-13 18:00:01 +00:00
return array ();
2013-11-24 10:42:36 +00:00
}
2013-11-13 18:00:01 +00:00
// 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
2014-02-25 23:17:50 +00:00
$query [ 'fields' ] = " SELECT DISTINCT ID FROM { $wpdb -> posts } p " ;
2013-11-14 09:48:41 +00:00
$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) " ;
2013-11-13 18:00:01 +00:00
2014-03-05 00:19:12 +00:00
if ( get_option ( 'woocommerce_hide_out_of_stock_items' ) === 'yes' ) {
2013-11-14 09:48:41 +00:00
$query [ 'join' ] .= " INNER JOIN { $wpdb -> postmeta } pm2 ON ( pm2.post_id = p.ID AND pm2.meta_key='_stock_status' ) " ;
2013-11-24 10:42:36 +00:00
}
2013-11-13 18:00:01 +00:00
2013-11-14 09:48:41 +00:00
$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' ) " ;
2013-11-13 18:00:01 +00:00
2014-03-05 00:19:12 +00:00
if ( get_option ( 'woocommerce_hide_out_of_stock_items' ) === 'yes' ) {
2013-11-14 09:48:41 +00:00
$query [ 'where' ] .= " AND pm2.meta_value = 'instock' " ;
2013-11-24 10:42:36 +00:00
}
2013-11-13 18:00:01 +00:00
2014-05-21 09:35:54 +00:00
if ( apply_filters ( 'woocommerce_product_related_posts_relate_by_category' , true , $this -> id ) ) {
2013-11-14 09:48:41 +00:00
$query [ 'where' ] .= " AND ( tt.taxonomy = 'product_cat' AND t.term_id IN ( " . implode ( ',' , $cats_array ) . " ) ) " ;
2013-11-13 18:00:01 +00:00
$andor = 'OR' ;
} else {
$andor = 'AND' ;
}
2014-03-05 00:19:12 +00:00
// when query is OR - need to check against excluded ids again
2014-05-21 09:35:54 +00:00
if ( apply_filters ( 'woocommerce_product_related_posts_relate_by_tag' , true , $this -> id ) ) {
2014-06-24 06:11:10 +00:00
$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 ) . " ) ) " ;
2013-11-24 10:42:36 +00:00
}
2012-08-06 23:33:52 +00:00
2013-11-14 09:48:41 +00:00
$query [ 'orderby' ] = " ORDER BY RAND() " ;
$query [ 'limits' ] = " LIMIT " . absint ( $limit ) . " " ;
2012-08-06 23:33:52 +00:00
2011-11-13 12:17:52 +00:00
// Get the posts
2014-05-21 09:35:54 +00:00
$related_posts = $wpdb -> get_col ( implode ( ' ' , apply_filters ( 'woocommerce_product_related_posts_query' , $query , $this -> id ) ) );
2012-08-06 23:33:52 +00:00
2011-11-13 12:17:52 +00:00
return $related_posts ;
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns a single product attribute .
*
* @ access public
* @ param mixed $attr
2013-03-07 19:34:29 +00:00
* @ return string
2012-08-15 17:08:42 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_attribute ( $attr ) {
2011-11-26 20:23:57 +00:00
$attributes = $this -> get_attributes ();
2012-08-06 23:33:52 +00:00
2013-04-16 14:39:07 +00:00
$attr = sanitize_title ( $attr );
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
if ( isset ( $attributes [ $attr ] ) || isset ( $attributes [ 'pa_' . $attr ] ) ) {
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
$attribute = isset ( $attributes [ $attr ] ) ? $attributes [ $attr ] : $attributes [ 'pa_' . $attr ];
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
if ( $attribute [ 'is_taxonomy' ] ) {
2012-08-06 23:33:52 +00:00
2013-11-25 13:30:20 +00:00
return implode ( ', ' , wc_get_product_terms ( $this -> id , $attribute [ 'name' ], array ( 'fields' => 'names' ) ) );
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
} else {
2012-08-06 23:33:52 +00:00
2012-01-10 17:14:40 +00:00
return $attribute [ 'value' ];
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
}
2012-08-06 23:33:52 +00:00
2012-06-10 17:15:02 +00:00
}
2013-03-07 19:34:29 +00:00
return '' ;
2011-11-26 20:23:57 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns product attributes .
*
* @ access public
* @ return array
*/
2013-07-23 10:28:59 +00:00
public function get_attributes () {
2012-12-20 11:54:38 +00:00
return ( array ) maybe_unserialize ( $this -> product_attributes );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product has any attributes set .
*
* @ access public
* @ return mixed
*/
2013-07-23 10:28:59 +00:00
public function has_attributes () {
2012-11-21 18:07:45 +00:00
if ( sizeof ( $this -> get_attributes () ) > 0 ) {
foreach ( $this -> get_attributes () as $attribute ) {
2014-02-07 17:35:45 +00:00
if ( isset ( $attribute [ 'is_visible' ] ) && $attribute [ 'is_visible' ] ) {
2012-11-21 18:07:45 +00:00
return true ;
2014-02-07 17:35:45 +00:00
}
2012-11-21 18:07:45 +00:00
}
}
2011-08-09 15:16:18 +00:00
return false ;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not we are showing dimensions on the product page .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function enable_dimensions_display () {
2013-08-22 10:58:03 +00:00
return apply_filters ( 'wc_product_enable_dimensions_display' , true );
2012-01-10 15:36:14 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product has dimensions set .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function has_dimensions () {
2012-11-21 18:07:45 +00:00
return $this -> get_dimensions () ? true : false ;
2012-01-10 15:36:14 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns whether or not the product has weight set .
*
* @ access public
* @ return bool
*/
2013-07-23 10:28:59 +00:00
public function has_weight () {
2012-11-21 18:07:45 +00:00
return $this -> get_weight () ? true : false ;
2012-01-10 15:36:14 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns dimensions .
*
* @ access public
* @ return string
*/
2013-07-23 10:28:59 +00:00
public function get_dimensions () {
2012-11-29 16:48:40 +00:00
if ( ! $this -> dimensions ) {
$dimensions = array ();
2013-11-24 10:42:36 +00:00
if ( $this -> length ) {
2012-11-29 16:48:40 +00:00
$dimensions [] = $this -> length ;
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
2013-11-24 10:42:36 +00:00
if ( $this -> width ) {
2012-11-29 16:48:40 +00:00
$dimensions [] = $this -> width ;
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
2013-11-24 10:42:36 +00:00
if ( $this -> height ){
2012-11-29 16:48:40 +00:00
$dimensions [] = $this -> height ;
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
$this -> dimensions = implode ( ' x ' , $dimensions );
2013-11-24 10:42:36 +00:00
if ( ! empty ( $this -> dimensions ) ) {
2012-11-29 16:48:40 +00:00
$this -> dimensions .= ' ' . get_option ( 'woocommerce_dimension_unit' );
2013-11-24 10:42:36 +00:00
}
2012-11-29 16:48:40 +00:00
}
2012-01-10 15:36:14 +00:00
return $this -> dimensions ;
}
2012-08-15 17:08:42 +00:00
/**
* Lists a table of attributes for the product page .
*
* @ access public
* @ return void
*/
2013-07-23 10:28:59 +00:00
public function list_attributes () {
2013-11-25 12:45:04 +00:00
wc_get_template ( 'single-product/product-attributes.php' , array (
2012-11-29 16:48:40 +00:00
'product' => $this
2012-11-21 18:07:45 +00:00
) );
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2014-04-08 14:02:11 +00:00
/**
* 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 ;
}
2014-02-07 17:31:25 +00:00
/**
* 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 = '' ;
2012-08-06 23:33:52 +00:00
2012-06-29 16:51:15 +00:00
if ( has_post_thumbnail ( $this -> id ) ) {
2012-11-28 18:02:12 +00:00
$image = get_the_post_thumbnail ( $this -> id , $size , $attr );
2012-06-29 16:51:15 +00:00
} elseif ( ( $parent_id = wp_get_post_parent_id ( $this -> id ) ) && has_post_thumbnail ( $parent_id ) ) {
2012-11-28 18:02:12 +00:00
$image = get_the_post_thumbnail ( $parent_id , $size , $attr );
2012-06-29 16:51:15 +00:00
} else {
2013-11-25 13:56:59 +00:00
$image = wc_placeholder_img ( $size );
2012-06-29 16:51:15 +00:00
}
2012-08-06 23:33:52 +00:00
2012-06-29 17:56:42 +00:00
return $image ;
2014-02-07 17:31:25 +00:00
}
2013-03-27 07:57:26 +00:00
/**
2013-03-27 08:06:59 +00:00
* Get product name with SKU or ID . Used within admin .
2013-03-27 07:57:26 +00:00
*
* @ access public
* @ param mixed $product
2013-03-27 08:06:59 +00:00
* @ return string Formatted product name
2013-03-27 07:57:26 +00:00
*/
2013-07-23 10:28:59 +00:00
public function get_formatted_name () {
2013-03-27 07:57:26 +00:00
2013-11-24 10:42:36 +00:00
if ( $this -> get_sku () ) {
2013-03-27 07:57:26 +00:00
$identifier = $this -> get_sku ();
2013-11-24 10:42:36 +00:00
} else {
2013-03-27 07:57:26 +00:00
$identifier = '#' . $this -> id ;
2013-11-24 10:42:36 +00:00
}
2013-03-27 07:57:26 +00:00
return sprintf ( __ ( '%s – %s' , 'woocommerce' ), $identifier , $this -> get_title () );
}
2013-12-02 11:34:27 +00:00
}