Managing Categories

Overview

Categories organize your packages into logical groups, making it easier for users to browse and find downloads. WordPress Download Manager uses a hierarchical category system similar to WordPress posts, allowing parent/child relationships and custom display templates.

Prerequisites

• WordPress Download Manager installed
• Administrator access
• Packages to categorize

Accessing Categories

• Go to Downloads > Categories
• View, add, edit, or delete categories

Creating Categories

Step 1: Add New Category

On the Categories page:

┌─────────────────────────────────────┐
│ Add New Category                    │
├─────────────────────────────────────┤
│ Name:        [Software            ] │
│ Slug:        [software            ] │
│ Parent:      [None               ▼] │
│ Description: [Download software     │
│              packages and apps    ] │
│ Access :     [Select Roles        ] │
└─────────────────────────────────────┘

Step 2: Configure Fields

Field	Description
Name	Display name (e.g., “Software”)
Slug	URL-friendly version (e.g., “software”)
Parent	Parent category for hierarchy
Description	Category description text
Category Image	Image used to visually represent the category
Access	Controls which roles can access this category

Step 3: Save

Click Add New Category to create.

Category Hierarchy

Creating Child Categories

• Add new category
• Select Parent drop-down
• Choose parent category
• Save

Example hierarchy:

Software
├── Windows
├── macOS
└── Linux
    ├── Ubuntu
    └── Fedora
Documents
├── Manuals
├── Guides
└── Templates

Hierarchy Benefits

• Organized navigation
• Inherited permissions (optional)
• Breadcrumb trails
• Nested archive pages

Category Settings

Editing a Category

• Hover over category name
• Click Edit
• Modify settings
• Click Update

Category Options

Setting	Description
Name	Display name
Slug	URL slug
Parent	Parent category
Description	Detailed description
Image/Icon	Category thumbnail
Access	Select the roles

Category Image

Add visual identity:

• Edit category
• Find Category Image input section
• Upload or select image
• Save

Used in:

• Category listings
• Navigation menus
• Archive page headers

Assigning Packages to Categories

When Creating a Package

• Create/edit package
• Find Categories panel (right sidebar)
• Check desired categories
• Save package

Category Quick Edit

• Hover over package
• Click Quick Edit
• Select/deselect categories
• Click Update

Category Display

Archive Pages

Categories automatically have archive pages:

yoursite.com/download-category/software/
yoursite.com/download-category/software/windows/

Shortcode Display

Display category packages:

[wpdm_packages categories="software"]

Multiple categories:

[wpdm_packages categories="software,documents"]

Category Grid

Display categories themselves:

[wpdm_categories style="grid" cols="3"]

Navigation Menus

Add categories to menus:

• Go to Appearance > Menus
• Find Download Categories box
• Check categories to add
• Click Add to Menu
• Arrange as needed
• Save menu

Category Widgets

Category List Widget

Displays category list in sidebar:

• Go to Appearance > Widgets
• Add Download Categories widget

Inheritance

Child categories can inherit parent permissions:

Software (Admin, Editor)
├── Windows (inherits: Admin, Editor)
├── macOS (custom: Admin only)
└── Linux (inherits: Admin, Editor)

Per Package Override

Individual packages can override category settings in their own access control panel.

Category URLs

Default Structure

yoursite.com/download-category/category-slug/

Changing Base Slug

At Downloads > Settings > General > URL Structure:

Category URL Base: [downloads]

Result:

yoursite.com/downloads/software/

After Changing

• Save settings
• Go to Settings > Permalinks
• Click Save Changes (flush rewrites)

SEO for Categories

Category Descriptions

Write unique, keyword-rich descriptions:

Download the latest Windows software including utilities,
productivity apps, and system tools. All software is tested
and safe to use.

Meta Settings

If using SEO plugin:

• Edit category
• Find SEO section
• Set: SEO title, meta description
• Save

WPDM Directory Add-on

WordPress Download Manager Directory Add-on will help WordPress Download Manager users to show all categories and downloads on a single page with different styles.

