Installation and Usage
WPDM Directory Add-on also known as WPDM Archive page add-on will help wpdm pro users to show all categories and downloads in a single page. Also added search option for find specific download(s).
Instructions:
- Go to Plugins → Add New → Upload Plugin in your WordPress admin.
- Upload the wpdm-directory-add-on.zip file and activate it.
- Paste any of the shortcodes below into a page or post to display the directory.
Tip: Install the WPDM Gutenberg Block Add-on or the Advanced TinyMCE Button Add-on to generate these shortcodes visually instead of typing them by hand.
Layouts at a Glance
| Layout | Shortcode | Live Demo |
|---|---|---|
| Archive Page Default | [wpdm_archive] |
View Demo |
| Archive Page Compact | [wpdm_archive_compact] |
View Demo |
| Archive Page Simple | [wpdm_archive_simple] |
View Demo |
| Archive Page Flat | [wpdm_archive_flat] |
View Demo |
| Archive Page Green (Default w/ card template) | [wpdm_archive] |
View Demo |
| Archive Page Filter | [wpdm_archive_filter] |
View Demo |
| Advanced Search (Right Sidebar) | [wpdm_archive_filter] |
View Demo |
| Simple Search | [wpdm_simple_search] |
View Demo |
1. Archive Page — Default
A classic sidebar-style directory: category tree on the left/top, package list with search and sort controls on the right.
Demo: Click here…
[wpdm_archive button_style="primary" template="default" order_by="post_title" order="ASC" items_per_page=12 cols=1]Parameters
| Parameter | Description | Example Values |
|---|---|---|
button_style |
Color style of the action buttons | default, success, info, warning, danger, primary, secondary |
template |
Link template ID used to render each package row (optional) | default, app_card, etc. |
category |
Restrict the archive to a specific category slug (optional — omit to show all) | software |
include_children |
When category is used, include packages from sub-categories too |
1 |
orderby |
Field used to sort the list | package_size_b, date, modified, download_count, view_count, title |
order |
Sort direction | asc, desc |
order_fields |
Customize the labels/options shown in the “Order By” dropdown | order_fields="date:Date|title:Title|modified:Last Updated" |
login |
Restrict the whole shortcode to logged-in members only | 1 |
cols |
Number of columns | 1, 2, 3, etc. |
items_per_page |
Number of packages shown per page | 10, 12, etc. |
last_state |
Remember the last opened category/search state for the visitor | 0 or 1 |
2. Archive Page — Green (Card Style)
Same shortcode as the Default layout, restyled with a card-based link template and multi-column grid — a good option when you want a more visual, product-grid look while keeping the sidebar category tree.
Demo: Click here…
[wpdm_archive button_style="success" link_template="app_card" order_by="post_title" order="ASC" items_per_page=12 cols=3 colspad=2 colsphone=1]Parameters
Uses the same parameter set as [wpdm_archive] above, plus:
| Parameter | Description |
|---|---|
link_template |
Link/card template used to render each package (e.g. app_card) |
colspad |
Number of columns shown on tablets |
colsphone |
Number of columns shown on mobile phones |
3. Archive Page — Compact
A condensed, table-like view with a category dropdown filter and sort controls above the list — ideal for directories with a large number of files.
Demo: Click here…
[wpdm_archive_compact template="default" order_by="post_title" order="ASC" items_per_page="12" cols=2]Parameters
| Parameter | Description | Example Values |
|---|---|---|
template |
Link template ID used to render each package row | default, link-template-default |
cols |
Number of columns (desktop) | 2 |
colspad |
Number of columns on tablets | 1 |
colsphone |
Number of columns on phones | 1 |
items_per_page |
Packages shown per page | 10, 12 |
orderby / order_by |
Field used to sort the list | title, date, modified, download_count, view_count, package_size_b |
order |
Sort direction | ASC, DESC |
login |
Restrict to logged-in members only | 1 |
4. Archive Page — Simple
A clean, thumbnail-driven grid layout with a search box and sort dropdown above the package cards.
Demo: Click here…
[wpdm_archive_simple template="msthumnail" order_by="post_title" order="asc" items_per_page="12" cols=3 colspad=2 colsphone=1]Parameters
| Parameter | Description | Example Values |
|---|---|---|
template |
Link template ID used to render each package card | msthumnail, link-template-default |
cols |
Number of columns (desktop) | 3 |
colspad |
Number of columns on tablets | 2 |
colsphone |
Number of columns on phones | 1 |
items_per_page |
Packages shown per page | 12 |
orderby / order_by |
Field used to sort the list | title, date, modified, download_count, view_count, package_size_b |
order |
Sort direction | asc, desc |
login |
Restrict to logged-in members only | 1 |
5. Archive Page — Flat
A single-page “everything at once” layout: a horizontal category nav bar at the top, followed by a flat grid of every package (no pagination needed if items_per_page is set high).
Demo: Click here…
[wpdm_archive_flat order_by="post_title" order="asc" items_per_page="999"]Parameters
| Parameter | Description | Example Values |
|---|---|---|
orderby / order_by |
Field used to sort the list | title, date, modified, download_count, view_count, package_size_b |
order |
Sort direction | asc, desc |
items_per_page |
Packages shown (set a high number, e.g. 999, to effectively show all) |
999 |
login |
Restrict to logged-in members only | 1 |
6. Archive Page — Filter
A faceted-search layout with checkboxes for categories, a “Match Any / All” toggle, date-range filters, and tag filters — best suited for large directories where visitors need to narrow results.
Demo: Click here…
[wpdm_archive_filter items_per_page="9" template="fresh_card" cols=3]Parameters
| Parameter | Description | Example Values |
|---|---|---|
template |
Link template ID used to render each package card (optional) | fresh_card, link-template-default |
category |
Restrict to a specific category slug (optional) | software |
include_children |
Include sub-category packages when category is set |
1 |
orderby |
Field used to sort the list | package_size_b, date, modified, download_count, view_count, title |
order_fields |
Customize “Order By” dropdown labels/options | order_fields="date:Date|title:Title|modified:Last Updated" |
order |
Sort direction | asc, desc |
login |
Restrict to logged-in members only | 1 |
cols |
Number of columns (desktop) | 3 |
colspad |
Number of columns on tablets | 2 |
colsphone |
Number of columns on phones | 1 |
items_per_page |
Packages shown per page | 9, 12 |
sidebar |
Position of the filter sidebar | left, right |
7. Advanced Search (Right Sidebar)
The same Filter shortcode as above, but with the filter sidebar pushed to the right instead of the left, and the package grid using a horizontal thumbnail card template.
Demo: Click here…
[wpdm_archive_filter items_per_page="12" link_template="msthumnail" cols=3 colspad=2 colsphone=1 sidebar="right"]For the left-sidebar variation, simply use
sidebar="left"(or omit the parameter, since left is the default). See: Advanced Search Left Demo
8. Simple Search
A lightweight, standalone search box (no category sidebar/filters) that returns results as horizontal cards. Best used in a widget area or a compact section of a page.
Demo: Click here…
[wpdm_simple_search template="link-template-cardh" cols=2]Parameters
| Parameter | Description | Example Values |
|---|---|---|
template |
Link template ID used to render each result card | link-template-cardh |
cols |
Number of columns | 2 |
9. Category Blocks
Displays selected categories as large, colored navigation blocks/buttons — useful as a visual entry point into your directory.
Demo: Click here…
[wpdm_category_blocks categories="slug1,slug2..." cols=4 button_color="green|blue|purple|primary|info|warning|danger|success|#colorcode" hover_color="primary-hover|info-hover|warning-hover|danger-hover|success-hover|#colorcode"]| Parameter | Description | Example Values |
|---|---|---|
categories |
Comma-separated list of category slugs to display | software,videos,musics |
cols |
Number of columns | 1, 2, 3, 4, 6, 12 |
button_color |
Block color scheme — preset name or hex code | green, blue, purple, primary, info, warning, danger, success, #339966 |
hover_color |
Block hover color — preset name or hex code | primary-hover, info-hover, warning-hover, danger-hover, success-hover, #339966 |
Supporting Shortcodes
These shortcodes work alongside the directory layouts above — for displaying just categories, tags, or category “blocks” on their own.
Categories — [wpdm_categories]
Displays all categories (and optionally sub-categories) as a standalone list/grid.
[wpdm_categories orderby="name" order="DESC" subcat="1" showcount="0" cols=3]| Parameter | Description | Example Values |
|---|---|---|
orderby |
How categories are sorted | name, slug, term_id (or id), count, description, parent |
order |
Sort direction | ASC, DESC |
subcat |
Show (1) or hide (0) sub-categories |
1 |
showcount |
Show (1) or hide (0) the package count per category |
0 |
cols |
Number of columns | 3 |
Tags — [wpdm_tags]
Displays all package tags as buttons.
[wpdm_tags btnstyle="link" icon="tag" showcount=1 cols=3]| Parameter | Description | Example Values |
|---|---|---|
showcount |
Show (1) or hide (0) the package count per tag |
1 |
cols |
Number of columns | 3 |
icon |
Font Awesome icon name | tag |
btnstyle |
Button style | link, secondary, primary, success, info, warning, danger |
Common Parameters Reference
The following parameters appear across multiple shortcodes (wpdm_archive, wpdm_archive_compact, wpdm_archive_simple, wpdm_archive_flat, wpdm_archive_filter):
| Parameter | Description |
|---|---|
template / link_template |
The link template ID used to render each package entry |
category |
Limit the directory to one category slug |
include_children |
Also pull packages from sub-categories of category |
orderby / order_by |
Sort field: package_size_b, date, modified, download_count, view_count, title |
order |
Sort direction: asc / desc |
order_fields |
Customize the “Order By” dropdown options, e.g. order_fields="date:Date|title:Title|modified:Last Updated" |
login |
Set to 1 to restrict the shortcode to logged-in users only |
cols |
Number of columns on desktop |
colspad |
Number of columns on tablets |
colsphone |
Number of columns on phones |
items_per_page |
Number of packages shown per page |
Customizing Templates
To customize how any layout looks, copy its template files into your active theme instead of editing the plugin files directly (so updates don’t overwrite your changes):
- Inside your active theme, create the folder:
download-manager/wpdm-arhive-page/{layout}/— replacing{layout}withsimple,flat,filter, orcompactdepending on which layout you’re customizing. - Copy the relevant template file(s) from
/plugins/wpdm-arhive-page/src/Templates/{Layout}/views/into that new theme folder. - Edit the copied files inside your theme directory as needed — the plugin will automatically use your theme’s version instead of its own.