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
2012-12-03 19:19:58 +00:00
* @ version 2.0 . 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
/**
2012-11-21 18:07:45 +00:00
* __construct function .
2012-11-27 16:22:47 +00:00
*
2012-11-21 18:07:45 +00:00
* @ access public
* @ param mixed $product
2011-08-09 15:16:18 +00:00
*/
2012-12-19 23:04:25 +00:00
public function __construct ( $product ) {
2013-02-12 12:15:44 +00:00
if ( ( function_exists ( 'get_called_class' ) && get_called_class () == 'WC_Product' ) || ( ! function_exists ( 'get_called_class' ) && is_null ( $this -> product_type ) ) ) {
_doing_it_wrong ( 'WC_Product' , __ ( 'The <code>WC_Product</code> class is now abstract. Use <code>get_product()</code> to instantiate an instance of a product instead of calling this class directly.' , 'woocommerce' ), '2.0 of WooCommerce' );
$product = get_product ( $product );
}
2012-11-21 18:07:45 +00:00
if ( is_object ( $product ) ) {
2012-12-19 23:04:25 +00:00
$this -> id = absint ( $product -> ID );
2012-11-21 18:07:45 +00:00
$this -> post = $product ;
} else {
2012-12-19 23:04:25 +00:00
$this -> id = absint ( $product );
2012-11-29 16:48:40 +00:00
$this -> post = get_post ( $this -> id );
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
2012-12-19 23:04:25 +00:00
if ( in_array ( $key , array ( 'downloadable' , 'virtual' , 'backorders' , 'manage_stock' , 'featured' , 'sold_individually' ) ) )
$value = ( $value = get_post_meta ( $this -> id , '_' . $key , true ) ) ? $value : 'no' ;
2012-12-20 11:54:38 +00:00
elseif ( in_array ( $key , array ( 'product_attributes' , 'crosssell_ids' , 'upsell_ids' ) ) )
$value = ( $value = get_post_meta ( $this -> id , '_' . $key , true ) ) ? $value : array ();
2012-12-19 23:04:25 +00:00
elseif ( 'visibility' == $key )
$value = ( $value = get_post_meta ( $this -> id , '_visibility' , true ) ) ? $value : 'hidden' ;
2012-12-20 11:54:38 +00:00
2012-12-19 23:04:25 +00:00
elseif ( 'stock' == $key )
$value = ( $value = get_post_meta ( $this -> id , '_stock' , true ) ) ? $value : 0 ;
2012-12-20 11:54:38 +00:00
2012-12-19 23:04:25 +00:00
elseif ( 'stock_status' == $key )
$value = ( $value = get_post_meta ( $this -> id , '_stock_status' , true ) ) ? $value : 'instock' ;
2012-12-20 11:54:38 +00:00
2012-12-19 23:04:25 +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
2012-12-20 11:54:38 +00:00
else
$value = get_post_meta ( $this -> id , '_' . $key , true );
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
*/
2012-12-20 10:53:34 +00:00
function get_gallery_attachment_ids () {
2012-12-20 01:13:06 +00:00
if ( ! isset ( $this -> product_image_gallery ) ) {
// Backwards compat
$attachment_ids = array_diff ( get_posts ( 'post_parent=' . $this -> id . '&numberposts=-1&post_type=attachment&orderby=menu_order&order=ASC&post_mime_type=image&fields=ids' ), array ( get_post_thumbnail_id () ) );
$this -> product_image_gallery = implode ( ',' , $attachment_ids );
}
2013-02-11 14:17:57 +00:00
return array_filter ( ( array ) explode ( ',' , $this -> product_image_gallery ) );
2012-12-20 01:13:06 +00:00
}
2011-08-22 14:10:22 +00:00
/**
2012-08-15 17:08:42 +00:00
* Get SKU ( Stock - keeping unit ) - product unique ID .
2012-08-06 23:33:52 +00:00
*
2012-08-15 17:08:42 +00:00
* @ return string
2011-08-22 14:10:22 +00:00
*/
function get_sku () {
return $this -> sku ;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
2011-11-13 02:15:00 +00:00
/**
2012-11-21 18:07:45 +00:00
* Returns number of items available for sale .
2012-08-06 23:33:52 +00:00
*
2012-11-21 18:07:45 +00:00
* @ access public
* @ return int
*/
function get_stock_quantity () {
2012-11-29 16:48:40 +00:00
return $this -> managing_stock () ? apply_filters ( 'woocommerce_stock_amount' , $this -> stock ) : '' ;
2012-11-21 18:07:45 +00:00
}
2012-11-27 16:22:47 +00:00
2012-11-21 18:07:45 +00:00
/**
* Get total stock .
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ return int
2011-11-13 02:15:00 +00:00
*/
function get_total_stock () {
2012-11-21 18:07:45 +00:00
return $this -> get_stock_quantity ();
2011-11-13 02:15:00 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
2012-12-28 09:59:20 +00:00
/**
* Set stock level of the product .
*
* @ access public
* @ param mixed $amount ( default : null )
* @ return int Stock
*/
function set_stock ( $amount = null ) {
global $woocommerce ;
if ( $this -> managing_stock () && ! is_null ( $amount ) ) {
$this -> stock = intval ( $amount );
update_post_meta ( $this -> id , '_stock' , $this -> stock );
// Out of stock attribute
if ( ! $this -> backorders_allowed () && $this -> get_total_stock () <= 0 )
$this -> set_stock_status ( 'outofstock' );
elseif ( $this -> backorders_allowed () || $this -> get_total_stock () > 0 )
$this -> set_stock_status ( 'instock' );
$woocommerce -> clear_product_transients ( $this -> id ); // Clear transient
return $this -> get_stock_quantity ();
}
}
2011-08-09 15:16:18 +00:00
/**
2012-08-15 17:08:42 +00:00
* Reduce stock level of the product .
2011-08-09 15:16:18 +00:00
*
2012-08-15 17:08:42 +00:00
* @ access public
* @ param int $by ( default : 1 ) Amount to reduce by .
* @ return int Stock
2011-08-09 15:16:18 +00:00
*/
function reduce_stock ( $by = 1 ) {
2011-11-21 11:33:46 +00:00
global $woocommerce ;
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
if ( $this -> managing_stock () ) {
2011-08-21 16:47:49 +00:00
$this -> stock = $this -> stock - $by ;
2012-11-21 18:07:45 +00:00
update_post_meta ( $this -> id , '_stock' , $this -> stock );
2012-08-06 23:33:52 +00:00
2011-08-18 23:14:35 +00:00
// Out of stock attribute
2012-12-28 09:59:20 +00:00
if ( ! $this -> backorders_allowed () && $this -> get_total_stock () <= 0 )
2012-11-28 15:40:08 +00:00
$this -> set_stock_status ( 'outofstock' );
2012-08-06 23:33:52 +00:00
2012-03-06 18:13:08 +00:00
$woocommerce -> clear_product_transients ( $this -> id ); // Clear transient
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
return $this -> get_stock_quantity ();
}
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +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
*
2012-08-15 17:08:42 +00:00
* @ access public
* @ param int $by ( default : 1 ) Amount to increase by
* @ return int Stock
2011-08-09 15:16:18 +00:00
*/
function increase_stock ( $by = 1 ) {
2012-02-16 19:15:52 +00:00
global $woocommerce ;
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
if ( $this -> managing_stock () ) {
2011-08-21 16:47:49 +00:00
$this -> stock = $this -> stock + $by ;
2012-11-21 18:07:45 +00:00
update_post_meta ( $this -> id , '_stock' , $this -> stock );
2012-08-06 23:33:52 +00:00
2011-08-18 23:14:35 +00:00
// Out of stock attribute
2012-12-28 09:59:20 +00:00
if ( $this -> backorders_allowed () || $this -> get_total_stock () > 0 )
2012-11-28 15:40:08 +00:00
$this -> set_stock_status ( 'instock' );
2012-08-06 23:33:52 +00:00
2012-03-06 18:13:08 +00:00
$woocommerce -> clear_product_transients ( $this -> id ); // Clear transient
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
return $this -> get_stock_quantity ();
}
2011-08-09 15:16:18 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
2012-11-28 15:40:08 +00:00
/**
* set_stock_status function .
*
* @ access public
* @ return void
*/
function set_stock_status ( $status ) {
$status = 'outofstock' ? 'outofstock' : 'instock' ;
if ( $this -> stock_status != $status ) {
update_post_meta ( $this -> id , '_stock_status' , $status );
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
*/
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
2012-08-15 17:08:42 +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
*/
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-08-15 17:08:42 +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
*/
2012-08-28 15:21:54 +00:00
function has_file ( $download_id = '' ) {
2012-11-29 16:48:40 +00:00
return ( $this -> is_downloadable () && $this -> get_file_download_path ( $download_id ) ) ? true : false ;
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
* @ access public
* @ param string $download_id file identifier
* @ return array
*/
function get_file_download_path ( $download_id ) {
2012-11-27 16:22:47 +00:00
2012-12-19 23:04:25 +00:00
$file_paths = isset ( $this -> file_paths ) ? $this -> file_paths : '' ;
2012-12-06 15:39:59 +00:00
$file_paths = maybe_unserialize ( $file_paths );
2012-11-21 18:07:45 +00:00
$file_paths = apply_filters ( 'woocommerce_file_download_paths' , $file_paths , $this -> id , null , null );
2012-08-28 15:21:54 +00:00
if ( ! $download_id && count ( $file_paths ) == 1 ) {
// backwards compatibility for old-style download URLs and template files
$file_path = array_shift ( $file_paths );
} elseif ( isset ( $file_paths [ $download_id ] ) ) {
$file_path = $file_paths [ $download_id ];
2012-11-21 18:07:45 +00:00
} else {
$file_path = '' ;
2012-08-28 15:21:54 +00:00
}
// allow overriding based on the particular file being requested
return apply_filters ( 'woocommerce_file_download_path' , $file_path , $this -> id , $download_id );
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +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
*/
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
2012-08-15 17:08:42 +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
*/
function needs_shipping () {
2012-11-21 18:07:45 +00:00
return $this -> is_virtual () ? false : true ;
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
*/
function is_sold_individually () {
$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
* @ return bool
*/
function get_children () {
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
*/
2011-09-21 15:13:53 +00:00
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
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-09 15:16:18 +00:00
function is_taxable () {
2012-11-29 16:48:40 +00:00
return $this -> tax_status == 'taxable' && get_option ( 'woocommerce_calc_taxes' ) == '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 shipping is taxable .
*
* @ access public
* @ return bool
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-30 11:24:28 +00:00
function get_title () {
2012-10-12 18:48:49 +00:00
return apply_filters ( 'woocommerce_product_title' , apply_filters ( 'the_title' , $this -> post -> post_title , $this -> id ), $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
*/
2012-03-12 13:11:08 +00:00
function get_parent () {
return apply_filters ( 'woocommerce_product_parent' , $this -> post -> post_parent , $this );
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Get the add to url .
*
* @ access public
* @ return string
*/
2011-08-09 15:16:18 +00:00
function add_to_cart_url () {
2012-09-21 20:11:57 +00:00
return apply_filters ( 'woocommerce_add_to_cart_url' , add_query_arg ( 'add-to-cart' , $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 stock managed .
*
* @ access public
* @ return bool
*/
2011-08-09 15:16:18 +00:00
function managing_stock () {
2012-11-29 16:48:40 +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
*/
2011-08-09 15:16:18 +00:00
function is_in_stock () {
2012-11-29 16:48:40 +00:00
if ( $this -> managing_stock () ) {
if ( $this -> backorders_allowed () ) {
return true ;
} else {
if ( $this -> get_total_stock () < 1 ) {
2011-08-09 15:16:18 +00:00
return false ;
2012-11-29 16:48:40 +00:00
} else {
if ( $this -> stock_status == 'instock' )
return true ;
else
return false ;
}
}
} else {
if ( $this -> stock_status == 'instock' )
2012-07-17 18:11:14 +00:00
return true ;
2012-11-29 16:48:40 +00:00
else
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 can be backordered .
*
* @ access public
* @ return bool
*/
2011-08-09 15:16:18 +00:00
function backorders_allowed () {
2012-11-29 16:48:40 +00:00
return $this -> backorders == 'yes' || $this -> backorders == 'notify' ? 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 needs to notify the customer on backorder .
*
* @ access public
* @ return bool
*/
2011-08-09 15:16:18 +00:00
function backorders_require_notification () {
2012-11-29 16:48:40 +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-08-15 17:08:42 +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
*/
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
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-09 15:16:18 +00:00
function get_availability () {
2012-08-06 23:33:52 +00:00
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 () ) {
if ( $this -> get_total_stock () > 0 ) {
2012-08-06 23:33:52 +00:00
2012-04-24 18:15:56 +00:00
$format_option = get_option ( 'woocommerce_stock_format' );
2012-08-06 23:33:52 +00:00
2012-04-24 18:15:56 +00:00
switch ( $format_option ) {
case 'no_amount' :
2012-10-16 09:45:33 +00:00
$format = __ ( 'In stock' , 'woocommerce' );
2012-04-24 18:15:56 +00:00
break ;
case 'low_amount' :
$low_amount = get_option ( 'woocommerce_notify_low_stock_amount' );
2012-08-06 23:33:52 +00:00
2012-10-16 09:45:33 +00:00
$format = ( $this -> get_total_stock () <= $low_amount ) ? __ ( 'Only %s left in stock' , 'woocommerce' ) : __ ( 'In stock' , 'woocommerce' );
2012-04-24 18:15:56 +00:00
break ;
default :
2012-10-16 09:45:33 +00:00
$format = __ ( '%s in stock' , 'woocommerce' );
2012-04-24 18:15:56 +00:00
break ;
}
2012-08-06 23:33:52 +00:00
2012-04-24 18:15:56 +00:00
$availability = sprintf ( $format , $this -> stock );
2012-08-06 23:33:52 +00:00
2012-11-29 16:48:40 +00:00
if ( $this -> backorders_allowed () && $this -> backorders_require_notification () )
2012-10-16 09:45:33 +00:00
$availability .= ' ' . __ ( '(backorders allowed)' , 'woocommerce' );
2012-08-06 23:33:52 +00:00
2012-11-29 16:48:40 +00:00
} else {
2012-08-06 23:33:52 +00:00
2012-11-29 16:48:40 +00:00
if ( $this -> backorders_allowed () ) {
if ( $this -> backorders_require_notification () ) {
2012-10-16 09:45:33 +00:00
$availability = __ ( 'Available on backorder' , 'woocommerce' );
2012-11-29 16:48:40 +00:00
$class = 'available-on-backorder' ;
} else {
2012-10-16 09:45:33 +00:00
$availability = __ ( 'In stock' , 'woocommerce' );
2012-11-29 16:48:40 +00:00
}
} else {
2012-10-16 09:45:33 +00:00
$availability = __ ( 'Out of stock' , 'woocommerce' );
2012-11-29 16:48:40 +00:00
$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' ;
}
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
*/
2011-08-09 15:16:18 +00:00
function is_featured () {
2012-11-21 18:07:45 +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
*/
2012-01-12 00:54:45 +00:00
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
2012-11-21 18:07:45 +00:00
if ( get_option ( 'woocommerce_hide_out_of_stock_items' ) == 'yes' && ! $this -> is_in_stock () ) $visible = false ;
2012-08-06 23:33:52 +00:00
2011-08-18 23:14:35 +00:00
// visibility setting
2012-11-21 18:07:45 +00:00
elseif ( $this -> visibility == 'hidden' ) $visible = false ;
elseif ( $this -> visibility == 'visible' ) $visible = true ;
2012-08-06 23:33:52 +00:00
2011-11-24 15:32:57 +00:00
// Visibility in loop
2012-11-21 18:07:45 +00:00
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 ;
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
*/
2011-08-09 15:16:18 +00:00
function is_on_sale () {
2012-11-21 18:07:45 +00:00
return $this -> sale_price && $this -> sale_price == $this -> price ? 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 product ' s weight .
*
* @ access public
* @ return string
*/
2011-08-09 15:16:18 +00:00
function get_weight () {
2012-11-21 18:07:45 +00:00
if ( $this -> weight ) return $this -> weight ;
2011-08-09 15:16:18 +00:00
}
2012-07-16 16:23:17 +00:00
2012-08-15 17:08:42 +00:00
/**
* Set a products price dynamically .
*
* @ access public
* @ param float $price Price to set .
* @ return void
*/
2012-07-16 16:23:17 +00:00
function set_price ( $price ) {
$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
*/
2011-11-06 13:45:18 +00:00
function adjust_price ( $price ) {
2012-11-29 16:48:40 +00:00
if ( $price > 0 )
2011-11-06 13:45:18 +00:00
$this -> price += $price ;
2012-11-29 16:48:40 +00:00
else
$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
/**
* Returns the product ' s price .
*
* @ access public
* @ return string
*/
2011-08-09 15:16:18 +00:00
function get_price () {
2012-04-21 16:38:34 +00:00
return apply_filters ( 'woocommerce_get_price' , $this -> 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
2012-08-06 23:33:52 +00:00
/**
2012-08-15 17:08:42 +00:00
* Returns false if the product cannot be bought .
2012-08-06 23:33:52 +00:00
*
* @ access public
2012-08-15 17:08:42 +00:00
* @ return cool
2012-08-06 23:33:52 +00:00
*/
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 ;
2012-08-07 00:27:24 +00:00
return apply_filters ( 'woocommerce_is_purchasable' , $purchasable , $this );
2012-08-06 23:33:52 +00:00
}
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
* @ return string
*/
function get_price_including_tax ( $qty = 1 ) {
global $woocommerce ;
$_tax = new WC_Tax ();
$price = $this -> get_price ();
if ( $this -> is_taxable () ) {
if ( get_option ( 'woocommerce_prices_include_tax' ) == 'no' ) {
$tax_rates = $_tax -> get_rates ( $this -> get_tax_class () );
$taxes = $_tax -> calc_tax ( $price * $qty , $tax_rates , false );
$tax_amount = $_tax -> get_tax_total ( $taxes );
$price = round ( $price * $qty + $tax_amount , 2 );
} else {
$tax_rates = $_tax -> get_rates ( $this -> get_tax_class () );
$base_tax_rates = $_tax -> get_shop_base_rate ( $this -> tax_class );
if ( $woocommerce -> customer -> is_vat_exempt () ) {
$base_taxes = $_tax -> calc_tax ( $price * $qty , $base_tax_rates , true );
$base_tax_amount = array_sum ( $base_taxes );
$price = round ( $price * $qty - $base_tax_amount , 2 );
} elseif ( $tax_rates !== $base_tax_rates ) {
$base_taxes = $_tax -> calc_tax ( $price * $qty , $base_tax_rates , true , true );
$modded_taxes = $_tax -> calc_tax ( $price * $qty - array_sum ( $base_taxes ), $tax_rates , false );
$price = round ( $price * $qty - array_sum ( $base_taxes ) + array_sum ( $modded_taxes ), 2 );
} 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
* @ return string
*/
2012-12-03 16:36:54 +00:00
function get_price_excluding_tax ( $qty = 1 ) {
2012-08-06 23:33:52 +00:00
2012-04-21 16:38:34 +00:00
$price = $this -> get_price ();
2011-08-09 15:16:18 +00:00
2012-11-29 16:48:40 +00:00
if ( $this -> is_taxable () && get_option ( 'woocommerce_prices_include_tax' ) == 'yes' ) {
2012-08-06 23:33:52 +00:00
2012-11-29 16:48:40 +00:00
$_tax = new WC_Tax ();
$tax_rates = $_tax -> get_shop_base_rate ( $this -> tax_class );
2012-12-03 16:36:54 +00:00
$taxes = $_tax -> calc_tax ( $price * $qty , $tax_rates , true );
2012-11-29 16:48:40 +00:00
$tax_amount = $_tax -> get_tax_total ( $taxes );
2012-12-03 16:36:54 +00:00
$price = round ( $price * $qty - $tax_amount , 2 );
} 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
2012-08-15 17:08:42 +00:00
/**
* Returns the tax class .
*
* @ access public
* @ return string
*/
2011-10-07 22:24:11 +00:00
function get_tax_class () {
2012-11-21 18:07:45 +00:00
return apply_filters ( 'woocommerce_product_tax_class' , $this -> tax_class , $this );
2011-10-07 22:24:11 +00:00
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the tax status .
*
* @ access public
* @ return string
*/
2011-12-31 19:03:41 +00:00
function get_tax_status () {
return $this -> tax_status ;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns the price in html format .
*
* @ access public
* @ param string $price ( default : '' )
* @ return string
*/
2012-02-26 14:11:56 +00:00
function get_price_html ( $price = '' ) {
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
if ( $this -> price > 0 ) {
2012-11-29 16:48:40 +00:00
2012-11-21 18:07:45 +00:00
if ( $this -> is_on_sale () && isset ( $this -> regular_price ) ) {
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
$price .= $this -> get_price_html_from_to ( $this -> regular_price , $this -> get_price () );
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
2012-11-21 18:07:45 +00:00
$price .= woocommerce_price ( $this -> get_price () );
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-11-29 16:48:40 +00:00
} elseif ( $this -> price === '' ) {
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
$price = apply_filters ( 'woocommerce_empty_price_html' , '' , $this );
2012-02-25 08:03:00 +00:00
2012-11-29 16:48:40 +00:00
} elseif ( $this -> price == 0 ) {
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
if ( $this -> is_on_sale () && isset ( $this -> regular_price ) ) {
2012-08-06 23:33:52 +00:00
2012-11-21 18:07:45 +00:00
$price .= $this -> get_price_html_from_to ( $this -> 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 .
*
* @ access public
* @ return string
*/
2012-02-26 14:11:56 +00:00
function get_price_html_from_text () {
return '<span class="from">' . _x ( 'From:' , 'min_price' , 'woocommerce' ) . ' </span>' ;
}
2012-08-15 17:08:42 +00:00
/**
* Functions for getting parts of a price , in html , used by get_price_html .
*
* @ access public
* @ return string
*/
2012-02-26 14:11:56 +00:00
function get_price_html_from_to ( $from , $to ) {
2012-11-29 16:48:40 +00:00
return '<del>' . ( ( is_numeric ( $from ) ) ? woocommerce_price ( $from ) : $from ) . '</del> <ins>' . ( ( is_numeric ( $to ) ) ? woocommerce_price ( $to ) : $to ) . '</ins>' ;
2012-02-26 14:11:56 +00:00
}
2012-08-06 23:33:52 +00:00
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
* @ return void
*/
2013-01-12 10:53:24 +00:00
function get_average_rating () {
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'
" , $this->id ) );
$average_rating = number_format ( $ratings / $count , 2 );
}
set_transient ( 'wc_average_rating_' . $this -> id , $average_rating );
}
return $average_rating ;
}
/**
* get_rating_count function .
*
* @ access public
* @ return void
*/
function get_rating_count () {
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
2013-01-12 10:53:24 +00:00
set_transient ( 'wc_rating_count_' . $this -> id , $count );
}
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
/**
* Returns the product rating in html format - ratings are stored in transient cache .
*
* @ access public
* @ param string $location ( default : '' )
* @ return void
*/
function get_rating_html ( $location = '' ) {
2012-08-06 23:33:52 +00:00
2013-01-12 10:53:24 +00:00
$average_rating = $this -> get_average_rating ();
if ( $average_rating > 0 ) {
if ( $location )
$location = '_' . $location ;
$average_rating = $this -> get_average_rating ();
$rating_html = '<div class="star-rating" title="' . sprintf ( __ ( 'Rated %s out of 5' , 'woocommerce' ), $average_rating ) . '">' ;
2013-01-14 10:51:06 +00:00
$rating_html .= '<span style="width:' . ( ( $average_rating / 5 ) * 100 ) . '%"><strong class="rating">' . $average_rating . '</strong> ' . __ ( 'out of 5' , 'woocommerce' ) . '</span>' ;
2013-01-12 10:53:24 +00:00
$rating_html .= '</div>' ;
return $rating_html ;
}
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
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-09 15:16:18 +00:00
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 : '' )
* @ return array
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-12-02 20:48:07 +00:00
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' );
2012-11-27 16:22:47 +00:00
if ( $classes && ! is_wp_error ( $classes ) )
$this -> shipping_class = current ( $classes ) -> slug ;
else
2012-11-21 18:07:45 +00:00
$this -> shipping_class = '' ;
}
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
*/
2012-05-31 10:05:00 +00:00
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' );
2012-08-06 23:33:52 +00:00
if ( $classes && ! is_wp_error ( $classes ) )
$this -> shipping_class_id = current ( $classes ) -> term_id ;
else
2012-06-03 12:12:08 +00:00
$this -> shipping_class_id = 0 ;
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
*/
2011-08-09 15:16:18 +00:00
function get_related ( $limit = 5 ) {
2011-11-13 12:17:52 +00:00
global $woocommerce ;
2012-08-06 23:33:52 +00:00
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
$terms = wp_get_post_terms ( $this -> id , 'product_tag' );
2012-11-29 16:48:40 +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
2011-08-09 15:16:18 +00:00
$terms = wp_get_post_terms ( $this -> id , 'product_cat' );
2012-11-29 16:48:40 +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
if ( sizeof ( $cats_array ) == 1 && sizeof ( $tags_array ) == 1 ) return array ();
2012-08-06 23:33:52 +00:00
2011-11-13 12:17:52 +00:00
// Meta query
$meta_query = array ();
$meta_query [] = $woocommerce -> query -> visibility_meta_query ();
$meta_query [] = $woocommerce -> query -> stock_status_meta_query ();
2012-08-06 23:33:52 +00:00
2011-11-13 12:17:52 +00:00
// Get the posts
2012-10-12 17:44:23 +00:00
$related_posts = get_posts ( apply_filters ( 'woocommerce_product_related_posts' , array (
2012-11-29 16:48:40 +00:00
'orderby' => 'rand' ,
'posts_per_page' => $limit ,
'post_type' => 'product' ,
'fields' => 'ids' ,
'meta_query' => $meta_query ,
'tax_query' => array (
'relation' => 'OR' ,
2011-11-13 12:17:52 +00:00
array (
2012-11-29 16:48:40 +00:00
'taxonomy' => 'product_cat' ,
'field' => 'id' ,
'terms' => $cats_array
2011-11-13 12:17:52 +00:00
),
array (
2012-11-29 16:48:40 +00:00
'taxonomy' => 'product_tag' ,
'field' => 'id' ,
'terms' => $tags_array
2011-08-09 15:16:18 +00:00
)
2011-11-13 12:17:52 +00:00
)
2012-10-12 17:44:23 +00:00
) ) );
2012-08-06 23:33:52 +00:00
2012-10-12 17:44:23 +00:00
$related_posts = array_diff ( $related_posts , array ( $this -> id ), $this -> get_upsells () );
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
* @ return mixed
*/
2011-11-26 20:23:57 +00:00
function get_attribute ( $attr ) {
$attributes = $this -> get_attributes ();
2012-08-06 23:33:52 +00:00
2012-01-10 17:14:40 +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
2012-06-10 17:15:02 +00:00
return implode ( ', ' , woocommerce_get_product_terms ( $this -> id , $attribute [ 'name' ], '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
}
2012-01-10 17:14:40 +00:00
return false ;
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
*/
2011-08-09 15:16:18 +00:00
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
*/
2011-08-09 15:16:18 +00:00
function has_attributes () {
2012-11-21 18:07:45 +00:00
if ( sizeof ( $this -> get_attributes () ) > 0 ) {
foreach ( $this -> get_attributes () as $attribute ) {
2012-11-27 16:22:47 +00:00
if ( isset ( $attribute [ 'is_visible' ] ) && $attribute [ 'is_visible' ] )
2012-11-21 18:07:45 +00:00
return true ;
}
}
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
*/
2012-01-10 15:36:14 +00:00
function enable_dimensions_display () {
2012-11-21 18:07:45 +00:00
return get_option ( 'woocommerce_enable_dimension_product_attributes' ) == 'yes' ? 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 dimensions set .
*
* @ access public
* @ return bool
*/
2012-01-10 15:36:14 +00:00
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
*/
2012-01-10 15:36:14 +00:00
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
*/
2012-01-10 15:36:14 +00:00
function get_dimensions () {
2012-11-29 16:48:40 +00:00
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' );
}
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
*/
2012-01-10 15:36:14 +00:00
function list_attributes () {
2012-11-21 18:07:45 +00:00
woocommerce_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
2012-08-15 17:08:42 +00:00
2011-11-09 15:39:14 +00:00
/**
2012-06-29 17:56:42 +00:00
* Returns the main product image
2012-08-15 17:08:42 +00:00
*
* @ access public
* @ param string $size ( default : 'shop_thumbnail' )
* @ return string
2012-08-06 23:33:52 +00:00
*/
2012-11-28 18:02:12 +00:00
function get_image ( $size = 'shop_thumbnail' , $attr = array () ) {
2011-11-09 15:39:14 +00:00
global $woocommerce ;
2012-08-06 23:33:52 +00:00
2012-06-29 17:56:42 +00:00
$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 {
2012-11-27 15:37:01 +00:00
$image = woocommerce_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 ;
2011-11-09 15:39:14 +00:00
}
2011-08-09 15:16:18 +00:00
}