Bulk Category Management

Import Categories

// Example: Import categories from CSV
$categories = [
    ['name' => 'Software', 'slug' => 'software', 'parent' => 0],
    ['name' => 'Documents', 'slug' => 'documents', 'parent' => 0],
    ['name' => 'Windows', 'slug' => 'windows', 'parent' => 'software'],
];

foreach ($categories as $cat) {
    $parent_id = 0;
    if ($cat['parent']) {
        $parent = get_term_by('slug', $cat['parent'], 'wpdmcategory');
        $parent_id = $parent ? $parent->term_id : 0;
    }

    wp_insert_term($cat['name'], 'wpdmcategory', [
        'slug' => $cat['slug'],
        'parent' => $parent_id,
    ]);
}

Export Categories

• Go to Tools > Export
• Select “Download Categories”
• Download XML file

Delete Multiple Categories

• Go to Downloads > Categories
• Bulk select (check-boxes)
• Choose Delete from Bulk Actions
• Apply

Note: Deleting a category doesn’t delete its packages.

Styling Category Archives

CSS for Archive Pages

/* Category archive header */
.wpdm-category-archive-header {
    background: linear-gradient(135deg, #4f46e5, #7c3aed);
    color: white;
    padding: 40px;
    border-radius: 12px;
    margin-bottom: 32px;
}

.wpdm-category-archive-header h1 {
    font-size: 32px;
    margin-bottom: 8px;
}

.wpdm-category-archive-header .category-description {
    opacity: 0.9;
    font-size: 16px;
}

/* Category image */
.wpdm-category-image {
    width: 80px;
    height: 80px;
    border-radius: 12px;
    object-fit: cover;
    margin-bottom: 16px;
}

/* Package count badge */
.wpdm-category-count {
    display: inline-block;
    background: rgba(255, 255, 255, 0.2);
    padding: 4px 12px;
    border-radius: 20px;
    font-size: 14px;
    margin-top: 16px;
}

Category Grid Styling

/* Category cards */
.wpdm-category-grid {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: 24px;
}

.wpdm-category-card {
    background: white;
    border-radius: 12px;
    padding: 24px;
    text-align: center;
    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
    transition: transform 0.2s, box-shadow 0.2s;
}

.wpdm-category-card:hover {
    transform: translateY(-4px);
    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
}

.wpdm-category-card .category-icon {
    width: 64px;
    height: 64px;
    margin: 0 auto 16px;
}

.wpdm-category-card .category-name {
    font-size: 18px;
    font-weight: 600;
    color: #1e293b;
    margin-bottom: 8px;
}

.wpdm-category-card .package-count {
    color: #64748b;
    font-size: 14px;
}

Common Patterns

Product Catalog Structure

Products
├── Software
│   ├── Business
│   ├── Creative
│   └── Utility
├── Documents
│   ├── Templates
│   ├── Forms
│   └── Guides
└── Media
    ├── Audio
    ├── Video
    └── Graphics

By File Type

Downloads
├── PDF Documents
├── ZIP Archives
├── Audio Files
├── Video Files
└── Image Packs

By User Level

Resources
├── Free Downloads
├── Basic Members
├── Pro Members
└── Enterprise

Troubleshooting

Category Not Showing

Causes:

• No packages in category
• Category not published
• Permissions issue

Solutions:

• Add packages to category
• Verify category exists
• Check access permissions

Wrong Package Count

Cause: Cache or transient issue

Solution:

• Clear object cache
• Edit and re-save category
• Recalculate counts manually

Archive Page 404

Cause: Permalink structure

Solution:

• Go to Settings > Permalinks
• Click Save (no changes needed)
• Clear any caching

Child Categories Not Inheriting

Cause: Inheritance not enabled

Solution:

• Check category settings
• Verify parent-child relationship
• Configure access control properly

Related Documentation

• [wpdm_tag] Shortcode
• [wpdm_categories] Shortcode
• [wpdm_packages] Shortcode
• Access Control
• All Shortcodes

---

Applies to: WordPress Download Manager 7.x