[listdom_category]
The [listdom_category] shortcode shows a list of the Listdom categories. This shortcode is fully independent and standalone from the Listdom skin shortcodes.
Shortcode Parameters
The parameters of this shortcode are:
- style: Specifies the style of the category display. Valid options are “image”, “simple”, “clean”, and “carousel”.
- Usage:
[listdom_category style="image"]
- Usage:
- hide_empty: Determines whether to hide empty categories. Use the value “1” to hide and “0” to show.
- Usage:
[listdom_category hide_empty="1"]or[listdom_category hide_empty="0"]
- Usage:
- ids: Filters categories by their IDs separated with a comma.
- Usage:
[listdom_category ids="1,2,3"]
- Usage:
- search: Filters categories by a search keyword.
- Usage:
[listdom_category search="keyword"]
- Usage:
- parent: Filters categories by their parent ID. It doesn’t work with the Carousel style.
- Usage:
[listdom_category parent="x"]Here’s a breakdown of how it works:- If
parent="0": Only top-level parent categories are displayed. - If
parent="x"(where “x” is the ID of a specific category): Only the child categories of that specific parent category (with ID “x”) will be displayed.
- If
- Usage:
- orderby: Specifies the order by which to sort categories. The default is “name”.
- Name: Sorts categories by their name.
- Usage:
[listdom_category orderby="name"]
- Usage:
- ID: Sorts categories by their ID numbers.
- Usage:
[listdom_category orderby="ID"]
- Usage:
- Count: Sorts categories by the number of posts assigned to each category.
- Usage:
[listdom_category orderby="count"]
- Usage:
- Name: Sorts categories by their name.
- order: Specifies the order direction (ascending or descending). The default is “ASC”.
- Usage:
[listdom_category order="ASC"]or[listdom_category order="DESC"]
- Usage:
- limit: Limits the number of categories displayed. The default is 8.
- Usage:
[listdom_category limit="10"]
- Usage:
- max_grid: Specifies the maximum number of grid items per row. The default is 8 and this parameter is only available in the image style. Note: This is the maximum number and not the exact number. It means that the number of items per row cannot be more than the value inserted but may be less than that based on the total count.
- Usage:
[listdom_category max_grid="4"]
- Usage:
- grid: Specifies the number of columns in the grid layout. It’s not available in the image style.
- Usage:
[listdom_category grid="3"]
- Usage:
- show_icon: Determines whether to display the icon for each category. The category icon can be selected in the categories settings. Use the value “1” to show and “0” to hide. It only works with the Clean style.
- Usage:
[listdom_category show_icon="1"]or[listdom_category show_icon="0"]
- Usage:
- show_count: Determines whether to display the count of items for each category. Use the value “1” to show and “0” to hide. It doesn’t work with the Carousel style.
- Usage:
[listdom_category show_count="1"]or[listdom_category show_count="0"]
- Usage:
- hierarchical: Determines whether to display hierarchical categories. The default is 0. Use the value “1” to show and “0” to hide.
- Usage:
[listdom_category hierarchical="1"]or[listdom_category hierarchical="0"]
- Usage:
Examples
[listdom_category style=”image” max_grid=”8″ show_count=”1″] 👇
[listdom_category grid=”4″ show_count=”1″] 👇
[listdom_category style=”simple” grid=”3″] 👇
[listdom_category style=”carousel”] 👇
