开发者 | ninetyninew |
---|---|
更新时间 | 2024年11月2日 19:53 |
WordPress版本: | 6.6.2 |
版权: | GNU General Public License v3.0 |
版权网址: | 版权信息 |
x
with your attribute name:
[wcpas_product_attributes attribute="x"]
If your attribute has spaces in the name then replace these with hyphens in the shortcode, if you have other characters in your attribute name see the related FAQ below.
There are various other shortcode attributes which can be used, if these are omitted the defaults are used, the available shortcode attributes are:
archive_links
- 1
to enable archive links e.g. /brand/sega/
, 0
to disable e.g. /shop/?filter_brand=sega
, default is 0
categorize
- first_character
to categorize the terms list by first character, default is emptycurrent_attribute_link
- 1
to still display a link if the current page, 0
to disable, default is 1
hide_empty
- 1
to hide empty terms, 0
to disable, default is 1
links_target
- Use a HTML link target e.g. _blank
to open links in a new window, default is emptymin_price
- Use a minimum price number for links to include a minimum price filter, requires archive_links="0"
, default is emptymax_price
- Use a maximum price number for links to include a maximum price filter, requires archive_links="0"
, default is emptyorder
- asc
or desc
, default is asc
orderby
- Any orderby parameter, default is nameshow_counts
- 1
to enable display of term counts, 0
to disable, default is 0
show_descriptions
- 1
to enable display of term descriptions, 0
to disable, default is 0
[wcpas_product_attributes attribute="brand" archive_links="0" categorize="first_character" current_attribute_link="0" hide_empty="0" links_target="_blank" min_price="50.00" max_price="500.00" order="desc" orderby="id" show_counts="1" show_descriptions="1"]
(BETA)
label. Functionality with this label should be used with caution and is only recommended to be tested on a staging/development environment. The functionality is included so users can test the functionality/provide feedback before it becomes stable, at which point the (BETA)
label will be removed. Note that there may be occasions where BETA functionality is determined unsuitable for use and removed entirely.
Caching
If you are using any form of caching then it is recommended that the cache lifespan/expiry should be set to 10 hours or less. This is recommended by most major caching solutions to avoid potential issues with WordPress nonces.
Screen Sizes
Ensure you have included the shortcode correctly and that the attribute you are using has products assigned. If nothing is still displaying the attribute name you have entered may not be in the correct format, see the related FAQ for more information.
If your attribute is a single word you just need to enter that. If your attribute has spaces in the name, replace these with hyphens in the shortcode attribute. For more complex attribute names e.g. with special characters you can determine what the attribute name is by editing the attribute in Products > Attributes, in the URL you will see something like /edit-tags.php?taxonomy=pa_example-attribute&post_type=product
, the part after the pa_
and before the &
is your attribute name, in this example it is example-attribute
.
The list will not include links on the terms if you are using archive_links="1"
and the attribute used does not have archives enabled on the attribute which is set when editing the attribute in Products > Attributes .
Links are filter based which use your shop page (unless you are using archive_links="1"
), if they are not working you may have not configured a shop page in WooCommerce, this is created during installation of WooCommerce, if it has been removed it will need recreating.
These are filter based and therefore require archive_links="0"
.
Use the categorize
shortcode attribute as described in the usage information above.
You can use it anywhere you can use a shortcode.
Yes, use the do_shortcode
function of WordPress to echo the shortcode.
The output is based on a <ul>
element, however you can use some custom CSS to make the <ul>
list display horizontally, and optionally with a separating character, such as a comma. See this custom CSS example. If using the categorize
shortcode attribute the linked example will need some additional custom CSS rules due to the additional category markup it includes.
We intentionally do not add any default styling to keep the extension as simple/lightweight as possible and to reduce the need to override any default CSS styles. If you wish to add your own styling, you will need to apply some custom CSS styling, each shortcode used outputs a parent <ul>
element containing child elements. All elements have classes and IDs for custom CSS styling purposes.