Overview
Page templates control how individual package pages display when users visit the package URL directly. Unlike link templates (for embedded content), page templates provide full-page layouts with comprehensive package information.
Prerequisites
- WordPress Download Manager installed
- Published packages
- Understanding of WordPress template hierarchy
Quick Start
- Go to Downloads > Settings > User Interface
- Select Default Page Template
- Save changes
- Visit any package page to see the template
Available Page Templates
Standard Templates
| Template | Description |
|---|---|
page-template-developer |
Detailed layout for software |
page-template-developer-flavor |
Card-based layout |
page-template-developer-flavor-developer |
Two-column layout |
Visual Templates
| Template | Description |
|---|---|
page-template-developer-flavor-developer-flavor |
Image-focused |
page-template-developer-flavor-developer-flavor-developer |
Gallery style |
Minimal Templates
| Template | Description |
|---|---|
page-template-developer-flavor-developer-flavor-developer-flavor |
Clean minimal |
page-template-developer-flavor-developer-flavor-developer-flavor-developer |
Compact single column |
Using Page Templates
Global Default
Set the default for all packages:
- Go to Downloads > Settings > User Interface
- Find Default Page Template
- Select from dropdown
- Click Save Changes
Per-Package Override
Set template for specific package:
- Edit the package
- Go to Package Settings > General
- Find Page Template
- Select template
- Save package
Theme Template Override
Create theme-level override:
- Create folder in theme:
download-manager/ - Copy template file from plugin
- Modify as needed
- WordPress uses theme version automatically
Template Sections
Page templates typically include these sections:
Header Section
| Element | Description |
|---|---|
| Title | Package name (H1) |
| Meta | Author, date, categories |
| Featured Image | Main package image |
Information Section
| Element | Description |
|---|---|
| Description | Full package content |
| File Details | Size, count, types |
| Version | Current version |
| Requirements | System requirements |
Download Section
| Element | Description |
|---|---|
| Download Button | Primary CTA |
| Lock Forms | If package is locked |
| File List | Individual files (if enabled) |
Sidebar Section
| Element | Description |
|---|---|
| Stats | Download count, views |
| Author | Author info box |
| Related | Related packages |
| Categories | Category links |
Footer Section
| Element | Description |
|---|---|
| Tags | Package tags |
| Share | Social share buttons |
| Changelog | Version history |
Template Comparison
page-template-developer
Classic developer-focused layout:
┌────────────────────────────────────────────────────┐ │ [Featured Image] │ ├────────────────────────────────────────────────────┤ │ Package Title v2.1.0 │ │ By Author Name | Category | Date │ ├────────────────────────────────────────────────────┤ │ │ ┌──────────────┐ │ │ Description │ │ DOWNLOAD │ │ │ Lorem ipsum dolor sit amet...│ └──────────────┘ │ │ │ │ │ │ Size: 5.2 MB │ │ │ Downloads: 1,234 │ │ │ Files: 3 │ ├────────────────────────────────────────────────────┤ │ File List │ │ • file1.pdf (2.1 MB) │ │ • file2.zip (3.1 MB) │ ├────────────────────────────────────────────────────┤ │ Changelog │ │ v2.1.0 - Jan 2026: Added new features... │ └────────────────────────────────────────────────────┘
Best for: Software, code libraries, technical downloads
page-template-developer-flavor
Card-based modern layout:
┌────────────────────────────────────────────────────┐ │ ┌──────────────────────────────────────────────┐ │ │ │ Featured Image │ │ │ └──────────────────────────────────────────────┘ │ ├────────────────────────────────────────────────────┤ │ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │ │ │ Version │ │ Size │ │ Downloads │ │ │ │ 2.1.0 │ │ 5.2 MB │ │ 1,234 │ │ │ └─────────────┘ └─────────────┘ └───────────┘ │ ├────────────────────────────────────────────────────┤ │ ┌──────────────────────────┐ │ │ │ DOWNLOAD NOW │ │ │ └──────────────────────────┘ │ ├────────────────────────────────────────────────────┤ │ Description │ │ Lorem ipsum dolor sit amet, consectetur... │ └────────────────────────────────────────────────────┘
Best for: Products, visual content, modern sites
Template Elements
Available Template Tags
Use these in page templates:
[title] // Package title [description] // Full content [featured_image] // Main image [download_link] // Download button [version] // Version number [package_size] // Total size [download_count] // Downloads [file_list] // List of files [categories] // Category links [tags] // Tag links [author] // Author name [changelog] // Version history [share_buttons] // Social share
Conditional Sections
[has_files]
Files Included
[file_list]
[/has_files]
[has_preview]
[featured_image]
[/has_preview]
Customizing Page Templates
CSS Styling
Add custom styles for page templates:
/* Page template container */
.wpdm-single-page {
max-width: 1200px;
margin: 0 auto;
padding: 40px 20px;
}
/* Download button */
.wpdm-single-page .wpdm-download-link {
font-size: 18px;
padding: 15px 40px;
}
/* Package info cards */
.wpdm-single-page .package-info-card {
background: #f8fafc;
border-radius: 8px;
padding: 20px;
}
Layout Modifications
Create custom template in theme:
[title]
[has_files][featured_image] [description][/has_files] Files Included
[file_list]Changelog
[changelog]
Template Hierarchy
WPDM checks for templates in this order:
your-theme/download-manager/page-template-name.phpyour-theme/download-manager/page-template-default.phpdownload-manager/src/Package/views/page-templates/page-template-name.phpdownload-manager/src/Package/views/page-templates/page-template-default.php
Theme Integration
Full Width Template
For themes with sidebars, use full-width page template:
<?php get_footer();
Removing Theme Elements
If theme adds unwanted elements:
// In theme's functions.php
add_action('wpdm_before_single_package', function() {
remove_action('theme_sidebar', 'display_sidebar');
});
Troubleshooting
Template Not Displaying
Cause: Theme override not in correct location
Solution:
- Verify folder name is exactly
download-manager/ - Check template file name matches exactly
- Clear any caching
Styling Issues
Cause: Theme CSS conflicts
Solution:
- Use browser inspector to identify conflicts
- Add more specific selectors
- Consider using
!importantfor overrides
Missing Elements
Cause: Template tags not recognized
Solution:
- Verify tag spelling
- Check if data exists for that package
- Test with default template first
Related Documentation
Last updated: January 2026
Applies to: WordPress Download Manager 7.x