woocommerce/classes/abstracts/abstract-wc-product.php

1225 lines
29 KiB
PHP
Raw Normal View History

2011-08-09 15:16:18 +00:00
<?php
/**
* 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
2012-08-15 17:08:42 +00:00
* @package WooCommerce/Classes
* @author WooThemes
2011-08-09 15:16:18 +00:00
*/
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
abstract 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). */
2012-12-20 11:54:38 +00:00
public $product_type;
2011-08-09 15:16:18 +00:00
/**
* __construct function.
2012-11-27 16:22:47 +00:00
*
* @access public
* @param mixed $product
2011-08-09 15:16:18 +00:00
*/
public function __construct( $product ) {
if ( is_object( $product ) ) {
$this->id = absint( $product->ID );
$this->post = $product;
} else {
$this->id = absint( $product );
$this->post = get_post( $this->id );
}
2011-08-09 15:16:18 +00:00
}
2012-11-27 16:22:47 +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
/**
* __get function.
2012-11-27 16:22:47 +00:00
*
* @access public
* @param mixed $key
* @return mixed
*/
public function __get( $key ) {
2012-12-20 11:54:38 +00:00
// Get values or default if not set
if ( in_array( $key, array( 'downloadable', 'virtual', 'backorders', 'manage_stock', 'featured', 'sold_individually' ) ) )
$value = ( $value = get_post_meta( $this->id, '_' . $key, true ) ) ? $value : 'no';
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();
elseif ( 'visibility' == $key )
$value = ( $value = get_post_meta( $this->id, '_visibility', true ) ) ? $value : 'hidden';
2012-12-20 11:54:38 +00:00
elseif ( 'stock' == $key )
$value = ( $value = get_post_meta( $this->id, '_stock', true ) ) ? $value : 0;
2012-12-20 11:54:38 +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
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-12-20 11:54:38 +00:00
else
$value = get_post_meta( $this->id, '_' . $key, true );
return $value;
}
2012-11-27 16:22:47 +00:00
/**
* get_gallery_attachment_ids function.
*
* @access public
* @return array
*/
function get_gallery_attachment_ids() {
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 );
}
return (array) explode( ',', $this->product_image_gallery );
}
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
/**
* Returns number of items available for sale.
2012-08-06 23:33:52 +00:00
*
* @access public
* @return int
*/
function get_stock_quantity() {
return $this->managing_stock() ? apply_filters( 'woocommerce_stock_amount', $this->stock ) : '';
}
2012-11-27 16:22:47 +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() {
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
/**
* 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 ) {
global $woocommerce;
2012-08-06 23:33:52 +00:00
if ( $this->managing_stock() ) {
2011-08-21 16:47:49 +00:00
$this->stock = $this->stock - $by;
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
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
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
if ( $this->managing_stock() ) {
2011-08-21 16:47:49 +00:00
$this->stock = $this->stock + $by;
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
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
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.
*
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 ) {
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
/**
* Checks if a product is downloadable
2012-08-15 17:08:42 +00:00
*
* @access public
* @return bool
*/
function is_downloadable() {
return $this->downloadable == 'yes' ? true : false;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
2012-07-31 11:58:00 +00:00
/**
* Check if downloadable product has a file attached.
*
* @since 1.6.2
*
* @access public
* @param string $download_id file identifier
* @return bool Whether downloadable product has a file attached.
2012-07-31 11:58:00 +00:00
*/
function has_file( $download_id = '' ) {
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
/**
* Get file download path identified by $download_id
2012-11-27 16:22:47 +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
$file_paths = isset( $this->file_paths ) ? $this->file_paths : '';
$file_paths = maybe_unserialize( $file_paths );
$file_paths = apply_filters( 'woocommerce_file_download_paths', $file_paths, $this->id, null, null );
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 ];
} else {
$file_path = '';
}
// 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
/**
2012-08-15 17:08:42 +00:00
* Checks if a product is virtual (has no shipping).
*
* @access public
* @return bool
*/
function is_virtual() {
return $this->virtual == 'yes' ? true : false;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
2012-08-15 17:08:42 +00:00
* Checks if a product needs shipping.
*
* @access public
* @return bool
*/
function needs_shipping() {
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
// Sold individually if downloadable, virtual, and the option is enabled OR if intentionally a singular item
if ( 'yes' == $this->sold_individually || ( $this->is_downloadable() && $this->is_virtual() && get_option('woocommerce_limit_downloadable_product_qty') == 'yes' ) || ( ! $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 );
}
2012-08-06 23:33:52 +00:00
/**
* get_children function.
2012-11-27 16:22:47 +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() {
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() {
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() {
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() {
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
*/
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() {
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() {
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() {
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;
} 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;
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() {
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() {
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 ) {
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 ) {
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
$availability = $class = "";
2012-08-06 23:33:52 +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
$format_option = get_option( 'woocommerce_stock_format' );
2012-08-06 23:33:52 +00:00
switch ( $format_option ) {
case 'no_amount' :
2012-10-16 09:45:33 +00:00
$format = __( 'In stock', 'woocommerce' );
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' );
break;
default :
2012-10-16 09:45:33 +00:00
$format = __( '%s in stock', 'woocommerce' );
break;
}
2012-08-06 23:33:52 +00:00
$availability = sprintf( $format, $this->stock );
2012-08-06 23:33:52 +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
} else {
2012-08-06 23:33:52 +00:00
if ( $this->backorders_allowed() ) {
if ( $this->backorders_require_notification() ) {
2012-10-16 09:45:33 +00:00
$availability = __( 'Available on backorder', 'woocommerce' );
$class = 'available-on-backorder';
} else {
2012-10-16 09:45:33 +00:00
$availability = __( 'In stock', 'woocommerce' );
}
} else {
2012-10-16 09:45:33 +00:00
$availability = __( 'Out of stock', 'woocommerce' );
$class = 'out-of-stock';
}
}
} elseif ( $this->backorders_allowed() ) {
$availability = __( 'Available on backorder', 'woocommerce' );
$class = 'available-on-backorder';
} else {
$availability = __( 'Out of stock', 'woocommerce' );
$class = 'out-of-stock';
}
} elseif ( ! $this->is_in_stock() ) {
$availability = __( 'Out of stock', 'woocommerce' );
$class = 'out-of-stock';
}
2012-08-06 23:33:52 +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() {
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
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
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
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
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() {
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() {
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
* @param mixed $price
2012-08-15 17:08:42 +00:00
* @return void
*/
function adjust_price( $price ) {
if ( $price > 0 )
$this->price += $price;
else
$this->price = $this->price - $price;
}
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;
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
if ( $this->is_taxable() && get_option('woocommerce_prices_include_tax') == 'yes' ) {
2012-08-06 23:33:52 +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 );
$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-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() {
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
*/
function get_price_html( $price = '' ) {
2012-08-06 23:33:52 +00:00
if ( $this->price > 0 ) {
if ( $this->is_on_sale() && isset( $this->regular_price ) ) {
2012-08-06 23:33:52 +00:00
$price .= $this->get_price_html_from_to( $this->regular_price, $this->get_price() );
2012-08-06 23:33:52 +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
$price .= woocommerce_price( $this->get_price() );
$price = apply_filters( 'woocommerce_price_html', $price, $this );
2012-08-06 23:33:52 +00:00
2012-10-08 11:51:00 +00:00
}
} elseif ( $this->price === '' ) {
2012-08-06 23:33:52 +00:00
$price = apply_filters( 'woocommerce_empty_price_html', '', $this );
} elseif ( $this->price == 0 ) {
2012-08-06 23:33:52 +00:00
if ( $this->is_on_sale() && isset( $this->regular_price ) ) {
2012-08-06 23:33:52 +00:00
$price .= $this->get_price_html_from_to( $this->regular_price, __( 'Free!', 'woocommerce' ) );
$price = apply_filters( 'woocommerce_free_sale_price_html', $price, $this );
} else {
$price = __( 'Free!', 'woocommerce' );
$price = apply_filters( 'woocommerce_free_price_html', $price, $this );
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
*/
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
*/
function get_price_html_from_to( $from, $to ) {
return '<del>' . ( ( is_numeric( $from ) ) ? woocommerce_price( $from ) : $from ) . '</del> <ins>' . ( ( is_numeric( $to ) ) ? woocommerce_price( $to ) : $to ) . '</ins>';
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +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
2012-11-27 16:22:47 +00:00
if ( $location )
$location = '_' . $location;
2012-11-27 16:22:47 +00:00
$star_size = apply_filters( 'woocommerce_star_rating_size' . $location, 16 );
if ( false === ( $average_rating = get_transient( 'wc_average_rating_' . $this->id ) ) ) {
2012-08-06 23:33:52 +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
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
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
2012-10-18 13:37:04 +00:00
$ratings = $wpdb->get_var( $wpdb->prepare("
2012-08-06 23:33:52 +00:00
SELECT SUM(meta_value) FROM $wpdb->commentmeta
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
AND comment_approved = '1'
2012-12-12 10:27:58 +00:00
", $this->id ) );
2012-08-06 23:33:52 +00:00
if ( $count > 0 )
$average_rating = number_format($ratings / $count, 2);
else
$average_rating = '';
2012-08-06 23:33:52 +00:00
2012-03-16 16:39:16 +00:00
set_transient( 'wc_average_rating_' . $this->id, $average_rating );
}
2012-08-06 23:33:52 +00:00
if ( $average_rating > 0 )
return '<div class="star-rating" title="' . sprintf( __( 'Rated %s out of 5', 'woocommerce' ), $average_rating ) . '"><span style="width:' . ( $average_rating * $star_size ) . 'px"><span class="rating">' . $average_rating . '</span> ' . __( 'out of 5', 'woocommerce' ) . '</span></div>';
else
2011-08-28 12:04:05 +00:00
return '';
}
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
/**
* Returns the crosssell product ids.
*
* @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
* @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_tags( $sep = ', ', $before = '', $after = '' ) {
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() {
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
$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() {
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;
}
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');
foreach ( $terms as $term ) $tags_array[] = $term->term_id;
2012-08-06 23:33:52 +00:00
// Get categories
2011-08-09 15:16:18 +00:00
$terms = wp_get_post_terms($this->id, 'product_cat');
foreach ( $terms as $term ) $cats_array[] = $term->term_id;
2012-08-06 23:33:52 +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
$related_posts = get_posts( apply_filters('woocommerce_product_related_posts', array(
'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(
'taxonomy' => 'product_cat',
'field' => 'id',
'terms' => $cats_array
2011-11-13 12:17:52 +00:00
),
array(
'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-08-06 23:33:52 +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
if ( isset( $attributes[ $attr ] ) || isset( $attributes[ 'pa_' . $attr ] ) ) {
2012-08-06 23:33:52 +00:00
$attribute = isset( $attributes[ $attr ] ) ? $attributes[ $attr ] : $attributes[ 'pa_' . $attr ];
2012-08-06 23:33:52 +00:00
if ( $attribute['is_taxonomy'] ) {
2012-08-06 23:33:52 +00:00
return implode( ', ', woocommerce_get_product_terms( $this->id, $attribute['name'], 'names' ) );
2012-08-06 23:33:52 +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-08-06 23:33:52 +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() {
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'] )
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
*/
function enable_dimensions_display() {
return get_option( 'woocommerce_enable_dimension_product_attributes' ) == 'yes' ? true : false;
}
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
*/
function has_dimensions() {
return $this->get_dimensions() ? true : false;
}
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
*/
function has_weight() {
return $this->get_weight() ? true : false;
}
2012-08-06 23:33:52 +00:00
2012-08-15 17:08:42 +00:00
/**
* Returns dimensions.
*
* @access public
* @return string
*/
function get_dimensions() {
if ( ! $this->dimensions ) {
$dimensions = array();
if ( $this->length )
$dimensions[] = $this->length;
if ( $this->width )
$dimensions[] = $this->width;
if ( $this->height )
$dimensions[] = $this->height;
$this->dimensions = implode( ' x ', $dimensions );
if ( ! empty( $this->dimensions ) )
$this->dimensions .= ' ' . get_option( 'woocommerce_dimension_unit' );
}
return $this->dimensions;
}
2012-08-15 17:08:42 +00:00
/**
* Lists a table of attributes for the product page.
*
* @access public
* @return void
*/
function list_attributes() {
woocommerce_get_template( 'single-product/product-attributes.php', array(
'product' => $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 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() ) {
global $woocommerce;
2012-08-06 23:33:52 +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 {
$image = woocommerce_placeholder_img( $size );
2012-06-29 16:51:15 +00:00
}
2012-08-06 23:33:52 +00:00
return $image;
}
2011-08-09 15:16:18 +00:00
}