This page documents Pro edition settings. Upgrade to Pro to access these features.
Pro: Settings Reference
Complete reference for all Pro edition settings. This page documents every setting, its purpose, accepted values, and default configuration.
Accessing Pro Settings
You need an active license key to access and use Pro settings. If you have no active license (or it has expired), the settings screen will be disabled. Activate your key at WP Enhanced > Free Download Woo > License to enable settings.
Go to WP Enhanced > Free Download Woo, then click the section you want in the sidebar.
Pro settings are organized into sections:
- Tracking - Download tracking and email capture
- Download Limits - Quota management
- Newsletter - MailChimp integration
- Reports - Analytics, export data, and delete logs
Tracking Settings
Enable Download Tracking
Setting: Enable Download Tracking
Type: Checkbox
Default: Unchecked
Purpose: Enable logging of all free downloads
When Enabled:
- Creates log entry for each download
- Stores user information and metadata
- Powers statistics and reports
- Required for download limits
Database: Creates somdn_tracked custom post type entries
Enable Email Capture
Setting: Enable Email Capture
Type: Checkbox
Default: Unchecked
Purpose: Show email capture form before downloads
When Enabled:
- Modal form appears before download
- Collects user information
- Validates email addresses
- Stores data in download logs
Requirements: Download tracking must be enabled
Capture Users
Setting: Capture Users
Type: Radio buttons
Default: all
Options:
all- All users (logged-in and guests)guests- Guests only (skip for logged-in users)
Purpose: Control who sees email capture form
Required Fields
Setting: Required Fields
Type: Checkboxes (multiple)
Default: Email only
Options:
email- Email address (always required)fname- First namelname- Last nametel- Phone numbercompany- Company namewebsite- Website URL
Purpose: Make fields required in email capture form
Newsletter Subscription
Setting: Newsletter Subscription
Type: Select dropdown
Default: disabled
Options:
disabled- No subscription optioncheckbox- Optional checkbox (not pre-checked)text- Text only (no checkbox)hidden- Auto-subscribe (no checkbox shown)required- Required checkbox (must check to download)
Purpose: Control newsletter subscription in email capture
Subscription Text
Setting: Subscription Text
Type: Text input
Default: "Subscribe to our newsletter"
Purpose: Label for subscription checkbox
Supports HTML: Yes, basic HTML allowed
Enable Download History
Setting: Enable Download History
Type: Checkbox
Default: Checked
Purpose: Show download history on My Account page
When Enabled:
- Adds "Free Downloads" tab to My Account
- Displays user's download history
- Shows download limits
- Provides re-download links
Download Limits Settings
Enable Download Limits
Setting: Enable Download Limits
Type: Checkbox
Default: Unchecked
Purpose: Enable download quota system
When Enabled:
- Enforces download limits
- Tracks download counts
- Displays limit errors
- Auto-enables tracking
Limit Type
Setting: Limit Type
Type: Radio buttons
Default: user
Options:
user- Track by WordPress user IDip- Track by IP address
Purpose: Method for identifying users
Recommendations:
- Use
userfor accuracy (requires login) - Use
ipfor guests (less accurate)
Frequency
Setting: Frequency
Type: Select dropdown
Default: Day
Options:
Day- Daily limit (resets at midnight)Week- Weekly limit (resets every 7 days)Month- Monthly limit (resets every 30 days)Year- Yearly limit (resets every 365 days)
Purpose: Time period for limit enforcement
Amount
Setting: Amount
Type: Number input
Default: 5
Min: 1
Purpose: Number of downloads allowed per period
Example: 5 with Day frequency = 5 downloads per day
Products
Setting: Products
Type: Multi-select dropdown
Default: Empty (all products)
Purpose: Products subject to limits
Options:
- Empty - Apply to all products
- Selected products - Apply only to selected
Require Login
Setting: Require Login
Type: Checkbox
Default: Unchecked
Purpose: Require login to enforce user ID limits
When Enabled:
- Users must log in to download
- Enables accurate user tracking
- Prevents IP-based circumvention
Note: Only relevant for user limit type
Error Message
Setting: Error Message
Type: Textarea
Default: "You have reached your download limit. Please try again later."
Purpose: Message shown when limit reached
Supports:
- Plain text
- HTML
- Placeholders:
{limit},{frequency},{reset_time}
Example:
You've reached your limit of {limit} downloads per {frequency}.
Your limit resets in {reset_time}.
Newsletter Settings (MailChimp)
MailChimp API Key
Setting: MailChimp API Key
Type: Text input
Default: Empty
Purpose: MailChimp API authentication
Format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1
Validation: Click "Validate API Key" button
Get API Key:
- Log in to MailChimp
- Go to Account > Extras > API Keys
- Create new key
- Copy and paste here
MailChimp List ID
Setting: MailChimp List ID
Type: Select dropdown
Default: Empty
Purpose: Target audience for subscriptions
Options: Populated after API key validated
Validation: Click "Validate List ID" button
Double Opt-In
Setting: Double Opt-In
Type: Checkbox
Default: Checked
Purpose: Require email confirmation
When Enabled:
- User receives confirmation email
- Must click link to confirm
- GDPR compliant
- Reduces spam subscriptions
When Disabled:
- User subscribed immediately
- No confirmation required
- Faster list building
Tags
Setting: Tags
Type: Text input (comma-separated)
Default: Empty
Purpose: Tags applied to subscribers
Format: tag1, tag2, tag3
Placeholders:
{product_id}- Product ID number{product_name}- Product name{variation_id}- Variation ID{variation_name}- Variation name
Example:
free-download, product-{product_id}, {product_name}
Result:
free-download, product-123, Premium eBook
Reports (Export Data tab)
Export preferences are saved when you click Save on the Reports page. The Export Data tab uses the date range from the top of the page and lets you choose what to export (All Downloads, All Products, or Specific Products) and which columns to include.
Export Date Range
Setting: Export Date Range
Type: Radio buttons
Default: all
Options:
all- All timetoday- Today onlyyesterday- Yesterday onlylast_7- Last 7 dayslast_30- Last 30 dayslast_90- Last 90 dayscustom- Custom date range
Purpose: Filter exports by date
Custom Date Range
Settings: Start date, End date
Type: Date picker
Format: YYYY-MM-DD
Purpose: Custom date range for exports
Export Type
Setting: Export Type
Type: Radio buttons
Default: all
Options:
all- All productsspecific- Specific products only
Purpose: Filter exports by product
Selected Products
Setting: Selected Products
Type: Multi-select dropdown
Default: Empty
Purpose: Products to include in export
Note: Only used when export type is specific
Export Columns
Setting: Export Columns
Type: Checkboxes (multiple)
Default: All checked
Options (column labels in the UI):
- Download ID
- Date/Time
- User ID
- Email Address
- User Name
- Product ID
- Product Name
- Variation ID
- Variation Name
- Downloaded Files
- IP Address
- Phone Number
- Company
- Website
- Newsletter Subscription
Purpose: Columns to include in export
User Role Limits
Per-Role Configuration
Setting: User Role Limits (per role)
Type: One set of options per WordPress role (e.g. Subscriber, Customer)
Where: Download Limits → User Role Limits section
Per-role options:
- Enable limits for this role
- Download limit (amount)
- Time period (Day / Week / Month / Year)
- Applicable products
- Custom error message
Purpose: Role-specific download limits
Priority: Role limits override global limits
Membership Plan Limits
Per-Plan Configuration
Setting: Membership Plan Limits (per plan)
Where: Download Limits → Membership Plan Limits; configured per membership plan.
Per-plan options: Enable limits, download limit (amount), frequency, applicable products, error message.
Purpose: Membership-specific limits (override role and global limits).
Free trial limits: Enable trial limits, trial limit amount, trial frequency (when the plan supports trials).
Individual User Limits
Per-User Configuration
Setting: Individual User Limits (per user)
Where: Download Limits → Individual User Limits; set per user (e.g. in user profile or via support).
Per-user options: Enable custom limits, download limit, frequency, applicable products.
Purpose: User-specific limits (highest priority; override role, membership, and global limits).
PDF Watermarking Settings
Enable Watermarking
Setting: Enable Watermarking
Type: Checkbox
Default: Unchecked
Purpose: Enable PDF watermarking
Requirements:
- PHP GD Library
- 128MB+ memory
- 60+ second execution time
Watermark Text
Setting: Watermark Text
Type: Textarea
Default: Empty
Purpose: Text to display as watermark
Placeholders:
{user_name}- User's full name{user_email}- User's email{user_id}- User ID{date}- Download date{time}- Download time{product_name}- Product name{site_name}- Site name{site_url}- Site URL
Example:
Licensed to {user_name} ({user_email}) on {date}
Watermark Position
Setting: Watermark Position
Type: Select dropdown
Default: Bottom Center
Options:
top-left,top-center,top-rightmiddle-left,middle-center,middle-rightbottom-left,bottom-center,bottom-right
Purpose: Watermark placement on page
Font Size
Setting: Font Size
Type: Number input
Default: 12
Range: 8-72 points
Purpose: Watermark text size
Color
Setting: Color
Type: Color picker
Default: Black (#000000)
Format: Hex color code
Purpose: Watermark text color
Opacity
Setting: Opacity
Type: Number input (slider)
Default: 50
Range: 0-100%
Purpose: Watermark transparency
Rotation
Setting: Rotation
Type: Number input
Default: 0
Range: 0-360 degrees
Purpose: Watermark angle
Products
Setting: Products
Type: Multi-select dropdown
Default: Empty (all PDFs)
Purpose: Products to watermark
Database Storage
Options Table
Pro settings are stored in WordPress options. The following correspond to the sidebar sections you see in WP Enhanced > Free Download Woo:
| Settings section (in UI) | Stored as |
|---|---|
| Tracking | Tracking configuration |
| Download Limits (global) | Global limits |
| Download Limits (per role) | Role-based limits |
| Newsletter (MailChimp) | MailChimp config |
| Reports (export options) | Export preferences |
| PDF Watermarking | Watermark config |
Post Meta
Membership limits stored as post meta on membership plan posts.
User Meta
Individual user limits stored as user meta.
Custom Post Type
Download logs stored as somdn_tracked custom post type with extensive post meta.
Default Values Summary
| Setting | Default Value |
|---|---|
| Tracking Enabled | Unchecked |
| Email Capture | Unchecked |
| Capture Users | All users |
| Required Fields | Email only |
| Newsletter Subscription | Disabled |
| Download Limits | Unchecked |
| Limit Type | User ID |
| Frequency | Day |
| Amount | 5 |
| Require Login | Unchecked |
| Double Opt-In | Checked |
| Export Date Range | All time |
| Export Type | All products |
| PDF Watermarking | Unchecked |
| Watermark Position | Bottom Center |
| Font Size | 12pt |
| Opacity | 50% |
Related Topics
- Download Tracking - Tracking feature details
- Download Limits - Limits feature details
- Email Capture - Email capture details
- MailChimp Integration - Newsletter integration
- Reports - Analytics, export, and delete logs
- PDF Watermarking - Watermarking details
- Shortcodes Reference Pro - Pro shortcodes