2013-09-12 13:41:02 +00:00
< ? php
/**
2015-11-03 13:31:20 +00:00
* WooCommerce Attribute Functions .
2013-09-12 13:41:02 +00:00
*
* @ author WooThemes
* @ category Core
* @ package WooCommerce / Functions
* @ version 2.1 . 0
*/
2014-09-20 19:04:38 +00:00
if ( ! defined ( 'ABSPATH' ) ) {
exit ; // Exit if accessed directly
}
2013-09-12 13:41:02 +00:00
2015-06-11 13:42:37 +00:00
/**
2015-11-03 13:31:20 +00:00
* Gets text attributes from a string .
2015-06-11 13:42:37 +00:00
*
* @ since 2.4
* @ return array
*/
function wc_get_text_attributes ( $raw_attributes ) {
2015-09-03 22:15:06 +00:00
return array_map ( 'trim' , explode ( WC_DELIMITER , html_entity_decode ( $raw_attributes , ENT_QUOTES , get_bloginfo ( 'charset' ) ) ) );
2015-06-11 13:42:37 +00:00
}
2013-09-12 13:41:02 +00:00
/**
* Get attribute taxonomies .
*
2015-08-11 16:10:32 +00:00
* @ return array of objects
2013-09-12 13:41:02 +00:00
*/
function wc_get_attribute_taxonomies () {
$transient_name = 'wc_attribute_taxonomies' ;
if ( false === ( $attribute_taxonomies = get_transient ( $transient_name ) ) ) {
global $wpdb ;
$attribute_taxonomies = $wpdb -> get_results ( " SELECT * FROM " . $wpdb -> prefix . " woocommerce_attribute_taxonomies " );
2014-03-12 11:58:41 +00:00
set_transient ( $transient_name , $attribute_taxonomies );
2013-09-12 13:41:02 +00:00
}
2015-08-11 16:10:32 +00:00
return ( array ) array_filter ( apply_filters ( 'woocommerce_attribute_taxonomies' , $attribute_taxonomies ) );
2013-09-12 13:41:02 +00:00
}
/**
* Get a product attributes name .
*
* @ param mixed $name
* @ return string
*/
function wc_attribute_taxonomy_name ( $name ) {
2013-11-25 13:34:21 +00:00
return 'pa_' . wc_sanitize_taxonomy_name ( $name );
2013-09-12 13:41:02 +00:00
}
/**
* Get a product attributes label .
*
2015-03-09 13:40:07 +00:00
* @ param string $name
* @ param object $product object Optional
2013-09-12 13:41:02 +00:00
* @ return string
*/
2015-03-09 13:40:07 +00:00
function wc_attribute_label ( $name , $product = '' ) {
2013-09-12 13:41:02 +00:00
global $wpdb ;
if ( taxonomy_is_product_attribute ( $name ) ) {
2013-11-25 13:34:21 +00:00
$name = wc_sanitize_taxonomy_name ( str_replace ( 'pa_' , '' , $name ) );
2013-09-12 13:41:02 +00:00
$label = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT attribute_label FROM { $wpdb -> prefix } woocommerce_attribute_taxonomies WHERE attribute_name = %s; " , $name ) );
2014-03-20 15:47:52 +00:00
if ( ! $label ) {
2015-03-13 22:41:12 +00:00
$label = $name ;
2014-03-20 15:47:52 +00:00
}
2015-03-09 13:40:07 +00:00
} elseif ( $product && ( $attributes = $product -> get_attributes () ) && isset ( $attributes [ sanitize_title ( $name ) ][ 'name' ] ) ) {
// Attempt to get label from product, as entered by the user
$label = $attributes [ sanitize_title ( $name ) ][ 'name' ];
2013-09-12 13:41:02 +00:00
} else {
2015-03-13 22:41:12 +00:00
$label = str_replace ( '-' , ' ' , $name );
2013-09-12 13:41:02 +00:00
}
2015-03-09 13:40:07 +00:00
return apply_filters ( 'woocommerce_attribute_label' , $label , $name , $product );
2013-09-12 13:41:02 +00:00
}
/**
* Get a product attributes orderby setting .
*
* @ param mixed $name
* @ return string
*/
function wc_attribute_orderby ( $name ) {
global $wpdb ;
$name = str_replace ( 'pa_' , '' , sanitize_title ( $name ) );
$orderby = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT attribute_orderby FROM " . $wpdb -> prefix . " woocommerce_attribute_taxonomies WHERE attribute_name = %s; " , $name ) );
return apply_filters ( 'woocommerce_attribute_orderby' , $orderby , $name );
}
/**
* Get an array of product attribute taxonomies .
*
* @ return array
*/
function wc_get_attribute_taxonomy_names () {
$taxonomy_names = array ();
$attribute_taxonomies = wc_get_attribute_taxonomies ();
if ( $attribute_taxonomies ) {
foreach ( $attribute_taxonomies as $tax ) {
$taxonomy_names [] = wc_attribute_taxonomy_name ( $tax -> attribute_name );
}
}
return $taxonomy_names ;
2014-03-07 08:29:01 +00:00
}
2015-04-27 15:31:34 +00:00
/**
* Get attribute types .
*
* @ since 2.4 . 0
* @ return array
*/
function wc_get_attribute_types () {
return ( array ) apply_filters ( 'product_attributes_type_selector' , array (
'select' => __ ( 'Select' , 'woocommerce' ),
'text' => __ ( 'Text' , 'woocommerce' )
) );
}
2015-04-27 16:06:28 +00:00
/**
2015-11-03 13:31:20 +00:00
* Check if attribute name is reserved .
* http :// codex . wordpress . org / Function_Reference / register_taxonomy #Reserved_Terms.
2015-04-27 16:06:28 +00:00
*
* @ since 2.4 . 0
* @ param string $attribute_name
* @ return bool
*/
function wc_check_if_attribute_name_is_reserved ( $attribute_name ) {
// Forbidden attribute names
$reserved_terms = array (
'attachment' , 'attachment_id' , 'author' , 'author_name' , 'calendar' , 'cat' , 'category' , 'category__and' ,
'category__in' , 'category__not_in' , 'category_name' , 'comments_per_page' , 'comments_popup' , 'cpage' , 'day' ,
'debug' , 'error' , 'exact' , 'feed' , 'hour' , 'link_category' , 'm' , 'minute' , 'monthnum' , 'more' , 'name' ,
'nav_menu' , 'nopaging' , 'offset' , 'order' , 'orderby' , 'p' , 'page' , 'page_id' , 'paged' , 'pagename' , 'pb' , 'perm' ,
'post' , 'post__in' , 'post__not_in' , 'post_format' , 'post_mime_type' , 'post_status' , 'post_tag' , 'post_type' ,
'posts' , 'posts_per_archive_page' , 'posts_per_page' , 'preview' , 'robots' , 's' , 'search' , 'second' , 'sentence' ,
'showposts' , 'static' , 'subpost' , 'subpost_id' , 'tag' , 'tag__and' , 'tag__in' , 'tag__not_in' , 'tag_id' ,
'tag_slug__and' , 'tag_slug__in' , 'taxonomy' , 'tb' , 'term' , 'type' , 'w' , 'withcomments' , 'withoutcomments' , 'year' ,
);
return in_array ( $attribute_name , $reserved_terms );
}