Functions
Table of Contents
- wc_lostpassword_url() : string
- Returns the url to the lost password endpoint url.
- wc_customer_edit_account_url() : string
- Get the link to the edit account details page.
- wc_edit_address_i18n() : string
- Get the edit address slug translation.
- wc_get_account_menu_items() : array<string|int, mixed>
- Get My Account menu items.
- wc_get_account_menu_item_classes() : string
- Get account menu item classes.
- wc_get_account_endpoint_url() : string
- Get account endpoint URL.
- wc_get_account_orders_columns() : array<string|int, mixed>
- Get My Account > Orders columns.
- wc_get_account_downloads_columns() : array<string|int, mixed>
- Get My Account > Downloads columns.
- wc_get_account_payment_methods_columns() : array<string|int, mixed>
- Get My Account > Payment methods columns.
- wc_get_account_payment_methods_types() : array<string|int, mixed>
- Get My Account > Payment methods types
- wc_get_account_orders_actions() : array<string|int, mixed>
- Get account orders actions.
- wc_get_account_formatted_address() : string
- Get account formatted address.
- wc_get_account_saved_payment_methods_list() : array<string|int, mixed>
- Returns an array of a user's saved payments list for output on the account tab.
- wc_get_account_saved_payment_methods_list_item_cc() : array<string|int, mixed>
- Controls the output for credit cards on the my account page.
- wc_get_account_saved_payment_methods_list_item_echeck() : array<string|int, mixed>
- Controls the output for eChecks on the my account page.
- wc_get_text_attributes() : array<string|int, mixed>
- Gets text attributes from a string.
- wc_get_text_attributes_filter_callback() : bool
- See if an attribute is actually valid.
- wc_implode_text_attributes() : string
- Implode an array of attributes using WC_DELIMITER.
- wc_get_attribute_taxonomies() : array<string|int, mixed>
- Get attribute taxonomies.
- wc_get_attribute_taxonomy_ids() : array<string|int, mixed>
- Get (cached) attribute taxonomy ID and name pairs.
- wc_get_attribute_taxonomy_labels() : array<string|int, mixed>
- Get (cached) attribute taxonomy label and name pairs.
- wc_attribute_taxonomy_name() : string
- Get a product attribute name.
- wc_variation_attribute_name() : string
- Get the attribute name used when storing values in post meta.
- wc_attribute_taxonomy_name_by_id() : string
- Get a product attribute name by ID.
- wc_attribute_taxonomy_id_by_name() : int
- Get a product attribute ID by name.
- wc_attribute_label() : string
- Get a product attributes label.
- wc_attribute_orderby() : string
- Get a product attributes orderby setting.
- wc_get_attribute_taxonomy_names() : array<string|int, mixed>
- Get an array of product attribute taxonomies.
- wc_get_attribute_types() : array<string|int, mixed>
- Get attribute types.
- wc_has_custom_attribute_types() : bool
- Check if there are custom attribute types.
- wc_get_attribute_type_label() : string
- Get attribute type label.
- wc_check_if_attribute_name_is_reserved() : bool
- Check if attribute name is reserved.
- wc_attributes_array_filter_visible() : bool
- Callback for array filter to get visible only.
- wc_attributes_array_filter_variation() : bool
- Callback for array filter to get variation attributes only.
- wc_is_attribute_in_product_name() : bool
- Check if an attribute is included in the attributes area of a variation name.
- wc_array_filter_default_attributes() : bool
- Callback for array filter to get default attributes. Will allow for '0' string values, but regard all other class PHP FALSE equivalents normally.
- wc_get_attribute() : stdClass|null
- Get attribute data by ID.
- wc_create_attribute() : int|WP_Error
- Create attribute.
- wc_update_attribute() : int|WP_Error
- Update an attribute.
- wc_delete_attribute() : bool
- Delete attribute by ID.
- wc_attribute_taxonomy_slug() : string
- Get an unprefixed product attribute name.
- wc_protected_product_add_to_cart() : bool
- Prevent password protected products being added to the cart.
- wc_empty_cart() : mixed
- Clears the cart session when called.
- wc_load_persistent_cart() : mixed
- Load the persistent cart.
- wc_get_raw_referer() : string|false
- Retrieves unvalidated referer from '_wp_http_referer' or HTTP referer.
- wc_add_to_cart_message() : mixed
- Add to cart messages.
- wc_format_list_of_items() : string
- Comma separate a list of item names, and replace final comma with 'and'.
- wc_clear_cart_after_payment() : mixed
- Clear cart after payment.
- wc_cart_totals_subtotal_html() : mixed
- Get the subtotal.
- wc_cart_totals_shipping_html() : mixed
- Get shipping methods.
- wc_cart_totals_taxes_total_html() : mixed
- Get taxes total.
- wc_cart_totals_coupon_label() : string
- Get a coupon label.
- wc_cart_totals_coupon_html() : mixed
- Get coupon display HTML.
- wc_cart_totals_order_total_html() : mixed
- Get order total html including inc tax if needed.
- wc_cart_totals_fee_html() : mixed
- Get the fee value.
- wc_cart_totals_shipping_method_label() : string
- Get a shipping methods full label including price.
- wc_cart_round_discount() : float
- Round discount.
- wc_get_chosen_shipping_method_ids() : array<string|int, string>
- Gets chosen shipping method IDs from chosen_shipping_methods session, without instance IDs.
- wc_get_chosen_shipping_method_for_package() : string|bool
- Get chosen method for package from session.
- wc_get_default_shipping_method_for_package() : string
- Choose the default method for a package.
- wc_shipping_methods_have_changed() : bool
- See if the methods have changed since the last request.
- wc_get_cart_item_data_hash() : string
- Gets a hash of important product data that when changed should cause cart items to be invalidated.
- is_woocommerce() : bool
- Is_woocommerce - Returns true if on a page which uses WooCommerce templates (cart and checkout are standard pages with shortcodes and thus are not included).
- is_shop() : bool
- Is_shop - Returns true when viewing the product type archive (shop).
- is_product_taxonomy() : bool
- Is_product_taxonomy - Returns true when viewing a product taxonomy archive.
- is_product_category() : bool
- Is_product_category - Returns true when viewing a product category.
- is_product_tag() : bool
- Is_product_tag - Returns true when viewing a product tag.
- is_product() : bool
- Is_product - Returns true when viewing a single product.
- is_cart() : bool
- Is_cart - Returns true when viewing the cart page.
- is_checkout() : bool
- Is_checkout - Returns true when viewing the checkout page, or when processing AJAX requests for updating or processing the checkout.
- is_checkout_pay_page() : bool
- Is_checkout_pay - Returns true when viewing the checkout's pay page.
- is_wc_endpoint_url() : bool
- Is_wc_endpoint_url - Check if an endpoint is showing.
- is_account_page() : bool
- Is_account_page - Returns true when viewing an account page.
- is_view_order_page() : bool
- Is_view_order_page - Returns true when on the view order page.
- is_edit_account_page() : bool
- Check for edit account page.
- is_order_received_page() : bool
- Is_order_received_page - Returns true when viewing the order received page.
- is_add_payment_method_page() : bool
- Is_add_payment_method_page - Returns true when viewing the add payment method page.
- is_lost_password_page() : bool
- Is_lost_password_page - Returns true when viewing the lost password page.
- is_ajax() : bool
- Is_ajax - Returns true when the page is loaded via ajax.
- is_store_notice_showing() : bool
- Is_store_notice_showing - Returns true when store notice is active.
- is_filtered() : bool
- Is_filtered - Returns true when filtering products using layered nav or price sliders.
- taxonomy_is_product_attribute() : bool
- Returns true when the passed taxonomy name is a product attribute.
- meta_is_product_attribute() : bool
- Returns true when the passed meta name is a product attribute.
- wc_tax_enabled() : bool
- Are store-wide taxes enabled?
- wc_shipping_enabled() : bool
- Is shipping enabled?
- wc_prices_include_tax() : bool
- Are prices inclusive of tax?
- wc_is_valid_url() : bool
- Simple check for validating a URL, it must start with http:// or https://.
- wc_site_is_https() : bool
- Check if the home URL is https. If it is, we don't need to do things such as 'force ssl'.
- wc_checkout_is_https() : bool
- Check if the checkout is configured for https. Look at options, WP HTTPS plugin, or the permalink itself.
- wc_post_content_has_shortcode() : bool
- Checks whether the content passed contains a specific short code.
- wc_reviews_enabled() : bool
- Check if reviews are enabled.
- wc_review_ratings_enabled() : bool
- Check if reviews ratings are enabled.
- wc_review_ratings_required() : bool
- Check if review ratings are required.
- wc_is_file_valid_csv() : bool
- Check if a CSV file is valid.
- wc_current_theme_is_fse_theme() : bool
- Check if the current theme is a block theme.
- wc_current_theme_supports_woocommerce_or_fse() : bool
- Check if the current theme has WooCommerce support or is a FSE theme.
- wc_wp_theme_get_element_class_name() : string
- Given an element name, returns a class name.
- wc_block_theme_has_styles_for_element() : bool
- Given an element name, returns true or false depending on whether the current theme has styles for that element defined in theme.json.
- wc_maybe_define_constant() : mixed
- Define a constant if it is not already defined.
- wc_create_order() : WC_Order|WP_Error
- Create a new order programmatically.
- wc_update_order() : WC_Order|WP_Error
- Update an order. Uses wc_create_order.
- wc_tokenize_path() : string
- Given a path, this will convert any of the subpaths into their corresponding tokens.
- wc_untokenize_path() : string
- Given a tokenized path, this will expand the tokens to their full path.
- wc_get_path_define_tokens() : array<string|int, mixed>
- Fetches an array containing all of the configurable path constants to be used in tokenization.
- wc_get_template_part() : mixed
- Get template part (for templates like the shop-loop).
- wc_get_template() : mixed
- Get other templates (e.g. product attributes) passing attributes and including the file.
- wc_get_template_html() : string
- Like wc_get_template, but returns the HTML instead of outputting.
- wc_locate_template() : string
- Locate a template and return the path for inclusion.
- wc_set_template_cache() : mixed
- Add a template to the template cache.
- wc_clear_template_cache() : mixed
- Clear the template cache.
- get_woocommerce_currency() : string
- Get Base Currency Code.
- get_woocommerce_currencies() : array<string|int, mixed>
- Get full list of currency codes.
- get_woocommerce_currency_symbols() : array<string|int, mixed>
- Get all available Currency symbols.
- get_woocommerce_currency_symbol() : string
- Get Currency symbol.
- wc_mail() : bool
- Send HTML emails from WooCommerce.
- wc_get_theme_support() : mixed
- Return "theme support" values from the current theme, if set.
- wc_get_image_size() : array<string|int, mixed>
- Get an image size by name or defined dimensions.
- wc_enqueue_js() : mixed
- Queue some JavaScript code to be output in the footer.
- wc_print_js() : mixed
- Output any queued javascript code in the footer.
- wc_setcookie() : mixed
- Set a cookie - wrapper for setcookie using WP constants.
- get_woocommerce_api_url() : string
- Get the URL to the WooCommerce Legacy REST API.
- wc_get_page_children() : array<string|int, int>
- Recursively get page children.
- flush_rewrite_rules_on_shop_page_save() : mixed
- Flushes rewrite rules when the shop page (or it's children) gets saved.
- wc_fix_rewrite_rules() : array<string|int, mixed>
- Various rewrite rule fixes.
- wc_fix_product_attachment_link() : string
- Prevent product attachment links from breaking when using complex rewrite structures.
- wc_ms_protect_download_rewite_rules() : string
- Protect downloads from ms-files.php in multisite.
- wc_format_country_state_string() : array<string|int, mixed>
- Formats a string in the format COUNTRY:STATE into an array.
- wc_get_base_location() : array<string|int, mixed>
- Get the store's base location.
- wc_get_customer_default_location() : array<string|int, mixed>
- Get the customer's default location.
- wc_get_user_agent() : string
- Get user agent string.
- wc_rand_hash() : string
- Generate a rand hash.
- wc_api_hash() : string
- WC API - Hash.
- wc_array_cartesian() : array<string|int, mixed>
- Find all possible combinations of values from the input array and return in a logical order.
- wc_transaction_query() : mixed
- Run a MySQL transaction query, if supported.
- wc_get_cart_url() : string
- Gets the url to the cart page.
- wc_get_checkout_url() : string
- Gets the url to the checkout page.
- woocommerce_register_shipping_method() : mixed
- Register a shipping method.
- wc_get_shipping_zone() : WC_Shipping_Zone
- Get the shipping zone matching a given package from the cart.
- wc_get_credit_card_type_label() : string
- Get a nice name for credit card providers.
- wc_back_link() : mixed
- Outputs a "back" link so admin screens can easily jump back a page.
- wc_help_tip() : string
- Display a WooCommerce help tip.
- wc_get_wildcard_postcodes() : array<string|int, string>
- Return a list of potential postcodes for wildcard searching.
- wc_postcode_location_matcher() : array<string|int, mixed>
- Used by shipping zones and taxes to compare a given $postcode to stored postcodes to find matches for numerical ranges, and wildcards.
- wc_get_shipping_method_count() : int
- Gets number of shipping methods currently enabled. Used to identify if shipping is configured.
- wc_set_time_limit() : mixed
- Wrapper for set_time_limit to see if it is enabled.
- wc_nocache_headers() : mixed
- Wrapper for nocache_headers which also disables page caching.
- wc_product_attribute_uasort_comparison() : int
- Used to sort products attributes with uasort.
- wc_shipping_zone_method_order_uasort_comparison() : int
- Used to sort shipping zone methods with uasort.
- wc_checkout_fields_uasort_comparison() : int
- User to sort checkout fields based on priority with uasort.
- wc_uasort_comparison() : int
- User to sort two values with ausort.
- wc_ascii_uasort_comparison() : int
- Sort values based on ascii, usefull for special chars in strings.
- wc_asort_by_locale() : array<string|int, mixed>
- Sort array according to current locale rules and maintaining index association.
- wc_get_tax_rounding_mode() : int
- Get rounding mode for internal tax calculations.
- wc_get_rounding_precision() : int
- Get rounding precision for internal WC calculations.
- wc_add_number_precision() : int|float
- Add precision to a number by moving the decimal point to the right as many places as indicated by wc_get_price_decimals().
- wc_remove_number_precision() : float
- Remove precision from a number and return a float.
- wc_add_number_precision_deep() : int|array<string|int, mixed>
- Add precision to an array of number and return an array of int.
- wc_remove_number_precision_deep() : int|array<string|int, mixed>
- Remove precision from an array of number and return an array of int.
- wc_get_logger() : WC_Logger_Interface
- Get a shared logger instance.
- wc_cleanup_logs() : mixed
- Trigger logging cleanup using the logging class.
- wc_print_r() : string|bool
- Prints human-readable information about a variable.
- wc_list_pluck() : array<string|int, mixed>
- Based on wp_list_pluck, this calls a method instead of returning a property.
- wc_get_permalink_structure() : array<string|int, mixed>
- Get permalink settings for things like products and taxonomies.
- wc_switch_to_site_locale() : mixed
- Switch WooCommerce to site language.
- wc_restore_locale() : mixed
- Switch WooCommerce language to original.
- wc_make_phone_clickable() : string
- Convert plaintext phone number to clickable phone number.
- wc_get_post_data_by_key() : mixed
- Get an item of post data if set, otherwise return a default value.
- wc_get_var() : mixed
- Get data if set, otherwise return a default value or null. Prevents notices when data is not set.
- wc_enable_wc_plugin_headers() : array<string|int, mixed>
- Read in WooCommerce headers when reading plugin headers.
- wc_prevent_dangerous_auto_updates() : bool
- Prevent auto-updating the WooCommerce plugin on major releases if there are untested extensions active.
- wc_delete_expired_transients() : int
- Delete expired transients.
- wc_get_relative_url() : string
- Make a URL relative, if possible.
- wc_is_external_resource() : bool
- See if a resource is remote.
- wc_is_active_theme() : bool
- See if theme/s is activate or not.
- wc_is_wp_default_theme_active() : bool
- Is the site using a default WP theme?
- wc_cleanup_session_data() : mixed
- Cleans up session data - cron callback.
- wc_decimal_to_fraction() : array<string|int, mixed>|bool
- Convert a decimal (e.g. 3.5) to a fraction (e.g. 7/2).
- wc_round_discount() : float
- Round discount.
- wc_selected() : string
- Return the html selected attribute if stringified $value is found in array of stringified $options or if stringified $value is the same as scalar stringified $options.
- wc_get_server_database_version() : array<string|int, mixed>
- Retrieves the MySQL server version. Based on $wpdb.
- wc_load_cart() : void
- Initialize and load the cart functionality.
- wc_is_running_from_async_action_scheduler() : bool
- Test whether the context of execution comes from async action scheduler.
- wc_cache_get_multiple() : array<string|int, mixed>|bool
- Polyfill for wp_cache_get_multiple for WP versions before 5.5.
- wc_get_coupon_types() : array<string|int, mixed>
- Get coupon types.
- wc_get_coupon_type() : string
- Get a coupon type's name.
- wc_get_product_coupon_types() : array<string|int, mixed>
- Coupon types that apply to individual products. Controls which validation rules will apply.
- wc_get_cart_coupon_types() : array<string|int, mixed>
- Coupon types that apply to the cart as a whole. Controls which validation rules will apply.
- wc_coupons_enabled() : bool
- Check if coupons are enabled.
- wc_get_coupon_code_by_id() : string
- Get coupon code by ID.
- wc_get_coupon_id_by_code() : int
- Get coupon ID by code.
- wc_do_deprecated_action() : mixed
- Runs a deprecated action with notice only if used.
- wc_deprecated_function() : mixed
- Wrapper for deprecated functions so we can apply some extra logic.
- wc_deprecated_hook() : mixed
- Wrapper for deprecated hook so we can apply some extra logic.
- wc_caught_exception() : mixed
- When catching an exception, this allows us to log it if unexpected.
- wc_doing_it_wrong() : mixed
- Wrapper for _doing_it_wrong().
- wc_deprecated_argument() : mixed
- Wrapper for deprecated arguments so we can apply some extra logic.
- woocommerce_show_messages() : mixed
- woocommerce_weekend_area_js() : mixed
- woocommerce_tooltip_js() : mixed
- woocommerce_datepicker_js() : mixed
- woocommerce_admin_scripts() : mixed
- woocommerce_create_page() : mixed
- woocommerce_readfile_chunked() : mixed
- woocommerce_format_total() : string
- Formal total costs - format to the number of decimal places for the base currency.
- woocommerce_get_formatted_product_name() : string
- Get product name with extra details such as SKU price and attributes. Used within admin.
- woocommerce_legacy_paypal_ipn() : mixed
- Handle IPN requests for the legacy paypal gateway by calling gateways manually if needed.
- get_product() : mixed
- woocommerce_protected_product_add_to_cart() : mixed
- woocommerce_empty_cart() : mixed
- woocommerce_load_persistent_cart() : mixed
- woocommerce_add_to_cart_message() : mixed
- woocommerce_clear_cart_after_payment() : mixed
- woocommerce_cart_totals_subtotal_html() : mixed
- woocommerce_cart_totals_shipping_html() : mixed
- woocommerce_cart_totals_coupon_html() : mixed
- woocommerce_cart_totals_order_total_html() : mixed
- woocommerce_cart_totals_fee_html() : mixed
- woocommerce_cart_totals_shipping_method_label() : mixed
- woocommerce_get_template_part() : mixed
- woocommerce_get_template() : mixed
- woocommerce_locate_template() : mixed
- woocommerce_mail() : mixed
- woocommerce_disable_admin_bar() : mixed
- woocommerce_create_new_customer() : mixed
- woocommerce_set_customer_auth_cookie() : mixed
- woocommerce_update_new_customer_past_orders() : mixed
- woocommerce_paying_customer() : mixed
- woocommerce_customer_bought_product() : mixed
- woocommerce_customer_has_capability() : mixed
- woocommerce_sanitize_taxonomy_name() : mixed
- woocommerce_get_filename_from_url() : mixed
- woocommerce_get_dimension() : mixed
- woocommerce_get_weight() : mixed
- woocommerce_trim_zeros() : mixed
- woocommerce_round_tax_total() : mixed
- woocommerce_format_decimal() : mixed
- woocommerce_clean() : mixed
- woocommerce_array_overlay() : mixed
- woocommerce_price() : mixed
- woocommerce_let_to_num() : mixed
- woocommerce_date_format() : mixed
- woocommerce_time_format() : mixed
- woocommerce_timezone_string() : mixed
- woocommerce_rgb_from_hex() : mixed
- woocommerce_hex_darker() : mixed
- woocommerce_hex_lighter() : mixed
- woocommerce_light_or_dark() : mixed
- woocommerce_format_hex() : mixed
- woocommerce_get_order_id_by_order_key() : mixed
- woocommerce_downloadable_file_permission() : mixed
- woocommerce_downloadable_product_permissions() : mixed
- woocommerce_add_order_item() : mixed
- woocommerce_delete_order_item() : mixed
- woocommerce_update_order_item_meta() : mixed
- woocommerce_add_order_item_meta() : mixed
- woocommerce_delete_order_item_meta() : mixed
- woocommerce_get_order_item_meta() : mixed
- woocommerce_cancel_unpaid_orders() : mixed
- woocommerce_processing_order_count() : mixed
- woocommerce_get_page_id() : mixed
- woocommerce_get_endpoint_url() : mixed
- woocommerce_lostpassword_url() : mixed
- woocommerce_customer_edit_account_url() : mixed
- woocommerce_nav_menu_items() : mixed
- woocommerce_nav_menu_item_classes() : mixed
- woocommerce_list_pages() : mixed
- woocommerce_product_dropdown_categories() : mixed
- woocommerce_walk_category_dropdown_tree() : mixed
- woocommerce_taxonomy_metadata_wpdbfix() : mixed
- wc_taxonomy_metadata_wpdbfix() : mixed
- woocommerce_order_terms() : mixed
- woocommerce_set_term_order() : mixed
- woocommerce_terms_clauses() : mixed
- _woocommerce_term_recount() : mixed
- woocommerce_recount_after_stock_change() : mixed
- woocommerce_change_term_counts() : mixed
- woocommerce_get_product_ids_on_sale() : mixed
- woocommerce_get_featured_product_ids() : mixed
- woocommerce_get_product_terms() : mixed
- woocommerce_product_post_type_link() : mixed
- woocommerce_placeholder_img_src() : mixed
- woocommerce_placeholder_img() : mixed
- woocommerce_get_formatted_variation() : mixed
- woocommerce_scheduled_sales() : mixed
- woocommerce_get_attachment_image_attributes() : mixed
- woocommerce_prepare_attachment_for_js() : mixed
- woocommerce_track_product_view() : mixed
- woocommerce_compile_less_styles() : mixed
- woocommerce_calc_shipping_backwards_compatibility() : string
- woocommerce_calc_shipping was an option used to determine if shipping was enabled prior to version 2.6.0. This has since been replaced with wc_shipping_enabled() function and the woocommerce_ship_to_countries setting.
- woocommerce_get_product_schema() : string
- _wc_save_product_price() : mixed
- Save product price.
- wc_get_customer_avatar_url() : string
- Return customer avatar URL.
- wc_get_core_supported_themes() : array<string|int, string>
- WooCommerce Core Supported Themes.
- wc_get_min_max_price_meta_query() : array<string|int, mixed>
- Get min/max price meta query args.
- wc_taxonomy_metadata_update_content_for_split_terms() : mixed
- When a term is split, ensure meta data maintained.
- update_woocommerce_term_meta() : bool
- WooCommerce Term Meta API.
- add_woocommerce_term_meta() : bool
- WooCommerce Term Meta API.
- delete_woocommerce_term_meta() : bool
- WooCommerce Term Meta API
- get_woocommerce_term_meta() : mixed
- WooCommerce Term Meta API
- wc_register_default_log_handler() : array<string|int, mixed>
- Registers the default log handler.
- wc_get_log_file_path() : string
- Get a log file path.
- wc_get_log_file_name() : string
- Get a log file name.
- wc_string_to_bool() : bool
- Converts a string (e.g. 'yes' or 'no') to a bool.
- wc_bool_to_string() : string
- Converts a bool to a 'yes' or 'no'.
- wc_string_to_array() : array<string|int, mixed>
- Explode a string into an array by $delimiter and remove empty values.
- wc_sanitize_taxonomy_name() : string
- Sanitize taxonomy names. Slug format (no spaces, lowercase).
- wc_sanitize_permalink() : string
- Sanitize permalink values before insertion into DB.
- wc_get_filename_from_url() : string
- Gets the filename part of a download URL.
- wc_get_dimension() : float
- Normalise dimensions, unify to cm then convert to wanted unit value.
- wc_get_weight() : float
- Normalise weights, unify to kg then convert to wanted unit value.
- wc_trim_zeros() : string
- Trim trailing zeros off prices.
- wc_round_tax_total() : float
- Round a tax amount.
- wc_legacy_round_half_down() : float
- Round half down in PHP 5.2.
- wc_format_refund_total() : float
- Make a refund total negative.
- wc_format_decimal() : string
- Format decimal numbers ready for DB storage.
- wc_float_to_string() : string
- Convert a float to a string without locale formatting which PHP adds when changing floats to strings.
- wc_format_localized_price() : string
- Format a price with WC Currency Locale settings.
- wc_format_localized_decimal() : string
- Format a decimal with the decimal separator for prices or PHP Locale settings.
- wc_format_coupon_code() : string
- Format a coupon code.
- wc_sanitize_coupon_code() : string
- Sanitize a coupon code.
- wc_clean() : string|array<string|int, mixed>
- Clean variables using sanitize_text_field. Arrays are cleaned recursively.
- wc_check_invalid_utf8() : string|array<string|int, mixed>
- Function wp_check_invalid_utf8 with recursive array support.
- wc_sanitize_textarea() : string
- Run wc_clean over posted textarea but maintain line breaks.
- wc_sanitize_tooltip() : string
- Sanitize a string destined to be a tooltip.
- wc_array_overlay() : array<string|int, mixed>
- Merge two arrays.
- wc_stock_amount() : int|float
- Formats a stock amount by running it through a filter.
- get_woocommerce_price_format() : string
- Get the price format depending on the currency position.
- wc_get_price_thousand_separator() : string
- Return the thousand separator for prices.
- wc_get_price_decimal_separator() : string
- Return the decimal separator for prices.
- wc_get_price_decimals() : int
- Return the number of decimals after the decimal point.
- wc_price() : string
- Format the price with a currency symbol.
- wc_let_to_num() : int
- Notation to numbers.
- wc_date_format() : string
- WooCommerce Date Format - Allows to change date format for everything WooCommerce.
- wc_time_format() : string
- WooCommerce Time Format - Allows to change time format for everything WooCommerce.
- wc_string_to_timestamp() : int
- Convert mysql datetime to PHP timestamp, forcing UTC. Wrapper for strtotime.
- wc_string_to_datetime() : WC_DateTime
- Convert a date string to a WC_DateTime.
- wc_timezone_string() : string
- WooCommerce Timezone - helper to retrieve the timezone string for a site until.
- wc_timezone_offset() : float
- Get timezone offset in seconds.
- wc_flatten_meta_callback() : mixed
- Callback which can flatten post meta (gets the first value if it's an array).
- wc_rgb_from_hex() : array<string|int, mixed>
- Convert RGB to HEX.
- wc_hex_darker() : string
- Make HEX color darker.
- wc_hex_lighter() : string
- Make HEX color lighter.
- wc_hex_is_light() : bool
- Determine whether a hex color is light.
- wc_light_or_dark() : string
- Detect if we should use a light or dark color on a background color.
- wc_format_hex() : string|null
- Format string as hex.
- wc_format_postcode() : string
- Format the postcode according to the country and length of the postcode.
- wc_normalize_postcode() : string
- Normalize postcodes.
- wc_format_phone_number() : string
- Format phone numbers.
- wc_sanitize_phone_number() : string
- Sanitize phone number.
- wc_strtoupper() : string
- Wrapper for mb_strtoupper which see's if supported first.
- wc_strtolower() : string
- Make a string lowercase.
- wc_trim_string() : string
- Trim a string and append a suffix.
- wc_format_content() : string
- Format content to display shortcodes.
- wc_format_product_short_description() : string
- Format product short description.
- wc_format_option_price_separators() : string
- Formats curency symbols when saved in settings.
- wc_format_option_price_num_decimals() : string
- Formats decimals when saved in settings.
- wc_format_option_hold_stock_minutes() : string
- Formats hold stock option and sets cron event up.
- wc_sanitize_term_text_based() : string
- Sanitize terms from an attribute text based.
- wc_make_numeric_postcode() : string
- Make numeric postcode.
- wc_format_stock_for_display() : string
- Format the stock amount ready for display based on settings.
- wc_format_stock_quantity_for_display() : string
- Format the stock quantity ready for display.
- wc_format_sale_price() : string
- Format a sale price for display.
- wc_format_price_range() : string
- Format a price range for display.
- wc_format_weight() : string
- Format a weight for display.
- wc_format_dimensions() : string
- Format dimensions for display.
- wc_format_datetime() : string
- Format a date for output.
- wc_do_oembeds() : string
- Process oEmbeds.
- wc_get_string_before_colon() : string
- Get part of a string before :.
- wc_array_merge_recursive_numeric() : array<string|int, mixed>
- Array merge and sum function.
- wc_implode_html_attributes() : string
- Implode and escape HTML attributes for output.
- wc_esc_json() : string
- Escape JSON for use on HTML or attribute text nodes.
- wc_parse_relative_date_option() : array<string|int, mixed>
- Parse a relative date option from the settings API into a standard format.
- wc_sanitize_endpoint_slug() : string
- Format the endpoint slug, strip out anything not allowed in a url.
- wc_notice_count() : int
- Get the count of notices added, either for all notices (default) or for one.
- wc_has_notice() : bool
- Check if a notice has already been added.
- wc_add_notice() : mixed
- Add and store a notice.
- wc_set_notices() : mixed
- Set all notices at once.
- wc_clear_notices() : mixed
- Unset all notices.
- wc_print_notices() : string|void
- Prints messages and errors which are stored in the session, then clears them.
- wc_print_notice() : mixed
- Print a single notice immediately.
- wc_get_notices() : array<string|int, array<string|int, mixed>>
- Returns all queued notices, optionally filtered by a notice type.
- wc_add_wp_error_notices() : mixed
- Add notices for WP Errors.
- wc_kses_notice() : string
- Filters out the same tags as wp_kses_post, but allows tabindex for <a> element.
- wc_get_notice_data_attr() : string
- Get notice data attribute.
- wc_get_orders() : array<string|int, WC_Order>|stdClass
- Standard way of retrieving orders based on certain parameters.
- wc_get_order() : bool|WC_Order|WC_Order_Refund
- Main function for returning orders, uses the WC_Order_Factory class.
- wc_get_order_statuses() : array<string|int, mixed>
- Get all order statuses.
- wc_is_order_status() : bool
- See if a string is an order status.
- wc_get_is_paid_statuses() : array<string|int, mixed>
- Get list of statuses which are consider 'paid'.
- wc_get_is_pending_statuses() : array<string|int, mixed>
- Get list of statuses which are consider 'pending payment'.
- wc_get_order_status_name() : string
- Get the nice name for an order status.
- wc_generate_order_key() : string
- Generate an order key with prefix.
- wc_get_order_id_by_order_key() : int
- Finds an Order ID based on an order key.
- wc_get_order_types() : array<string|int, mixed>
- Get all registered order types.
- wc_get_order_type() : bool|array<string|int, mixed>
- Get an order type by post type name.
- wc_register_order_type() : bool
- Register order type. Do not use before init.
- wc_processing_order_count() : int
- Return the count of processing orders.
- wc_orders_count() : int
- Return the orders count of a specific order status.
- wc_downloadable_file_permission() : int|bool
- Grant downloadable product access to the file identified by $download_id.
- wc_downloadable_product_permissions() : mixed
- Order Status completed - give downloadable product access to customer.
- wc_delete_shop_order_transients() : mixed
- Clear all transients cache for order data.
- wc_ship_to_billing_address_only() : bool
- See if we only ship to billing addresses.
- wc_create_refund() : WC_Order_Refund|WP_Error
- Create a new order refund programmatically.
- wc_refund_payment() : bool|WP_Error
- Try to refund the payment for an order via the gateway.
- wc_restock_refunded_items() : mixed
- Restock items during refund.
- wc_get_tax_class_by_tax_id() : string
- Get tax class by tax id.
- wc_get_payment_gateway_by_order() : WC_Payment_Gateway|bool
- Get payment gateway class by order data.
- wc_order_fully_refunded() : mixed
- When refunding an order, create a refund line item if the partial refunds do not match order total.
- wc_order_search() : array<string|int, mixed>
- Search orders.
- wc_update_total_sales_counts() : mixed
- Update total sales amount for each product within a paid order.
- wc_update_coupon_usage_counts() : mixed
- Update used coupon amount for each coupon within an order.
- wc_cancel_unpaid_orders() : mixed
- Cancel all unpaid orders after held duration to prevent stock lock for those products.
- wc_sanitize_order_id() : mixed
- Sanitize order id removing unwanted characters.
- wc_get_order_note() : stdClass|null
- Get an order note.
- wc_get_order_notes() : array<string|int, stdClass>
- Get order notes.
- wc_create_order_note() : int|WP_Error
- Create an order note.
- wc_delete_order_note() : bool
- Delete an order note.
- wc_add_order_item() : int|bool
- Add a item to an order (for example a line item).
- wc_update_order_item() : bool
- Update an item for an order.
- wc_delete_order_item() : bool
- Delete an item from the order it belongs to based on item id.
- wc_update_order_item_meta() : bool
- WooCommerce Order Item Meta API - Update term meta.
- wc_add_order_item_meta() : int
- WooCommerce Order Item Meta API - Add term meta.
- wc_delete_order_item_meta() : bool
- WooCommerce Order Item Meta API - Delete term meta.
- wc_get_order_item_meta() : mixed
- WooCommerce Order Item Meta API - Get term meta.
- wc_get_order_id_by_order_item_id() : int
- Get order ID by order item ID.
- wc_page_endpoint_title() : string
- Replace a page title with the endpoint title.
- wc_get_page_id() : int
- Retrieve page ids - used for myaccount, edit_address, shop, cart, checkout, pay, view_order, terms. returns -1 if no page is found.
- wc_get_page_permalink() : string
- Retrieve page permalink.
- wc_get_endpoint_url() : string
- Get endpoint URL.
- wc_nav_menu_items() : array<string|int, mixed>
- Hide menu items conditionally.
- wc_nav_menu_item_classes() : array<string|int, mixed>
- Fix active class in nav for shop page.
- wc_list_pages() : string
- Fix active class in wp_list_pages for shop page.
- wc_get_products() : array<string|int, mixed>|stdClass
- Standard way of retrieving products based on certain parameters.
- wc_get_product() : WC_Product|null|false
- Main function for returning products, uses the WC_Product_Factory class.
- wc_get_product_object() : WC_Product
- Get a product object.
- wc_product_sku_enabled() : bool
- Returns whether or not SKUS are enabled.
- wc_product_weight_enabled() : bool
- Returns whether or not product weights are enabled.
- wc_product_dimensions_enabled() : bool
- Returns whether or not product dimensions (HxWxD) are enabled.
- wc_delete_product_transients() : mixed
- Clear transient cache for product data.
- wc_get_product_ids_on_sale() : array<string|int, mixed>
- Function that returns an array containing the IDs of the products that are on sale.
- wc_get_featured_product_ids() : array<string|int, mixed>
- Function that returns an array containing the IDs of the featured products.
- wc_product_post_type_link() : string
- Filter to allow product_cat in the permalinks for products.
- wc_placeholder_img_src() : string
- Get the placeholder image URL either from media, or use the fallback image.
- wc_placeholder_img() : string
- Get the placeholder image.
- wc_get_formatted_variation() : string
- Variation Formatting.
- wc_scheduled_sales() : mixed
- Function which handles the start and end of scheduled sales via cron.
- wc_get_attachment_image_attributes() : array<string|int, mixed>
- Get attachment image attributes.
- wc_prepare_attachment_for_js() : array<string|int, mixed>
- Prepare attachment for JavaScript.
- wc_track_product_view() : mixed
- Track product views.
- wc_get_product_types() : array<string|int, mixed>
- Get product types.
- wc_product_has_unique_sku() : bool
- Check if product sku is unique.
- wc_product_force_unique_sku() : mixed
- Force a unique SKU.
- wc_product_generate_unique_sku() : string
- Recursively appends a suffix until a unique SKU is found.
- wc_get_product_id_by_sku() : int
- Get product ID by SKU.
- wc_get_product_variation_attributes() : array<string|int, mixed>
- Get attributes/data for an individual variation from the database and maintain it's integrity.
- wc_get_product_cat_ids() : array<string|int, mixed>
- Get all product cats for a product by ID, including hierarchy
- wc_get_product_attachment_props() : array<string|int, mixed>
- Gets data about an attachment, such as alt text and captions.
- wc_get_product_visibility_options() : array<string|int, mixed>
- Get product visibility options.
- wc_get_product_tax_class_options() : array<string|int, mixed>
- Get product tax class options.
- wc_get_product_stock_status_options() : array<string|int, mixed>
- Get stock status options.
- wc_get_product_backorder_options() : array<string|int, mixed>
- Get backorder options.
- wc_get_related_products() : array<string|int, mixed>
- Get related products based on product category and tags.
- wc_get_product_term_ids() : array<string|int, mixed>
- Retrieves product term ids for a taxonomy.
- wc_get_price_including_tax() : float|string
- For a given product, and optionally price/qty, work out the price with tax included, based on store settings.
- wc_get_price_excluding_tax() : float|string
- For a given product, and optionally price/qty, work out the price with tax excluded, based on store settings.
- wc_get_price_to_display() : float
- Returns the price including or excluding tax.
- wc_get_product_category_list() : string
- Returns the product categories in a list.
- wc_get_product_tag_list() : string
- Returns the product tags in a list.
- wc_products_array_filter_visible() : bool
- Callback for array filter to get visible only.
- wc_products_array_filter_visible_grouped() : bool
- Callback for array filter to get visible grouped products only.
- wc_products_array_filter_editable() : bool
- Callback for array filter to get products the user can edit only.
- wc_products_array_filter_readable() : bool
- Callback for array filter to get products the user can view only.
- wc_products_array_orderby() : array<string|int, mixed>
- Sort an array of products by a value.
- wc_products_array_orderby_title() : int
- Sort by title.
- wc_products_array_orderby_id() : int
- Sort by id.
- wc_products_array_orderby_date() : int
- Sort by date.
- wc_products_array_orderby_modified() : int
- Sort by modified.
- wc_products_array_orderby_menu_order() : int
- Sort by menu order.
- wc_products_array_orderby_price() : int
- Sort by price low to high.
- wc_deferred_product_sync() : mixed
- Queue a product for syncing at the end of the request.
- wc_update_product_lookup_tables_is_running() : bool
- See if the lookup table is being generated already.
- wc_update_product_lookup_tables() : mixed
- Populate lookup table data for products.
- wc_update_product_lookup_tables_column() : mixed
- Populate lookup table column data.
- wc_update_product_lookup_tables_rating_count() : mixed
- Populate rating count lookup table data for products.
- wc_update_product_lookup_tables_rating_count_batch() : mixed
- Populate a batch of rating count lookup table data for products.
- wc_product_attach_featured_image() : void
- Attach product featured image. Use image filename to match a product sku when product is not provided.
- wc_rest_prepare_date_response() : string|null
- Parses and formats a date for ISO8601/RFC3339.
- wc_rest_allowed_image_mime_types() : array<string|int, mixed>
- Returns image mime types users are allowed to upload via the API.
- wc_rest_upload_image_from_url() : array<string|int, mixed>|WP_Error
- Upload image from URL.
- wc_rest_set_uploaded_image_as_attachment() : int
- Set uploaded image as attachment.
- wc_rest_validate_reports_request_arg() : WP_Error|bool
- Validate reports request arguments.
- wc_rest_urlencode_rfc3986() : string|array<string|int, mixed>
- Encodes a value according to RFC 3986.
- wc_rest_check_post_permissions() : bool
- Check permissions of posts on REST API.
- wc_rest_check_user_permissions() : bool
- Check permissions of users on REST API.
- wc_rest_check_product_term_permissions() : bool
- Check permissions of product terms on REST API.
- wc_rest_check_manager_permissions() : bool
- Check manager permissions on REST API.
- wc_rest_check_product_reviews_permissions() : bool
- Check product reviews permissions on REST API.
- wc_rest_is_from_product_editor() : bool
- Returns true if the current REST request is from the product editor.
- wc_update_product_stock() : bool|int|null
- Update a product's stock amount.
- wc_update_product_stock_status() : mixed
- Update a product's stock status.
- wc_maybe_reduce_stock_levels() : mixed
- When a payment is complete, we can reduce stock levels for items within an order.
- wc_maybe_increase_stock_levels() : mixed
- When a payment is cancelled, restore stock.
- wc_reduce_stock_levels() : mixed
- Reduce stock levels for items within an order, if stock has not already been reduced for the items.
- wc_trigger_stock_change_notifications() : mixed
- After stock change events, triggers emails and adds order notes.
- wc_increase_stock_levels() : mixed
- Increase stock levels for items within an order.
- wc_get_held_stock_quantity() : int
- See how much stock is being held in pending orders.
- wc_reserve_stock_for_order() : mixed
- Hold stock for an order.
- wc_release_stock_for_order() : mixed
- Release held stock for an order.
- wc_get_low_stock_amount() : int
- Return low stock amount to determine if notification needs to be sent
- wc_template_redirect() : mixed
- Handle redirects before content is output - hooked into template_redirect so is_page works.
- wc_send_frame_options_header() : mixed
- When loading sensitive checkout or account pages, send a HTTP header to limit rendering of pages to same origin iframes for security reasons.
- wc_prevent_endpoint_indexing() : mixed
- No index our endpoints.
- wc_prevent_adjacent_posts_rel_link_wp_head() : mixed
- Remove adjacent_posts_rel_link_wp_head - pointless for products.
- wc_gallery_noscript() : mixed
- Show the gallery if JS is disabled.
- wc_setup_product_data() : WC_Product
- When the_post is called, put product data into a global.
- wc_setup_loop() : mixed
- Sets up the woocommerce_loop global from the passed args or from the main query.
- wc_reset_loop() : mixed
- Resets the woocommerce_loop global.
- wc_get_loop_prop() : mixed
- Gets a property from the woocommerce_loop global.
- wc_set_loop_prop() : mixed
- Sets a property in the woocommerce_loop global.
- wc_set_loop_product_visibility() : mixed
- Set the current visbility for a product in the woocommerce_loop global.
- wc_get_loop_product_visibility() : bool|null
- Gets the cached current visibility for a product from the woocommerce_loop global.
- woocommerce_product_loop() : bool
- Should the WooCommerce loop be displayed?
- wc_generator_tag() : string
- Output generator tag to aid debugging.
- wc_body_class() : array<string|int, mixed>
- Add body classes for WC pages.
- wc_no_js() : mixed
- NO JS handling.
- wc_product_cat_class() : mixed
- Display the classes for the product cat div.
- wc_get_default_products_per_row() : int
- Get the default columns setting - this is how many products will be shown per row in loops.
- wc_get_default_product_rows_per_page() : int
- Get the default rows setting - this is how many product rows will be shown in loops.
- wc_reset_product_grid_settings() : mixed
- Reset the product grid settings when a new theme is activated.
- wc_get_loop_class() : string
- Get classname for woocommerce loops.
- wc_get_product_cat_class() : array<string|int, mixed>
- Get the classes for the product cat div.
- wc_product_post_class() : array<string|int, mixed>
- Adds extra post classes for products via the WordPress post_class hook, if used.
- wc_get_product_taxonomy_class() : array<string|int, mixed>
- Get product taxonomy HTML classes.
- wc_get_product_class() : array<string|int, mixed>
- Retrieves the classes for the post div as an array.
- wc_product_class() : mixed
- Display the classes for the product div.
- wc_query_string_form_fields() : string
- Outputs hidden form inputs for each query string variable.
- wc_terms_and_conditions_page_id() : int
- Get the terms and conditions page ID.
- wc_privacy_policy_page_id() : int
- Get the privacy policy page ID.
- wc_terms_and_conditions_checkbox_enabled() : bool
- See if the checkbox is enabled or not based on the existence of the terms page and checkbox text.
- wc_get_terms_and_conditions_checkbox_text() : string
- Get the terms and conditions checkbox text, if set.
- wc_get_privacy_policy_text() : string
- Get the privacy policy text, if set.
- wc_terms_and_conditions_checkbox_text() : mixed
- Output t&c checkbox text.
- wc_terms_and_conditions_page_content() : mixed
- Output t&c page's content (if set). The page can be set from checkout settings.
- wc_checkout_privacy_policy_text() : mixed
- Render privacy policy text on the checkout.
- wc_registration_privacy_policy_text() : mixed
- Render privacy policy text on the register forms.
- wc_privacy_policy_text() : mixed
- Output privacy policy text. This is custom text which can be added via the customizer/privacy settings section.
- wc_replace_policy_page_link_placeholders() : string
- Replaces placeholders with links to WooCommerce policy pages.
- woocommerce_content() : mixed
- Output WooCommerce content.
- woocommerce_output_content_wrapper() : mixed
- Output the start of the page wrapper.
- woocommerce_output_content_wrapper_end() : mixed
- Output the end of the page wrapper.
- woocommerce_get_sidebar() : mixed
- Get the shop sidebar template.
- woocommerce_demo_store() : mixed
- Adds a demo store banner to the site if enabled.
- woocommerce_page_title() : string
- Page Title function.
- woocommerce_product_loop_start() : string
- Output the start of a product loop. By default this is a UL.
- woocommerce_product_loop_end() : string
- Output the end of a product loop. By default this is a UL.
- woocommerce_template_loop_product_title() : mixed
- Show the product title in the product loop. By default this is an H2.
- woocommerce_template_loop_category_title() : mixed
- Show the subcategory title in the product loop.
- woocommerce_template_loop_product_link_open() : mixed
- Insert the opening anchor tag for products in the loop.
- woocommerce_template_loop_product_link_close() : mixed
- Insert the closing anchor tag for products in the loop.
- woocommerce_template_loop_category_link_open() : mixed
- Insert the opening anchor tag for categories in the loop.
- woocommerce_template_loop_category_link_close() : mixed
- Insert the closing anchor tag for categories in the loop.
- woocommerce_product_taxonomy_archive_header() : mixed
- Output the products header on taxonomy archives.
- woocommerce_taxonomy_archive_description() : mixed
- Show an archive description on taxonomy archives.
- woocommerce_product_archive_description() : mixed
- Show a shop page description on product archives.
- woocommerce_template_loop_add_to_cart() : mixed
- Get the add to cart template for the loop.
- woocommerce_template_loop_product_thumbnail() : mixed
- Get the product thumbnail for the loop.
- woocommerce_template_loop_price() : mixed
- Get the product price for the loop.
- woocommerce_template_loop_rating() : mixed
- Display the average rating in the loop.
- woocommerce_show_product_loop_sale_flash() : mixed
- Get the sale flash for the loop.
- woocommerce_get_product_thumbnail() : string
- Get the product thumbnail, or the placeholder if not set.
- woocommerce_result_count() : mixed
- Output the result count text (Showing x - x of x results).
- woocommerce_catalog_ordering() : mixed
- Output the product sorting options.
- woocommerce_pagination() : mixed
- Output the pagination.
- woocommerce_show_product_images() : mixed
- Output the product image before the single product summary.
- woocommerce_show_product_thumbnails() : mixed
- Output the product thumbnails.
- wc_get_gallery_image_html() : string
- Get HTML for a gallery image.
- woocommerce_output_product_data_tabs() : mixed
- Output the product tabs.
- woocommerce_template_single_title() : mixed
- Output the product title.
- woocommerce_template_single_rating() : mixed
- Output the product rating.
- woocommerce_template_single_price() : mixed
- Output the product price.
- woocommerce_template_single_excerpt() : mixed
- Output the product short description (excerpt).
- woocommerce_template_single_meta() : mixed
- Output the product meta.
- woocommerce_template_single_sharing() : mixed
- Output the product sharing.
- woocommerce_show_product_sale_flash() : mixed
- Output the product sale flash.
- woocommerce_template_single_add_to_cart() : mixed
- Trigger the single product add to cart action.
- woocommerce_simple_add_to_cart() : mixed
- Output the simple product add to cart area.
- woocommerce_grouped_add_to_cart() : mixed
- Output the grouped product add to cart area.
- woocommerce_variable_add_to_cart() : mixed
- Output the variable product add to cart area.
- woocommerce_external_add_to_cart() : mixed
- Output the external product add to cart area.
- woocommerce_quantity_input() : string
- Output the quantity input for add to cart forms.
- woocommerce_product_description_tab() : mixed
- Output the description tab content.
- woocommerce_product_additional_information_tab() : mixed
- Output the attributes tab content.
- woocommerce_default_product_tabs() : array<string|int, mixed>
- Add default product tabs to product pages.
- woocommerce_sort_product_tabs() : array<string|int, mixed>
- Sort tabs by priority.
- woocommerce_comments() : mixed
- Output the Review comments template.
- woocommerce_review_display_gravatar() : void
- Display the review authors gravatar
- woocommerce_review_display_rating() : void
- Display the reviewers star rating
- woocommerce_review_display_meta() : void
- Display the review authors meta (name, verified owner, review date)
- woocommerce_review_display_comment_text() : mixed
- Display the review content.
- woocommerce_output_related_products() : mixed
- Output the related products.
- woocommerce_related_products() : mixed
- Output the related products.
- woocommerce_upsell_display() : mixed
- Output product up sells.
- woocommerce_shipping_calculator() : mixed
- Output the cart shipping calculator.
- woocommerce_cart_totals() : mixed
- Output the cart totals.
- woocommerce_cross_sell_display() : mixed
- Output the cart cross-sells.
- woocommerce_button_proceed_to_checkout() : mixed
- Output the proceed to checkout button.
- woocommerce_widget_shopping_cart_button_view_cart() : mixed
- Output the view cart button.
- woocommerce_widget_shopping_cart_proceed_to_checkout() : mixed
- Output the proceed to checkout button.
- woocommerce_widget_shopping_cart_subtotal() : mixed
- Output to view cart subtotal.
- woocommerce_mini_cart() : mixed
- Output the Mini-cart - used by cart widget.
- woocommerce_login_form() : mixed
- Output the WooCommerce Login Form.
- woocommerce_checkout_login_form() : mixed
- Output the WooCommerce Checkout Login Form.
- woocommerce_breadcrumb() : mixed
- Output the WooCommerce Breadcrumb.
- woocommerce_order_review() : mixed
- Output the Order review table for the checkout.
- woocommerce_checkout_payment() : mixed
- Output the Payment Methods on the checkout.
- woocommerce_checkout_coupon_form() : mixed
- Output the Coupon form for the checkout.
- woocommerce_products_will_display() : bool
- Check if we will be showing products or not (and not sub-categories only).
- woocommerce_get_loop_display_mode() : string
- See what is going to display in the loop.
- woocommerce_maybe_show_product_subcategories() : string
- Maybe display categories before, or instead of, a product loop.
- woocommerce_product_subcategories() : null|bool
- This is a legacy function which used to check if we needed to display subcats and then output them. It was called by templates.
- woocommerce_output_product_categories() : bool
- Display product sub categories as thumbnails.
- woocommerce_get_product_subcategories() : array<string|int, mixed>
- Get (and cache) product subcategories.
- woocommerce_subcategory_thumbnail() : mixed
- Show subcategory thumbnails.
- woocommerce_order_details_table() : mixed
- Displays order details in a table.
- woocommerce_order_downloads_table() : mixed
- Displays order downloads in a table.
- woocommerce_order_again_button() : mixed
- Display an 'order again' button on the view order page.
- woocommerce_form_field() : string
- Outputs a checkout/address form field.
- get_product_search_form() : string
- Display product search form.
- woocommerce_output_auth_header() : mixed
- Output the Auth header.
- woocommerce_output_auth_footer() : mixed
- Output the Auth footer.
- woocommerce_single_variation() : mixed
- Output placeholders for the single variation.
- woocommerce_single_variation_add_to_cart_button() : mixed
- Output the add to cart button for variations.
- wc_dropdown_variation_attribute_options() : mixed
- Output a list of variation attributes for use in the cart forms.
- woocommerce_account_content() : mixed
- My Account content output.
- woocommerce_account_navigation() : mixed
- My Account navigation template.
- woocommerce_account_orders() : mixed
- My Account > Orders template.
- woocommerce_account_view_order() : mixed
- My Account > View order template.
- woocommerce_account_downloads() : mixed
- My Account > Downloads template.
- woocommerce_account_edit_address() : mixed
- My Account > Edit address template.
- woocommerce_account_payment_methods() : mixed
- My Account > Downloads template.
- woocommerce_account_add_payment_method() : mixed
- My Account > Add payment method template.
- woocommerce_account_edit_account() : mixed
- My Account > Edit account template.
- wc_no_products_found() : mixed
- Handles the loop when no products were found/no product exist.
- wc_get_email_order_items() : string
- Get HTML for the order items to be shown in emails.
- wc_display_item_meta() : string|void
- Display item meta data.
- wc_display_item_downloads() : string|void
- Display item download links.
- woocommerce_photoswipe() : mixed
- Get the shop sidebar template.
- wc_display_product_attributes() : mixed
- Outputs a list of product attributes for a product.
- wc_get_stock_html() : string
- Get HTML to show product stock.
- wc_get_rating_html() : string
- Get HTML for ratings.
- wc_get_star_rating_html() : string
- Get HTML for star rating.
- wc_get_price_html_from_text() : string
- Returns a 'from' prefix if you want to show where prices start at.
- wc_logout_url() : string
- Get logout endpoint.
- wc_empty_cart_message() : mixed
- Show notice if cart is empty.
- wc_page_noindex() : mixed
- Disable search engines indexing core, dynamic, cart/checkout pages.
- wc_page_no_robots() : array<string|int, mixed>
- Disable search engines indexing core, dynamic, cart/checkout pages.
- wc_get_theme_slug_for_templates() : string
- Get a slug identifying the current theme.
- wc_get_formatted_cart_item_data() : string
- Gets and formats a list of cart item data + variations for display on the frontend.
- wc_get_cart_remove_url() : string
- Gets the url to remove an item from the cart.
- wc_get_cart_undo_url() : string
- Gets the url to re-add an item into the cart.
- woocommerce_output_all_notices() : mixed
- Outputs all queued notices on WC pages.
- wc_products_rss_feed() : mixed
- Products RSS Feed.
- woocommerce_reset_loop() : mixed
- Reset the loop's index and columns when we're done outputting a product loop.
- woocommerce_product_reviews_tab() : mixed
- Output the reviews tab content.
- wc_get_pay_buttons() : mixed
- Display pay buttons HTML.
- wc_update_product_archive_title() : string
- Update the product archive title to the title of the shop page. Fallback to 'Shop' if the shop page doesn't exist.
- wc_change_get_terms_defaults() : array<string|int, mixed>
- Change get terms defaults for attributes to order by the sorting setting, or default to menu_order for sortable taxonomies.
- wc_change_pre_get_terms() : mixed
- Adds support to get_terms for menu_order argument.
- wc_terms_clauses() : array<string|int, mixed>
- Adjust term query to handle custom sorting parameters.
- wc_get_object_terms() : array<string|int, mixed>
- Helper to get cached object terms and filter by field using wp_list_pluck().
- _wc_get_cached_product_terms() : array<string|int, mixed>
- Cached version of wp_get_post_terms().
- wc_get_product_terms() : array<string|int, mixed>
- Wrapper used to get terms for a product.
- _wc_get_product_terms_name_num_usort_callback() : int
- Sort by name (numeric).
- _wc_get_product_terms_parent_usort_callback() : int
- Sort by parent.
- wc_product_dropdown_categories() : mixed
- WooCommerce Dropdown categories.
- wc_walk_category_dropdown_tree() : mixed
- Custom walker for Product Categories.
- wc_taxonomy_metadata_migrate_data() : mixed
- Migrate data from WC term meta to WP term meta.
- wc_reorder_terms() : int
- Move a term before the a given element of its hierarchy level.
- wc_set_term_order() : int
- Set the sort order of a term.
- _wc_term_recount() : mixed
- Function for recounting product terms, ignoring hidden products.
- wc_recount_after_stock_change() : mixed
- Recount terms after the stock amount changes.
- wc_change_term_counts() : array<string|int, mixed>
- Overrides the original term count for product categories and tags with the product count.
- wc_get_term_product_ids() : array<string|int, mixed>
- Return products in a given term, and cache value.
- wc_clear_term_product_ids() : mixed
- When a post is updated and terms recounted (called by _update_post_term_count), clear the ids.
- wc_get_product_visibility_term_ids() : array<string|int, int>
- Get full list of product visibility term ids.
- wc_recount_all_terms() : void
- Recounts all terms.
- _wc_recount_terms_by_product() : void
- Recounts terms by product.
- wc_update_200_file_paths() : void
- Update file paths for 2.0
- wc_update_200_permalinks() : void
- Update permalinks for 2.0
- wc_update_200_subcat_display() : void
- Update sub-category display options for 2.0
- wc_update_200_taxrates() : void
- Update tax rates for 2.0
- wc_update_200_line_items() : void
- Update order item line items for 2.0
- wc_update_200_images() : void
- Update image settings for 2.0
- wc_update_200_db_version() : void
- Update DB version for 2.0
- wc_update_209_brazillian_state() : void
- Update Brazilian States for 2.0.9
- wc_update_209_db_version() : void
- Update DB version for 2.0.9
- wc_update_210_remove_pages() : void
- Remove pages for 2.1
- wc_update_210_file_paths() : void
- Update file paths to support multiple files for 2.1
- wc_update_210_db_version() : void
- Update DB version for 2.1
- wc_update_220_shipping() : void
- Update shipping options for 2.2
- wc_update_220_order_status() : void
- Update order statuses for 2.2
- wc_update_220_variations() : void
- Update variations for 2.2
- wc_update_220_attributes() : void
- Update attributes for 2.2
- wc_update_220_db_version() : void
- Update DB version for 2.2
- wc_update_230_options() : void
- Update options for 2.3
- wc_update_230_db_version() : void
- Update DB version for 2.3
- wc_update_240_options() : void
- Update calc discount options for 2.4
- wc_update_240_shipping_methods() : void
- Update shipping methods for 2.4
- wc_update_240_api_keys() : void
- Update API keys for 2.4
- wc_update_240_webhooks() : void
- Update webhooks for 2.4
- wc_update_240_refunds() : void
- Update refunds for 2.4
- wc_update_240_db_version() : void
- Update DB version for 2.4
- wc_update_241_variations() : void
- Update variations for 2.4.1
- wc_update_241_db_version() : void
- Update DB version for 2.4.1
- wc_update_250_currency() : void
- Update currency settings for 2.5
- wc_update_250_db_version() : void
- Update DB version for 2.5
- wc_update_260_options() : void
- Update ship to countries options for 2.6
- wc_update_260_termmeta() : void
- Update term meta for 2.6
- wc_update_260_zones() : void
- Update zones for 2.6
- wc_update_260_zone_methods() : void
- Update zone methods for 2.6
- wc_update_260_refunds() : void
- Update refunds for 2.6
- wc_update_260_db_version() : void
- Update DB version for 2.6
- wc_update_300_webhooks() : void
- Update webhooks for 3.0
- wc_update_300_comment_type_index() : mixed
- Add an index to the field comment_type to improve the response time of the query used by WC_Comments::wp_count_comments() to get the number of comments by type.
- wc_update_300_grouped_products() : void
- Update grouped products for 3.0
- wc_update_300_settings() : void
- Update shipping tax classes for 3.0
- wc_update_300_product_visibility() : mixed
- Convert meta values into term for product visibility.
- wc_update_300_db_version() : mixed
- Update DB Version.
- wc_update_310_downloadable_products() : mixed
- Add an index to the downloadable product permissions table to improve performance of update_user_by_order_id.
- wc_update_310_old_comments() : mixed
- Find old order notes and ensure they have the correct type for exclusion.
- wc_update_310_db_version() : mixed
- Update DB Version.
- wc_update_312_shop_manager_capabilities() : mixed
- Update shop_manager capabilities.
- wc_update_312_db_version() : mixed
- Update DB Version.
- wc_update_320_mexican_states() : mixed
- Update state codes for Mexico.
- wc_update_320_db_version() : mixed
- Update DB Version.
- wc_update_330_image_options() : mixed
- Update image settings to use new aspect ratios and widths.
- wc_update_330_webhooks() : mixed
- Migrate webhooks from post type to CRUD.
- wc_update_330_set_default_product_cat() : mixed
- Assign default cat to all products with no cats.
- wc_update_330_product_stock_status() : mixed
- Update product stock status to use the new onbackorder status.
- wc_update_330_clear_transients() : mixed
- Clear addons page transients
- wc_update_330_set_paypal_sandbox_credentials() : mixed
- Set PayPal's sandbox credentials.
- wc_update_330_db_version() : mixed
- Update DB Version.
- wc_update_340_states() : mixed
- Update state codes for Ireland and BD.
- wc_update_340_state() : bool
- Update next state in the queue.
- wc_update_340_last_active() : mixed
- Set last active prop for users.
- wc_update_340_db_version() : mixed
- Update DB Version.
- wc_update_343_cleanup_foreign_keys() : void
- Remove duplicate foreign keys
- wc_update_343_db_version() : void
- Update DB version.
- wc_update_344_recreate_roles() : void
- Recreate user roles so existing users will get the new capabilities.
- wc_update_344_db_version() : void
- Update DB version.
- wc_update_350_reviews_comment_type() : mixed
- Set the comment type to 'review' for product reviews that don't have a comment type.
- wc_update_350_db_version() : mixed
- Update DB Version.
- wc_update_352_drop_download_log_fk() : void
- Drop the fk_wc_download_log_permission_id FK as we use a new one with the table and blog prefix for MS compatibility.
- wc_update_354_modify_shop_manager_caps() : mixed
- Remove edit_user capabilities from shop managers and use "translated" capabilities instead.
- wc_update_354_db_version() : mixed
- Update DB Version.
- wc_update_360_product_lookup_tables() : mixed
- Update product lookup tables in bulk.
- wc_update_360_term_meta() : mixed
- Renames ordering meta to be consistent across taxonomies.
- wc_update_360_downloadable_product_permissions_index() : void
- Add new user_order_remaining_expires to speed up user download permission fetching.
- wc_update_360_db_version() : mixed
- Update DB Version.
- wc_update_370_tax_rate_classes() : void
- Put tax classes into a DB table.
- wc_update_370_mro_std_currency() : void
- Update currency settings for 3.7.0
- wc_update_370_db_version() : mixed
- Update DB Version.
- wc_update_390_move_maxmind_database() : mixed
- We've moved the MaxMind database to a new location, as per the TOS' requirement that the database not be publicly accessible.
- wc_update_390_change_geolocation_database_update_cron() : mixed
- So that we can best meet MaxMind's TOS, the geolocation database update cron should run once per 15 days.
- wc_update_390_db_version() : mixed
- Update DB version.
- wc_update_400_increase_size_of_column() : mixed
- Increase column size
- wc_update_400_reset_action_scheduler_migration_status() : mixed
- Reset ActionScheduler migration status. Needs AS >= 3.0 shipped with WC >= 4.0.
- wc_update_400_db_version() : mixed
- Update DB version.
- wc_update_440_insert_attribute_terms_for_variable_products() : bool
- Register attributes as terms for variable products, in increments of 100 products.
- wc_update_440_db_version() : mixed
- Update DB version.
- wc_update_450_db_version() : mixed
- Update DB version to 4.5.0.
- wc_update_450_sanitize_coupons_code() : bool
- Sanitize all coupons code.
- wc_update_500_fix_product_review_count() : mixed
- Fixes product review count that might have been incorrect.
- wc_update_500_db_version() : mixed
- Update DB version to 5.0.0.
- wc_update_560_create_refund_returns_page() : mixed
- Creates the refund and returns policy page.
- wc_update_560_db_version() : mixed
- Update DB version to 5.6.0.
- wc_update_600_migrate_rate_limit_options() : mixed
- Migrate rate limit options to the new table.
- wc_update_600_db_version() : mixed
- Update DB version to 6.0.0.
- wc_update_630_create_product_attributes_lookup_table() : false
- Create the product attributes lookup table and initiate its filling, unless the table had been already created manually (via the tools page).
- wc_update_630_db_version() : mixed
- Update DB version to 6.3.0.
- wc_update_640_add_primary_key_to_product_attributes_lookup_table() : bool
- Create the primary key for the product attributes lookup table if it doesn't exist already.
- wc_update_640_db_version() : mixed
- Update DB version to 6.4.0.
- wc_update_650_approved_download_directories() : mixed
- Add the standard WooCommerce upload directories to the Approved Product Download Directories list and start populating it based on existing product download URLs, but do not enable the feature (for existing installations, a site admin should review and make a conscious decision to enable).
- wc_update_651_approved_download_directories() : mixed
- In some cases, the approved download directories table may not have been successfully created during the update to 6.5.0. If this was the case we will need to re-initialize the feature.
- wc_update_670_purge_comments_count_cache() : mixed
- Purges the comments count cache after 6.7.0 split reviews from the comments page.
- wc_update_700_remove_download_log_fk() : void
- Remove unnecessary foreign keys.
- wc_update_700_remove_recommended_marketing_plugins_transient() : mixed
- Remove the transient data for recommended marketing extensions.
- wc_update_721_adjust_new_zealand_states() : mixed
- Update the New Zealand state codes in the database after they were updated in code to the CLDR standard.
- wc_update_721_adjust_ukraine_states() : mixed
- Update the Ukraine state codes in the database after they were updated in code to the CLDR standard.
- wc_update_722_adjust_new_zealand_states() : mixed
- Update the New Zealand state codes in the database after they were updated in code to the CLDR standard.
- wc_update_722_adjust_ukraine_states() : mixed
- Update the Ukraine state codes in the database after they were updated in code to the CLDR standard.
- wc_update_750_add_columns_to_order_stats_table() : mixed
- Add new columns date_paid and date_completed to wp_wc_order_stats table in order to provide the option of using the dates in the reports
- wc_update_750_disable_new_product_management_experience() : void
- Disable the experimental product management experience.
- wc_update_770_remove_multichannel_marketing_feature_options() : mixed
- Remove the multichannel marketing feature flag and options. This feature is now enabled by default.
- wc_update_810_migrate_transactional_metadata_for_hpos() : bool
- Migrate transaction data which was being incorrectly stored in the postmeta table to HPOS tables.
- wc_update_860_remove_recommended_marketing_plugins_transient() : mixed
- Remove the transient data for recommended marketing extensions.
- wc_update_870_prevent_listing_of_transient_files_directory() : mixed
- Create an .htaccess file and an empty index.html file to prevent listing of the default transient files directory, if the directory exists.
- wc_update_890_update_connect_to_woocommerce_note() : mixed
- If it exists, remove and recreate the inbox note that asks users to connect to `Woo.com` so that the domain name is changed to the updated `WooCommerce.com`.
- wc_update_890_update_paypal_standard_load_eligibility() : mixed
- Disables the PayPal Standard gateway for stores that aren't using it.
- wc_update_891_create_plugin_autoinstall_history_option() : mixed
- Create the woocommerce_history_of_autoinstalled_plugins option if it doesn't exist as a copy of woocommerce_autoinstalled_plugins if it exists.
- wc_update_910_add_launch_your_store_tour_option() : mixed
- Add woocommerce_show_lys_tour.
- wc_update_910_remove_obsolete_user_meta() : void
- Remove user meta associated with the keys '_last_order', '_order_count' and '_money_spent'.
- wc_disable_admin_bar() : bool
- Prevent any user who cannot 'edit_posts' (subscribers, customers etc) from seeing the admin bar.
- wc_create_new_customer() : int|WP_Error
- Create a new customer.
- wc_create_new_customer_username() : string
- Create a unique username for a new customer.
- wc_set_customer_auth_cookie() : mixed
- Login a customer (set auth cookie and set global user object).
- wc_update_new_customer_past_orders() : int
- Get past orders (by email) and update them.
- wc_paying_customer() : mixed
- Order payment completed - This is a paying customer.
- wc_customer_bought_product() : bool
- Checks if a user (by email or ID or both) has bought an item.
- wc_current_user_has_role() : bool
- Checks if the current user has a role.
- wc_user_has_role() : bool
- Checks if a user has a role.
- wc_customer_has_capability() : array<string|int, mixed>
- Checks if a user has a certain capability.
- wc_shop_manager_has_capability() : array<string|int, bool>
- Safe way of allowing shop managers restricted capabilities that will remove access to the capabilities if WooCommerce is deactivated.
- wc_modify_editable_roles() : array<string|int, mixed>
- Modify the list of editable roles to prevent non-admin adding admin users.
- wc_modify_map_meta_cap() : array<string|int, mixed>
- Modify capabilities to prevent non-admin users editing admin users.
- wc_get_customer_download_permissions() : array<string|int, mixed>
- Get customer download permissions from the database.
- wc_get_customer_available_downloads() : array<string|int, mixed>
- Get customer available downloads.
- wc_get_customer_total_spent() : string
- Get total spent by customer.
- wc_get_customer_order_count() : int
- Get total orders by customer.
- wc_reset_order_customer_id_on_deleted_user() : mixed
- Reset _customer_user on orders when a user is deleted.
- wc_review_is_from_verified_owner() : bool
- Get review verification status.
- wc_disable_author_archives_for_customers() : mixed
- Disable author archives for customers.
- wc_update_profile_last_update_time() : mixed
- Hooks into the `profile_update` hook to set the user last updated timestamp.
- wc_meta_update_last_update_time() : mixed
- Hooks into the update user meta function to set the user last updated timestamp.
- wc_set_user_last_update_time() : mixed
- Sets a user's "last update" time to the current timestamp.
- wc_get_customer_saved_methods_list() : array<string|int, mixed>
- Get customer saved payment methods list.
- wc_get_customer_last_order() : WC_Order|bool
- Get info about customer's last order.
- wc_user_search_columns() : array<string|int, mixed>
- Add support for searching by display_name.
- wc_delete_user_data() : mixed
- When a user is deleted in WordPress, delete corresponding WooCommerce data.
- wc_maybe_store_user_agent() : mixed
- Store user agents. Used for tracker.
- wc_user_logged_in() : mixed
- Update logic triggered on login.
- wc_current_user_is_active() : mixed
- Update when the user was last active.
- wc_update_user_last_active() : mixed
- Set the user last active timestamp to now.
- wc_translate_user_roles() : string
- Translate WC roles using the woocommerce textdomain.
- wc_webhook_execute_queue() : mixed
- Process the web hooks at the end of the request.
- wc_webhook_process_delivery() : mixed
- Process webhook delivery.
- wc_deliver_webhook_async() : mixed
- Wrapper function to execute the `woocommerce_deliver_webhook_async` cron.
- wc_is_webhook_valid_topic() : bool
- Check if the given topic is a valid webhook topic, a topic is valid if:
- wc_is_webhook_valid_status() : bool
- Check if given status is a valid webhook status.
- wc_get_webhook_statuses() : array<string|int, mixed>
- Get Webhook statuses.
- wc_load_webhooks() : bool
- Load webhooks.
- wc_get_webhook() : WC_Webhook|null
- Get webhook.
- wc_get_webhook_rest_api_versions() : array<string|int, mixed>
- Get webhoook REST API versions.
- wc_register_widgets() : mixed
- Register Widgets.
Functions
wc_lostpassword_url()
Returns the url to the lost password endpoint url.
wc_lostpassword_url([string $default_url = '' ]) : string
Parameters
- $default_url : string = ''
-
Default lost password URL.
wc_customer_edit_account_url()
Get the link to the edit account details page.
wc_customer_edit_account_url() : string
wc_edit_address_i18n()
Get the edit address slug translation.
wc_edit_address_i18n(string $id[, bool $flip = false ]) : string
Parameters
- $id : string
-
Address ID.
- $flip : bool = false
-
Flip the array to make it possible to retrieve the values ​​from both sides.
wc_get_account_menu_items()
Get My Account menu items.
wc_get_account_menu_items() : array<string|int, mixed>
Tags
wc_get_account_menu_item_classes()
Get account menu item classes.
wc_get_account_menu_item_classes(string $endpoint) : string
Parameters
- $endpoint : string
-
Endpoint.
Tags
wc_get_account_endpoint_url()
Get account endpoint URL.
wc_get_account_endpoint_url(string $endpoint) : string
Parameters
- $endpoint : string
-
Endpoint.
Tags
wc_get_account_orders_columns()
Get My Account > Orders columns.
wc_get_account_orders_columns() : array<string|int, mixed>
Tags
wc_get_account_downloads_columns()
Get My Account > Downloads columns.
wc_get_account_downloads_columns() : array<string|int, mixed>
Tags
wc_get_account_payment_methods_columns()
Get My Account > Payment methods columns.
wc_get_account_payment_methods_columns() : array<string|int, mixed>
Tags
wc_get_account_payment_methods_types()
Get My Account > Payment methods types
wc_get_account_payment_methods_types() : array<string|int, mixed>
Tags
wc_get_account_orders_actions()
Get account orders actions.
wc_get_account_orders_actions(int|WC_Order $order) : array<string|int, mixed>
Parameters
- $order : int|WC_Order
-
Order instance or ID.
Tags
wc_get_account_formatted_address()
Get account formatted address.
wc_get_account_formatted_address([string $address_type = 'billing' ], int $customer_id) : string
Parameters
- $address_type : string = 'billing'
-
Type of address; 'billing' or 'shipping'.
- $customer_id : int
-
Customer ID. Defaults to 0.
Tags
wc_get_account_saved_payment_methods_list()
Returns an array of a user's saved payments list for output on the account tab.
wc_get_account_saved_payment_methods_list(array<string|int, mixed> $list, int $customer_id) : array<string|int, mixed>
Parameters
- $list : array<string|int, mixed>
-
List of payment methods passed from wc_get_customer_saved_methods_list().
- $customer_id : int
-
The customer to fetch payment methods for.
Tags
wc_get_account_saved_payment_methods_list_item_cc()
Controls the output for credit cards on the my account page.
wc_get_account_saved_payment_methods_list_item_cc(array<string|int, mixed> $item, WC_Payment_Token $payment_token) : array<string|int, mixed>
Parameters
- $item : array<string|int, mixed>
-
Individual list item from woocommerce_saved_payment_methods_list.
- $payment_token : WC_Payment_Token
-
The payment token associated with this method entry.
Tags
wc_get_account_saved_payment_methods_list_item_echeck()
Controls the output for eChecks on the my account page.
wc_get_account_saved_payment_methods_list_item_echeck(array<string|int, mixed> $item, WC_Payment_Token $payment_token) : array<string|int, mixed>
Parameters
- $item : array<string|int, mixed>
-
Individual list item from woocommerce_saved_payment_methods_list.
- $payment_token : WC_Payment_Token
-
The payment token associated with this method entry.
Tags
wc_get_text_attributes()
Gets text attributes from a string.
wc_get_text_attributes(string $raw_attributes) : array<string|int, mixed>
Parameters
- $raw_attributes : string
-
Raw attributes.
Tags
wc_get_text_attributes_filter_callback()
See if an attribute is actually valid.
wc_get_text_attributes_filter_callback(string $value) : bool
Parameters
- $value : string
-
Value.
Tags
wc_implode_text_attributes()
Implode an array of attributes using WC_DELIMITER.
wc_implode_text_attributes(array<string|int, mixed> $attributes) : string
Parameters
- $attributes : array<string|int, mixed>
-
Attributes list.
Tags
wc_get_attribute_taxonomies()
Get attribute taxonomies.
wc_get_attribute_taxonomies() : array<string|int, mixed>
wc_get_attribute_taxonomy_ids()
Get (cached) attribute taxonomy ID and name pairs.
wc_get_attribute_taxonomy_ids() : array<string|int, mixed>
Tags
wc_get_attribute_taxonomy_labels()
Get (cached) attribute taxonomy label and name pairs.
wc_get_attribute_taxonomy_labels() : array<string|int, mixed>
Tags
wc_attribute_taxonomy_name()
Get a product attribute name.
wc_attribute_taxonomy_name(string $attribute_name) : string
Parameters
- $attribute_name : string
-
Attribute name.
wc_variation_attribute_name()
Get the attribute name used when storing values in post meta.
wc_variation_attribute_name(string $attribute_name) : string
Parameters
- $attribute_name : string
-
Attribute name.
Tags
wc_attribute_taxonomy_name_by_id()
Get a product attribute name by ID.
wc_attribute_taxonomy_name_by_id(int $attribute_id) : string
Parameters
- $attribute_id : int
-
Attribute ID.
Tags
wc_attribute_taxonomy_id_by_name()
Get a product attribute ID by name.
wc_attribute_taxonomy_id_by_name(string $name) : int
Parameters
- $name : string
-
Attribute name.
Tags
wc_attribute_label()
Get a product attributes label.
wc_attribute_label(string $name[, WC_Product $product = '' ]) : string
Parameters
- $name : string
-
Attribute name.
- $product : WC_Product = ''
-
Product data.
wc_attribute_orderby()
Get a product attributes orderby setting.
wc_attribute_orderby(string $name) : string
Parameters
- $name : string
-
Attribute name.
wc_get_attribute_taxonomy_names()
Get an array of product attribute taxonomies.
wc_get_attribute_taxonomy_names() : array<string|int, mixed>
wc_get_attribute_types()
Get attribute types.
wc_get_attribute_types() : array<string|int, mixed>
Tags
wc_has_custom_attribute_types()
Check if there are custom attribute types.
wc_has_custom_attribute_types() : bool
Tags
wc_get_attribute_type_label()
Get attribute type label.
wc_get_attribute_type_label(string $type) : string
Parameters
- $type : string
-
Attribute type slug.
Tags
wc_check_if_attribute_name_is_reserved()
Check if attribute name is reserved.
wc_check_if_attribute_name_is_reserved(string $attribute_name) : bool
https://codex.wordpress.org/Function_Reference/register_taxonomy#Reserved_Terms.
Parameters
- $attribute_name : string
-
Attribute name.
Tags
wc_attributes_array_filter_visible()
Callback for array filter to get visible only.
wc_attributes_array_filter_visible(WC_Product_Attribute $attribute) : bool
Parameters
- $attribute : WC_Product_Attribute
-
Attribute data.
Tags
wc_attributes_array_filter_variation()
Callback for array filter to get variation attributes only.
wc_attributes_array_filter_variation(WC_Product_Attribute $attribute) : bool
Parameters
- $attribute : WC_Product_Attribute
-
Attribute data.
Tags
wc_is_attribute_in_product_name()
Check if an attribute is included in the attributes area of a variation name.
wc_is_attribute_in_product_name(string $attribute, string $name) : bool
Parameters
- $attribute : string
-
Attribute value to check for.
- $name : string
-
Product name to check in.
Tags
wc_array_filter_default_attributes()
Callback for array filter to get default attributes. Will allow for '0' string values, but regard all other class PHP FALSE equivalents normally.
wc_array_filter_default_attributes(mixed $attribute) : bool
Parameters
- $attribute : mixed
-
Attribute being considered for exclusion from parent array.
Tags
wc_get_attribute()
Get attribute data by ID.
wc_get_attribute(int $id) : stdClass|null
Parameters
- $id : int
-
Attribute ID.
Tags
wc_create_attribute()
Create attribute.
wc_create_attribute(array<string|int, mixed> $args) : int|WP_Error
Parameters
- $args : array<string|int, mixed>
-
Attribute arguments { Array of attribute parameters.
@type int $id Unique identifier, used to update an attribute. @type string $name Attribute name. Always required. @type string $slug Attribute alphanumeric identifier. @type string $type Type of attribute. Core by default accepts: 'select' and 'text'. Default to 'select'. @type string $order_by Sort order. Accepts: 'menu_order', 'name', 'name_num' and 'id'. Default to 'menu_order'. @type bool $has_archives Enable or disable attribute archives. False by default.
}
Tags
wc_update_attribute()
Update an attribute.
wc_update_attribute(int $id, array<string|int, mixed> $args) : int|WP_Error
For available args see wc_create_attribute().
Parameters
- $id : int
-
Attribute ID.
- $args : array<string|int, mixed>
-
Attribute arguments.
Tags
wc_delete_attribute()
Delete attribute by ID.
wc_delete_attribute(int $id) : bool
Parameters
- $id : int
-
Attribute ID.
Tags
wc_attribute_taxonomy_slug()
Get an unprefixed product attribute name.
wc_attribute_taxonomy_slug(string $attribute_name) : string
Parameters
- $attribute_name : string
-
Attribute name.
Tags
wc_protected_product_add_to_cart()
Prevent password protected products being added to the cart.
wc_protected_product_add_to_cart(bool $passed, int $product_id) : bool
Parameters
- $passed : bool
-
Validation.
- $product_id : int
-
Product ID.
wc_empty_cart()
Clears the cart session when called.
wc_empty_cart() : mixed
wc_load_persistent_cart()
Load the persistent cart.
wc_load_persistent_cart(string $user_login, WP_User $user) : mixed
Parameters
- $user_login : string
-
User login.
- $user : WP_User
-
User data.
Tags
wc_get_raw_referer()
Retrieves unvalidated referer from '_wp_http_referer' or HTTP referer.
wc_get_raw_referer() : string|false
Do not use for redirects, use {@see} instead.
Tags
wc_add_to_cart_message()
Add to cart messages.
wc_add_to_cart_message(int|array<string|int, mixed> $products[, bool $show_qty = false ][, bool $return = false ]) : mixed
Parameters
- $products : int|array<string|int, mixed>
-
Product ID list or single product ID.
- $show_qty : bool = false
-
Should quantities be shown? Added in 2.6.0.
- $return : bool = false
-
Return message rather than add it.
wc_format_list_of_items()
Comma separate a list of item names, and replace final comma with 'and'.
wc_format_list_of_items(array<string|int, mixed> $items) : string
Parameters
- $items : array<string|int, mixed>
-
Cart items.
wc_clear_cart_after_payment()
Clear cart after payment.
wc_clear_cart_after_payment() : mixed
wc_cart_totals_subtotal_html()
Get the subtotal.
wc_cart_totals_subtotal_html() : mixed
wc_cart_totals_shipping_html()
Get shipping methods.
wc_cart_totals_shipping_html() : mixed
wc_cart_totals_taxes_total_html()
Get taxes total.
wc_cart_totals_taxes_total_html() : mixed
wc_cart_totals_coupon_label()
Get a coupon label.
wc_cart_totals_coupon_label(string|WC_Coupon $coupon[, bool $echo = true ]) : string
Parameters
- $coupon : string|WC_Coupon
-
Coupon data or code.
- $echo : bool = true
-
Echo or return.
wc_cart_totals_coupon_html()
Get coupon display HTML.
wc_cart_totals_coupon_html(string|WC_Coupon $coupon) : mixed
Parameters
- $coupon : string|WC_Coupon
-
Coupon data or code.
wc_cart_totals_order_total_html()
Get order total html including inc tax if needed.
wc_cart_totals_order_total_html() : mixed
wc_cart_totals_fee_html()
Get the fee value.
wc_cart_totals_fee_html(object $fee) : mixed
Parameters
- $fee : object
-
Fee data.
wc_cart_totals_shipping_method_label()
Get a shipping methods full label including price.
wc_cart_totals_shipping_method_label(WC_Shipping_Rate $method) : string
Parameters
- $method : WC_Shipping_Rate
-
Shipping method rate data.
wc_cart_round_discount()
Round discount.
wc_cart_round_discount(float $value, int $precision) : float
Parameters
- $value : float
-
Amount to round.
- $precision : int
-
DP to round.
wc_get_chosen_shipping_method_ids()
Gets chosen shipping method IDs from chosen_shipping_methods session, without instance IDs.
wc_get_chosen_shipping_method_ids() : array<string|int, string>
Tags
wc_get_chosen_shipping_method_for_package()
Get chosen method for package from session.
wc_get_chosen_shipping_method_for_package(int $key, array<string|int, mixed> $package) : string|bool
Parameters
- $key : int
-
Key of package.
- $package : array<string|int, mixed>
-
Package data array.
Tags
wc_get_default_shipping_method_for_package()
Choose the default method for a package.
wc_get_default_shipping_method_for_package(int $key, array<string|int, mixed> $package, string $chosen_method) : string
Parameters
- $key : int
-
Key of package.
- $package : array<string|int, mixed>
-
Package data array.
- $chosen_method : string
-
Chosen shipping method. e.g. flat_rate:1.
Tags
wc_shipping_methods_have_changed()
See if the methods have changed since the last request.
wc_shipping_methods_have_changed(int $key, array<string|int, mixed> $package) : bool
Parameters
- $key : int
-
Key of package.
- $package : array<string|int, mixed>
-
Package data array.
Tags
wc_get_cart_item_data_hash()
Gets a hash of important product data that when changed should cause cart items to be invalidated.
wc_get_cart_item_data_hash(WC_Product $product) : string
The woocommerce_cart_item_data_to_validate filter can be used to add custom properties.
Parameters
- $product : WC_Product
-
Product object.
is_woocommerce()
Is_woocommerce - Returns true if on a page which uses WooCommerce templates (cart and checkout are standard pages with shortcodes and thus are not included).
is_woocommerce() : bool
is_shop()
Is_shop - Returns true when viewing the product type archive (shop).
is_shop() : bool
is_product_taxonomy()
Is_product_taxonomy - Returns true when viewing a product taxonomy archive.
is_product_taxonomy() : bool
is_product_category()
Is_product_category - Returns true when viewing a product category.
is_product_category([string $term = '' ]) : bool
Parameters
- $term : string = ''
-
(default: '') The term slug your checking for. Leave blank to return true on any.
is_product_tag()
Is_product_tag - Returns true when viewing a product tag.
is_product_tag([string $term = '' ]) : bool
Parameters
- $term : string = ''
-
(default: '') The term slug your checking for. Leave blank to return true on any.
is_product()
Is_product - Returns true when viewing a single product.
is_product() : bool
is_cart()
Is_cart - Returns true when viewing the cart page.
is_cart() : bool
is_checkout()
Is_checkout - Returns true when viewing the checkout page, or when processing AJAX requests for updating or processing the checkout.
is_checkout() : bool
is_checkout_pay_page()
Is_checkout_pay - Returns true when viewing the checkout's pay page.
is_checkout_pay_page() : bool
is_wc_endpoint_url()
Is_wc_endpoint_url - Check if an endpoint is showing.
is_wc_endpoint_url([string|false $endpoint = false ]) : bool
Parameters
- $endpoint : string|false = false
-
Whether endpoint.
is_account_page()
Is_account_page - Returns true when viewing an account page.
is_account_page() : bool
is_view_order_page()
Is_view_order_page - Returns true when on the view order page.
is_view_order_page() : bool
is_edit_account_page()
Check for edit account page.
is_edit_account_page() : bool
Returns true when viewing the edit account page.
Tags
is_order_received_page()
Is_order_received_page - Returns true when viewing the order received page.
is_order_received_page() : bool
is_add_payment_method_page()
Is_add_payment_method_page - Returns true when viewing the add payment method page.
is_add_payment_method_page() : bool
is_lost_password_page()
Is_lost_password_page - Returns true when viewing the lost password page.
is_lost_password_page() : bool
is_ajax()
Is_ajax - Returns true when the page is loaded via ajax.
is_ajax() : bool
Tags
is_store_notice_showing()
Is_store_notice_showing - Returns true when store notice is active.
is_store_notice_showing() : bool
is_filtered()
Is_filtered - Returns true when filtering products using layered nav or price sliders.
is_filtered() : bool
taxonomy_is_product_attribute()
Returns true when the passed taxonomy name is a product attribute.
taxonomy_is_product_attribute(string $name) : bool
Parameters
- $name : string
-
of the attribute.
Tags
meta_is_product_attribute()
Returns true when the passed meta name is a product attribute.
meta_is_product_attribute(string $name, string $value, int $product_id) : bool
Parameters
- $name : string
-
of the attribute.
- $value : string
-
of the attribute.
- $product_id : int
-
to check for attribute.
wc_tax_enabled()
Are store-wide taxes enabled?
wc_tax_enabled() : bool
wc_shipping_enabled()
Is shipping enabled?
wc_shipping_enabled() : bool
wc_prices_include_tax()
Are prices inclusive of tax?
wc_prices_include_tax() : bool
wc_is_valid_url()
Simple check for validating a URL, it must start with http:// or https://.
wc_is_valid_url(string $url) : bool
and pass FILTER_VALIDATE_URL validation.
Parameters
- $url : string
-
to check.
wc_site_is_https()
Check if the home URL is https. If it is, we don't need to do things such as 'force ssl'.
wc_site_is_https() : bool
Tags
wc_checkout_is_https()
Check if the checkout is configured for https. Look at options, WP HTTPS plugin, or the permalink itself.
wc_checkout_is_https() : bool
Tags
wc_post_content_has_shortcode()
Checks whether the content passed contains a specific short code.
wc_post_content_has_shortcode([string $tag = '' ]) : bool
Parameters
- $tag : string = ''
-
Shortcode tag to check.
wc_reviews_enabled()
Check if reviews are enabled.
wc_reviews_enabled() : bool
Tags
wc_review_ratings_enabled()
Check if reviews ratings are enabled.
wc_review_ratings_enabled() : bool
Tags
wc_review_ratings_required()
Check if review ratings are required.
wc_review_ratings_required() : bool
Tags
wc_is_file_valid_csv()
Check if a CSV file is valid.
wc_is_file_valid_csv(string $file[, bool $check_path = true ]) : bool
Parameters
- $file : string
-
File name.
- $check_path : bool = true
-
If should check for the path.
Tags
wc_current_theme_is_fse_theme()
Check if the current theme is a block theme.
wc_current_theme_is_fse_theme() : bool
Tags
wc_current_theme_supports_woocommerce_or_fse()
Check if the current theme has WooCommerce support or is a FSE theme.
wc_current_theme_supports_woocommerce_or_fse() : bool
Tags
wc_wp_theme_get_element_class_name()
Given an element name, returns a class name.
wc_wp_theme_get_element_class_name(string $element) : string
If the WP-related function is not defined or current theme is not a FSE theme, return empty string.
Parameters
- $element : string
-
The name of the element.
Tags
wc_block_theme_has_styles_for_element()
Given an element name, returns true or false depending on whether the current theme has styles for that element defined in theme.json.
wc_block_theme_has_styles_for_element(string $element) : bool
If the theme is not a block theme or the WP-related function is not defined, return false.
Parameters
- $element : string
-
The name of the element.
Tags
wc_maybe_define_constant()
Define a constant if it is not already defined.
wc_maybe_define_constant(string $name, mixed $value) : mixed
Parameters
- $name : string
-
Constant name.
- $value : mixed
-
Value.
Tags
wc_create_order()
Create a new order programmatically.
wc_create_order([array<string|int, mixed> $args = array() ]) : WC_Order|WP_Error
Returns a new order object on success which can then be used to add additional data.
Parameters
- $args : array<string|int, mixed> = array()
-
Order arguments.
wc_update_order()
Update an order. Uses wc_create_order.
wc_update_order(array<string|int, mixed> $args) : WC_Order|WP_Error
Parameters
- $args : array<string|int, mixed>
-
Order arguments.
wc_tokenize_path()
Given a path, this will convert any of the subpaths into their corresponding tokens.
wc_tokenize_path(string $path, array<string|int, mixed> $path_tokens) : string
Parameters
- $path : string
-
The absolute path to tokenize.
- $path_tokens : array<string|int, mixed>
-
An array keyed with the token, containing paths that should be replaced.
Tags
wc_untokenize_path()
Given a tokenized path, this will expand the tokens to their full path.
wc_untokenize_path(string $path, array<string|int, mixed> $path_tokens) : string
Parameters
- $path : string
-
The absolute path to expand.
- $path_tokens : array<string|int, mixed>
-
An array keyed with the token, containing paths that should be expanded.
Tags
wc_get_path_define_tokens()
Fetches an array containing all of the configurable path constants to be used in tokenization.
wc_get_path_define_tokens() : array<string|int, mixed>
wc_get_template_part()
Get template part (for templates like the shop-loop).
wc_get_template_part(mixed $slug[, string $name = '' ]) : mixed
WC_TEMPLATE_DEBUG_MODE will prevent overrides in themes from taking priority.
Parameters
- $slug : mixed
-
Template slug.
- $name : string = ''
-
Template name (default: '').
wc_get_template()
Get other templates (e.g. product attributes) passing attributes and including the file.
wc_get_template(string $template_name[, array<string|int, mixed> $args = array() ][, string $template_path = '' ][, string $default_path = '' ]) : mixed
Parameters
- $template_name : string
-
Template name.
- $args : array<string|int, mixed> = array()
-
Arguments. (default: array).
- $template_path : string = ''
-
Template path. (default: '').
- $default_path : string = ''
-
Default path. (default: '').
wc_get_template_html()
Like wc_get_template, but returns the HTML instead of outputting.
wc_get_template_html(string $template_name[, array<string|int, mixed> $args = array() ][, string $template_path = '' ][, string $default_path = '' ]) : string
Parameters
- $template_name : string
-
Template name.
- $args : array<string|int, mixed> = array()
-
Arguments. (default: array).
- $template_path : string = ''
-
Template path. (default: '').
- $default_path : string = ''
-
Default path. (default: '').
Tags
wc_locate_template()
Locate a template and return the path for inclusion.
wc_locate_template(string $template_name[, string $template_path = '' ][, string $default_path = '' ]) : string
This is the load order:
yourtheme/$template_path/$template_name yourtheme/$template_name $default_path/$template_name
Parameters
- $template_name : string
-
Template name.
- $template_path : string = ''
-
Template path. (default: '').
- $default_path : string = ''
-
Default path. (default: '').
wc_set_template_cache()
Add a template to the template cache.
wc_set_template_cache(string $cache_key, string $template) : mixed
Parameters
- $cache_key : string
-
Object cache key.
- $template : string
-
Located template.
Tags
wc_clear_template_cache()
Clear the template cache.
wc_clear_template_cache() : mixed
Tags
get_woocommerce_currency()
Get Base Currency Code.
get_woocommerce_currency() : string
get_woocommerce_currencies()
Get full list of currency codes.
get_woocommerce_currencies() : array<string|int, mixed>
Currency symbols and names should follow the Unicode CLDR recommendation (https://cldr.unicode.org/translation/currency-names-and-symbols)
get_woocommerce_currency_symbols()
Get all available Currency symbols.
get_woocommerce_currency_symbols() : array<string|int, mixed>
Currency symbols and names should follow the Unicode CLDR recommendation (https://cldr.unicode.org/translation/currency-names-and-symbols)
Tags
get_woocommerce_currency_symbol()
Get Currency symbol.
get_woocommerce_currency_symbol([string $currency = '' ]) : string
Currency symbols and names should follow the Unicode CLDR recommendation (https://cldr.unicode.org/translation/currency-names-and-symbols)
Parameters
- $currency : string = ''
-
Currency. (default: '').
wc_mail()
Send HTML emails from WooCommerce.
wc_mail(mixed $to, mixed $subject, mixed $message[, string $headers = "Content-Type: text/html
" ][, string $attachments = '' ]) : bool
Parameters
- $to : mixed
-
Receiver.
- $subject : mixed
-
Subject.
- $message : mixed
-
Message.
- $headers : string = "Content-Type: text/html "
-
Headers. (default: "Content-Type: text/html\r\n").
- $attachments : string = ''
-
Attachments. (default: "").
wc_get_theme_support()
Return "theme support" values from the current theme, if set.
wc_get_theme_support([string $prop = '' ][, mixed $default = null ]) : mixed
Parameters
- $prop : string = ''
-
Name of prop (or key::subkey for arrays of props) if you want a specific value. Leave blank to get all props as an array.
- $default : mixed = null
-
Optional value to return if the theme does not declare support for a prop.
Tags
wc_get_image_size()
Get an image size by name or defined dimensions.
wc_get_image_size(array<string|int, mixed>|string $image_size) : array<string|int, mixed>
The returned variable is filtered by woocommerce_get_image_size_{image_size} filter to allow 3rd party customisation.
Sizes defined by the theme take priority over settings. Settings are hidden when a theme defines sizes.
Parameters
- $image_size : array<string|int, mixed>|string
-
Name of the image size to get, or an array of dimensions.
wc_enqueue_js()
Queue some JavaScript code to be output in the footer.
wc_enqueue_js(string $code) : mixed
Parameters
- $code : string
-
Code.
wc_print_js()
Output any queued javascript code in the footer.
wc_print_js() : mixed
wc_setcookie()
Set a cookie - wrapper for setcookie using WP constants.
wc_setcookie(string $name, string $value, int $expire[, bool $secure = false ][, bool $httponly = false ]) : mixed
Parameters
- $name : string
-
Name of the cookie being set.
- $value : string
-
Value of the cookie.
- $expire : int
-
Expiry of the cookie.
- $secure : bool = false
-
Whether the cookie should be served only over https.
- $httponly : bool = false
-
Whether the cookie is only accessible over HTTP, not scripting languages like JavaScript. @since 3.6.0.
get_woocommerce_api_url()
Get the URL to the WooCommerce Legacy REST API.
get_woocommerce_api_url(string $path) : string
Note that as of WooCommerce 9.0 the WooCommerce Legacy REST API has been moved to a dedicated extension, and the implementation of its root endpoint in WooCommerce core is now just a stub that will always return an error. See the setup_legacy_api_stub method in includes/class-woocommerce.php and: https://developer.woocommerce.com/2023/10/03/the-legacy-rest-api-will-move-to-a-dedicated-extension-in-woocommerce-9-0/
Parameters
- $path : string
-
an endpoint to include in the URL.
Tags
wc_get_page_children()
Recursively get page children.
wc_get_page_children(int $page_id) : array<string|int, int>
Parameters
- $page_id : int
-
Page ID.
flush_rewrite_rules_on_shop_page_save()
Flushes rewrite rules when the shop page (or it's children) gets saved.
flush_rewrite_rules_on_shop_page_save() : mixed
wc_fix_rewrite_rules()
Various rewrite rule fixes.
wc_fix_rewrite_rules(array<string|int, mixed> $rules) : array<string|int, mixed>
Parameters
- $rules : array<string|int, mixed>
-
Rules.
Tags
wc_fix_product_attachment_link()
Prevent product attachment links from breaking when using complex rewrite structures.
wc_fix_product_attachment_link(string $link, int $post_id) : string
Parameters
- $link : string
-
Link.
- $post_id : int
-
Post ID.
wc_ms_protect_download_rewite_rules()
Protect downloads from ms-files.php in multisite.
wc_ms_protect_download_rewite_rules(string $rewrite) : string
Parameters
- $rewrite : string
-
rewrite rules.
wc_format_country_state_string()
Formats a string in the format COUNTRY:STATE into an array.
wc_format_country_state_string(string $country_string) : array<string|int, mixed>
Parameters
- $country_string : string
-
Country string.
Tags
wc_get_base_location()
Get the store's base location.
wc_get_base_location() : array<string|int, mixed>
Tags
wc_get_customer_default_location()
Get the customer's default location.
wc_get_customer_default_location() : array<string|int, mixed>
Filtered, and set to base location or left blank. If cache-busting, this should only be used when 'location' is set in the querystring.
Tags
wc_get_user_agent()
Get user agent string.
wc_get_user_agent() : string
Tags
wc_rand_hash()
Generate a rand hash.
wc_rand_hash() : string
Tags
wc_api_hash()
WC API - Hash.
wc_api_hash(string $data) : string
Parameters
- $data : string
-
Message to be hashed.
Tags
wc_array_cartesian()
Find all possible combinations of values from the input array and return in a logical order.
wc_array_cartesian(array<string|int, mixed> $input) : array<string|int, mixed>
Parameters
- $input : array<string|int, mixed>
-
Input.
Tags
wc_transaction_query()
Run a MySQL transaction query, if supported.
wc_transaction_query([string $type = 'start' ][, bool $force = false ]) : mixed
Parameters
- $type : string = 'start'
-
Types: start (default), commit, rollback.
- $force : bool = false
-
use of transactions.
Tags
wc_get_cart_url()
Gets the url to the cart page.
wc_get_cart_url() : string
Tags
wc_get_checkout_url()
Gets the url to the checkout page.
wc_get_checkout_url() : string
Tags
woocommerce_register_shipping_method()
Register a shipping method.
woocommerce_register_shipping_method(string|object $shipping_method) : mixed
Parameters
- $shipping_method : string|object
-
class name (string) or a class object.
Tags
wc_get_shipping_zone()
Get the shipping zone matching a given package from the cart.
wc_get_shipping_zone(array<string|int, mixed> $package) : WC_Shipping_Zone
Parameters
- $package : array<string|int, mixed>
-
Shipping package.
Tags
wc_get_credit_card_type_label()
Get a nice name for credit card providers.
wc_get_credit_card_type_label(string $type) : string
Parameters
- $type : string
-
Provider Slug/Type.
Tags
wc_back_link()
Outputs a "back" link so admin screens can easily jump back a page.
wc_back_link(string $label, string $url) : mixed
Parameters
- $label : string
-
Title of the page to return to.
- $url : string
-
URL of the page to return to.
wc_help_tip()
Display a WooCommerce help tip.
wc_help_tip(string $tip[, bool $allow_html = false ]) : string
Parameters
- $tip : string
-
Help tip text.
- $allow_html : bool = false
-
Allow sanitized HTML if true or escape.
Tags
wc_get_wildcard_postcodes()
Return a list of potential postcodes for wildcard searching.
wc_get_wildcard_postcodes(string $postcode[, string $country = '' ]) : array<string|int, string>
Parameters
- $postcode : string
-
Postcode.
- $country : string = ''
-
Country to format postcode for matching.
Tags
wc_postcode_location_matcher()
Used by shipping zones and taxes to compare a given $postcode to stored postcodes to find matches for numerical ranges, and wildcards.
wc_postcode_location_matcher(string $postcode, array<string|int, mixed> $objects, string $object_id_key, string $object_compare_key[, string $country = '' ]) : array<string|int, mixed>
Parameters
- $postcode : string
-
Postcode you want to match against stored postcodes.
- $objects : array<string|int, mixed>
-
Array of postcode objects from Database.
- $object_id_key : string
-
DB column name for the ID.
- $object_compare_key : string
-
DB column name for the value.
- $country : string = ''
-
Country from which this postcode belongs. Allows for formatting.
Tags
wc_get_shipping_method_count()
Gets number of shipping methods currently enabled. Used to identify if shipping is configured.
wc_get_shipping_method_count([bool $include_legacy = false ][, bool $enabled_only = false ]) : int
Parameters
- $include_legacy : bool = false
-
Count legacy shipping methods too.
- $enabled_only : bool = false
-
Whether non-legacy shipping methods should be restricted to enabled ones. It doesn't affect legacy shipping methods. @since 4.3.0.
Tags
wc_set_time_limit()
Wrapper for set_time_limit to see if it is enabled.
wc_set_time_limit(int $limit) : mixed
Parameters
- $limit : int
-
Time limit.
Tags
wc_nocache_headers()
Wrapper for nocache_headers which also disables page caching.
wc_nocache_headers() : mixed
Tags
wc_product_attribute_uasort_comparison()
Used to sort products attributes with uasort.
wc_product_attribute_uasort_comparison(array<string|int, mixed> $a, array<string|int, mixed> $b) : int
Parameters
- $a : array<string|int, mixed>
-
First attribute to compare.
- $b : array<string|int, mixed>
-
Second attribute to compare.
Tags
wc_shipping_zone_method_order_uasort_comparison()
Used to sort shipping zone methods with uasort.
wc_shipping_zone_method_order_uasort_comparison(array<string|int, mixed> $a, array<string|int, mixed> $b) : int
Parameters
- $a : array<string|int, mixed>
-
First shipping zone method to compare.
- $b : array<string|int, mixed>
-
Second shipping zone method to compare.
Tags
wc_checkout_fields_uasort_comparison()
User to sort checkout fields based on priority with uasort.
wc_checkout_fields_uasort_comparison(array<string|int, mixed> $a, array<string|int, mixed> $b) : int
Parameters
- $a : array<string|int, mixed>
-
First field to compare.
- $b : array<string|int, mixed>
-
Second field to compare.
Tags
wc_uasort_comparison()
User to sort two values with ausort.
wc_uasort_comparison(int $a, int $b) : int
Parameters
- $a : int
-
First value to compare.
- $b : int
-
Second value to compare.
Tags
wc_ascii_uasort_comparison()
Sort values based on ascii, usefull for special chars in strings.
wc_ascii_uasort_comparison(string $a, string $b) : int
Parameters
- $a : string
-
First value.
- $b : string
-
Second value.
wc_asort_by_locale()
Sort array according to current locale rules and maintaining index association.
wc_asort_by_locale(array<string|int, mixed> &$data[, string $locale = '' ]) : array<string|int, mixed>
By default tries to use Collator from PHP Internationalization Functions if available.
If PHP Collator class doesn't exists it fallback to removing accepts from a array
and by sorting with uasort( $data, 'strcmp' )
giving support for ASCII values.
Parameters
- $data : array<string|int, mixed>
-
List of values to sort.
- $locale : string = ''
-
Locale.
Tags
wc_get_tax_rounding_mode()
Get rounding mode for internal tax calculations.
wc_get_tax_rounding_mode() : int
Tags
wc_get_rounding_precision()
Get rounding precision for internal WC calculations.
wc_get_rounding_precision() : int
Will return the value of wc_get_price_decimals increased by 2 decimals, with WC_ROUNDING_PRECISION being the minimum.
Tags
wc_add_number_precision()
Add precision to a number by moving the decimal point to the right as many places as indicated by wc_get_price_decimals().
wc_add_number_precision(float|null $value[, bool $round = true ]) : int|float
Optionally the result is rounded so that the total number of digits equals wc_get_rounding_precision() plus one.
Parameters
- $value : float|null
-
Number to add precision to.
- $round : bool = true
-
If the result should be rounded.
Tags
wc_remove_number_precision()
Remove precision from a number and return a float.
wc_remove_number_precision(float $value) : float
Parameters
- $value : float
-
Number to add precision to.
Tags
wc_add_number_precision_deep()
Add precision to an array of number and return an array of int.
wc_add_number_precision_deep(array<string|int, mixed> $value[, bool $round = true ]) : int|array<string|int, mixed>
Parameters
- $value : array<string|int, mixed>
-
Number to add precision to.
- $round : bool = true
-
Should we round after adding precision?.
Tags
wc_remove_number_precision_deep()
Remove precision from an array of number and return an array of int.
wc_remove_number_precision_deep(array<string|int, mixed> $value) : int|array<string|int, mixed>
Parameters
- $value : array<string|int, mixed>
-
Number to add precision to.
Tags
wc_get_logger()
Get a shared logger instance.
wc_get_logger() : WC_Logger_Interface
Use the woocommerce_logging_class filter to change the logging class. You may provide one of the following:
- a class name which will be instantiated as new $class
with no arguments
- an instance which will be used directly as the logger
In either case, the class or instance must implement WC_Logger_Interface.
wc_cleanup_logs()
Trigger logging cleanup using the logging class.
wc_cleanup_logs() : mixed
Tags
wc_print_r()
Prints human-readable information about a variable.
wc_print_r(mixed $expression[, bool $return = false ]) : string|bool
Some server environments block some debugging functions. This function provides a safe way to turn an expression into a printable, readable form without calling blocked functions.
Parameters
- $expression : mixed
-
The expression to be printed.
- $return : bool = false
-
Optional. Default false. Set to true to return the human-readable string.
Tags
wc_list_pluck()
Based on wp_list_pluck, this calls a method instead of returning a property.
wc_list_pluck(array<string|int, mixed> $list, int|string $callback_or_field[, int|string $index_key = null ]) : array<string|int, mixed>
Parameters
- $list : array<string|int, mixed>
-
List of objects or arrays.
- $callback_or_field : int|string
-
Callback method from the object to place instead of the entire object.
- $index_key : int|string = null
-
Optional. Field from the object to use as keys for the new array. Default null.
Tags
wc_get_permalink_structure()
Get permalink settings for things like products and taxonomies.
wc_get_permalink_structure() : array<string|int, mixed>
As of 3.3.0, the permalink settings are stored to the option instead of being blank and inheritting from the locale. This speeds up page loading times by negating the need to switch locales on each page load.
This is more inline with WP core behavior which does not localize slugs.
Tags
wc_switch_to_site_locale()
Switch WooCommerce to site language.
wc_switch_to_site_locale() : mixed
Tags
wc_restore_locale()
Switch WooCommerce language to original.
wc_restore_locale() : mixed
Tags
wc_make_phone_clickable()
Convert plaintext phone number to clickable phone number.
wc_make_phone_clickable(string $phone) : string
Remove formatting and allow "+". Example and specs: https://developer.mozilla.org/en/docs/Web/HTML/Element/a#Creating_a_phone_link
Parameters
- $phone : string
-
Content to convert phone number.
Tags
wc_get_post_data_by_key()
Get an item of post data if set, otherwise return a default value.
wc_get_post_data_by_key(string $key[, string $default = '' ]) : mixed
Parameters
- $key : string
-
Meta key.
- $default : string = ''
-
Default value.
Tags
wc_get_var()
Get data if set, otherwise return a default value or null. Prevents notices when data is not set.
wc_get_var(mixed &$var[, string $default = null ]) : mixed
Parameters
- $var : mixed
-
Variable.
- $default : string = null
-
Default value.
Tags
wc_enable_wc_plugin_headers()
Read in WooCommerce headers when reading plugin headers.
wc_enable_wc_plugin_headers(array<string|int, mixed> $headers) : array<string|int, mixed>
Parameters
- $headers : array<string|int, mixed>
-
Headers.
Tags
wc_prevent_dangerous_auto_updates()
Prevent auto-updating the WooCommerce plugin on major releases if there are untested extensions active.
wc_prevent_dangerous_auto_updates(bool $should_update, object $plugin) : bool
Parameters
- $should_update : bool
-
If should update.
- $plugin : object
-
Plugin data.
Tags
wc_delete_expired_transients()
Delete expired transients.
wc_delete_expired_transients() : int
Deletes all expired transients. The multi-table delete syntax is used. to delete the transient record from table a, and the corresponding. transient_timeout record from table b.
Based on code inside core's upgrade_network() function.
Tags
wc_get_relative_url()
Make a URL relative, if possible.
wc_get_relative_url(string $url) : string
Parameters
- $url : string
-
URL to make relative.
Tags
wc_is_external_resource()
See if a resource is remote.
wc_is_external_resource(string $url) : bool
Parameters
- $url : string
-
URL to check.
Tags
wc_is_active_theme()
See if theme/s is activate or not.
wc_is_active_theme(string|array<string|int, mixed> $theme) : bool
Parameters
- $theme : string|array<string|int, mixed>
-
Theme name or array of theme names to check.
Tags
wc_is_wp_default_theme_active()
Is the site using a default WP theme?
wc_is_wp_default_theme_active() : bool
wc_cleanup_session_data()
Cleans up session data - cron callback.
wc_cleanup_session_data() : mixed
Tags
wc_decimal_to_fraction()
Convert a decimal (e.g. 3.5) to a fraction (e.g. 7/2).
wc_decimal_to_fraction(float $decimal) : array<string|int, mixed>|bool
From: https://www.designedbyaturtle.co.uk/2015/converting-a-decimal-to-a-fraction-in-php/
Parameters
- $decimal : float
-
the decimal number.
wc_round_discount()
Round discount.
wc_round_discount(float $value, int $precision) : float
Parameters
- $value : float
-
Amount to round.
- $precision : int
-
DP to round.
wc_selected()
Return the html selected attribute if stringified $value is found in array of stringified $options or if stringified $value is the same as scalar stringified $options.
wc_selected(string|int $value, string|int|array<string|int, mixed> $options) : string
Parameters
- $value : string|int
-
Value to find within options.
- $options : string|int|array<string|int, mixed>
-
Options to go through when looking for value.
wc_get_server_database_version()
Retrieves the MySQL server version. Based on $wpdb.
wc_get_server_database_version() : array<string|int, mixed>
Tags
wc_load_cart()
Initialize and load the cart functionality.
wc_load_cart() : void
Tags
wc_is_running_from_async_action_scheduler()
Test whether the context of execution comes from async action scheduler.
wc_is_running_from_async_action_scheduler() : bool
Tags
wc_cache_get_multiple()
Polyfill for wp_cache_get_multiple for WP versions before 5.5.
wc_cache_get_multiple(array<string|int, mixed> $keys[, string $group = '' ][, bool $force = false ]) : array<string|int, mixed>|bool
Parameters
- $keys : array<string|int, mixed>
-
Array of keys to get from group.
- $group : string = ''
-
Optional. Where the cache contents are grouped. Default empty.
- $force : bool = false
-
Optional. Whether to force an update of the local cache from the persistent cache. Default false.
wc_get_coupon_types()
Get coupon types.
wc_get_coupon_types() : array<string|int, mixed>
wc_get_coupon_type()
Get a coupon type's name.
wc_get_coupon_type([string $type = '' ]) : string
Parameters
- $type : string = ''
-
Coupon type.
wc_get_product_coupon_types()
Coupon types that apply to individual products. Controls which validation rules will apply.
wc_get_product_coupon_types() : array<string|int, mixed>
Tags
wc_get_cart_coupon_types()
Coupon types that apply to the cart as a whole. Controls which validation rules will apply.
wc_get_cart_coupon_types() : array<string|int, mixed>
Tags
wc_coupons_enabled()
Check if coupons are enabled.
wc_coupons_enabled() : bool
Filterable.
Tags
wc_get_coupon_code_by_id()
Get coupon code by ID.
wc_get_coupon_code_by_id(int $id) : string
Parameters
- $id : int
-
Coupon ID.
Tags
wc_get_coupon_id_by_code()
Get coupon ID by code.
wc_get_coupon_id_by_code(string $code, int $exclude) : int
Parameters
- $code : string
-
Coupon code.
- $exclude : int
-
Used to exclude an ID from the check if you're checking existence.
Tags
wc_do_deprecated_action()
Runs a deprecated action with notice only if used.
wc_do_deprecated_action(string $tag, array<string|int, mixed> $args, string $version[, string $replacement = null ][, string $message = null ]) : mixed
Parameters
- $tag : string
-
The name of the action hook.
- $args : array<string|int, mixed>
-
Array of additional function arguments to be passed to do_action().
- $version : string
-
The version of WooCommerce that deprecated the hook.
- $replacement : string = null
-
The hook that should have been used.
- $message : string = null
-
A message regarding the change.
Tags
wc_deprecated_function()
Wrapper for deprecated functions so we can apply some extra logic.
wc_deprecated_function(string $function, string $version[, string $replacement = null ]) : mixed
Parameters
- $function : string
-
Function used.
- $version : string
-
Version the message was added in.
- $replacement : string = null
-
Replacement for the called function.
Tags
wc_deprecated_hook()
Wrapper for deprecated hook so we can apply some extra logic.
wc_deprecated_hook(string $hook, string $version[, string $replacement = null ][, string $message = null ]) : mixed
Parameters
- $hook : string
-
The hook that was used.
- $version : string
-
The version of WordPress that deprecated the hook.
- $replacement : string = null
-
The hook that should have been used.
- $message : string = null
-
A message regarding the change.
Tags
wc_caught_exception()
When catching an exception, this allows us to log it if unexpected.
wc_caught_exception(Exception $exception_object[, string $function = '' ][, array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $exception_object : Exception
-
The exception object.
- $function : string = ''
-
The function which threw exception.
- $args : array<string|int, mixed> = array()
-
The args passed to the function.
Tags
wc_doing_it_wrong()
Wrapper for _doing_it_wrong().
wc_doing_it_wrong(string $function, string $message, string $version) : mixed
Parameters
- $function : string
-
Function used.
- $message : string
-
Message to log.
- $version : string
-
Version the message was added in.
Tags
wc_deprecated_argument()
Wrapper for deprecated arguments so we can apply some extra logic.
wc_deprecated_argument(string $argument, string $version[, mixed $message = null ]) : mixed
Parameters
- $argument : string
- $version : string
- $message : mixed = null
Tags
woocommerce_show_messages()
woocommerce_show_messages() : mixed
Tags
woocommerce_weekend_area_js()
woocommerce_weekend_area_js() : mixed
Tags
woocommerce_tooltip_js()
woocommerce_tooltip_js() : mixed
Tags
woocommerce_datepicker_js()
woocommerce_datepicker_js() : mixed
Tags
woocommerce_admin_scripts()
woocommerce_admin_scripts() : mixed
Tags
woocommerce_create_page()
woocommerce_create_page(mixed $slug[, mixed $option = '' ][, mixed $page_title = '' ][, mixed $page_content = '' ], mixed $post_parent) : mixed
Parameters
- $slug : mixed
- $option : mixed = ''
- $page_title : mixed = ''
- $page_content : mixed = ''
- $post_parent : mixed
Tags
woocommerce_readfile_chunked()
woocommerce_readfile_chunked(mixed $file[, mixed $retbytes = true ]) : mixed
Parameters
- $file : mixed
- $retbytes : mixed = true
Tags
woocommerce_format_total()
Formal total costs - format to the number of decimal places for the base currency.
woocommerce_format_total(mixed $number) : string
Parameters
- $number : mixed
Tags
woocommerce_get_formatted_product_name()
Get product name with extra details such as SKU price and attributes. Used within admin.
woocommerce_get_formatted_product_name(WC_Product $product) : string
Parameters
- $product : WC_Product
Tags
woocommerce_legacy_paypal_ipn()
Handle IPN requests for the legacy paypal gateway by calling gateways manually if needed.
woocommerce_legacy_paypal_ipn() : mixed
Tags
get_product()
get_product([mixed $the_product = false ][, mixed $args = array() ]) : mixed
Parameters
- $the_product : mixed = false
- $args : mixed = array()
Tags
woocommerce_protected_product_add_to_cart()
woocommerce_protected_product_add_to_cart(mixed $passed, mixed $product_id) : mixed
Parameters
- $passed : mixed
- $product_id : mixed
Tags
woocommerce_empty_cart()
woocommerce_empty_cart() : mixed
Tags
woocommerce_load_persistent_cart()
woocommerce_load_persistent_cart(mixed $user_login, mixed $user) : mixed
Parameters
- $user_login : mixed
- $user : mixed
Tags
woocommerce_add_to_cart_message()
woocommerce_add_to_cart_message(mixed $product_id) : mixed
Parameters
- $product_id : mixed
Tags
woocommerce_clear_cart_after_payment()
woocommerce_clear_cart_after_payment() : mixed
Tags
woocommerce_cart_totals_subtotal_html()
woocommerce_cart_totals_subtotal_html() : mixed
Tags
woocommerce_cart_totals_shipping_html()
woocommerce_cart_totals_shipping_html() : mixed
Tags
woocommerce_cart_totals_coupon_html()
woocommerce_cart_totals_coupon_html(mixed $coupon) : mixed
Parameters
- $coupon : mixed
Tags
woocommerce_cart_totals_order_total_html()
woocommerce_cart_totals_order_total_html() : mixed
Tags
woocommerce_cart_totals_fee_html()
woocommerce_cart_totals_fee_html(mixed $fee) : mixed
Parameters
- $fee : mixed
Tags
woocommerce_cart_totals_shipping_method_label()
woocommerce_cart_totals_shipping_method_label(mixed $method) : mixed
Parameters
- $method : mixed
Tags
woocommerce_get_template_part()
woocommerce_get_template_part(mixed $slug[, mixed $name = '' ]) : mixed
Parameters
- $slug : mixed
- $name : mixed = ''
Tags
woocommerce_get_template()
woocommerce_get_template(mixed $template_name[, mixed $args = array() ][, mixed $template_path = '' ][, mixed $default_path = '' ]) : mixed
Parameters
- $template_name : mixed
- $args : mixed = array()
- $template_path : mixed = ''
- $default_path : mixed = ''
Tags
woocommerce_locate_template()
woocommerce_locate_template(mixed $template_name[, mixed $template_path = '' ][, mixed $default_path = '' ]) : mixed
Parameters
- $template_name : mixed
- $template_path : mixed = ''
- $default_path : mixed = ''
Tags
woocommerce_mail()
woocommerce_mail(mixed $to, mixed $subject, mixed $message[, mixed $headers = "Content-Type: text/html
" ][, mixed $attachments = "" ]) : mixed
Parameters
- $to : mixed
- $subject : mixed
- $message : mixed
- $headers : mixed = "Content-Type: text/html "
- $attachments : mixed = ""
Tags
woocommerce_disable_admin_bar()
woocommerce_disable_admin_bar(mixed $show_admin_bar) : mixed
Parameters
- $show_admin_bar : mixed
Tags
woocommerce_create_new_customer()
woocommerce_create_new_customer(mixed $email[, mixed $username = '' ][, mixed $password = '' ]) : mixed
Parameters
- $email : mixed
- $username : mixed = ''
- $password : mixed = ''
Tags
woocommerce_set_customer_auth_cookie()
woocommerce_set_customer_auth_cookie(mixed $customer_id) : mixed
Parameters
- $customer_id : mixed
Tags
woocommerce_update_new_customer_past_orders()
woocommerce_update_new_customer_past_orders(mixed $customer_id) : mixed
Parameters
- $customer_id : mixed
Tags
woocommerce_paying_customer()
woocommerce_paying_customer(mixed $order_id) : mixed
Parameters
- $order_id : mixed
Tags
woocommerce_customer_bought_product()
woocommerce_customer_bought_product(mixed $customer_email, mixed $user_id, mixed $product_id) : mixed
Parameters
- $customer_email : mixed
- $user_id : mixed
- $product_id : mixed
Tags
woocommerce_customer_has_capability()
woocommerce_customer_has_capability(mixed $allcaps, mixed $caps, mixed $args) : mixed
Parameters
- $allcaps : mixed
- $caps : mixed
- $args : mixed
Tags
woocommerce_sanitize_taxonomy_name()
woocommerce_sanitize_taxonomy_name(mixed $taxonomy) : mixed
Parameters
- $taxonomy : mixed
Tags
woocommerce_get_filename_from_url()
woocommerce_get_filename_from_url(mixed $file_url) : mixed
Parameters
- $file_url : mixed
Tags
woocommerce_get_dimension()
woocommerce_get_dimension(mixed $dim, mixed $to_unit) : mixed
Parameters
- $dim : mixed
- $to_unit : mixed
Tags
woocommerce_get_weight()
woocommerce_get_weight(mixed $weight, mixed $to_unit) : mixed
Parameters
- $weight : mixed
- $to_unit : mixed
Tags
woocommerce_trim_zeros()
woocommerce_trim_zeros(mixed $price) : mixed
Parameters
- $price : mixed
Tags
woocommerce_round_tax_total()
woocommerce_round_tax_total(mixed $tax) : mixed
Parameters
- $tax : mixed
Tags
woocommerce_format_decimal()
woocommerce_format_decimal(mixed $number[, mixed $dp = false ][, mixed $trim_zeros = false ]) : mixed
Parameters
- $number : mixed
- $dp : mixed = false
- $trim_zeros : mixed = false
Tags
woocommerce_clean()
woocommerce_clean(mixed $var) : mixed
Parameters
- $var : mixed
Tags
woocommerce_array_overlay()
woocommerce_array_overlay(mixed $a1, mixed $a2) : mixed
Parameters
- $a1 : mixed
- $a2 : mixed
Tags
woocommerce_price()
woocommerce_price(mixed $price[, mixed $args = array() ]) : mixed
Parameters
- $price : mixed
- $args : mixed = array()
Tags
woocommerce_let_to_num()
woocommerce_let_to_num(mixed $size) : mixed
Parameters
- $size : mixed
Tags
woocommerce_date_format()
woocommerce_date_format() : mixed
Tags
woocommerce_time_format()
woocommerce_time_format() : mixed
Tags
woocommerce_timezone_string()
woocommerce_timezone_string() : mixed
Tags
woocommerce_rgb_from_hex()
woocommerce_rgb_from_hex(mixed $color) : mixed
Parameters
- $color : mixed
Tags
woocommerce_hex_darker()
woocommerce_hex_darker(mixed $color[, mixed $factor = 30 ]) : mixed
Parameters
- $color : mixed
- $factor : mixed = 30
Tags
woocommerce_hex_lighter()
woocommerce_hex_lighter(mixed $color[, mixed $factor = 30 ]) : mixed
Parameters
- $color : mixed
- $factor : mixed = 30
Tags
woocommerce_light_or_dark()
woocommerce_light_or_dark(mixed $color[, mixed $dark = '#000000' ][, mixed $light = '#FFFFFF' ]) : mixed
Parameters
- $color : mixed
- $dark : mixed = '#000000'
- $light : mixed = '#FFFFFF'
Tags
woocommerce_format_hex()
woocommerce_format_hex(mixed $hex) : mixed
Parameters
- $hex : mixed
Tags
woocommerce_get_order_id_by_order_key()
woocommerce_get_order_id_by_order_key(mixed $order_key) : mixed
Parameters
- $order_key : mixed
Tags
woocommerce_downloadable_file_permission()
woocommerce_downloadable_file_permission(mixed $download_id, mixed $product_id, mixed $order) : mixed
Parameters
- $download_id : mixed
- $product_id : mixed
- $order : mixed
Tags
woocommerce_downloadable_product_permissions()
woocommerce_downloadable_product_permissions(mixed $order_id) : mixed
Parameters
- $order_id : mixed
Tags
woocommerce_add_order_item()
woocommerce_add_order_item(mixed $order_id, mixed $item) : mixed
Parameters
- $order_id : mixed
- $item : mixed
Tags
woocommerce_delete_order_item()
woocommerce_delete_order_item(mixed $item_id) : mixed
Parameters
- $item_id : mixed
Tags
woocommerce_update_order_item_meta()
woocommerce_update_order_item_meta(mixed $item_id, mixed $meta_key, mixed $meta_value[, mixed $prev_value = '' ]) : mixed
Parameters
- $item_id : mixed
- $meta_key : mixed
- $meta_value : mixed
- $prev_value : mixed = ''
Tags
woocommerce_add_order_item_meta()
woocommerce_add_order_item_meta(mixed $item_id, mixed $meta_key, mixed $meta_value[, mixed $unique = false ]) : mixed
Parameters
- $item_id : mixed
- $meta_key : mixed
- $meta_value : mixed
- $unique : mixed = false
Tags
woocommerce_delete_order_item_meta()
woocommerce_delete_order_item_meta(mixed $item_id, mixed $meta_key[, mixed $meta_value = '' ][, mixed $delete_all = false ]) : mixed
Parameters
- $item_id : mixed
- $meta_key : mixed
- $meta_value : mixed = ''
- $delete_all : mixed = false
Tags
woocommerce_get_order_item_meta()
woocommerce_get_order_item_meta(mixed $item_id, mixed $key[, mixed $single = true ]) : mixed
Parameters
- $item_id : mixed
- $key : mixed
- $single : mixed = true
Tags
woocommerce_cancel_unpaid_orders()
woocommerce_cancel_unpaid_orders() : mixed
Tags
woocommerce_processing_order_count()
woocommerce_processing_order_count() : mixed
Tags
woocommerce_get_page_id()
woocommerce_get_page_id(mixed $page) : mixed
Parameters
- $page : mixed
Tags
woocommerce_get_endpoint_url()
woocommerce_get_endpoint_url(mixed $endpoint[, mixed $value = '' ][, mixed $permalink = '' ]) : mixed
Parameters
- $endpoint : mixed
- $value : mixed = ''
- $permalink : mixed = ''
Tags
woocommerce_lostpassword_url()
woocommerce_lostpassword_url(mixed $url) : mixed
Parameters
- $url : mixed
Tags
woocommerce_customer_edit_account_url()
woocommerce_customer_edit_account_url() : mixed
Tags
woocommerce_nav_menu_items()
woocommerce_nav_menu_items(mixed $items, mixed $args) : mixed
Parameters
- $items : mixed
- $args : mixed
Tags
woocommerce_nav_menu_item_classes()
woocommerce_nav_menu_item_classes(mixed $menu_items, mixed $args) : mixed
Parameters
- $menu_items : mixed
- $args : mixed
Tags
woocommerce_list_pages()
woocommerce_list_pages(mixed $pages) : mixed
Parameters
- $pages : mixed
Tags
woocommerce_product_dropdown_categories()
woocommerce_product_dropdown_categories([mixed $args = array() ][, mixed $deprecated_hierarchical = 1 ][, mixed $deprecated_show_uncategorized = 1 ][, mixed $deprecated_orderby = '' ]) : mixed
Parameters
- $args : mixed = array()
- $deprecated_hierarchical : mixed = 1
- $deprecated_show_uncategorized : mixed = 1
- $deprecated_orderby : mixed = ''
Tags
woocommerce_walk_category_dropdown_tree()
woocommerce_walk_category_dropdown_tree([mixed $a1 = '' ][, mixed $a2 = '' ][, mixed $a3 = '' ]) : mixed
Parameters
- $a1 : mixed = ''
- $a2 : mixed = ''
- $a3 : mixed = ''
Tags
woocommerce_taxonomy_metadata_wpdbfix()
woocommerce_taxonomy_metadata_wpdbfix() : mixed
Tags
wc_taxonomy_metadata_wpdbfix()
wc_taxonomy_metadata_wpdbfix() : mixed
Tags
woocommerce_order_terms()
woocommerce_order_terms(mixed $the_term, mixed $next_id, mixed $taxonomy, mixed $index[, mixed $terms = null ]) : mixed
Parameters
- $the_term : mixed
- $next_id : mixed
- $taxonomy : mixed
- $index : mixed
- $terms : mixed = null
Tags
woocommerce_set_term_order()
woocommerce_set_term_order(mixed $term_id, mixed $index, mixed $taxonomy[, mixed $recursive = false ]) : mixed
Parameters
- $term_id : mixed
- $index : mixed
- $taxonomy : mixed
- $recursive : mixed = false
Tags
woocommerce_terms_clauses()
woocommerce_terms_clauses(mixed $clauses, mixed $taxonomies, mixed $args) : mixed
Parameters
- $clauses : mixed
- $taxonomies : mixed
- $args : mixed
Tags
_woocommerce_term_recount()
_woocommerce_term_recount(mixed $terms, mixed $taxonomy, mixed $callback, mixed $terms_are_term_taxonomy_ids) : mixed
Parameters
- $terms : mixed
- $taxonomy : mixed
- $callback : mixed
- $terms_are_term_taxonomy_ids : mixed
Tags
woocommerce_recount_after_stock_change()
woocommerce_recount_after_stock_change(mixed $product_id) : mixed
Parameters
- $product_id : mixed
Tags
woocommerce_change_term_counts()
woocommerce_change_term_counts(mixed $terms, mixed $taxonomies, mixed $args) : mixed
Parameters
- $terms : mixed
- $taxonomies : mixed
- $args : mixed
Tags
woocommerce_get_product_ids_on_sale()
woocommerce_get_product_ids_on_sale() : mixed
Tags
woocommerce_get_featured_product_ids()
woocommerce_get_featured_product_ids() : mixed
Tags
woocommerce_get_product_terms()
woocommerce_get_product_terms(mixed $object_id, mixed $taxonomy[, mixed $fields = 'all' ]) : mixed
Parameters
- $object_id : mixed
- $taxonomy : mixed
- $fields : mixed = 'all'
Tags
woocommerce_product_post_type_link()
woocommerce_product_post_type_link(mixed $permalink, mixed $post) : mixed
Parameters
- $permalink : mixed
- $post : mixed
Tags
woocommerce_placeholder_img_src()
woocommerce_placeholder_img_src() : mixed
Tags
woocommerce_placeholder_img()
woocommerce_placeholder_img([mixed $size = 'woocommerce_thumbnail' ]) : mixed
Parameters
- $size : mixed = 'woocommerce_thumbnail'
Tags
woocommerce_get_formatted_variation()
woocommerce_get_formatted_variation([mixed $variation = '' ][, mixed $flat = false ]) : mixed
Parameters
- $variation : mixed = ''
- $flat : mixed = false
Tags
woocommerce_scheduled_sales()
woocommerce_scheduled_sales() : mixed
Tags
woocommerce_get_attachment_image_attributes()
woocommerce_get_attachment_image_attributes(mixed $attr) : mixed
Parameters
- $attr : mixed
Tags
woocommerce_prepare_attachment_for_js()
woocommerce_prepare_attachment_for_js(mixed $response) : mixed
Parameters
- $response : mixed
Tags
woocommerce_track_product_view()
woocommerce_track_product_view() : mixed
Tags
woocommerce_compile_less_styles()
woocommerce_compile_less_styles() : mixed
Tags
woocommerce_calc_shipping_backwards_compatibility()
woocommerce_calc_shipping was an option used to determine if shipping was enabled prior to version 2.6.0. This has since been replaced with wc_shipping_enabled() function and the woocommerce_ship_to_countries setting.
woocommerce_calc_shipping_backwards_compatibility(mixed $value) : string
Parameters
- $value : mixed
Tags
woocommerce_get_product_schema()
woocommerce_get_product_schema() : string
Tags
_wc_save_product_price()
Save product price.
_wc_save_product_price(int $product_id, float $regular_price[, float $sale_price = '' ][, string $date_from = '' ][, string $date_to = '' ]) : mixed
This is a private function (internal use ONLY) used until a data manipulation api is built.
Parameters
- $product_id : int
- $regular_price : float
- $sale_price : float = ''
- $date_from : string = ''
- $date_to : string = ''
Tags
wc_get_customer_avatar_url()
Return customer avatar URL.
wc_get_customer_avatar_url(string $email) : string
Parameters
- $email : string
-
the customer's email.
Tags
wc_get_core_supported_themes()
WooCommerce Core Supported Themes.
wc_get_core_supported_themes() : array<string|int, string>
Tags
wc_get_min_max_price_meta_query()
Get min/max price meta query args.
wc_get_min_max_price_meta_query(array<string|int, mixed> $args) : array<string|int, mixed>
Parameters
- $args : array<string|int, mixed>
-
Min price and max price arguments.
Tags
wc_taxonomy_metadata_update_content_for_split_terms()
When a term is split, ensure meta data maintained.
wc_taxonomy_metadata_update_content_for_split_terms(int $old_term_id, int $new_term_id, string $term_taxonomy_id, string $taxonomy) : mixed
Parameters
- $old_term_id : int
-
Old term ID.
- $new_term_id : int
-
New term ID.
- $term_taxonomy_id : string
-
Term taxonomy ID.
- $taxonomy : string
-
Taxonomy.
Tags
update_woocommerce_term_meta()
WooCommerce Term Meta API.
update_woocommerce_term_meta(int $term_id, string $meta_key, mixed $meta_value[, string $prev_value = '' ]) : bool
WC tables for storing term meta are deprecated from WordPress 4.4 since 4.4 has its own table. This function serves as a wrapper, using the new table if present, or falling back to the WC table.
Parameters
- $term_id : int
-
Term ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed
-
Meta value.
- $prev_value : string = ''
-
Previous value. (default: '').
Tags
add_woocommerce_term_meta()
WooCommerce Term Meta API.
add_woocommerce_term_meta(int $term_id, string $meta_key, mixed $meta_value[, bool $unique = false ]) : bool
WC tables for storing term meta are deprecated from WordPress 4.4 since 4.4 has its own table. This function serves as a wrapper, using the new table if present, or falling back to the WC table.
Parameters
- $term_id : int
-
Term ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed
-
Meta value.
- $unique : bool = false
-
Make meta key unique. (default: false).
Tags
delete_woocommerce_term_meta()
WooCommerce Term Meta API
delete_woocommerce_term_meta(int $term_id, string $meta_key[, mixed $meta_value = '' ][, bool $deprecated = false ]) : bool
WC tables for storing term meta are deprecated from WordPress 4.4 since 4.4 has its own table. This function serves as a wrapper, using the new table if present, or falling back to the WC table.
Parameters
- $term_id : int
-
Term ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed = ''
-
Meta value (default: '').
- $deprecated : bool = false
-
Deprecated param (default: false).
Tags
get_woocommerce_term_meta()
WooCommerce Term Meta API
get_woocommerce_term_meta(int $term_id, string $key[, bool $single = true ]) : mixed
WC tables for storing term meta are deprecated from WordPress 4.4 since 4.4 has its own table. This function serves as a wrapper, using the new table if present, or falling back to the WC table.
Parameters
- $term_id : int
-
Term ID.
- $key : string
-
Meta key.
- $single : bool = true
-
Whether to return a single value. (default: true).
Tags
wc_register_default_log_handler()
Registers the default log handler.
wc_register_default_log_handler([array<string|int, mixed> $handlers = array() ]) : array<string|int, mixed>
Parameters
- $handlers : array<string|int, mixed> = array()
-
Handlers.
Tags
wc_get_log_file_path()
Get a log file path.
wc_get_log_file_path(string $handle) : string
Parameters
- $handle : string
-
name.
Tags
wc_get_log_file_name()
Get a log file name.
wc_get_log_file_name(string $handle) : string
Parameters
- $handle : string
-
Name.
Tags
wc_string_to_bool()
Converts a string (e.g. 'yes' or 'no') to a bool.
wc_string_to_bool(string|bool $string) : bool
Parameters
- $string : string|bool
-
String to convert. If a bool is passed it will be returned as-is.
Tags
wc_bool_to_string()
Converts a bool to a 'yes' or 'no'.
wc_bool_to_string(bool|string $bool) : string
Parameters
- $bool : bool|string
-
Bool to convert. If a string is passed it will first be converted to a bool.
Tags
wc_string_to_array()
Explode a string into an array by $delimiter and remove empty values.
wc_string_to_array(string $string[, string $delimiter = ',' ]) : array<string|int, mixed>
Parameters
- $string : string
-
String to convert.
- $delimiter : string = ','
-
Delimiter, defaults to ','.
Tags
wc_sanitize_taxonomy_name()
Sanitize taxonomy names. Slug format (no spaces, lowercase).
wc_sanitize_taxonomy_name(string $taxonomy) : string
Urldecode is used to reverse munging of UTF8 characters.
Parameters
- $taxonomy : string
-
Taxonomy name.
wc_sanitize_permalink()
Sanitize permalink values before insertion into DB.
wc_sanitize_permalink(string $value) : string
Cannot use wc_clean because it sometimes strips % chars and breaks the user's setting.
Parameters
- $value : string
-
Permalink.
Tags
wc_get_filename_from_url()
Gets the filename part of a download URL.
wc_get_filename_from_url(string $file_url) : string
Parameters
- $file_url : string
-
File URL.
wc_get_dimension()
Normalise dimensions, unify to cm then convert to wanted unit value.
wc_get_dimension(int|float $dimension, string $to_unit[, string $from_unit = '' ]) : float
Usage: wc_get_dimension( 55, 'in' ); wc_get_dimension( 55, 'in', 'm' );
Parameters
- $dimension : int|float
-
Dimension.
- $to_unit : string
-
Unit to convert to. Options: 'in', 'mm', 'cm', 'm'.
- $from_unit : string = ''
-
Unit to convert from. Defaults to ''. Options: 'in', 'mm', 'cm', 'm'.
wc_get_weight()
Normalise weights, unify to kg then convert to wanted unit value.
wc_get_weight(int|float $weight, string $to_unit[, string $from_unit = '' ]) : float
Usage: wc_get_weight(55, 'kg'); wc_get_weight(55, 'kg', 'lbs');
Parameters
- $weight : int|float
-
Weight.
- $to_unit : string
-
Unit to convert to. Options: 'g', 'kg', 'lbs', 'oz'.
- $from_unit : string = ''
-
Unit to convert from. Defaults to ''. Options: 'g', 'kg', 'lbs', 'oz'.
wc_trim_zeros()
Trim trailing zeros off prices.
wc_trim_zeros(string|float|int $price) : string
Parameters
- $price : string|float|int
-
Price.
wc_round_tax_total()
Round a tax amount.
wc_round_tax_total(float $value[, int $precision = null ]) : float
Parameters
- $value : float
-
Amount to round.
- $precision : int = null
-
DP to round. Defaults to wc_get_price_decimals.
wc_legacy_round_half_down()
Round half down in PHP 5.2.
wc_legacy_round_half_down(float $value, int $precision) : float
Parameters
- $value : float
-
Value to round.
- $precision : int
-
Precision to round down to.
Tags
wc_format_refund_total()
Make a refund total negative.
wc_format_refund_total(float $amount) : float
Parameters
- $amount : float
-
Refunded amount.
wc_format_decimal()
Format decimal numbers ready for DB storage.
wc_format_decimal(float|string $number[, mixed $dp = false ][, bool $trim_zeros = false ]) : string
Sanitize, optionally remove decimals, and optionally round + trim off zeros.
This function does not remove thousands - this should be done before passing a value to the function.
Parameters
- $number : float|string
-
Expects either a float or a string with a decimal separator only (no thousands).
- $dp : mixed = false
-
number Number of decimal points to use, blank to use woocommerce_price_num_decimals, or false to avoid all rounding.
- $trim_zeros : bool = false
-
From end of string.
wc_float_to_string()
Convert a float to a string without locale formatting which PHP adds when changing floats to strings.
wc_float_to_string(float $float) : string
Parameters
- $float : float
-
Float value to format.
wc_format_localized_price()
Format a price with WC Currency Locale settings.
wc_format_localized_price(string $value) : string
Parameters
- $value : string
-
Price to localize.
wc_format_localized_decimal()
Format a decimal with the decimal separator for prices or PHP Locale settings.
wc_format_localized_decimal(string $value) : string
Parameters
- $value : string
-
Decimal to localize.
wc_format_coupon_code()
Format a coupon code.
wc_format_coupon_code(string $value) : string
Parameters
- $value : string
-
Coupon code to format.
Tags
wc_sanitize_coupon_code()
Sanitize a coupon code.
wc_sanitize_coupon_code(string $value) : string
Uses sanitize_post_field since coupon codes are stored as post_titles - the sanitization and escaping must match.
Due to the unfiltered_html captability that some (admin) users have, we need to account for slashes.
Parameters
- $value : string
-
Coupon code to format.
Tags
wc_clean()
Clean variables using sanitize_text_field. Arrays are cleaned recursively.
wc_clean(string|array<string|int, mixed> $var) : string|array<string|int, mixed>
Non-scalar values are ignored.
Parameters
- $var : string|array<string|int, mixed>
-
Data to sanitize.
wc_check_invalid_utf8()
Function wp_check_invalid_utf8 with recursive array support.
wc_check_invalid_utf8(string|array<string|int, mixed> $var) : string|array<string|int, mixed>
Parameters
- $var : string|array<string|int, mixed>
-
Data to sanitize.
wc_sanitize_textarea()
Run wc_clean over posted textarea but maintain line breaks.
wc_sanitize_textarea(string $var) : string
Parameters
- $var : string
-
Data to sanitize.
Tags
wc_sanitize_tooltip()
Sanitize a string destined to be a tooltip.
wc_sanitize_tooltip(string $var) : string
Parameters
- $var : string
-
Data to sanitize.
Tags
wc_array_overlay()
Merge two arrays.
wc_array_overlay(array<string|int, mixed> $a1, array<string|int, mixed> $a2) : array<string|int, mixed>
Parameters
- $a1 : array<string|int, mixed>
-
First array to merge.
- $a2 : array<string|int, mixed>
-
Second array to merge.
wc_stock_amount()
Formats a stock amount by running it through a filter.
wc_stock_amount(int|float $amount) : int|float
Parameters
- $amount : int|float
-
Stock amount.
get_woocommerce_price_format()
Get the price format depending on the currency position.
get_woocommerce_price_format() : string
wc_get_price_thousand_separator()
Return the thousand separator for prices.
wc_get_price_thousand_separator() : string
Tags
wc_get_price_decimal_separator()
Return the decimal separator for prices.
wc_get_price_decimal_separator() : string
Tags
wc_get_price_decimals()
Return the number of decimals after the decimal point.
wc_get_price_decimals() : int
Tags
wc_price()
Format the price with a currency symbol.
wc_price(float $price[, array<string|int, mixed> $args = array() ]) : string
Parameters
- $price : float
-
Raw price.
- $args : array<string|int, mixed> = array()
-
Arguments to format a price { Array of arguments. Defaults to empty array.
@type bool $ex_tax_label Adds exclude tax label. Defaults to false. @type string $currency Currency code. Defaults to empty string (Use the result from get_woocommerce_currency()). @type string $decimal_separator Decimal separator. Defaults the result of wc_get_price_decimal_separator(). @type string $thousand_separator Thousand separator. Defaults the result of wc_get_price_thousand_separator(). @type string $decimals Number of decimals. Defaults the result of wc_get_price_decimals(). @type string $price_format Price format depending on the currency position. Defaults the result of get_woocommerce_price_format().
}
wc_let_to_num()
Notation to numbers.
wc_let_to_num(string $size) : int
This function transforms the php.ini notation for numbers (like '2M') to an integer.
Parameters
- $size : string
-
Size value.
wc_date_format()
WooCommerce Date Format - Allows to change date format for everything WooCommerce.
wc_date_format() : string
wc_time_format()
WooCommerce Time Format - Allows to change time format for everything WooCommerce.
wc_time_format() : string
wc_string_to_timestamp()
Convert mysql datetime to PHP timestamp, forcing UTC. Wrapper for strtotime.
wc_string_to_timestamp(string $time_string[, int|null $from_timestamp = null ]) : int
Based on wcs_strtotime_dark_knight() from WC Subscriptions by Prospress.
Parameters
- $time_string : string
-
Time string.
- $from_timestamp : int|null = null
-
Timestamp to convert from.
Tags
wc_string_to_datetime()
Convert a date string to a WC_DateTime.
wc_string_to_datetime(string $time_string) : WC_DateTime
Parameters
- $time_string : string
-
Time string.
Tags
wc_timezone_string()
WooCommerce Timezone - helper to retrieve the timezone string for a site until.
wc_timezone_string() : string
a WP core method exists (see https://core.trac.wordpress.org/ticket/24730).
Adapted from https://secure.php.net/manual/en/function.timezone-name-from-abbr.php#89155.
Tags
wc_timezone_offset()
Get timezone offset in seconds.
wc_timezone_offset() : float
Tags
wc_flatten_meta_callback()
Callback which can flatten post meta (gets the first value if it's an array).
wc_flatten_meta_callback(array<string|int, mixed> $value) : mixed
Parameters
- $value : array<string|int, mixed>
-
Value to flatten.
Tags
wc_rgb_from_hex()
Convert RGB to HEX.
wc_rgb_from_hex(mixed $color) : array<string|int, mixed>
Parameters
- $color : mixed
-
Color.
wc_hex_darker()
Make HEX color darker.
wc_hex_darker(mixed $color[, int $factor = 30 ]) : string
Parameters
- $color : mixed
-
Color.
- $factor : int = 30
-
Darker factor. Defaults to 30.
wc_hex_lighter()
Make HEX color lighter.
wc_hex_lighter(mixed $color[, int $factor = 30 ]) : string
Parameters
- $color : mixed
-
Color.
- $factor : int = 30
-
Lighter factor. Defaults to 30.
wc_hex_is_light()
Determine whether a hex color is light.
wc_hex_is_light(mixed $color) : bool
Parameters
- $color : mixed
-
Color.
wc_light_or_dark()
Detect if we should use a light or dark color on a background color.
wc_light_or_dark(mixed $color[, string $dark = '#000000' ][, string $light = '#FFFFFF' ]) : string
Parameters
- $color : mixed
-
Color.
- $dark : string = '#000000'
-
Darkest reference. Defaults to '#000000'.
- $light : string = '#FFFFFF'
-
Lightest reference. Defaults to '#FFFFFF'.
wc_format_hex()
Format string as hex.
wc_format_hex(string $hex) : string|null
Parameters
- $hex : string
-
HEX color.
wc_format_postcode()
Format the postcode according to the country and length of the postcode.
wc_format_postcode(string $postcode, string $country) : string
Parameters
- $postcode : string
-
Unformatted postcode.
- $country : string
-
Base country.
wc_normalize_postcode()
Normalize postcodes.
wc_normalize_postcode(string $postcode) : string
Remove spaces and convert characters to uppercase.
Parameters
- $postcode : string
-
Postcode.
Tags
wc_format_phone_number()
Format phone numbers.
wc_format_phone_number(string $phone) : string
Parameters
- $phone : string
-
Phone number.
wc_sanitize_phone_number()
Sanitize phone number.
wc_sanitize_phone_number(string $phone) : string
Allows only numbers and "+" (plus sign).
Parameters
- $phone : string
-
Phone number.
Tags
wc_strtoupper()
Wrapper for mb_strtoupper which see's if supported first.
wc_strtoupper(string $string) : string
Parameters
- $string : string
-
String to format.
Tags
wc_strtolower()
Make a string lowercase.
wc_strtolower(string $string) : string
Try to use mb_strtolower() when available.
Parameters
- $string : string
-
String to format.
Tags
wc_trim_string()
Trim a string and append a suffix.
wc_trim_string(string $string[, int $chars = 200 ][, string $suffix = '...' ]) : string
Parameters
- $string : string
-
String to trim.
- $chars : int = 200
-
Amount of characters. Defaults to 200.
- $suffix : string = '...'
-
Suffix. Defaults to '...'.
wc_format_content()
Format content to display shortcodes.
wc_format_content(string $raw_string) : string
Parameters
- $raw_string : string
-
Raw string.
Tags
wc_format_product_short_description()
Format product short description.
wc_format_product_short_description(string $content) : string
Adds support for Jetpack Markdown.
Parameters
- $content : string
-
Product short description.
Tags
wc_format_option_price_separators()
Formats curency symbols when saved in settings.
wc_format_option_price_separators(string $value, array<string|int, mixed> $option, string $raw_value) : string
Parameters
- $value : string
-
Option value.
- $option : array<string|int, mixed>
-
Option name.
- $raw_value : string
-
Raw value.
Tags
wc_format_option_price_num_decimals()
Formats decimals when saved in settings.
wc_format_option_price_num_decimals(string $value, array<string|int, mixed> $option, string $raw_value) : string
Parameters
- $value : string
-
Option value.
- $option : array<string|int, mixed>
-
Option name.
- $raw_value : string
-
Raw value.
Tags
wc_format_option_hold_stock_minutes()
Formats hold stock option and sets cron event up.
wc_format_option_hold_stock_minutes(string $value, array<string|int, mixed> $option, string $raw_value) : string
Parameters
- $value : string
-
Option value.
- $option : array<string|int, mixed>
-
Option name.
- $raw_value : string
-
Raw value.
Tags
wc_sanitize_term_text_based()
Sanitize terms from an attribute text based.
wc_sanitize_term_text_based(string $term) : string
Parameters
- $term : string
-
Term value.
Tags
wc_make_numeric_postcode()
Make numeric postcode.
wc_make_numeric_postcode(string $postcode) : string
Converts letters to numbers so we can do a simple range check on postcodes. E.g. PE30 becomes 16050300 (P = 16, E = 05, 3 = 03, 0 = 00)
Parameters
- $postcode : string
-
Regular postcode.
Tags
wc_format_stock_for_display()
Format the stock amount ready for display based on settings.
wc_format_stock_for_display(WC_Product $product) : string
Parameters
- $product : WC_Product
-
Product object for which the stock you need to format.
Tags
wc_format_stock_quantity_for_display()
Format the stock quantity ready for display.
wc_format_stock_quantity_for_display(int $stock_quantity, WC_Product $product) : string
Parameters
- $stock_quantity : int
-
Stock quantity.
- $product : WC_Product
-
Product instance so that we can pass through the filters.
Tags
wc_format_sale_price()
Format a sale price for display.
wc_format_sale_price(string $regular_price, string $sale_price) : string
Parameters
- $regular_price : string
-
Regular price.
- $sale_price : string
-
Sale price.
Tags
wc_format_price_range()
Format a price range for display.
wc_format_price_range(string $from, string $to) : string
Parameters
- $from : string
-
Price from.
- $to : string
-
Price to.
wc_format_weight()
Format a weight for display.
wc_format_weight(float $weight) : string
Parameters
- $weight : float
-
Weight.
Tags
wc_format_dimensions()
Format dimensions for display.
wc_format_dimensions(array<string|int, mixed> $dimensions) : string
Parameters
- $dimensions : array<string|int, mixed>
-
Array of dimensions.
Tags
wc_format_datetime()
Format a date for output.
wc_format_datetime(WC_DateTime $date[, string $format = '' ]) : string
Parameters
- $date : WC_DateTime
-
Instance of WC_DateTime.
- $format : string = ''
-
Data format. Defaults to the wc_date_format function if not set.
Tags
wc_do_oembeds()
Process oEmbeds.
wc_do_oembeds(string $content) : string
Parameters
- $content : string
-
Content.
Tags
wc_get_string_before_colon()
Get part of a string before :.
wc_get_string_before_colon(string $string) : string
Used for example in shipping methods ids where they take the format method_id:instance_id
Parameters
- $string : string
-
String to extract.
Tags
wc_array_merge_recursive_numeric()
Array merge and sum function.
wc_array_merge_recursive_numeric() : array<string|int, mixed>
Source: https://gist.github.com/Nickology/f700e319cbafab5eaedc
Tags
wc_implode_html_attributes()
Implode and escape HTML attributes for output.
wc_implode_html_attributes(array<string|int, mixed> $raw_attributes) : string
Parameters
- $raw_attributes : array<string|int, mixed>
-
Attribute name value pairs.
Tags
wc_esc_json()
Escape JSON for use on HTML or attribute text nodes.
wc_esc_json(string $json[, bool $html = false ]) : string
Parameters
- $json : string
-
JSON to escape.
- $html : bool = false
-
True if escaping for HTML text node, false for attributes. Determines how quotes are handled.
Tags
wc_parse_relative_date_option()
Parse a relative date option from the settings API into a standard format.
wc_parse_relative_date_option(mixed $raw_value) : array<string|int, mixed>
Parameters
- $raw_value : mixed
-
Value stored in DB.
Tags
wc_sanitize_endpoint_slug()
Format the endpoint slug, strip out anything not allowed in a url.
wc_sanitize_endpoint_slug(string $raw_value) : string
Parameters
- $raw_value : string
-
The raw value.
Tags
wc_notice_count()
Get the count of notices added, either for all notices (default) or for one.
wc_notice_count([string $notice_type = '' ]) : int
particular notice type specified by $notice_type.
Parameters
- $notice_type : string = ''
-
Optional. The name of the notice type - either error, success or notice.
Tags
wc_has_notice()
Check if a notice has already been added.
wc_has_notice(string $message[, string $notice_type = 'success' ]) : bool
Parameters
- $message : string
-
The text to display in the notice.
- $notice_type : string = 'success'
-
Optional. The name of the notice type - either error, success or notice.
Tags
wc_add_notice()
Add and store a notice.
wc_add_notice(string $message[, string $notice_type = 'success' ][, array<string|int, mixed> $data = array() ]) : mixed
Parameters
- $message : string
-
The text to display in the notice.
- $notice_type : string = 'success'
-
Optional. The name of the notice type - either error, success or notice.
- $data : array<string|int, mixed> = array()
-
Optional notice data.
Tags
wc_set_notices()
Set all notices at once.
wc_set_notices(array<string|int, array<string|int, mixed>> $notices) : mixed
Parameters
- $notices : array<string|int, array<string|int, mixed>>
-
Array of notices.
Tags
wc_clear_notices()
Unset all notices.
wc_clear_notices() : mixed
Tags
wc_print_notices()
Prints messages and errors which are stored in the session, then clears them.
wc_print_notices([bool $return = false ]) : string|void
Parameters
- $return : bool = false
-
true to return rather than echo. @since 3.5.0.
Tags
wc_print_notice()
Print a single notice immediately.
wc_print_notice(string $message[, string $notice_type = 'success' ][, array<string|int, mixed> $data = array() ][, bool $return = false ]) : mixed
Parameters
- $message : string
-
The text to display in the notice.
- $notice_type : string = 'success'
-
Optional. The singular name of the notice type - either error, success or notice.
- $data : array<string|int, mixed> = array()
-
Optional notice data. @since 3.9.0.
- $return : bool = false
-
true to return rather than echo. @since 7.7.0.
Tags
wc_get_notices()
Returns all queued notices, optionally filtered by a notice type.
wc_get_notices([string $notice_type = '' ]) : array<string|int, array<string|int, mixed>>
Parameters
- $notice_type : string = ''
-
Optional. The singular name of the notice type - either error, success or notice.
Tags
wc_add_wp_error_notices()
Add notices for WP Errors.
wc_add_wp_error_notices(WP_Error $errors) : mixed
Parameters
- $errors : WP_Error
-
Errors.
wc_kses_notice()
Filters out the same tags as wp_kses_post, but allows tabindex for <a> element.
wc_kses_notice(string $message) : string
Parameters
- $message : string
-
Content to filter through kses.
Tags
wc_get_notice_data_attr()
Get notice data attribute.
wc_get_notice_data_attr(array<string|int, mixed> $notice) : string
Parameters
- $notice : array<string|int, mixed>
-
Notice data.
Tags
wc_get_orders()
Standard way of retrieving orders based on certain parameters.
wc_get_orders(array<string|int, mixed> $args) : array<string|int, WC_Order>|stdClass
This function should be used for order retrieval so that when we move to custom tables, functions still work.
Args and usage: https://github.com/woocommerce/woocommerce/wiki/wc_get_orders-and-WC_Order_Query
Parameters
- $args : array<string|int, mixed>
-
Array of args (above).
Tags
wc_get_order()
Main function for returning orders, uses the WC_Order_Factory class.
wc_get_order([mixed $the_order = false ]) : bool|WC_Order|WC_Order_Refund
Parameters
- $the_order : mixed = false
-
Post object or post ID of the order.
Tags
wc_get_order_statuses()
Get all order statuses.
wc_get_order_statuses() : array<string|int, mixed>
Tags
wc_is_order_status()
See if a string is an order status.
wc_is_order_status(string $maybe_status) : bool
Parameters
- $maybe_status : string
-
Status, including any wc- prefix.
wc_get_is_paid_statuses()
Get list of statuses which are consider 'paid'.
wc_get_is_paid_statuses() : array<string|int, mixed>
Tags
wc_get_is_pending_statuses()
Get list of statuses which are consider 'pending payment'.
wc_get_is_pending_statuses() : array<string|int, mixed>
Tags
wc_get_order_status_name()
Get the nice name for an order status.
wc_get_order_status_name(string $status) : string
Parameters
- $status : string
-
Status.
Tags
wc_generate_order_key()
Generate an order key with prefix.
wc_generate_order_key([string $key = '' ]) : string
Parameters
- $key : string = ''
-
Order key without a prefix. By default generates a 13 digit secret.
Tags
wc_get_order_id_by_order_key()
Finds an Order ID based on an order key.
wc_get_order_id_by_order_key(string $order_key) : int
Parameters
- $order_key : string
-
An order key has generated by.
wc_get_order_types()
Get all registered order types.
wc_get_order_types([string $for = '' ]) : array<string|int, mixed>
Parameters
- $for : string = ''
-
Optionally define what you are getting order types for so only relevant types are returned. e.g. for 'order-meta-boxes', 'order-count'.
Tags
wc_get_order_type()
Get an order type by post type name.
wc_get_order_type(string $type) : bool|array<string|int, mixed>
Parameters
- $type : string
-
Post type name.
wc_register_order_type()
Register order type. Do not use before init.
wc_register_order_type(string $type[, array<string|int, mixed> $args = array() ]) : bool
Wrapper for register post type, as well as a method of telling WC which. post types are types of orders, and having them treated as such.
$args are passed to register_post_type, but there are a few specific to this function: - add_order_meta_boxes (bool) Whether or not the order type gets shop_order meta boxes. - exclude_from_order_count (bool) Whether or not this order type is excluded from counts. - exclude_from_order_views (bool) Whether or not this order type is visible by customers when. viewing orders e.g. on the my account page. - exclude_from_order_reports (bool) Whether or not to exclude this type from core reports. - exclude_from_order_sales_reports (bool) Whether or not to exclude this type from core sales reports.
Parameters
- $type : string
-
Post type. (max. 20 characters, can not contain capital letters or spaces).
- $args : array<string|int, mixed> = array()
-
An array of arguments.
Tags
wc_processing_order_count()
Return the count of processing orders.
wc_processing_order_count() : int
wc_orders_count()
Return the orders count of a specific order status.
wc_orders_count(string $status[, string $type = '' ]) : int
Parameters
- $status : string
-
Status.
- $type : string = ''
-
(Optional) Order type. Leave empty to include all 'for order-count' order types. @{see wc_get_order_types()}.
wc_downloadable_file_permission()
Grant downloadable product access to the file identified by $download_id.
wc_downloadable_file_permission(string $download_id, int|WC_Product $product, WC_Order $order[, int $qty = 1 ][, WC_Order_Item $item = null ]) : int|bool
Parameters
- $download_id : string
-
File identifier.
- $product : int|WC_Product
-
Product instance or ID.
- $order : WC_Order
-
Order data.
- $qty : int = 1
-
Quantity purchased.
- $item : WC_Order_Item = null
-
Item of the order.
wc_downloadable_product_permissions()
Order Status completed - give downloadable product access to customer.
wc_downloadable_product_permissions(int $order_id[, bool $force = false ]) : mixed
Parameters
- $order_id : int
-
Order ID.
- $force : bool = false
-
Force downloadable permissions.
wc_delete_shop_order_transients()
Clear all transients cache for order data.
wc_delete_shop_order_transients(int|WC_Order $order) : mixed
Parameters
- $order : int|WC_Order
-
Order instance or ID.
wc_ship_to_billing_address_only()
See if we only ship to billing addresses.
wc_ship_to_billing_address_only() : bool
wc_create_refund()
Create a new order refund programmatically.
wc_create_refund([array<string|int, mixed> $args = array() ]) : WC_Order_Refund|WP_Error
Returns a new refund object on success which can then be used to add additional data.
Parameters
- $args : array<string|int, mixed> = array()
-
New refund arguments.
Tags
wc_refund_payment()
Try to refund the payment for an order via the gateway.
wc_refund_payment(WC_Order $order, string $amount[, string $reason = '' ]) : bool|WP_Error
Parameters
- $order : WC_Order
-
Order instance.
- $amount : string
-
Amount to refund.
- $reason : string = ''
-
Refund reason.
Tags
wc_restock_refunded_items()
Restock items during refund.
wc_restock_refunded_items(WC_Order $order, array<string|int, mixed> $refunded_line_items) : mixed
Parameters
- $order : WC_Order
-
Order instance.
- $refunded_line_items : array<string|int, mixed>
-
Refunded items list.
Tags
wc_get_tax_class_by_tax_id()
Get tax class by tax id.
wc_get_tax_class_by_tax_id(int $tax_id) : string
Parameters
- $tax_id : int
-
Tax ID.
Tags
wc_get_payment_gateway_by_order()
Get payment gateway class by order data.
wc_get_payment_gateway_by_order(int|WC_Order $order) : WC_Payment_Gateway|bool
Parameters
- $order : int|WC_Order
-
Order instance.
Tags
wc_order_fully_refunded()
When refunding an order, create a refund line item if the partial refunds do not match order total.
wc_order_fully_refunded(int $order_id) : mixed
This is manual; no gateway refund will be performed.
Parameters
- $order_id : int
-
Order ID.
Tags
wc_order_search()
Search orders.
wc_order_search(string $term) : array<string|int, mixed>
Parameters
- $term : string
-
Term to search.
Tags
wc_update_total_sales_counts()
Update total sales amount for each product within a paid order.
wc_update_total_sales_counts(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
Tags
wc_update_coupon_usage_counts()
Update used coupon amount for each coupon within an order.
wc_update_coupon_usage_counts(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
Tags
wc_cancel_unpaid_orders()
Cancel all unpaid orders after held duration to prevent stock lock for those products.
wc_cancel_unpaid_orders() : mixed
wc_sanitize_order_id()
Sanitize order id removing unwanted characters.
wc_sanitize_order_id(int $order_id) : mixed
E.g Users can sometimes try to track an order id using # with no success. This function will fix this.
Parameters
- $order_id : int
-
Order ID.
Tags
wc_get_order_note()
Get an order note.
wc_get_order_note(int|WP_Comment $data) : stdClass|null
Parameters
- $data : int|WP_Comment
-
Note ID (or WP_Comment instance for internal use only).
Tags
wc_get_order_notes()
Get order notes.
wc_get_order_notes(array<string|int, mixed> $args) : array<string|int, stdClass>
Parameters
- $args : array<string|int, mixed>
-
Query arguments { Array of query parameters.
@type string $limit Maximum number of notes to retrieve. Default empty (no limit). @type int $order_id Limit results to those affiliated with a given order ID. Default 0. @type array $order__in Array of order IDs to include affiliated notes for. Default empty. @type array $order__not_in Array of order IDs to exclude affiliated notes for. Default empty. @type string $orderby Define how should sort notes. Accepts 'date_created', 'date_created_gmt' or 'id'. Default: 'id'. @type string $order How to order retrieved notes. Accepts 'ASC' or 'DESC'. Default: 'DESC'. @type string $type Define what type of note should retrieve. Accepts 'customer', 'internal' or empty for both. Default empty.
}
Tags
wc_create_order_note()
Create an order note.
wc_create_order_note(int $order_id, string $note[, bool $is_customer_note = false ][, bool $added_by_user = false ]) : int|WP_Error
Parameters
- $order_id : int
-
Order ID.
- $note : string
-
Note to add.
- $is_customer_note : bool = false
-
If is a costumer note.
- $added_by_user : bool = false
-
If note is create by an user.
Tags
wc_delete_order_note()
Delete an order note.
wc_delete_order_note(int $note_id) : bool
Parameters
- $note_id : int
-
Order note.
Tags
wc_add_order_item()
Add a item to an order (for example a line item).
wc_add_order_item(int $order_id, array<string|int, mixed> $item_array) : int|bool
Parameters
- $order_id : int
-
Order ID.
- $item_array : array<string|int, mixed>
-
Items list.
Tags
wc_update_order_item()
Update an item for an order.
wc_update_order_item(int $item_id, array<string|int, mixed> $args) : bool
Parameters
- $item_id : int
-
Item ID.
- $args : array<string|int, mixed>
-
Either
order_item_type
ororder_item_name
.
Tags
wc_delete_order_item()
Delete an item from the order it belongs to based on item id.
wc_delete_order_item(int $item_id) : bool
Parameters
- $item_id : int
-
Item ID.
Tags
wc_update_order_item_meta()
WooCommerce Order Item Meta API - Update term meta.
wc_update_order_item_meta(int $item_id, string $meta_key, mixed $meta_value[, string $prev_value = '' ]) : bool
Parameters
- $item_id : int
-
Item ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed
-
Meta value.
- $prev_value : string = ''
-
Previous value (default: '').
Tags
wc_add_order_item_meta()
WooCommerce Order Item Meta API - Add term meta.
wc_add_order_item_meta(int $item_id, string $meta_key, mixed $meta_value[, bool $unique = false ]) : int
Parameters
- $item_id : int
-
Item ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed
-
Meta value.
- $unique : bool = false
-
If meta data should be unique (default: false).
Tags
wc_delete_order_item_meta()
WooCommerce Order Item Meta API - Delete term meta.
wc_delete_order_item_meta(int $item_id, string $meta_key[, mixed $meta_value = '' ][, bool $delete_all = false ]) : bool
Parameters
- $item_id : int
-
Item ID.
- $meta_key : string
-
Meta key.
- $meta_value : mixed = ''
-
Meta value (default: '').
- $delete_all : bool = false
-
Delete all meta data, defaults to
false
.
Tags
wc_get_order_item_meta()
WooCommerce Order Item Meta API - Get term meta.
wc_get_order_item_meta(int $item_id, string $key[, bool $single = true ]) : mixed
Parameters
- $item_id : int
-
Item ID.
- $key : string
-
Meta key.
- $single : bool = true
-
Whether to return a single value. (default: true).
Tags
wc_get_order_id_by_order_item_id()
Get order ID by order item ID.
wc_get_order_id_by_order_item_id(int $item_id) : int
Parameters
- $item_id : int
-
Item ID.
Tags
wc_page_endpoint_title()
Replace a page title with the endpoint title.
wc_page_endpoint_title(string $title) : string
Parameters
- $title : string
-
Post title.
wc_get_page_id()
Retrieve page ids - used for myaccount, edit_address, shop, cart, checkout, pay, view_order, terms. returns -1 if no page is found.
wc_get_page_id(string $page) : int
Parameters
- $page : string
-
Page slug.
wc_get_page_permalink()
Retrieve page permalink.
wc_get_page_permalink(string $page[, string|bool $fallback = null ]) : string
Parameters
- $page : string
-
page slug.
- $fallback : string|bool = null
-
Fallback URL if page is not set. Defaults to home URL. @since 3.4.0.
wc_get_endpoint_url()
Get endpoint URL.
wc_get_endpoint_url(string $endpoint[, string $value = '' ][, string $permalink = '' ]) : string
Gets the URL for an endpoint, which varies depending on permalink settings.
Parameters
- $endpoint : string
-
Endpoint slug.
- $value : string = ''
-
Query param value.
- $permalink : string = ''
-
Permalink.
wc_nav_menu_items()
Hide menu items conditionally.
wc_nav_menu_items(array<string|int, mixed> $items) : array<string|int, mixed>
Parameters
- $items : array<string|int, mixed>
-
Navigation items.
wc_nav_menu_item_classes()
Fix active class in nav for shop page.
wc_nav_menu_item_classes(array<string|int, mixed> $menu_items) : array<string|int, mixed>
Parameters
- $menu_items : array<string|int, mixed>
-
Menu items.
wc_list_pages()
Fix active class in wp_list_pages for shop page.
wc_list_pages(string $pages) : string
See details in https://github.com/woocommerce/woocommerce/issues/177.
Parameters
- $pages : string
-
Pages list.
wc_get_products()
Standard way of retrieving products based on certain parameters.
wc_get_products(array<string|int, mixed> $args) : array<string|int, mixed>|stdClass
This function should be used for product retrieval so that we have a data agnostic way to get a list of products.
Args and usage: https://github.com/woocommerce/woocommerce/wiki/wc_get_products-and-WC_Product_Query
Parameters
- $args : array<string|int, mixed>
-
Array of args (above).
Tags
wc_get_product()
Main function for returning products, uses the WC_Product_Factory class.
wc_get_product([mixed $the_product = false ][, array<string|int, mixed> $deprecated = array() ]) : WC_Product|null|false
This function should only be called after 'init' action is finished, as there might be taxonomies that are getting registered during the init action.
Parameters
- $the_product : mixed = false
-
Post object or post ID of the product.
- $deprecated : array<string|int, mixed> = array()
-
Previously used to pass arguments to the factory, e.g. to force a type.
Tags
wc_get_product_object()
Get a product object.
wc_get_product_object(string $product_type, int $product_id) : WC_Product
Parameters
- $product_type : string
-
Product type. If used an invalid type a WC_Product_Simple instance will be returned.
- $product_id : int
-
Product ID.
Tags
wc_product_sku_enabled()
Returns whether or not SKUS are enabled.
wc_product_sku_enabled() : bool
wc_product_weight_enabled()
Returns whether or not product weights are enabled.
wc_product_weight_enabled() : bool
wc_product_dimensions_enabled()
Returns whether or not product dimensions (HxWxD) are enabled.
wc_product_dimensions_enabled() : bool
wc_delete_product_transients()
Clear transient cache for product data.
wc_delete_product_transients(int $post_id) : mixed
Parameters
- $post_id : int
-
(default: 0) The product ID.
wc_get_product_ids_on_sale()
Function that returns an array containing the IDs of the products that are on sale.
wc_get_product_ids_on_sale() : array<string|int, mixed>
Tags
wc_get_featured_product_ids()
Function that returns an array containing the IDs of the featured products.
wc_get_featured_product_ids() : array<string|int, mixed>
Tags
wc_product_post_type_link()
Filter to allow product_cat in the permalinks for products.
wc_product_post_type_link(string $permalink, WP_Post $post) : string
Parameters
- $permalink : string
-
The existing permalink URL.
- $post : WP_Post
-
WP_Post object.
wc_placeholder_img_src()
Get the placeholder image URL either from media, or use the fallback image.
wc_placeholder_img_src([string $size = 'woocommerce_thumbnail' ]) : string
Parameters
- $size : string = 'woocommerce_thumbnail'
-
Thumbnail size to use.
wc_placeholder_img()
Get the placeholder image.
wc_placeholder_img([string $size = 'woocommerce_thumbnail' ][, string|array<string|int, mixed> $attr = '' ]) : string
Uses wp_get_attachment_image if using an attachment ID @since 3.6.0 to handle responsiveness.
Parameters
- $size : string = 'woocommerce_thumbnail'
-
Image size.
- $attr : string|array<string|int, mixed> = ''
-
Optional. Attributes for the image markup. Default empty.
wc_get_formatted_variation()
Variation Formatting.
wc_get_formatted_variation(array<string|int, mixed>|WC_Product_Variation $variation[, bool $flat = false ][, bool $include_names = true ][, bool $skip_attributes_in_name = false ]) : string
Gets a formatted version of variation data or item meta.
Parameters
- $variation : array<string|int, mixed>|WC_Product_Variation
-
Variation object.
- $flat : bool = false
-
Should this be a flat list or HTML list? (default: false).
- $include_names : bool = true
-
include attribute names/labels in the list.
- $skip_attributes_in_name : bool = false
-
Do not list attributes already part of the variation name.
wc_scheduled_sales()
Function which handles the start and end of scheduled sales via cron.
wc_scheduled_sales() : mixed
wc_get_attachment_image_attributes()
Get attachment image attributes.
wc_get_attachment_image_attributes(array<string|int, mixed> $attr) : array<string|int, mixed>
Parameters
- $attr : array<string|int, mixed>
-
Image attributes.
wc_prepare_attachment_for_js()
Prepare attachment for JavaScript.
wc_prepare_attachment_for_js(array<string|int, mixed> $response) : array<string|int, mixed>
Parameters
- $response : array<string|int, mixed>
-
JS version of a attachment post object.
wc_track_product_view()
Track product views.
wc_track_product_view() : mixed
wc_get_product_types()
Get product types.
wc_get_product_types() : array<string|int, mixed>
Tags
wc_product_has_unique_sku()
Check if product sku is unique.
wc_product_has_unique_sku(int $product_id, string $sku) : bool
Parameters
- $product_id : int
-
Product ID.
- $sku : string
-
Product SKU.
Tags
wc_product_force_unique_sku()
Force a unique SKU.
wc_product_force_unique_sku(int $product_id) : mixed
Parameters
- $product_id : int
-
Product ID.
Tags
wc_product_generate_unique_sku()
Recursively appends a suffix until a unique SKU is found.
wc_product_generate_unique_sku(int $product_id, string $sku, int $index) : string
Parameters
- $product_id : int
-
Product ID.
- $sku : string
-
Product SKU.
- $index : int
-
An optional index that can be added to the product SKU.
Tags
wc_get_product_id_by_sku()
Get product ID by SKU.
wc_get_product_id_by_sku(string $sku) : int
Parameters
- $sku : string
-
Product SKU.
Tags
wc_get_product_variation_attributes()
Get attributes/data for an individual variation from the database and maintain it's integrity.
wc_get_product_variation_attributes(int $variation_id) : array<string|int, mixed>
Parameters
- $variation_id : int
-
Variation ID.
Tags
wc_get_product_cat_ids()
Get all product cats for a product by ID, including hierarchy
wc_get_product_cat_ids(int $product_id) : array<string|int, mixed>
Parameters
- $product_id : int
-
Product ID.
Tags
wc_get_product_attachment_props()
Gets data about an attachment, such as alt text and captions.
wc_get_product_attachment_props([int|null $attachment_id = null ][, WC_Product|bool $product = false ]) : array<string|int, mixed>
Parameters
- $attachment_id : int|null = null
-
Attachment ID.
- $product : WC_Product|bool = false
-
WC_Product object.
Tags
wc_get_product_visibility_options()
Get product visibility options.
wc_get_product_visibility_options() : array<string|int, mixed>
Tags
wc_get_product_tax_class_options()
Get product tax class options.
wc_get_product_tax_class_options() : array<string|int, mixed>
Tags
wc_get_product_stock_status_options()
Get stock status options.
wc_get_product_stock_status_options() : array<string|int, mixed>
Tags
wc_get_product_backorder_options()
Get backorder options.
wc_get_product_backorder_options() : array<string|int, mixed>
Tags
wc_get_related_products()
Get related products based on product category and tags.
wc_get_related_products(int $product_id[, int $limit = 5 ][, array<string|int, mixed> $exclude_ids = array() ]) : array<string|int, mixed>
Parameters
- $product_id : int
-
Product ID.
- $limit : int = 5
-
Limit of results.
- $exclude_ids : array<string|int, mixed> = array()
-
Exclude IDs from the results.
Tags
wc_get_product_term_ids()
Retrieves product term ids for a taxonomy.
wc_get_product_term_ids(int $product_id, string $taxonomy) : array<string|int, mixed>
Parameters
- $product_id : int
-
Product ID.
- $taxonomy : string
-
Taxonomy slug.
Tags
wc_get_price_including_tax()
For a given product, and optionally price/qty, work out the price with tax included, based on store settings.
wc_get_price_including_tax(WC_Product $product[, array<string|int, mixed> $args = array() ]) : float|string
Parameters
- $product : WC_Product
-
WC_Product object.
- $args : array<string|int, mixed> = array()
-
Optional arguments to pass product quantity and price.
Tags
wc_get_price_excluding_tax()
For a given product, and optionally price/qty, work out the price with tax excluded, based on store settings.
wc_get_price_excluding_tax(WC_Product $product[, array<string|int, mixed> $args = array() ]) : float|string
Parameters
- $product : WC_Product
-
WC_Product object.
- $args : array<string|int, mixed> = array()
-
Optional arguments to pass product quantity and price.
Tags
wc_get_price_to_display()
Returns the price including or excluding tax.
wc_get_price_to_display(WC_Product $product[, array<string|int, mixed> $args = array() ]) : float
By default it's based on the 'woocommerce_tax_display_shop' setting.
Set $arg['display_context']
to 'cart' to base on the 'woocommerce_tax_display_cart' setting instead.
Parameters
- $product : WC_Product
-
WC_Product object.
- $args : array<string|int, mixed> = array()
-
Optional arguments to pass product quantity and price.
Tags
wc_get_product_category_list()
Returns the product categories in a list.
wc_get_product_category_list(int $product_id[, string $sep = ', ' ][, string $before = '' ][, string $after = '' ]) : string
Parameters
- $product_id : int
-
Product ID.
- $sep : string = ', '
-
(default: ', ').
- $before : string = ''
-
(default: '').
- $after : string = ''
-
(default: '').
wc_get_product_tag_list()
Returns the product tags in a list.
wc_get_product_tag_list(int $product_id[, string $sep = ', ' ][, string $before = '' ][, string $after = '' ]) : string
Parameters
- $product_id : int
-
Product ID.
- $sep : string = ', '
-
(default: ', ').
- $before : string = ''
-
(default: '').
- $after : string = ''
-
(default: '').
wc_products_array_filter_visible()
Callback for array filter to get visible only.
wc_products_array_filter_visible(WC_Product $product) : bool
Parameters
- $product : WC_Product
-
WC_Product object.
Tags
wc_products_array_filter_visible_grouped()
Callback for array filter to get visible grouped products only.
wc_products_array_filter_visible_grouped(WC_Product $product) : bool
Parameters
- $product : WC_Product
-
WC_Product object.
Tags
wc_products_array_filter_editable()
Callback for array filter to get products the user can edit only.
wc_products_array_filter_editable(WC_Product $product) : bool
Parameters
- $product : WC_Product
-
WC_Product object.
Tags
wc_products_array_filter_readable()
Callback for array filter to get products the user can view only.
wc_products_array_filter_readable(WC_Product $product) : bool
Parameters
- $product : WC_Product
-
WC_Product object.
Tags
wc_products_array_orderby()
Sort an array of products by a value.
wc_products_array_orderby(array<string|int, mixed> $products[, string $orderby = 'date' ][, string $order = 'desc' ]) : array<string|int, mixed>
Parameters
- $products : array<string|int, mixed>
-
List of products to be ordered.
- $orderby : string = 'date'
-
Optional order criteria.
- $order : string = 'desc'
-
Ascending or descending order.
Tags
wc_products_array_orderby_title()
Sort by title.
wc_products_array_orderby_title(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_products_array_orderby_id()
Sort by id.
wc_products_array_orderby_id(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_products_array_orderby_date()
Sort by date.
wc_products_array_orderby_date(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_products_array_orderby_modified()
Sort by modified.
wc_products_array_orderby_modified(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_products_array_orderby_menu_order()
Sort by menu order.
wc_products_array_orderby_menu_order(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_products_array_orderby_price()
Sort by price low to high.
wc_products_array_orderby_price(WC_Product $a, WC_Product $b) : int
Parameters
- $a : WC_Product
-
First WC_Product object.
- $b : WC_Product
-
Second WC_Product object.
Tags
wc_deferred_product_sync()
Queue a product for syncing at the end of the request.
wc_deferred_product_sync(int $product_id) : mixed
Parameters
- $product_id : int
-
Product ID.
wc_update_product_lookup_tables_is_running()
See if the lookup table is being generated already.
wc_update_product_lookup_tables_is_running() : bool
Tags
wc_update_product_lookup_tables()
Populate lookup table data for products.
wc_update_product_lookup_tables() : mixed
Tags
wc_update_product_lookup_tables_column()
Populate lookup table column data.
wc_update_product_lookup_tables_column(string $column) : mixed
Parameters
- $column : string
-
Column name to set.
Tags
wc_update_product_lookup_tables_rating_count()
Populate rating count lookup table data for products.
wc_update_product_lookup_tables_rating_count(array<string|int, mixed> $rows) : mixed
Parameters
- $rows : array<string|int, mixed>
-
Rows of rating counts to update in lookup table.
Tags
wc_update_product_lookup_tables_rating_count_batch()
Populate a batch of rating count lookup table data for products.
wc_update_product_lookup_tables_rating_count_batch(array<string|int, mixed> $offset, array<string|int, mixed> $limit) : mixed
Parameters
- $offset : array<string|int, mixed>
-
Offset to query.
- $limit : array<string|int, mixed>
-
Limit to query.
Tags
wc_product_attach_featured_image()
Attach product featured image. Use image filename to match a product sku when product is not provided.
wc_product_attach_featured_image(int $attachment_id[, WC_Product $product = null ][, bool $save_product = true ]) : void
Parameters
- $attachment_id : int
-
Media attachment ID.
- $product : WC_Product = null
-
Optional product object.
- $save_product : bool = true
-
If true, the changes in the product will be saved before the method returns.
Tags
wc_rest_prepare_date_response()
Parses and formats a date for ISO8601/RFC3339.
wc_rest_prepare_date_response(string|null|WC_DateTime $date[, bool $utc = true ]) : string|null
Required WP 4.4 or later. See https://developer.wordpress.org/reference/functions/mysql_to_rfc3339/
Parameters
- $date : string|null|WC_DateTime
-
Date.
- $utc : bool = true
-
Send false to get local/offset time.
Tags
wc_rest_allowed_image_mime_types()
Returns image mime types users are allowed to upload via the API.
wc_rest_allowed_image_mime_types() : array<string|int, mixed>
Tags
wc_rest_upload_image_from_url()
Upload image from URL.
wc_rest_upload_image_from_url(string $image_url) : array<string|int, mixed>|WP_Error
Parameters
- $image_url : string
-
Image URL.
Tags
wc_rest_set_uploaded_image_as_attachment()
Set uploaded image as attachment.
wc_rest_set_uploaded_image_as_attachment(array<string|int, mixed> $upload, int $id) : int
Parameters
- $upload : array<string|int, mixed>
-
Upload information from wp_upload_bits.
- $id : int
-
Post ID. Default to 0.
Tags
wc_rest_validate_reports_request_arg()
Validate reports request arguments.
wc_rest_validate_reports_request_arg(mixed $value, WP_REST_Request $request, string $param) : WP_Error|bool
Parameters
- $value : mixed
-
Value to validate.
- $request : WP_REST_Request
-
Request instance.
- $param : string
-
Param to validate.
Tags
wc_rest_urlencode_rfc3986()
Encodes a value according to RFC 3986.
wc_rest_urlencode_rfc3986(string|array<string|int, mixed> $value) : string|array<string|int, mixed>
Supports multidimensional arrays.
Parameters
- $value : string|array<string|int, mixed>
-
The value to encode.
Tags
wc_rest_check_post_permissions()
Check permissions of posts on REST API.
wc_rest_check_post_permissions(string $post_type[, string $context = 'read' ], int $object_id) : bool
Parameters
- $post_type : string
-
Post type.
- $context : string = 'read'
-
Request context.
- $object_id : int
-
Post ID.
Tags
wc_rest_check_user_permissions()
Check permissions of users on REST API.
wc_rest_check_user_permissions([string $context = 'read' ], int $object_id) : bool
Parameters
- $context : string = 'read'
-
Request context.
- $object_id : int
-
Post ID.
Tags
wc_rest_check_product_term_permissions()
Check permissions of product terms on REST API.
wc_rest_check_product_term_permissions(string $taxonomy[, string $context = 'read' ], int $object_id) : bool
Parameters
- $taxonomy : string
-
Taxonomy.
- $context : string = 'read'
-
Request context.
- $object_id : int
-
Post ID.
Tags
wc_rest_check_manager_permissions()
Check manager permissions on REST API.
wc_rest_check_manager_permissions(string $object[, string $context = 'read' ]) : bool
Parameters
- $object : string
-
Object.
- $context : string = 'read'
-
Request context.
Tags
wc_rest_check_product_reviews_permissions()
Check product reviews permissions on REST API.
wc_rest_check_product_reviews_permissions([string $context = 'read' ], string $object_id) : bool
Parameters
- $context : string = 'read'
-
Request context.
- $object_id : string
-
Object ID.
Tags
wc_rest_is_from_product_editor()
Returns true if the current REST request is from the product editor.
wc_rest_is_from_product_editor() : bool
Tags
wc_update_product_stock()
Update a product's stock amount.
wc_update_product_stock(int|WC_Product $product[, int|null $stock_quantity = null ][, string $operation = 'set' ][, bool $updating = false ]) : bool|int|null
Uses queries rather than update_post_meta so we can do this in one query (to avoid stock issues).
Parameters
- $product : int|WC_Product
-
Product ID or product instance.
- $stock_quantity : int|null = null
-
Stock quantity.
- $operation : string = 'set'
-
Type of operation, allows 'set', 'increase' and 'decrease'.
- $updating : bool = false
-
If true, the product object won't be saved here as it will be updated later.
Tags
wc_update_product_stock_status()
Update a product's stock status.
wc_update_product_stock_status(int $product_id, string $status) : mixed
Parameters
- $product_id : int
-
Product ID.
- $status : string
-
Status.
wc_maybe_reduce_stock_levels()
When a payment is complete, we can reduce stock levels for items within an order.
wc_maybe_reduce_stock_levels(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
Tags
wc_maybe_increase_stock_levels()
When a payment is cancelled, restore stock.
wc_maybe_increase_stock_levels(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
Tags
wc_reduce_stock_levels()
Reduce stock levels for items within an order, if stock has not already been reduced for the items.
wc_reduce_stock_levels(int|WC_Order $order_id) : mixed
Parameters
- $order_id : int|WC_Order
-
Order ID or order instance.
Tags
wc_trigger_stock_change_notifications()
After stock change events, triggers emails and adds order notes.
wc_trigger_stock_change_notifications(WC_Order $order, array<string|int, mixed> $changes) : mixed
Parameters
- $order : WC_Order
-
order object.
- $changes : array<string|int, mixed>
-
Array of changes.
Tags
wc_increase_stock_levels()
Increase stock levels for items within an order.
wc_increase_stock_levels(int|WC_Order $order_id) : mixed
Parameters
- $order_id : int|WC_Order
-
Order ID or order instance.
Tags
wc_get_held_stock_quantity()
See how much stock is being held in pending orders.
wc_get_held_stock_quantity(WC_Product $product, int $exclude_order_id) : int
Parameters
- $product : WC_Product
-
Product to check.
- $exclude_order_id : int
-
Order ID to exclude.
Tags
wc_reserve_stock_for_order()
Hold stock for an order.
wc_reserve_stock_for_order(WC_Order|int $order) : mixed
Parameters
- $order : WC_Order|int
-
Order ID or instance.
Tags
wc_release_stock_for_order()
Release held stock for an order.
wc_release_stock_for_order(WC_Order|int $order) : mixed
Parameters
- $order : WC_Order|int
-
Order ID or instance.
Tags
wc_get_low_stock_amount()
Return low stock amount to determine if notification needs to be sent
wc_get_low_stock_amount(WC_Product $product) : int
Since 5.2.0, this function no longer redirects from variation to its parent product. Low stock amount can now be attached to the variation itself and if it isn't, only then we check the parent product, and if it's not there, then we take the default from the store-wide setting.
Parameters
- $product : WC_Product
-
Product to get data from.
Tags
wc_template_redirect()
Handle redirects before content is output - hooked into template_redirect so is_page works.
wc_template_redirect() : mixed
wc_send_frame_options_header()
When loading sensitive checkout or account pages, send a HTTP header to limit rendering of pages to same origin iframes for security reasons.
wc_send_frame_options_header() : mixed
Can be disabled with: remove_action( 'template_redirect', 'wc_send_frame_options_header' );
Tags
wc_prevent_endpoint_indexing()
No index our endpoints.
wc_prevent_endpoint_indexing() : mixed
Prevent indexing pages like order-received.
Tags
wc_prevent_adjacent_posts_rel_link_wp_head()
Remove adjacent_posts_rel_link_wp_head - pointless for products.
wc_prevent_adjacent_posts_rel_link_wp_head() : mixed
Tags
wc_gallery_noscript()
Show the gallery if JS is disabled.
wc_gallery_noscript() : mixed
Tags
wc_setup_product_data()
When the_post is called, put product data into a global.
wc_setup_product_data(mixed $post) : WC_Product
Parameters
- $post : mixed
-
Post Object.
wc_setup_loop()
Sets up the woocommerce_loop global from the passed args or from the main query.
wc_setup_loop([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Args to pass into the global.
Tags
wc_reset_loop()
Resets the woocommerce_loop global.
wc_reset_loop() : mixed
Tags
wc_get_loop_prop()
Gets a property from the woocommerce_loop global.
wc_get_loop_prop(string $prop[, string $default = '' ]) : mixed
Parameters
- $prop : string
-
Prop to get.
- $default : string = ''
-
Default if the prop does not exist.
Tags
wc_set_loop_prop()
Sets a property in the woocommerce_loop global.
wc_set_loop_prop(string $prop[, string $value = '' ]) : mixed
Parameters
- $prop : string
-
Prop to set.
- $value : string = ''
-
Value to set.
Tags
wc_set_loop_product_visibility()
Set the current visbility for a product in the woocommerce_loop global.
wc_set_loop_product_visibility(int $product_id, bool $value) : mixed
Parameters
- $product_id : int
-
Product it to cache visbiility for.
- $value : bool
-
The poduct visibility value to cache.
Tags
wc_get_loop_product_visibility()
Gets the cached current visibility for a product from the woocommerce_loop global.
wc_get_loop_product_visibility(int $product_id) : bool|null
Parameters
- $product_id : int
-
Product id to get the cached visibility for.
Tags
woocommerce_product_loop()
Should the WooCommerce loop be displayed?
woocommerce_product_loop() : bool
This will return true if we have posts (products) or if we have subcats to display.
Tags
wc_generator_tag()
Output generator tag to aid debugging.
wc_generator_tag(string $gen, string $type) : string
Parameters
- $gen : string
-
Generator.
- $type : string
-
Type.
wc_body_class()
Add body classes for WC pages.
wc_body_class(array<string|int, mixed> $classes) : array<string|int, mixed>
Parameters
- $classes : array<string|int, mixed>
-
Body Classes.
wc_no_js()
NO JS handling.
wc_no_js() : mixed
Tags
wc_product_cat_class()
Display the classes for the product cat div.
wc_product_cat_class([string|array<string|int, mixed> $class = '' ][, object $category = null ]) : mixed
Parameters
- $class : string|array<string|int, mixed> = ''
-
One or more classes to add to the class list.
- $category : object = null
-
object Optional.
Tags
wc_get_default_products_per_row()
Get the default columns setting - this is how many products will be shown per row in loops.
wc_get_default_products_per_row() : int
Tags
wc_get_default_product_rows_per_page()
Get the default rows setting - this is how many product rows will be shown in loops.
wc_get_default_product_rows_per_page() : int
Tags
wc_reset_product_grid_settings()
Reset the product grid settings when a new theme is activated.
wc_reset_product_grid_settings() : mixed
Tags
wc_get_loop_class()
Get classname for woocommerce loops.
wc_get_loop_class() : string
Tags
wc_get_product_cat_class()
Get the classes for the product cat div.
wc_get_product_cat_class([string|array<string|int, mixed> $class = '' ][, object $category = null ]) : array<string|int, mixed>
Parameters
- $class : string|array<string|int, mixed> = ''
-
One or more classes to add to the class list.
- $category : object = null
-
object Optional.
Tags
wc_product_post_class()
Adds extra post classes for products via the WordPress post_class hook, if used.
wc_product_post_class(array<string|int, mixed> $classes[, string|array<string|int, mixed> $class = '' ], int $post_id) : array<string|int, mixed>
Note: For performance reasons we instead recommend using wc_product_class/wc_get_product_class instead.
Parameters
- $classes : array<string|int, mixed>
-
Current classes.
- $class : string|array<string|int, mixed> = ''
-
Additional class.
- $post_id : int
-
Post ID.
Tags
wc_get_product_taxonomy_class()
Get product taxonomy HTML classes.
wc_get_product_taxonomy_class(array<string|int, mixed> $term_ids, string $taxonomy) : array<string|int, mixed>
Parameters
- $term_ids : array<string|int, mixed>
-
Array of terms IDs or objects.
- $taxonomy : string
-
Taxonomy.
Tags
wc_get_product_class()
Retrieves the classes for the post div as an array.
wc_get_product_class([string|array<string|int, mixed> $class = '' ][, int|WP_Post|WC_Product $product = null ]) : array<string|int, mixed>
This method was modified from WordPress's get_post_class() to allow the removal of taxonomies (for performance reasons). Previously wc_product_post_class was hooked into post_class. @since 3.6.0
Parameters
- $class : string|array<string|int, mixed> = ''
-
One or more classes to add to the class list.
- $product : int|WP_Post|WC_Product = null
-
Product ID or product object.
Tags
wc_product_class()
Display the classes for the product div.
wc_product_class([string|array<string|int, mixed> $class = '' ][, int|WP_Post|WC_Product $product_id = null ]) : mixed
Parameters
- $class : string|array<string|int, mixed> = ''
-
One or more classes to add to the class list.
- $product_id : int|WP_Post|WC_Product = null
-
Product ID or product object.
Tags
wc_query_string_form_fields()
Outputs hidden form inputs for each query string variable.
wc_query_string_form_fields([string|array<string|int, mixed> $values = null ][, array<string|int, mixed> $exclude = array() ][, string $current_key = '' ][, bool $return = false ]) : string
Parameters
- $values : string|array<string|int, mixed> = null
-
Name value pairs, or a URL to parse.
- $exclude : array<string|int, mixed> = array()
-
Keys to exclude.
- $current_key : string = ''
-
Current key we are outputting.
- $return : bool = false
-
Whether to return.
Tags
wc_terms_and_conditions_page_id()
Get the terms and conditions page ID.
wc_terms_and_conditions_page_id() : int
Tags
wc_privacy_policy_page_id()
Get the privacy policy page ID.
wc_privacy_policy_page_id() : int
Tags
wc_terms_and_conditions_checkbox_enabled()
See if the checkbox is enabled or not based on the existence of the terms page and checkbox text.
wc_terms_and_conditions_checkbox_enabled() : bool
Tags
wc_get_terms_and_conditions_checkbox_text()
Get the terms and conditions checkbox text, if set.
wc_get_terms_and_conditions_checkbox_text() : string
Tags
wc_get_privacy_policy_text()
Get the privacy policy text, if set.
wc_get_privacy_policy_text([string $type = '' ]) : string
Parameters
- $type : string = ''
-
Type of policy to load. Valid values include registration and checkout.
Tags
wc_terms_and_conditions_checkbox_text()
Output t&c checkbox text.
wc_terms_and_conditions_checkbox_text() : mixed
Tags
wc_terms_and_conditions_page_content()
Output t&c page's content (if set). The page can be set from checkout settings.
wc_terms_and_conditions_page_content() : mixed
Tags
wc_checkout_privacy_policy_text()
Render privacy policy text on the checkout.
wc_checkout_privacy_policy_text() : mixed
Tags
wc_registration_privacy_policy_text()
Render privacy policy text on the register forms.
wc_registration_privacy_policy_text() : mixed
Tags
wc_privacy_policy_text()
Output privacy policy text. This is custom text which can be added via the customizer/privacy settings section.
wc_privacy_policy_text([string $type = 'checkout' ]) : mixed
Loads the relevant policy for the current page unless a specific policy text is required.
Parameters
- $type : string = 'checkout'
-
Type of policy to load. Valid values include registration and checkout.
Tags
wc_replace_policy_page_link_placeholders()
Replaces placeholders with links to WooCommerce policy pages.
wc_replace_policy_page_link_placeholders(string $text) : string
Parameters
- $text : string
-
Text to find/replace within.
Tags
woocommerce_content()
Output WooCommerce content.
woocommerce_content() : mixed
This function is only used in the optional 'woocommerce.php' template. which people can add to their themes to add basic woocommerce support. without hooks or modifying core templates.
woocommerce_output_content_wrapper()
Output the start of the page wrapper.
woocommerce_output_content_wrapper() : mixed
woocommerce_output_content_wrapper_end()
Output the end of the page wrapper.
woocommerce_output_content_wrapper_end() : mixed
woocommerce_get_sidebar()
Get the shop sidebar template.
woocommerce_get_sidebar() : mixed
woocommerce_demo_store()
Adds a demo store banner to the site if enabled.
woocommerce_demo_store() : mixed
woocommerce_page_title()
Page Title function.
woocommerce_page_title([bool $echo = true ]) : string
Parameters
- $echo : bool = true
-
Should echo title.
woocommerce_product_loop_start()
Output the start of a product loop. By default this is a UL.
woocommerce_product_loop_start([bool $echo = true ]) : string
Parameters
- $echo : bool = true
-
Should echo?.
woocommerce_product_loop_end()
Output the end of a product loop. By default this is a UL.
woocommerce_product_loop_end([bool $echo = true ]) : string
Parameters
- $echo : bool = true
-
Should echo?.
woocommerce_template_loop_product_title()
Show the product title in the product loop. By default this is an H2.
woocommerce_template_loop_product_title() : mixed
woocommerce_template_loop_category_title()
Show the subcategory title in the product loop.
woocommerce_template_loop_category_title(object $category) : mixed
Parameters
- $category : object
-
Category object.
woocommerce_template_loop_product_link_open()
Insert the opening anchor tag for products in the loop.
woocommerce_template_loop_product_link_open() : mixed
woocommerce_template_loop_product_link_close()
Insert the closing anchor tag for products in the loop.
woocommerce_template_loop_product_link_close() : mixed
woocommerce_template_loop_category_link_open()
Insert the opening anchor tag for categories in the loop.
woocommerce_template_loop_category_link_open(int|object|string $category) : mixed
Parameters
- $category : int|object|string
-
Category ID, Object or String.
woocommerce_template_loop_category_link_close()
Insert the closing anchor tag for categories in the loop.
woocommerce_template_loop_category_link_close() : mixed
woocommerce_product_taxonomy_archive_header()
Output the products header on taxonomy archives.
woocommerce_product_taxonomy_archive_header() : mixed
woocommerce_taxonomy_archive_description()
Show an archive description on taxonomy archives.
woocommerce_taxonomy_archive_description() : mixed
woocommerce_product_archive_description()
Show a shop page description on product archives.
woocommerce_product_archive_description() : mixed
woocommerce_template_loop_add_to_cart()
Get the add to cart template for the loop.
woocommerce_template_loop_add_to_cart([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
woocommerce_template_loop_product_thumbnail()
Get the product thumbnail for the loop.
woocommerce_template_loop_product_thumbnail() : mixed
woocommerce_template_loop_price()
Get the product price for the loop.
woocommerce_template_loop_price() : mixed
woocommerce_template_loop_rating()
Display the average rating in the loop.
woocommerce_template_loop_rating() : mixed
woocommerce_show_product_loop_sale_flash()
Get the sale flash for the loop.
woocommerce_show_product_loop_sale_flash() : mixed
woocommerce_get_product_thumbnail()
Get the product thumbnail, or the placeholder if not set.
woocommerce_get_product_thumbnail([string $size = 'woocommerce_thumbnail' ][, array<string|int, mixed> $attr = array() ][, bool $placeholder = true ]) : string
Parameters
- $size : string = 'woocommerce_thumbnail'
-
(default: 'woocommerce_thumbnail').
- $attr : array<string|int, mixed> = array()
-
Image attributes.
- $placeholder : bool = true
-
True to return $placeholder if no image is found, or false to return an empty string.
woocommerce_result_count()
Output the result count text (Showing x - x of x results).
woocommerce_result_count() : mixed
woocommerce_catalog_ordering()
Output the product sorting options.
woocommerce_catalog_ordering() : mixed
woocommerce_pagination()
Output the pagination.
woocommerce_pagination() : mixed
woocommerce_show_product_images()
Output the product image before the single product summary.
woocommerce_show_product_images() : mixed
woocommerce_show_product_thumbnails()
Output the product thumbnails.
woocommerce_show_product_thumbnails() : mixed
wc_get_gallery_image_html()
Get HTML for a gallery image.
wc_get_gallery_image_html(int $attachment_id[, bool $main_image = false ]) : string
Hooks: woocommerce_gallery_thumbnail_size, woocommerce_gallery_image_size and woocommerce_gallery_full_size accept name based image sizes, or an array of width/height values.
Parameters
- $attachment_id : int
-
Attachment ID.
- $main_image : bool = false
-
Is this the main image or a thumbnail?.
Tags
woocommerce_output_product_data_tabs()
Output the product tabs.
woocommerce_output_product_data_tabs() : mixed
woocommerce_template_single_title()
Output the product title.
woocommerce_template_single_title() : mixed
woocommerce_template_single_rating()
Output the product rating.
woocommerce_template_single_rating() : mixed
woocommerce_template_single_price()
Output the product price.
woocommerce_template_single_price() : mixed
woocommerce_template_single_excerpt()
Output the product short description (excerpt).
woocommerce_template_single_excerpt() : mixed
woocommerce_template_single_meta()
Output the product meta.
woocommerce_template_single_meta() : mixed
woocommerce_template_single_sharing()
Output the product sharing.
woocommerce_template_single_sharing() : mixed
woocommerce_show_product_sale_flash()
Output the product sale flash.
woocommerce_show_product_sale_flash() : mixed
woocommerce_template_single_add_to_cart()
Trigger the single product add to cart action.
woocommerce_template_single_add_to_cart() : mixed
woocommerce_simple_add_to_cart()
Output the simple product add to cart area.
woocommerce_simple_add_to_cart() : mixed
woocommerce_grouped_add_to_cart()
Output the grouped product add to cart area.
woocommerce_grouped_add_to_cart() : mixed
woocommerce_variable_add_to_cart()
Output the variable product add to cart area.
woocommerce_variable_add_to_cart() : mixed
woocommerce_external_add_to_cart()
Output the external product add to cart area.
woocommerce_external_add_to_cart() : mixed
woocommerce_quantity_input()
Output the quantity input for add to cart forms.
woocommerce_quantity_input([array<string|int, mixed> $args = array() ][, WC_Product|null $product = null ][, bool $echo = true ]) : string
Parameters
- $args : array<string|int, mixed> = array()
-
Args for the input.
- $product : WC_Product|null = null
-
Product.
- $echo : bool = true
-
Whether to return or echo|string.
woocommerce_product_description_tab()
Output the description tab content.
woocommerce_product_description_tab() : mixed
woocommerce_product_additional_information_tab()
Output the attributes tab content.
woocommerce_product_additional_information_tab() : mixed
woocommerce_default_product_tabs()
Add default product tabs to product pages.
woocommerce_default_product_tabs([array<string|int, mixed> $tabs = array() ]) : array<string|int, mixed>
Parameters
- $tabs : array<string|int, mixed> = array()
-
Array of tabs.
woocommerce_sort_product_tabs()
Sort tabs by priority.
woocommerce_sort_product_tabs([array<string|int, mixed> $tabs = array() ]) : array<string|int, mixed>
Parameters
- $tabs : array<string|int, mixed> = array()
-
Array of tabs.
woocommerce_comments()
Output the Review comments template.
woocommerce_comments(WP_Comment $comment, array<string|int, mixed> $args, int $depth) : mixed
Parameters
- $comment : WP_Comment
-
Comment object.
- $args : array<string|int, mixed>
-
Arguments.
- $depth : int
-
Depth.
woocommerce_review_display_gravatar()
Display the review authors gravatar
woocommerce_review_display_gravatar(array<string|int, mixed> $comment) : void
Parameters
- $comment : array<string|int, mixed>
-
WP_Comment.
woocommerce_review_display_rating()
Display the reviewers star rating
woocommerce_review_display_rating() : void
woocommerce_review_display_meta()
Display the review authors meta (name, verified owner, review date)
woocommerce_review_display_meta() : void
woocommerce_review_display_comment_text()
Display the review content.
woocommerce_review_display_comment_text() : mixed
woocommerce_output_related_products()
Output the related products.
woocommerce_output_related_products() : mixed
woocommerce_related_products()
Output the related products.
woocommerce_related_products([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Provided arguments.
woocommerce_upsell_display()
Output product up sells.
woocommerce_upsell_display([int $limit = '-1' ][, int $columns = 4 ][, string $orderby = 'rand' ][, string $order = 'desc' ]) : mixed
Parameters
- $limit : int = '-1'
-
(default: -1).
- $columns : int = 4
-
(default: 4).
- $orderby : string = 'rand'
-
Supported values - rand, title, ID, date, modified, menu_order, price.
- $order : string = 'desc'
-
Sort direction.
woocommerce_shipping_calculator()
Output the cart shipping calculator.
woocommerce_shipping_calculator([string $button_text = '' ]) : mixed
Parameters
- $button_text : string = ''
-
Text for the shipping calculation toggle.
woocommerce_cart_totals()
Output the cart totals.
woocommerce_cart_totals() : mixed
woocommerce_cross_sell_display()
Output the cart cross-sells.
woocommerce_cross_sell_display([int $limit = 2 ][, int $columns = 2 ][, string $orderby = 'rand' ][, string $order = 'desc' ]) : mixed
Parameters
- $limit : int = 2
-
(default: 2).
- $columns : int = 2
-
(default: 2).
- $orderby : string = 'rand'
-
(default: 'rand').
- $order : string = 'desc'
-
(default: 'desc').
woocommerce_button_proceed_to_checkout()
Output the proceed to checkout button.
woocommerce_button_proceed_to_checkout() : mixed
woocommerce_widget_shopping_cart_button_view_cart()
Output the view cart button.
woocommerce_widget_shopping_cart_button_view_cart() : mixed
woocommerce_widget_shopping_cart_proceed_to_checkout()
Output the proceed to checkout button.
woocommerce_widget_shopping_cart_proceed_to_checkout() : mixed
woocommerce_widget_shopping_cart_subtotal()
Output to view cart subtotal.
woocommerce_widget_shopping_cart_subtotal() : mixed
Tags
woocommerce_mini_cart()
Output the Mini-cart - used by cart widget.
woocommerce_mini_cart([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
woocommerce_login_form()
Output the WooCommerce Login Form.
woocommerce_login_form([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
woocommerce_checkout_login_form()
Output the WooCommerce Checkout Login Form.
woocommerce_checkout_login_form() : mixed
woocommerce_breadcrumb()
Output the WooCommerce Breadcrumb.
woocommerce_breadcrumb([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
woocommerce_order_review()
Output the Order review table for the checkout.
woocommerce_order_review([bool $deprecated = false ]) : mixed
Parameters
- $deprecated : bool = false
-
Deprecated param.
woocommerce_checkout_payment()
Output the Payment Methods on the checkout.
woocommerce_checkout_payment() : mixed
woocommerce_checkout_coupon_form()
Output the Coupon form for the checkout.
woocommerce_checkout_coupon_form() : mixed
woocommerce_products_will_display()
Check if we will be showing products or not (and not sub-categories only).
woocommerce_products_will_display() : bool
woocommerce_get_loop_display_mode()
See what is going to display in the loop.
woocommerce_get_loop_display_mode() : string
Tags
woocommerce_maybe_show_product_subcategories()
Maybe display categories before, or instead of, a product loop.
woocommerce_maybe_show_product_subcategories([string $loop_html = '' ]) : string
Parameters
- $loop_html : string = ''
-
HTML.
Tags
woocommerce_product_subcategories()
This is a legacy function which used to check if we needed to display subcats and then output them. It was called by templates.
woocommerce_product_subcategories([array<string|int, mixed> $args = array() ]) : null|bool
From 3.3 onwards this is all handled via hooks and the woocommerce_maybe_show_product_subcategories function.
Since some templates have not updated compatibility, to avoid showing incorrect categories this function has been deprecated and will return nothing. Replace usage with woocommerce_output_product_categories to render the category list manually.
This is a legacy function which also checks if things should display. Themes no longer need to call these functions. It's all done via hooks.
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
woocommerce_output_product_categories()
Display product sub categories as thumbnails.
woocommerce_output_product_categories([array<string|int, mixed> $args = array() ]) : bool
This is a replacement for woocommerce_product_subcategories which also does some logic based on the loop. This function however just outputs when called.
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
woocommerce_get_product_subcategories()
Get (and cache) product subcategories.
woocommerce_get_product_subcategories(int $parent_id) : array<string|int, mixed>
Parameters
- $parent_id : int
-
Get subcategories of this ID.
woocommerce_subcategory_thumbnail()
Show subcategory thumbnails.
woocommerce_subcategory_thumbnail(mixed $category) : mixed
Parameters
- $category : mixed
-
Category.
woocommerce_order_details_table()
Displays order details in a table.
woocommerce_order_details_table(mixed $order_id) : mixed
Parameters
- $order_id : mixed
-
Order ID.
woocommerce_order_downloads_table()
Displays order downloads in a table.
woocommerce_order_downloads_table(array<string|int, mixed> $downloads) : mixed
Parameters
- $downloads : array<string|int, mixed>
-
Downloads.
Tags
woocommerce_order_again_button()
Display an 'order again' button on the view order page.
woocommerce_order_again_button(object $order) : mixed
Parameters
- $order : object
-
Order.
woocommerce_form_field()
Outputs a checkout/address form field.
woocommerce_form_field(string $key, mixed $args[, string $value = null ]) : string
Parameters
- $key : string
-
Key.
- $args : mixed
-
Arguments.
- $value : string = null
-
(default: null).
get_product_search_form()
Display product search form.
get_product_search_form([bool $echo = true ]) : string
Will first attempt to locate the product-searchform.php file in either the child or. the parent, then load it. If it doesn't exist, then the default search form. will be displayed.
The default searchform uses html5.
Parameters
- $echo : bool = true
-
(default: true).
woocommerce_output_auth_header()
Output the Auth header.
woocommerce_output_auth_header() : mixed
woocommerce_output_auth_footer()
Output the Auth footer.
woocommerce_output_auth_footer() : mixed
woocommerce_single_variation()
Output placeholders for the single variation.
woocommerce_single_variation() : mixed
woocommerce_single_variation_add_to_cart_button()
Output the add to cart button for variations.
woocommerce_single_variation_add_to_cart_button() : mixed
wc_dropdown_variation_attribute_options()
Output a list of variation attributes for use in the cart forms.
wc_dropdown_variation_attribute_options([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
woocommerce_account_content()
My Account content output.
woocommerce_account_content() : mixed
woocommerce_account_navigation()
My Account navigation template.
woocommerce_account_navigation() : mixed
woocommerce_account_orders()
My Account > Orders template.
woocommerce_account_orders(int $current_page) : mixed
Parameters
- $current_page : int
-
Current page number.
woocommerce_account_view_order()
My Account > View order template.
woocommerce_account_view_order(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
woocommerce_account_downloads()
My Account > Downloads template.
woocommerce_account_downloads() : mixed
woocommerce_account_edit_address()
My Account > Edit address template.
woocommerce_account_edit_address(string $type) : mixed
Parameters
- $type : string
-
Type of address; 'billing' or 'shipping'.
woocommerce_account_payment_methods()
My Account > Downloads template.
woocommerce_account_payment_methods() : mixed
woocommerce_account_add_payment_method()
My Account > Add payment method template.
woocommerce_account_add_payment_method() : mixed
woocommerce_account_edit_account()
My Account > Edit account template.
woocommerce_account_edit_account() : mixed
wc_no_products_found()
Handles the loop when no products were found/no product exist.
wc_no_products_found() : mixed
wc_get_email_order_items()
Get HTML for the order items to be shown in emails.
wc_get_email_order_items(WC_Order $order[, array<string|int, mixed> $args = array() ]) : string
Parameters
- $order : WC_Order
-
Order object.
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
wc_display_item_meta()
Display item meta data.
wc_display_item_meta(WC_Order_Item $item[, array<string|int, mixed> $args = array() ]) : string|void
Parameters
- $item : WC_Order_Item
-
Order Item.
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
wc_display_item_downloads()
Display item download links.
wc_display_item_downloads(WC_Order_Item $item[, array<string|int, mixed> $args = array() ]) : string|void
Parameters
- $item : WC_Order_Item
-
Order Item.
- $args : array<string|int, mixed> = array()
-
Arguments.
Tags
woocommerce_photoswipe()
Get the shop sidebar template.
woocommerce_photoswipe() : mixed
wc_display_product_attributes()
Outputs a list of product attributes for a product.
wc_display_product_attributes(WC_Product $product) : mixed
Parameters
- $product : WC_Product
-
Product Object.
Tags
wc_get_stock_html()
Get HTML to show product stock.
wc_get_stock_html(WC_Product $product) : string
Parameters
- $product : WC_Product
-
Product Object.
Tags
wc_get_rating_html()
Get HTML for ratings.
wc_get_rating_html(float $rating, int $count) : string
Parameters
- $rating : float
-
Rating being shown.
- $count : int
-
Total number of ratings.
Tags
wc_get_star_rating_html()
Get HTML for star rating.
wc_get_star_rating_html(float $rating, int $count) : string
Parameters
- $rating : float
-
Rating being shown.
- $count : int
-
Total number of ratings.
Tags
wc_get_price_html_from_text()
Returns a 'from' prefix if you want to show where prices start at.
wc_get_price_html_from_text() : string
Tags
wc_logout_url()
Get logout endpoint.
wc_logout_url([string $redirect = '' ]) : string
Parameters
- $redirect : string = ''
-
Redirect URL.
Tags
wc_empty_cart_message()
Show notice if cart is empty.
wc_empty_cart_message() : mixed
Tags
wc_page_noindex()
Disable search engines indexing core, dynamic, cart/checkout pages.
wc_page_noindex() : mixed
Tags
wc_page_no_robots()
Disable search engines indexing core, dynamic, cart/checkout pages.
wc_page_no_robots(array<string|int, mixed> $robots) : array<string|int, mixed>
Uses "wp_robots" filter introduced in WP 5.7.
Parameters
- $robots : array<string|int, mixed>
-
Associative array of robots directives.
Tags
wc_get_theme_slug_for_templates()
Get a slug identifying the current theme.
wc_get_theme_slug_for_templates() : string
Tags
wc_get_formatted_cart_item_data()
Gets and formats a list of cart item data + variations for display on the frontend.
wc_get_formatted_cart_item_data(array<string|int, mixed> $cart_item[, bool $flat = false ]) : string
Parameters
- $cart_item : array<string|int, mixed>
-
Cart item object.
- $flat : bool = false
-
Should the data be returned flat or in a list.
Tags
wc_get_cart_remove_url()
Gets the url to remove an item from the cart.
wc_get_cart_remove_url(string $cart_item_key) : string
Parameters
- $cart_item_key : string
-
contains the id of the cart item.
Tags
wc_get_cart_undo_url()
Gets the url to re-add an item into the cart.
wc_get_cart_undo_url(string $cart_item_key) : string
Parameters
- $cart_item_key : string
-
Cart item key to undo.
Tags
woocommerce_output_all_notices()
Outputs all queued notices on WC pages.
woocommerce_output_all_notices() : mixed
Tags
wc_products_rss_feed()
Products RSS Feed.
wc_products_rss_feed() : mixed
Tags
woocommerce_reset_loop()
Reset the loop's index and columns when we're done outputting a product loop.
woocommerce_reset_loop() : mixed
Tags
woocommerce_product_reviews_tab()
Output the reviews tab content.
woocommerce_product_reviews_tab() : mixed
Tags
wc_get_pay_buttons()
Display pay buttons HTML.
wc_get_pay_buttons() : mixed
Tags
wc_update_product_archive_title()
Update the product archive title to the title of the shop page. Fallback to 'Shop' if the shop page doesn't exist.
wc_update_product_archive_title(string $post_type_name, string $post_type) : string
Parameters
- $post_type_name : string
-
Post type 'name' label.
- $post_type : string
-
Post type.
wc_change_get_terms_defaults()
Change get terms defaults for attributes to order by the sorting setting, or default to menu_order for sortable taxonomies.
wc_change_get_terms_defaults(array<string|int, mixed> $defaults, array<string|int, mixed> $taxonomies) : array<string|int, mixed>
Parameters
- $defaults : array<string|int, mixed>
-
An array of default get_terms() arguments.
- $taxonomies : array<string|int, mixed>
-
An array of taxonomies.
Tags
wc_change_pre_get_terms()
Adds support to get_terms for menu_order argument.
wc_change_pre_get_terms(WP_Term_Query $terms_query) : mixed
Parameters
- $terms_query : WP_Term_Query
-
Instance of WP_Term_Query.
Tags
wc_terms_clauses()
Adjust term query to handle custom sorting parameters.
wc_terms_clauses(array<string|int, mixed> $clauses, array<string|int, mixed> $taxonomies, array<string|int, mixed> $args) : array<string|int, mixed>
Parameters
- $clauses : array<string|int, mixed>
-
Clauses.
- $taxonomies : array<string|int, mixed>
-
Taxonomies.
- $args : array<string|int, mixed>
-
Arguments.
wc_get_object_terms()
Helper to get cached object terms and filter by field using wp_list_pluck().
wc_get_object_terms(int $object_id, string $taxonomy[, string $field = null ][, string $index_key = null ]) : array<string|int, mixed>
Works as a cached alternative for wp_get_post_terms() and wp_get_object_terms().
Parameters
- $object_id : int
-
Object ID.
- $taxonomy : string
-
Taxonomy slug.
- $field : string = null
-
Field name.
- $index_key : string = null
-
Index key name.
Tags
_wc_get_cached_product_terms()
Cached version of wp_get_post_terms().
_wc_get_cached_product_terms(int $product_id, string $taxonomy[, array<string|int, mixed> $args = array() ]) : array<string|int, mixed>
This is a private function (internal use ONLY).
Parameters
- $product_id : int
-
Product ID.
- $taxonomy : string
-
Taxonomy slug.
- $args : array<string|int, mixed> = array()
-
Query arguments.
Tags
wc_get_product_terms()
Wrapper used to get terms for a product.
wc_get_product_terms(int $product_id, string $taxonomy[, array<string|int, mixed> $args = array() ]) : array<string|int, mixed>
Parameters
- $product_id : int
-
Product ID.
- $taxonomy : string
-
Taxonomy slug.
- $args : array<string|int, mixed> = array()
-
Query arguments.
_wc_get_product_terms_name_num_usort_callback()
Sort by name (numeric).
_wc_get_product_terms_name_num_usort_callback(WP_Post $a, WP_Post $b) : int
Parameters
- $a : WP_Post
-
First item to compare.
- $b : WP_Post
-
Second item to compare.
_wc_get_product_terms_parent_usort_callback()
Sort by parent.
_wc_get_product_terms_parent_usort_callback(WP_Post $a, WP_Post $b) : int
Parameters
- $a : WP_Post
-
First item to compare.
- $b : WP_Post
-
Second item to compare.
wc_product_dropdown_categories()
WooCommerce Dropdown categories.
wc_product_dropdown_categories([array<string|int, mixed> $args = array() ]) : mixed
Parameters
- $args : array<string|int, mixed> = array()
-
Args to control display of dropdown.
wc_walk_category_dropdown_tree()
Custom walker for Product Categories.
wc_walk_category_dropdown_tree(mixed ...$args) : mixed
Previously used by wc_product_dropdown_categories, but wp_dropdown_categories has been fixed in core.
Parameters
- $args : mixed
-
Variable number of parameters to be passed to the walker.
wc_taxonomy_metadata_migrate_data()
Migrate data from WC term meta to WP term meta.
wc_taxonomy_metadata_migrate_data(string $wp_db_version, string $wp_current_db_version) : mixed
When the database is updated to support term meta, migrate WC term meta data across. We do this when the new version is >= 34370, and the old version is < 34370 (34370 is when term meta table was added).
Parameters
- $wp_db_version : string
-
The new $wp_db_version.
- $wp_current_db_version : string
-
The old (current) $wp_db_version.
wc_reorder_terms()
Move a term before the a given element of its hierarchy level.
wc_reorder_terms(int $the_term, int $next_id, string $taxonomy, int $index[, mixed $terms = null ]) : int
Parameters
- $the_term : int
-
Term ID.
- $next_id : int
-
The id of the next sibling element in save hierarchy level.
- $taxonomy : string
-
Taxonomy.
- $index : int
-
Term index (default: 0).
- $terms : mixed = null
-
List of terms. (default: null).
wc_set_term_order()
Set the sort order of a term.
wc_set_term_order(int $term_id, int $index, string $taxonomy[, bool $recursive = false ]) : int
Parameters
- $term_id : int
-
Term ID.
- $index : int
-
Index.
- $taxonomy : string
-
Taxonomy.
- $recursive : bool = false
-
Recursive (default: false).
_wc_term_recount()
Function for recounting product terms, ignoring hidden products.
_wc_term_recount(array<string|int, mixed> $terms, object $taxonomy[, bool $callback = true ][, bool $terms_are_term_taxonomy_ids = true ]) : mixed
Parameters
- $terms : array<string|int, mixed>
-
List of terms.
- $taxonomy : object
-
Taxonomy.
- $callback : bool = true
-
Callback.
- $terms_are_term_taxonomy_ids : bool = true
-
If terms are from term_taxonomy_id column.
wc_recount_after_stock_change()
Recount terms after the stock amount changes.
wc_recount_after_stock_change(int $product_id) : mixed
Parameters
- $product_id : int
-
Product ID.
wc_change_term_counts()
Overrides the original term count for product categories and tags with the product count.
wc_change_term_counts(array<string|int, mixed> $terms, string|array<string|int, mixed> $taxonomies) : array<string|int, mixed>
that takes catalog visibility into account.
Parameters
- $terms : array<string|int, mixed>
-
List of terms.
- $taxonomies : string|array<string|int, mixed>
-
Single taxonomy or list of taxonomies.
wc_get_term_product_ids()
Return products in a given term, and cache value.
wc_get_term_product_ids(int $term_id, string $taxonomy) : array<string|int, mixed>
To keep in sync, product_count will be cleared on "set_object_terms".
Parameters
- $term_id : int
-
Term ID.
- $taxonomy : string
-
Taxonomy.
wc_clear_term_product_ids()
When a post is updated and terms recounted (called by _update_post_term_count), clear the ids.
wc_clear_term_product_ids(int $object_id, array<string|int, mixed> $terms, array<string|int, mixed> $tt_ids, string $taxonomy, bool $append, array<string|int, mixed> $old_tt_ids) : mixed
Parameters
- $object_id : int
-
Object ID.
- $terms : array<string|int, mixed>
-
An array of object terms.
- $tt_ids : array<string|int, mixed>
-
An array of term taxonomy IDs.
- $taxonomy : string
-
Taxonomy slug.
- $append : bool
-
Whether to append new terms to the old terms.
- $old_tt_ids : array<string|int, mixed>
-
Old array of term taxonomy IDs.
wc_get_product_visibility_term_ids()
Get full list of product visibility term ids.
wc_get_product_visibility_term_ids() : array<string|int, int>
Tags
wc_recount_all_terms()
Recounts all terms.
wc_recount_all_terms() : void
Tags
_wc_recount_terms_by_product()
Recounts terms by product.
_wc_recount_terms_by_product([int $product_id = '' ]) : void
Parameters
- $product_id : int = ''
-
The ID of the product.
Tags
wc_update_200_file_paths()
Update file paths for 2.0
wc_update_200_file_paths() : void
wc_update_200_permalinks()
Update permalinks for 2.0
wc_update_200_permalinks() : void
wc_update_200_subcat_display()
Update sub-category display options for 2.0
wc_update_200_subcat_display() : void
wc_update_200_taxrates()
Update tax rates for 2.0
wc_update_200_taxrates() : void
wc_update_200_line_items()
Update order item line items for 2.0
wc_update_200_line_items() : void
wc_update_200_images()
Update image settings for 2.0
wc_update_200_images() : void
wc_update_200_db_version()
Update DB version for 2.0
wc_update_200_db_version() : void
wc_update_209_brazillian_state()
Update Brazilian States for 2.0.9
wc_update_209_brazillian_state() : void
wc_update_209_db_version()
Update DB version for 2.0.9
wc_update_209_db_version() : void
wc_update_210_remove_pages()
Remove pages for 2.1
wc_update_210_remove_pages() : void
wc_update_210_file_paths()
Update file paths to support multiple files for 2.1
wc_update_210_file_paths() : void
wc_update_210_db_version()
Update DB version for 2.1
wc_update_210_db_version() : void
wc_update_220_shipping()
Update shipping options for 2.2
wc_update_220_shipping() : void
wc_update_220_order_status()
Update order statuses for 2.2
wc_update_220_order_status() : void
wc_update_220_variations()
Update variations for 2.2
wc_update_220_variations() : void
wc_update_220_attributes()
Update attributes for 2.2
wc_update_220_attributes() : void
wc_update_220_db_version()
Update DB version for 2.2
wc_update_220_db_version() : void
wc_update_230_options()
Update options for 2.3
wc_update_230_options() : void
wc_update_230_db_version()
Update DB version for 2.3
wc_update_230_db_version() : void
wc_update_240_options()
Update calc discount options for 2.4
wc_update_240_options() : void
wc_update_240_shipping_methods()
Update shipping methods for 2.4
wc_update_240_shipping_methods() : void
wc_update_240_api_keys()
Update API keys for 2.4
wc_update_240_api_keys() : void
wc_update_240_webhooks()
Update webhooks for 2.4
wc_update_240_webhooks() : void
wc_update_240_refunds()
Update refunds for 2.4
wc_update_240_refunds() : void
wc_update_240_db_version()
Update DB version for 2.4
wc_update_240_db_version() : void
wc_update_241_variations()
Update variations for 2.4.1
wc_update_241_variations() : void
wc_update_241_db_version()
Update DB version for 2.4.1
wc_update_241_db_version() : void
wc_update_250_currency()
Update currency settings for 2.5
wc_update_250_currency() : void
wc_update_250_db_version()
Update DB version for 2.5
wc_update_250_db_version() : void
wc_update_260_options()
Update ship to countries options for 2.6
wc_update_260_options() : void
wc_update_260_termmeta()
Update term meta for 2.6
wc_update_260_termmeta() : void
wc_update_260_zones()
Update zones for 2.6
wc_update_260_zones() : void
wc_update_260_zone_methods()
Update zone methods for 2.6
wc_update_260_zone_methods() : void
wc_update_260_refunds()
Update refunds for 2.6
wc_update_260_refunds() : void
wc_update_260_db_version()
Update DB version for 2.6
wc_update_260_db_version() : void
wc_update_300_webhooks()
Update webhooks for 3.0
wc_update_300_webhooks() : void
wc_update_300_comment_type_index()
Add an index to the field comment_type to improve the response time of the query used by WC_Comments::wp_count_comments() to get the number of comments by type.
wc_update_300_comment_type_index() : mixed
wc_update_300_grouped_products()
Update grouped products for 3.0
wc_update_300_grouped_products() : void
wc_update_300_settings()
Update shipping tax classes for 3.0
wc_update_300_settings() : void
wc_update_300_product_visibility()
Convert meta values into term for product visibility.
wc_update_300_product_visibility() : mixed
wc_update_300_db_version()
Update DB Version.
wc_update_300_db_version() : mixed
wc_update_310_downloadable_products()
Add an index to the downloadable product permissions table to improve performance of update_user_by_order_id.
wc_update_310_downloadable_products() : mixed
wc_update_310_old_comments()
Find old order notes and ensure they have the correct type for exclusion.
wc_update_310_old_comments() : mixed
wc_update_310_db_version()
Update DB Version.
wc_update_310_db_version() : mixed
wc_update_312_shop_manager_capabilities()
Update shop_manager capabilities.
wc_update_312_shop_manager_capabilities() : mixed
wc_update_312_db_version()
Update DB Version.
wc_update_312_db_version() : mixed
wc_update_320_mexican_states()
Update state codes for Mexico.
wc_update_320_mexican_states() : mixed
wc_update_320_db_version()
Update DB Version.
wc_update_320_db_version() : mixed
wc_update_330_image_options()
Update image settings to use new aspect ratios and widths.
wc_update_330_image_options() : mixed
wc_update_330_webhooks()
Migrate webhooks from post type to CRUD.
wc_update_330_webhooks() : mixed
wc_update_330_set_default_product_cat()
Assign default cat to all products with no cats.
wc_update_330_set_default_product_cat() : mixed
wc_update_330_product_stock_status()
Update product stock status to use the new onbackorder status.
wc_update_330_product_stock_status() : mixed
wc_update_330_clear_transients()
Clear addons page transients
wc_update_330_clear_transients() : mixed
wc_update_330_set_paypal_sandbox_credentials()
Set PayPal's sandbox credentials.
wc_update_330_set_paypal_sandbox_credentials() : mixed
wc_update_330_db_version()
Update DB Version.
wc_update_330_db_version() : mixed
wc_update_340_states()
Update state codes for Ireland and BD.
wc_update_340_states() : mixed
wc_update_340_state()
Update next state in the queue.
wc_update_340_state() : bool
wc_update_340_last_active()
Set last active prop for users.
wc_update_340_last_active() : mixed
wc_update_340_db_version()
Update DB Version.
wc_update_340_db_version() : mixed
wc_update_343_cleanup_foreign_keys()
Remove duplicate foreign keys
wc_update_343_cleanup_foreign_keys() : void
wc_update_343_db_version()
Update DB version.
wc_update_343_db_version() : void
wc_update_344_recreate_roles()
Recreate user roles so existing users will get the new capabilities.
wc_update_344_recreate_roles() : void
wc_update_344_db_version()
Update DB version.
wc_update_344_db_version() : void
wc_update_350_reviews_comment_type()
Set the comment type to 'review' for product reviews that don't have a comment type.
wc_update_350_reviews_comment_type() : mixed
wc_update_350_db_version()
Update DB Version.
wc_update_350_db_version() : mixed
wc_update_352_drop_download_log_fk()
Drop the fk_wc_download_log_permission_id FK as we use a new one with the table and blog prefix for MS compatibility.
wc_update_352_drop_download_log_fk() : void
wc_update_354_modify_shop_manager_caps()
Remove edit_user capabilities from shop managers and use "translated" capabilities instead.
wc_update_354_modify_shop_manager_caps() : mixed
See wc_shop_manager_has_capability function.
wc_update_354_db_version()
Update DB Version.
wc_update_354_db_version() : mixed
wc_update_360_product_lookup_tables()
Update product lookup tables in bulk.
wc_update_360_product_lookup_tables() : mixed
wc_update_360_term_meta()
Renames ordering meta to be consistent across taxonomies.
wc_update_360_term_meta() : mixed
wc_update_360_downloadable_product_permissions_index()
Add new user_order_remaining_expires to speed up user download permission fetching.
wc_update_360_downloadable_product_permissions_index() : void
wc_update_360_db_version()
Update DB Version.
wc_update_360_db_version() : mixed
wc_update_370_tax_rate_classes()
Put tax classes into a DB table.
wc_update_370_tax_rate_classes() : void
wc_update_370_mro_std_currency()
Update currency settings for 3.7.0
wc_update_370_mro_std_currency() : void
wc_update_370_db_version()
Update DB Version.
wc_update_370_db_version() : mixed
wc_update_390_move_maxmind_database()
We've moved the MaxMind database to a new location, as per the TOS' requirement that the database not be publicly accessible.
wc_update_390_move_maxmind_database() : mixed
wc_update_390_change_geolocation_database_update_cron()
So that we can best meet MaxMind's TOS, the geolocation database update cron should run once per 15 days.
wc_update_390_change_geolocation_database_update_cron() : mixed
wc_update_390_db_version()
Update DB version.
wc_update_390_db_version() : mixed
wc_update_400_increase_size_of_column()
Increase column size
wc_update_400_increase_size_of_column() : mixed
wc_update_400_reset_action_scheduler_migration_status()
Reset ActionScheduler migration status. Needs AS >= 3.0 shipped with WC >= 4.0.
wc_update_400_reset_action_scheduler_migration_status() : mixed
wc_update_400_db_version()
Update DB version.
wc_update_400_db_version() : mixed
wc_update_440_insert_attribute_terms_for_variable_products()
Register attributes as terms for variable products, in increments of 100 products.
wc_update_440_insert_attribute_terms_for_variable_products() : bool
This migration was added to support a new mechanism to improve the filtering of variable products by attribute (https://github.com/woocommerce/woocommerce/pull/26260), however that mechanism was later reverted (https://github.com/woocommerce/woocommerce/pull/27625) due to numerous issues found. Thus the migration is no longer needed.
wc_update_440_db_version()
Update DB version.
wc_update_440_db_version() : mixed
wc_update_450_db_version()
Update DB version to 4.5.0.
wc_update_450_db_version() : mixed
wc_update_450_sanitize_coupons_code()
Sanitize all coupons code.
wc_update_450_sanitize_coupons_code() : bool
wc_update_500_fix_product_review_count()
Fixes product review count that might have been incorrect.
wc_update_500_fix_product_review_count() : mixed
See @link https://github.com/woocommerce/woocommerce/issues/27688.
wc_update_500_db_version()
Update DB version to 5.0.0.
wc_update_500_db_version() : mixed
wc_update_560_create_refund_returns_page()
Creates the refund and returns policy page.
wc_update_560_create_refund_returns_page() : mixed
See @link https://github.com/woocommerce/woocommerce/issues/29235.
wc_update_560_db_version()
Update DB version to 5.6.0.
wc_update_560_db_version() : mixed
wc_update_600_migrate_rate_limit_options()
Migrate rate limit options to the new table.
wc_update_600_migrate_rate_limit_options() : mixed
See @link https://github.com/woocommerce/woocommerce/issues/27103.
wc_update_600_db_version()
Update DB version to 6.0.0.
wc_update_600_db_version() : mixed
wc_update_630_create_product_attributes_lookup_table()
Create the product attributes lookup table and initiate its filling, unless the table had been already created manually (via the tools page).
wc_update_630_create_product_attributes_lookup_table() : false
wc_update_630_db_version()
Update DB version to 6.3.0.
wc_update_630_db_version() : mixed
wc_update_640_add_primary_key_to_product_attributes_lookup_table()
Create the primary key for the product attributes lookup table if it doesn't exist already.
wc_update_640_add_primary_key_to_product_attributes_lookup_table() : bool
wc_update_640_db_version()
Update DB version to 6.4.0.
wc_update_640_db_version() : mixed
wc_update_650_approved_download_directories()
Add the standard WooCommerce upload directories to the Approved Product Download Directories list and start populating it based on existing product download URLs, but do not enable the feature (for existing installations, a site admin should review and make a conscious decision to enable).
wc_update_650_approved_download_directories() : mixed
wc_update_651_approved_download_directories()
In some cases, the approved download directories table may not have been successfully created during the update to 6.5.0. If this was the case we will need to re-initialize the feature.
wc_update_651_approved_download_directories() : mixed
wc_update_670_purge_comments_count_cache()
Purges the comments count cache after 6.7.0 split reviews from the comments page.
wc_update_670_purge_comments_count_cache() : mixed
wc_update_700_remove_download_log_fk()
Remove unnecessary foreign keys.
wc_update_700_remove_download_log_fk() : void
wc_update_700_remove_recommended_marketing_plugins_transient()
Remove the transient data for recommended marketing extensions.
wc_update_700_remove_recommended_marketing_plugins_transient() : mixed
wc_update_721_adjust_new_zealand_states()
Update the New Zealand state codes in the database after they were updated in code to the CLDR standard.
wc_update_721_adjust_new_zealand_states() : mixed
wc_update_721_adjust_ukraine_states()
Update the Ukraine state codes in the database after they were updated in code to the CLDR standard.
wc_update_721_adjust_ukraine_states() : mixed
wc_update_722_adjust_new_zealand_states()
Update the New Zealand state codes in the database after they were updated in code to the CLDR standard.
wc_update_722_adjust_new_zealand_states() : mixed
This is a simple wrapper for the corresponding 7.2.1 update function. The reason we do this (instead of reusing the original function directly) is for better traceability in the Action Scheduler log, in case of problems.
wc_update_722_adjust_ukraine_states()
Update the Ukraine state codes in the database after they were updated in code to the CLDR standard.
wc_update_722_adjust_ukraine_states() : mixed
This is a simple wrapper for the corresponding 7.2.1 update function. The reason we do this (instead of reusing the original function directly) is for better traceability in the Action Scheduler log, in case of problems.
wc_update_750_add_columns_to_order_stats_table()
Add new columns date_paid and date_completed to wp_wc_order_stats table in order to provide the option of using the dates in the reports
wc_update_750_add_columns_to_order_stats_table() : mixed
wc_update_750_disable_new_product_management_experience()
Disable the experimental product management experience.
wc_update_750_disable_new_product_management_experience() : void
wc_update_770_remove_multichannel_marketing_feature_options()
Remove the multichannel marketing feature flag and options. This feature is now enabled by default.
wc_update_770_remove_multichannel_marketing_feature_options() : mixed
wc_update_810_migrate_transactional_metadata_for_hpos()
Migrate transaction data which was being incorrectly stored in the postmeta table to HPOS tables.
wc_update_810_migrate_transactional_metadata_for_hpos() : bool
wc_update_860_remove_recommended_marketing_plugins_transient()
Remove the transient data for recommended marketing extensions.
wc_update_860_remove_recommended_marketing_plugins_transient() : mixed
This is removed because it is not used anymore.
It is replaced by woocommerce_admin_marketing_recommendations_specs
transient that is created by MarketingRecommendationsDataSourcePoller
.
wc_update_870_prevent_listing_of_transient_files_directory()
Create an .htaccess file and an empty index.html file to prevent listing of the default transient files directory, if the directory exists.
wc_update_870_prevent_listing_of_transient_files_directory() : mixed
wc_update_890_update_connect_to_woocommerce_note()
If it exists, remove and recreate the inbox note that asks users to connect to `Woo.com` so that the domain name is changed to the updated `WooCommerce.com`.
wc_update_890_update_connect_to_woocommerce_note() : mixed
wc_update_890_update_paypal_standard_load_eligibility()
Disables the PayPal Standard gateway for stores that aren't using it.
wc_update_890_update_paypal_standard_load_eligibility() : mixed
PayPal Standard has been deprecated since WooCommerce 5.5, but there are some stores that have it showing up in their list of available Payment methods even if it's not setup. In WooComerce 8.9 we will disable PayPal Standard for those stores to reduce the amount of new connections to the legacy gateway.
Shows an admin notice to inform the store owner that PayPal Standard has been disabled and suggests installing PayPal Payments.
wc_update_891_create_plugin_autoinstall_history_option()
Create the woocommerce_history_of_autoinstalled_plugins option if it doesn't exist as a copy of woocommerce_autoinstalled_plugins if it exists.
wc_update_891_create_plugin_autoinstall_history_option() : mixed
wc_update_910_add_launch_your_store_tour_option()
Add woocommerce_show_lys_tour.
wc_update_910_add_launch_your_store_tour_option() : mixed
wc_update_910_remove_obsolete_user_meta()
Remove user meta associated with the keys '_last_order', '_order_count' and '_money_spent'.
wc_update_910_remove_obsolete_user_meta() : void
New keys are now used for these, to improve compatibility with multisite networks.
wc_disable_admin_bar()
Prevent any user who cannot 'edit_posts' (subscribers, customers etc) from seeing the admin bar.
wc_disable_admin_bar(bool $show_admin_bar) : bool
Note: get_option( 'woocommerce_lock_down_admin', true ) is a deprecated option here for backwards compatibility. Defaults to true.
Parameters
- $show_admin_bar : bool
-
If should display admin bar.
wc_create_new_customer()
Create a new customer.
wc_create_new_customer(string $email[, string $username = '' ][, string $password = '' ][, array<string|int, mixed> $args = array() ]) : int|WP_Error
Parameters
- $email : string
-
Customer email.
- $username : string = ''
-
Customer username.
- $password : string = ''
-
Customer password.
- $args : array<string|int, mixed> = array()
-
List of arguments to pass to
wp_insert_user()
.
wc_create_new_customer_username()
Create a unique username for a new customer.
wc_create_new_customer_username(string $email[, array<string|int, mixed> $new_user_args = array() ][, string $suffix = '' ]) : string
Parameters
- $email : string
-
New customer email address.
- $new_user_args : array<string|int, mixed> = array()
-
Array of new user args, maybe including first and last names.
- $suffix : string = ''
-
Append string to username to make it unique.
Tags
wc_set_customer_auth_cookie()
Login a customer (set auth cookie and set global user object).
wc_set_customer_auth_cookie(int $customer_id) : mixed
Parameters
- $customer_id : int
-
Customer ID.
wc_update_new_customer_past_orders()
Get past orders (by email) and update them.
wc_update_new_customer_past_orders(int $customer_id) : int
Parameters
- $customer_id : int
-
Customer ID.
wc_paying_customer()
Order payment completed - This is a paying customer.
wc_paying_customer(int $order_id) : mixed
Parameters
- $order_id : int
-
Order ID.
wc_customer_bought_product()
Checks if a user (by email or ID or both) has bought an item.
wc_customer_bought_product(string $customer_email, int $user_id, int $product_id) : bool
Parameters
- $customer_email : string
-
Customer email to check.
- $user_id : int
-
User ID to check.
- $product_id : int
-
Product ID to check.
wc_current_user_has_role()
Checks if the current user has a role.
wc_current_user_has_role(string $role) : bool
Parameters
- $role : string
-
The role.
wc_user_has_role()
Checks if a user has a role.
wc_user_has_role(int|WP_User $user, string $role) : bool
Parameters
- $user : int|WP_User
-
The user.
- $role : string
-
The role.
wc_customer_has_capability()
Checks if a user has a certain capability.
wc_customer_has_capability(array<string|int, mixed> $allcaps, array<string|int, mixed> $caps, array<string|int, mixed> $args) : array<string|int, mixed>
Parameters
- $allcaps : array<string|int, mixed>
-
All capabilities.
- $caps : array<string|int, mixed>
-
Capabilities.
- $args : array<string|int, mixed>
-
Arguments.
wc_shop_manager_has_capability()
Safe way of allowing shop managers restricted capabilities that will remove access to the capabilities if WooCommerce is deactivated.
wc_shop_manager_has_capability(array<string|int, bool> $allcaps, array<string|int, string> $caps, array<string|int, mixed> $args, WP_User $user) : array<string|int, bool>
Parameters
- $allcaps : array<string|int, bool>
-
Array of key/value pairs where keys represent a capability name and boolean values represent whether the user has that capability.
- $caps : array<string|int, string>
-
Required primitive capabilities for the requested capability.
- $args : array<string|int, mixed>
-
Arguments that accompany the requested capability check.
- $user : WP_User
-
The user object.
Tags
wc_modify_editable_roles()
Modify the list of editable roles to prevent non-admin adding admin users.
wc_modify_editable_roles(array<string|int, mixed> $roles) : array<string|int, mixed>
Parameters
- $roles : array<string|int, mixed>
-
Roles.
wc_modify_map_meta_cap()
Modify capabilities to prevent non-admin users editing admin users.
wc_modify_map_meta_cap(array<string|int, mixed> $caps, string $cap, int $user_id, array<string|int, mixed> $args) : array<string|int, mixed>
$args[0] will be the user being edited in this case.
Parameters
- $caps : array<string|int, mixed>
-
Array of caps.
- $cap : string
-
Name of the cap we are checking.
- $user_id : int
-
ID of the user being checked against.
- $args : array<string|int, mixed>
-
Arguments.
wc_get_customer_download_permissions()
Get customer download permissions from the database.
wc_get_customer_download_permissions(int $customer_id) : array<string|int, mixed>
Parameters
- $customer_id : int
-
Customer/User ID.
wc_get_customer_available_downloads()
Get customer available downloads.
wc_get_customer_available_downloads(int $customer_id) : array<string|int, mixed>
Parameters
- $customer_id : int
-
Customer/User ID.
wc_get_customer_total_spent()
Get total spent by customer.
wc_get_customer_total_spent(int $user_id) : string
Parameters
- $user_id : int
-
User ID.
wc_get_customer_order_count()
Get total orders by customer.
wc_get_customer_order_count(int $user_id) : int
Parameters
- $user_id : int
-
User ID.
wc_reset_order_customer_id_on_deleted_user()
Reset _customer_user on orders when a user is deleted.
wc_reset_order_customer_id_on_deleted_user(int $user_id) : mixed
Parameters
- $user_id : int
-
User ID.
wc_review_is_from_verified_owner()
Get review verification status.
wc_review_is_from_verified_owner(int $comment_id) : bool
Parameters
- $comment_id : int
-
Comment ID.
wc_disable_author_archives_for_customers()
Disable author archives for customers.
wc_disable_author_archives_for_customers() : mixed
Tags
wc_update_profile_last_update_time()
Hooks into the `profile_update` hook to set the user last updated timestamp.
wc_update_profile_last_update_time(int $user_id, array<string|int, mixed> $old) : mixed
Parameters
- $user_id : int
-
The user that was updated.
- $old : array<string|int, mixed>
-
The profile fields pre-change.
Tags
wc_meta_update_last_update_time()
Hooks into the update user meta function to set the user last updated timestamp.
wc_meta_update_last_update_time(int $meta_id, int $user_id, string $meta_key, mixed $_meta_value) : mixed
Parameters
- $meta_id : int
-
ID of the meta object that was changed.
- $user_id : int
-
The user that was updated.
- $meta_key : string
-
Name of the meta key that was changed.
- $_meta_value : mixed
-
Value of the meta that was changed.
Tags
wc_set_user_last_update_time()
Sets a user's "last update" time to the current timestamp.
wc_set_user_last_update_time(int $user_id) : mixed
Parameters
- $user_id : int
-
The user to set a timestamp for.
Tags
wc_get_customer_saved_methods_list()
Get customer saved payment methods list.
wc_get_customer_saved_methods_list(int $customer_id) : array<string|int, mixed>
Parameters
- $customer_id : int
-
Customer ID.
Tags
wc_get_customer_last_order()
Get info about customer's last order.
wc_get_customer_last_order(int $customer_id) : WC_Order|bool
Parameters
- $customer_id : int
-
Customer ID.
Tags
wc_user_search_columns()
Add support for searching by display_name.
wc_user_search_columns(array<string|int, mixed> $search_columns) : array<string|int, mixed>
Parameters
- $search_columns : array<string|int, mixed>
-
Column names.
Tags
wc_delete_user_data()
When a user is deleted in WordPress, delete corresponding WooCommerce data.
wc_delete_user_data(int $user_id) : mixed
Parameters
- $user_id : int
-
User ID being deleted.
wc_maybe_store_user_agent()
Store user agents. Used for tracker.
wc_maybe_store_user_agent(string $user_login, int|object $user) : mixed
Parameters
- $user_login : string
-
User login.
- $user : int|object
-
User.
Tags
wc_user_logged_in()
Update logic triggered on login.
wc_user_logged_in(string $user_login, object $user) : mixed
Parameters
- $user_login : string
-
User login.
- $user : object
-
User.
Tags
wc_current_user_is_active()
Update when the user was last active.
wc_current_user_is_active() : mixed
Tags
wc_update_user_last_active()
Set the user last active timestamp to now.
wc_update_user_last_active(int $user_id) : mixed
Parameters
- $user_id : int
-
User ID to mark active.
Tags
wc_translate_user_roles()
Translate WC roles using the woocommerce textdomain.
wc_translate_user_roles(string $translation, string $text, string $context, string $domain) : string
Parameters
- $translation : string
-
Translated text.
- $text : string
-
Text to translate.
- $context : string
-
Context information for the translators.
- $domain : string
-
Text domain. Unique identifier for retrieving translated strings.
Tags
wc_webhook_execute_queue()
Process the web hooks at the end of the request.
wc_webhook_execute_queue() : mixed
Tags
wc_webhook_process_delivery()
Process webhook delivery.
wc_webhook_process_delivery(WC_Webhook $webhook, array<string|int, mixed> $arg) : mixed
Parameters
- $webhook : WC_Webhook
-
Webhook instance.
- $arg : array<string|int, mixed>
-
Delivery arguments.
Tags
wc_deliver_webhook_async()
Wrapper function to execute the `woocommerce_deliver_webhook_async` cron.
wc_deliver_webhook_async(int $webhook_id, mixed $arg) : mixed
hook, see WC_Webhook::process().
Parameters
- $webhook_id : int
-
Webhook ID to deliver.
- $arg : mixed
-
Hook argument.
Tags
wc_is_webhook_valid_topic()
Check if the given topic is a valid webhook topic, a topic is valid if:
wc_is_webhook_valid_topic(string $topic) : bool
- starts with
action.woocommerce_
oraction.wc_
. - it has a valid resource & event.
Parameters
- $topic : string
-
Webhook topic.
Tags
wc_is_webhook_valid_status()
Check if given status is a valid webhook status.
wc_is_webhook_valid_status(string $status) : bool
Parameters
- $status : string
-
Status to check.
Tags
wc_get_webhook_statuses()
Get Webhook statuses.
wc_get_webhook_statuses() : array<string|int, mixed>
Tags
wc_load_webhooks()
Load webhooks.
wc_load_webhooks([string $status = '' ][, null|int $limit = null ]) : bool
Parameters
- $status : string = ''
-
Optional - status to filter results by. Must be a key in return value of @see wc_get_webhook_statuses(). @since 3.5.0.
- $limit : null|int = null
-
Limit number of webhooks loaded. @since 3.6.0.
Tags
wc_get_webhook()
Get webhook.
wc_get_webhook(int|WC_Webhook $id) : WC_Webhook|null
Parameters
- $id : int|WC_Webhook
-
Webhook ID or object.
Tags
wc_get_webhook_rest_api_versions()
Get webhoook REST API versions.
wc_get_webhook_rest_api_versions() : array<string|int, mixed>
Tags
wc_register_widgets()
Register Widgets.
wc_register_widgets() : mixed