The [wpdm_packages] shortcode displays multiple packages with powerful filtering options. It works like WordPress’s WP_Query, allowing you to filter by category, tag, author, and more.
Basic Syntax
[wpdm_packages]
This displays all packages with default settings. Add parameters to customize the output.
Parameters
Display Options
| Parameter | Type | Default | Description |
|---|
| items_per_page | integer | 10 | Number of packages to show per page |
| template | string | Default | Link template ID to use |
| cols | integer | 3 | Number of columns on desktop |
| colspad | integer | 2 | Number of columns on tablet |
| colsphone | integer | 1 | Number of columns on mobile |
| paging | 0 or 1 | 1 | Enable or disable pagination |
| toolbar | 0 or 1 | 1 | Show or hide the toolbar |
| async | 0 or 1 | 0 | Load pagination via AJAX |
Category Filtering
| Parameter | Type | Default | Description |
|---|
| categories | string | — | Category slugs, comma-separated |
| xcats | string | — | Categories to exclude, comma-separated |
| include_children | 0 or 1 | 1 | Include child category packages |
| operator | string | IN | IN (any category) or AND (all categories) |
| cat_field | string | slug | Field type: slug, term_id, or name |
Tag Filtering
| Parameter | Type | Description |
|---|
| tags | string | Tag slugs, comma-separated |
| tag_id | integer | Single tag ID |
| tag__and | array | Packages must have ALL these tag IDs |
| tag__in | array | Packages with ANY of these tag IDs |
| tag__not_in | array | Exclude packages with these tag IDs |
Author Filtering
| Parameter | Type | Description |
|---|
| author | integer | Author user ID. Prefix with – to exclude. |
| author_name | string | Author’s user_nicename (not display name) |
| author__not_in | array | Exclude packages from these author IDs |
Sorting
| Parameter | Type | Default | Description |
|---|
| orderby | string | date | Field to sort by: date, title, modified, download_count, view_count, rand |
| order | string | DESC | Sort direction: ASC or DESC |
Access Control
| Parameter | Type | Default | Description |
|---|
| login | 0 or 1 | 0 | Require login to view. Shows login form if not logged in. |
Usage Examples
Display All Packages
[wpdm_packages]
Filter by Category
[wpdm_packages categories="software,plugins" items_per_page="12"]
Exclude Categories
[wpdm_packages xcats="private,archived"]
Author’s Packages
[wpdm_packages author="5" template="link-template-panel"]
Popular Downloads
[wpdm_packages orderby="download_count" order="DESC" items_per_page="10"]
4-Column Grid Layout
[wpdm_packages cols="4" colspad="2" colsphone="1" template="link-template-bsthumnail"]
Members-Only Section
[wpdm_packages login="1" categories="premium-content"]
Related
View Live Demo