[shortcodeglut_kanban]
WooCommerce Kanban Board Shortcode
Complete Documentation for [shortcodeglut_kanban] — Plugin Version 1.5.5
Table of Contents
Overview
The Kanban Board shortcode displays WooCommerce products in a kanban-style board layout with up to 3 columns, where each column represents a product status or type. Products are grouped into color-coded columns with priority indicators, gradient icons, and AJAX-powered “Load More” functionality.
- Kanban board layout with up to 3 configurable columns
- 4 column types: Featured, New Arrivals, On Sale, and Last Chance (low stock)
- Color-coded priority indicators with gradient accents per column
- AJAX “Load More” button per column for progressive loading
- Product cards show: gradient icon, tag label, title, excerpt (10 words), price, and Add to Cart button
- Category filtering and product exclusion
- Configurable section header with custom title
Basic Usage
[shortcodeglut_kanban]
No parameters are required. The shortcode will display a 3-column kanban board showing Featured, New Arrivals, and On Sale products, with 4 products per column and a section header titled “Kanban Board”.
[shortcodeglut_kanban columns="2" show="featured,onsale" category="electronics"]
Displays a 2-column kanban board showing only Featured and On Sale products from the Electronics category.
Parameters Reference
| Parameter | Type | Default | Description |
|---|---|---|---|
| columns | integer | 3 | Number of kanban columns to display. Maximum is 3; values above 3 are clamped. |
| per_column | integer | 4 | Number of products shown per kanban column before the “Load More” button appears. |
| show_header | boolean | 1 | Show the section header above the kanban board: 1 or 0. |
| section_title | string | Kanban Board | Heading text displayed in the section header. |
| show | string | featured,new,onsale | Comma-separated list of column types to display. See Column Types below. |
| category | string | empty | Filter by category slug. Leave empty to show all products. |
| exclude | string | empty | Comma-separated product IDs to exclude. Example: exclude="12,34,56" |
Column Types
The show parameter determines which columns appear in the kanban board. Each column type has its own title, priority level, and color-coded gradient theme. You can specify any combination, but only the first columns number of types will be displayed.
show parameter. Example: show="featured,onsale". The order determines the left-to-right column layout.
| Value | Column Title | Priority | Gradient Color | Description |
|---|---|---|---|---|
| featured | Featured | High | Purple | Products marked as featured in WooCommerce. |
| new | New Arrivals | Medium | Pink | Newest products sorted by date. |
| onsale | On Sale | Low | Green | Products currently on sale. |
| low_stock | Last Chance | Critical | Indigo | Products with stock quantity less than 5. |
show determines the left-to-right layout. For example, show="onsale,featured,new" places the On Sale column first, Featured in the middle, and New Arrivals on the right.
Usage Examples
Example 1: Default Kanban Board
[shortcodeglut_kanban]
Displays a 3-column kanban board with the default columns: Featured, New Arrivals, and On Sale. Each column shows 4 products with a “Load More” button if additional products exist.
Example 2: Two-Column Featured and On Sale
[shortcodeglut_kanban columns="2" show="featured,onsale"]
Shows only the Featured and On Sale columns in a 2-column layout. Useful when you want to focus on curated picks and promotions.
Example 3: Category-Filtered Kanban
[shortcodeglut_kanban category="clothing" section_title="Fashion Board"]
Filters all kanban columns to show only products from the “clothing” category. The section header is customized to read “Fashion Board”.
Example 4: Low Stock Urgency Board
[shortcodeglut_kanban columns="1" show="low_stock" per_column="8" section_title="Last Chance Items"]
A single-column board focused entirely on low-stock products. Shows 8 items before the “Load More” button. Ideal for creating urgency on a dedicated deals page.
Example 5: Exclude Specific Products
[shortcodeglut_kanban exclude="12,34,56" show="featured,new,onsale"]
Displays the default 3-column board but excludes products with IDs 12, 34, and 56 from all columns. Useful for hiding discontinued or seasonal items.
Example 6: No Header, Compact Board
[shortcodeglut_kanban show_header="0" columns="3" per_column="3" show="new,onsale,low_stock"]
A compact 3-column kanban board without the section header. Shows New Arrivals, On Sale, and Last Chance columns with 3 products each. Fits neatly into existing page sections.
Example 7: Single Column New Arrivals
[shortcodeglut_kanban columns="1" show="new" per_column="6" category="electronics"]
A single-column board showing only the newest electronics products. Displays 6 items initially with a “Load More” button for browsing additional products.
Example 8: Full Board with Custom Title
[shortcodeglut_kanban columns="3" show="featured,onsale,low_stock" per_column="4" section_title="Shop Highlights" category="accessories"]
A 3-column kanban board showing Featured, On Sale, and Last Chance products from the “accessories” category. Uses a custom section title “Shop Highlights”.
Tips & Best Practices
The
columns parameter limits how many columns are displayed, even if you list more types in show. For example, if show="featured,new,onsale,low_stock" and columns="2", only “featured” and “new” will appear. Always match the number of column types to your column count.
The kanban board supports a maximum of 3 columns. If you pass
columns="4" or higher, it will be clamped to 3. This ensures each column has enough horizontal space for readable product cards.
The
per_column parameter controls how many products are initially visible in each column. A value of 3–5 keeps the board compact. Products beyond this count are loaded via the AJAX “Load More” button, which keeps page load fast even with large catalogs.
The
low_stock column type (Last Chance) shows products with stock under 5. This is an effective sales tool for creating urgency. Place it as the rightmost column so visitors see featured and sale items first, then feel the pressure of limited availability.
The
exclude parameter accepts comma-separated product IDs: exclude="12,34,56". Excluded products are removed from all columns. Use this to hide out-of-stock items that still have stock data, or products you do not want promoted.
The
category parameter applies to all columns simultaneously. If you set category="electronics", then the Featured column shows only featured electronics, the New column shows only new electronics, and so on.
If you are embedding the kanban board inside a section that already has its own heading, use
show_header="0" to remove the “Kanban Board” header and avoid duplicate titles.
Frequently Asked Questions
Q: What happens if I set columns to more than 3?
A: The value is automatically clamped to 3. The kanban board layout is designed for a maximum of 3 columns to ensure each column has sufficient width for readable product cards on all screen sizes.
Q: Can I show all four column types at once?
A: You can list all four in the show parameter (show="featured,new,onsale,low_stock"), but since the maximum columns is 3, only the first three will be displayed. To see all four, you would need to place two kanban shortcodes on the page.
Q: How does the “Load More” button work?
A: Each column independently loads per_column products initially. If there are more matching products, a “Load More” button appears at the bottom of that column. Clicking it fetches additional products via AJAX without reloading the page.
Q: What does “low_stock” consider as low stock?
A: The low_stock column type shows products where the stock quantity is less than 5. This threshold is set in the plugin source code. Products without stock management enabled will not appear in this column.
Q: Can I filter by more than one category?
A: The category parameter accepts a single category slug. If you need products from multiple categories displayed in a kanban layout, consider using multiple shortcode instances, each filtered to a different category, or use the [shortcodeglut_grid] shortcode instead.
Q: Can I customize the product card layout?
A: The kanban board uses its own built-in card design with a gradient icon, tag label, title, excerpt (10 words), price, and Add to Cart button. Unlike the grid shortcode, it does not support external WooTemplates. The card design is consistent across all columns, with the gradient color varying by column type.
Q: Does this work with variable products?
A: Yes. Variable products appear in the kanban columns based on their parent product status (featured, date, sale price, stock). The displayed price shows the range (e.g., “$10 – $25”) and the Add to Cart button links to the product page where customers can select variations.
ShortcodeGlut — WooCommerce Product Shortcodes Plugin
Version 1.5.5 | Last Updated: May 2026