Improve phpdoc comments and add missing param tags

This commit is contained in:
Fredrik Forsmo 2016-01-04 12:43:56 +01:00
parent 520f1de24b
commit 450ae6e7fd
1 changed files with 8 additions and 5 deletions

View File

@ -178,7 +178,7 @@ class WC_Product {
} }
/** /**
* get_gallery_attachment_ids function. * Returns the gallery attachment ids.
* *
* @return array * @return array
*/ */
@ -319,7 +319,7 @@ class WC_Product {
} }
/** /**
* set_stock_status function. * Set stock status of the product.
* *
* @param string $status * @param string $status
*/ */
@ -493,17 +493,17 @@ class WC_Product {
} }
/** /**
* get_child function. * Returns the child product.
* *
* @param mixed $child_id * @param mixed $child_id
* @return WC_Product WC_Product or WC_Product_variation * @return WC_Product|WC_Product|WC_Product_variation
*/ */
public function get_child( $child_id ) { public function get_child( $child_id ) {
return wc_get_product( $child_id ); return wc_get_product( $child_id );
} }
/** /**
* get_children function. * Returns the children.
* *
* @return array * @return array
*/ */
@ -845,6 +845,7 @@ class WC_Product {
/** /**
* Returns the price (including tax). Uses customer tax rates. Can work for a specific $qty for more accurate taxes. * Returns the price (including tax). Uses customer tax rates. Can work for a specific $qty for more accurate taxes.
* *
* @param int $qty
* @param string $price to calculate, left blank to just use get_price() * @param string $price to calculate, left blank to just use get_price()
* @return string * @return string
*/ */
@ -904,6 +905,7 @@ class WC_Product {
* Returns the price (excluding tax) - ignores tax_class filters since the price may *include* tax and thus needs subtracting. * Returns the price (excluding tax) - ignores tax_class filters since the price may *include* tax and thus needs subtracting.
* Uses store base tax rates. Can work for a specific $qty for more accurate taxes. * Uses store base tax rates. Can work for a specific $qty for more accurate taxes.
* *
* @param int $qty
* @param string $price to calculate, left blank to just use get_price() * @param string $price to calculate, left blank to just use get_price()
* @return string * @return string
*/ */
@ -1505,6 +1507,7 @@ class WC_Product {
* Returns the main product image. * Returns the main product image.
* *
* @param string $size (default: 'shop_thumbnail') * @param string $size (default: 'shop_thumbnail')
* @param array $attr
* @return string * @return string
*/ */
public function get_image( $size = 'shop_thumbnail', $attr = array() ) { public function get_image( $size = 'shop_thumbnail', $attr = array() ) {