Requirements & Compatibility
Overview
WordPress Download Manager is designed to work with most WordPress hosting environments. This guide outlines the minimum and recommended requirements for optimal performance.
Prerequisites
- Active WordPress installation
- FTP/SFTP access or WordPress admin file upload capability
- Basic understanding of WordPress plugin installation
Quick Start
Most modern WordPress hosts meet all requirements. If you can run WordPress 5.0+, you can run WPDM.
Server Requirements
Minimum Requirements
| Component | Minimum | Notes |
|---|---|---|
| WordPress | 5.0 | Core functionality requires 5.0+ |
| PHP | 7.4 | Security support ended Dec 2022 |
| MySQL | 5.6 | Or MariaDB 10.0+ |
| Memory | 128MB | PHP memory_limit |
Recommended Requirements
| Component | Recommended | Notes |
|---|---|---|
| WordPress | 6.4+ | Latest features and security |
| PHP | 8.1+ | Best performance and security |
| MySQL | 8.0 | Or MariaDB 10.6+ |
| Memory | 256MB+ | Required for large file handling |
PHP Extensions
These PHP extensions are required or recommended:
| Extension | Required | Purpose |
|---|---|---|
curl |
Yes | Remote file operations, API calls |
zip |
Yes | Creating ZIP archives for multi-file packages |
mbstring |
Yes | Multibyte string handling |
json |
Yes | JSON encoding/decoding |
gd or imagick |
Recommended | Image processing for thumbnails |
openssl |
Recommended | Secure connections, encryption |
fileinfo |
Recommended | MIME type detection |
PHP Configuration
Adjust these settings in php.ini or via .htaccess for optimal performance:
; Memory and execution memory_limit = 256M max_execution_time = 300 ; File uploads upload_max_filesize = 256M post_max_size = 256M max_file_uploads = 20 ; Session handling session.gc_maxlifetime = 3600
Setting via .htaccess (Apache)
php_value memory_limit 256M php_value upload_max_filesize 256M php_value post_max_size 256M php_value max_execution_time 300
Setting via wp-config.php
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
WordPress Compatibility
Core WordPress
| WPDM Version | WordPress Compatibility |
|---|---|
| 6.x | WordPress 5.0 – 6.4 |
| 7.x | WordPress 5.6 – 6.5+ |
Multisite Support
WordPress Download Manager fully supports WordPress Multisite:
- Network-wide activation
- Per-site configuration
- Shared file storage options
- Network admin controls
Block Editor (Gutenberg)
Full Gutenberg compatibility with dedicated Editor Blocks:
- WPDM Package block
- WPDM Packages list block
- WPDM Categories block
- WPDM Search block
Classic Editor is also fully supported.
Theme Compatibility
WPDM works with any properly coded WordPress theme. Tested with with
all default and renowned themes.
Theme Requirements
Your theme should:
- Include
wp_head()in header - Include
wp_footer()before - Support
the_contentfilter - Not override WordPress query handling
Custom Post Type Archives
If your theme supports custom post type archives, WPDM integrates automatically. Otherwise, use shortcodes or the Archive Page add-on.
Plugin Compatibility
Fully Compatible
| Plugin | Notes |
|---|---|
| Yoast SEO | Full meta, sitemap, breadcrumb support |
| Rank Math | SEO integration |
| WooCommerce | Can coexist; use Premium Packages for WPDM e-commerce |
| WPML | Multilingual package support |
| Loco Translate | Multilingual support |
| Wordfence | Security scanning compatible |
| WP Super Cache | Caching compatible |
| W3 Total Cache | Caching compatible |
| Elementor | Widget add-on available |
| WPBakery | Shortcode support |
Known Conflicts
| Plugin | Issue | Solution |
|---|---|---|
| Download Monitor | Shortcode conflicts | Use one or the other |
| Some security plugins | May block download URLs | Whitelist WPDM paths |
| Aggressive caching | May cache download pages | Exclude /download/ URLs |
Caching Plugin Configuration
For caching plugins, exclude these URLs:
/download/* /?wpdmdl=* /checkout/* /cart/*
Browser Compatibility
Desktop Browsers
| Browser | Minimum Version |
|---|---|
| Chrome | 90+ |
| Firefox | 88+ |
| Safari | 14+ |
| Edge | 90+ |
Mobile Browsers
| Browser | Support |
|---|---|
| Chrome Mobile | Full support |
| Safari iOS | Full support |
| Firefox Mobile | Full support |
| Samsung Internet | Full support |
JavaScript Requirements
WPDM requires JavaScript enabled for:
- Download button interactions
- Lock form submissions
- Admin panel functionality
- AJAX-based features
Hosting Recommendations
Shared Hosting
Works on most shared hosts. Ensure:
- PHP 7.4+ available
- Sufficient disk space for files
- No aggressive resource limits
VPS/Dedicated
Recommended for high-traffic sites or large file libraries.
Managed WordPress Hosting
Tested and compatible with:
- WP Engine
- Kinsta
- Flywheel
- SiteGround
- Hostinger
- Bluehost
Cloud Hosting
For large file storage, consider cloud integrations:
- Amazon S3 (via add-on)
- Google Drive (via add-on)
- OneDrive Integration (via add-on)
- Dropbox Explorer (via add-on)
- pCloud Connector (via add-on)
- Box.com Explorer (via add-on)
File System Requirements
Directory Permissions
| Directory | Permission | Purpose |
|---|---|---|
/wp-content/uploads/ |
755 | WordPress uploads |
/wp-content/uploads/download-manager-files/ |
755 | WPDM file storage |
/wp-content/uploads/wpdm-cache/ |
755 | Temporary files |
Disk Space
Plan disk space based on your needs:
| Usage | Recommended Space |
|---|---|
| Small site (<100 files) | 5GB |
| Medium site (100-1000 files) | 50GB |
| Large site (1000+ files) | 200GB+ |
Consider cloud storage add-ons for unlimited scaling.
SSL/HTTPS
Recommendation
HTTPS is strongly recommended for:
- Secure file downloads
- Payment processing (required for Premium Packages)
- User data protection
- SEO benefits
Database Requirements
Table Prefix
WPDM uses the ahm_ prefix for custom tables:
wp_ahm_download_statswp_ahm_emailswp_ahm_sessions- (and others)
Database Size
Estimated database growth:
| Downloads/Month | Approx. DB Growth |
|---|---|
| 1,000 | ~5MB/month |
| 10,000 | ~50MB/month |
| 100,000 | ~500MB/month |
Consider periodic cleanup for high volume sites.
Checking Your Environment
Health Check Plugin
Install the Site Health plugin (built into WordPress 5.2+):
- Go to Tools > Site Health
- Review PHP version, extensions, and limits
- Address any critical issues
WPDM System Status
After installation:
- Go to Downloads > Settings > System Info
- Review detected configuration
- Note any warnings
Troubleshooting Compatibility
PHP Version Issues
Symptom: White screen or fatal errors on activation
Solution: Upgrade PHP via hosting control panel or contact host
Memory Limit Issues
Symptom: “Allowed memory size exhausted” errors
Solution: Increase memory_limit in php.ini or wp-config.php
Upload Size Issues
Symptom: Large files fail to upload
Solution: Increase upload_max_filesize and post_max_size
Permission Issues
Symptom: Files don’t save or download
Solution: Set correct directory permissions (755) and file permissions (644)
Related Documentation
Applies to: WordPress Download Manager 7.x