Ohm·Tang

🎯OhmTang SD (Simple Download) adds secure download buttons to WooCommerce product pages for free digital downloads. It enhances WooCommerce’s native download functionality with front-end buttons and protection features.
⚡This plugin is suitable for stores that offer free digital resources such as manuals, guides, samples, and documentation.
⚠️Not for paid digital products: This plugin bypasses WooCommerce’s purchase verification. Do NOT use on stores selling paid downloadable digital products.
<h4>✨ Key Features ✨</h4>
<ul>
<li>📦 Simple Download Buttons: Automatically adds download buttons to WooCommerce products with downloadable files</li>
<li>📍 Flexible Positioning: Choose from 7 different positions to display download buttons on product pages</li>
<li>🔒 Advanced Security: Rate limiting, IP blacklist/whitelist, and nonce verification</li>
<li>📄 File Information Display: Shows file name, extension, and size for each download</li>
<li>🎨 Customizable: Custom text and appearance options</li>
<li>📱 Mobile Responsive: Optimized for all devices</li>
<li>⚙️ Admin Settings Panel: Comprehensive settings page with all configuration options</li>
</ul>
<h3>⚙️ Configuration</h3>
Navigate to WordPress Admin → OhmTang SD to configure:
<ul>
<li>🛒 WooCommerce Integration: Enable/disable WooCommerce integration</li>
<li>📍 Display Position: Choose where to show download buttons (7 options available)</li>
<li>⏱️ Rate Limiting: Set download limits per IP and time period</li>
<li>🚫 IP Filtering: Configure blacklist/whitelist for security</li>
<li>🎨 Appearance: Customize text</li>
</ul>
<h3>🔒 Security Features</h3>
<ul>
<li>⏱️ Rate Limiting: Configurable download limits per IP address (default: 5 per hour)</li>
<li>🌐 IP Filtering: Support for IP blacklist and whitelist with CIDR notation and wildcards</li>
<li>🔐 Nonce Protection: CSRF protection for all download requests</li>
<li>🌍 Real IP Detection: Supports Cloudflare and proxy environments</li>
<li>📂 File Validation: Secure file path validation</li>
</ul>
<h3>📍 Display Options</h3>
Choose from 7 positions to show download buttons: 
* 💰 Below product price 
* 🛒 Above add to cart button 
* ✅ Below add to cart button 
* 📊 Below meta information 
* 📝 Above product details 
* 📋 Below product summary (default) 
* 🔗 Below related products
<h3>WooCommerce Integration</h3>
OhmTang SD integrates seamlessly with WooCommerce products that have downloadable files:
<ul>
<li>Automatic Display: Download buttons automatically appear on product pages with downloadable files</li>
<li>Product Verification: Only shows for products that are marked as downloadable in WooCommerce</li>
<li>Native Compatibility: Uses WooCommerce’s built-in downloadable product functionality</li>
<li>No Purchase Required: Designed for free downloads – bypasses purchase verification</li>
</ul>
<h3>🎨 Customization Options</h3>
<ul>
<li>✍️ Text Customization: Custom titles, button text, notices, and error messages</li>
<li>⏱️ Rate Limiting: Adjustable periods (minute to year) and per-product options</li>
<li>📄 File Display: Shows file name, extension, and size</li>
<li>📅 Time Units: Flexible rate limiting periods (minute, hour, day, week, month, year)</li>
</ul>

OhmTang SD (Simple Download) for WooCommerce

Free download buttons for WooCommerce stores with security features. Rate limiting & IP filtering. Perfect for free resources, not paid downloads.

Abidemi Kusimo

sidocode

Quick Download Button lets you add professional download buttons anywhere on your WordPress site with minimal effort. Whether you are sharing PDFs, music, software, videos, or archives, every aspect of the button — style, colour, icon, countdown, and access rules — is controlled from a clean settings panel or a single shortcode.
Seven button styles
<ul>
<li>Large — full-width panel with prominent icon area</li>
<li>Mid — compact horizontal layout</li>
<li>Small — minimal inline style</li>
<li>Basic — clean, no-frills button</li>
<li>Pill — modern rounded pill shape</li>
<li>Card — elevated card with a panel background</li>
<li>Ghost — outlined transparent style</li>
</ul>
Countdown timer and popup modal
Set a wait time in seconds before the download starts. During the countdown an animated spinner and optional message keep the visitor informed.
Add a popup modal to display any content while the countdown runs — AdSense, banner ads, custom HTML, shortcodes, or any other embed code. You control whether the visitor can dismiss the popup early or whether it stays until the download fires automatically.
Full feature list
<ul>
<li>Works with both the Gutenberg block editor and the Classic Editor via shortcode</li>
<li>Button Row block and <code>[quick_download_button_group]</code> shortcode — place multiple buttons side by side with gap, alignment, and stack-on-mobile controls</li>
<li>Countdown timer — configurable wait time in seconds with a custom message</li>
<li>Popup modal during countdown — show ads or custom HTML/shortcodes while the timer runs; optionally prevent dismissal until the download starts</li>
<li>File size display — auto-calculated from the WordPress uploads folder, or enter any text manually (works with external URLs too)</li>
<li>File type icon — automatically detected for common extensions</li>
<li>Custom download icons — choose from 10 built-in icons or supply your own SVG</li>
<li>Custom file size icons — same built-in set or custom SVG</li>
<li>Icon position — left or right of the button label</li>
<li>Access control — restrict downloads to logged-in users or specific roles</li>
<li>External URL support — link to files hosted anywhere</li>
<li>Hidden download links — the real file URL is never exposed in the page source</li>
<li>Force download — bypasses the browser’s open-in-tab behaviour for supported file types</li>
<li>Open in new tab or same window</li>
<li>Custom button colour, font colour, border, border-radius, padding, and alignment</li>
<li>Panel colour for Card, Pill, and Ghost styles</li>
<li>Multisite compatible</li>
<li>Optimised loading — CSS and JS only enqueue on pages that contain a download button</li>
</ul>
Supported file types for automatic icon display:
<pre><code>pdf, `mp3`, `mov`, `zip`, `txt`, `doc`, `xml`, `mp4`, `ppt`, `htm`, `html`, `ps`, `tex`, `csv`, `xlsx`, `pptx`, `js`, `css`, `php`, and common images (`png`, `gif`, `jpg`, `jpeg`, `bmp`).
</code></pre>
Developer-friendly
The plugin exposes several action and filter hooks so add-on plugins can extend it without editing core files:
<ul>
<li><code>qdb_editor_localize_data</code> — add data to the Gutenberg editor script</li>
<li><code>qdb_localize_script_data</code> — add data to the frontend script</li>
<li><code>qdb_shortcode_atts</code> — modify parsed shortcode attributes</li>
<li><code>qdb_user_can_access</code> — override or extend the access check</li>
<li><code>qdb_button_data_atts</code> — inject extra <code>data-*</code> attributes onto the button element</li>
<li><code>qdb_shortcode_output</code> — filter the final button HTML before output</li>
</ul>
<h3>Basic Usage</h3>
<h4>Gutenberg Block</h4>
<ol>
<li>Open the post or page editor and click the Add Block (+) icon.</li>
<li>Search for Download Button (listed under the Media category).</li>
<li>Click the block to set the button title, then click the upload icon to select or upload your file.</li>
<li>Configure colours, countdown, file size, access control, and popup in the block settings sidebar.</li>
</ol>
<h4>Shortcode — minimal</h4>
<pre><code>[quick_download_button title="Download" url="https://yoursite.com/wp-content/uploads/file.pdf"]
</code></pre>
<h4>Shortcode — external file in a new tab</h4>
<pre><code>[quick_download_button title="Download" url_external="https://example.com/file.zip" open_new_window="true"]
</code></pre>
<h4>Shortcode — countdown with wait message</h4>
<pre><code>[quick_download_button title="Download" url_external="https://example.com/file.zip" wait="15" msg="Please wait 15 seconds..."]
</code></pre>
<h4>Shortcode — popup modal during countdown</h4>
The popup content goes between the opening and closing shortcode tags. It can include HTML, shortcodes, or ad embed code.
<pre><code>[quick_download_button title="Download" url_external="https://example.com/file.zip" wait="15"]<h3>Sponsored by Example Co.</h3>Check out our latest offer.[/quick_download_button]
</code></pre>
To prevent the visitor from closing the popup before the download starts:
<pre><code>[quick_download_button title="Download" url_external="https://example.com/file.zip" wait="15" popup_closable="0"]Ad or message here[/quick_download_button]
</code></pre>
<h4>Shortcode — button group (multiple buttons in a row)</h4>
<pre><code> [quick_download_button_group alignment="center" gap="16"]
 [quick_download_button title="Download v1.0" url_external="https://example.com/v1.zip"]
 [quick_download_button title="Download v2.0" url_external="https://example.com/v2.zip"]
 [/quick_download_button_group]<h3>More Shortcode Examples</h3>
</code></pre>
Auto-calculate file size (file must be in your WordPress uploads folder)
<pre><code>[quick_download_button file_size="1" title="Download" url="https://yoursite.com/wp-content/uploads/file.pdf"]
</code></pre>
Manual file size (works with any URL, including external)
<pre><code>[quick_download_button file_size="14.5 MB" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Hide the file extension icon
<pre><code>[quick_download_button title="Download" extension="0" url="https://yoursite.com/wp-content/uploads/file.pdf"]
</code></pre>
Show file extension icon and text label
<pre><code>[quick_download_button title="Download" extension="1" extension_text="1" url="https://yoursite.com/wp-content/uploads/file.pdf"]
</code></pre>
Change button style
<pre><code>[quick_download_button button_type="pill" title="Download Now" url_external="https://example.com/file.zip"]
</code></pre>
Available values: <code>large</code>, <code>mid</code>, <code>small</code>, <code>basic</code>, <code>pill</code>, <code>card</code>, <code>ghost</code>
Custom colours
<pre><code>[quick_download_button button_type="ghost" color_bg="#0073aa" color_font="#ffffff" panel_color="#f0f8ff" title="Download Now" url_external="https://example.com/file.zip"]
</code></pre>
Custom border
<pre><code>[quick_download_button button_type="small" border_width="2" border_style="solid" border_color="#333333" border_radius="9" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Change icon colour (dark/light)
<pre><code>[quick_download_button button_type="large" color_icon_dark="false" color_bg="#000000" color_font="#ffffff" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Place icon on the right
<pre><code>[quick_download_button icon_position="right" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Restrict to logged-in users
<pre><code>[quick_download_button user_must_be="loggedin" title="Members Only Download" url_external="https://example.com/file.zip"]
</code></pre>
Restrict to a specific role
<pre><code>[quick_download_button user_must_be="subscriber" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Countdown with file size and message
<pre><code>[quick_download_button button_type="basic" wait="10" msg="Your download will begin shortly..." file_size="40 MB" title="Download Now" url_external="https://example.com/file.zip"]
</code></pre>
Button alignment
<pre><code>[quick_download_button align="center" title="Download" url_external="https://example.com/file.zip"]
</code></pre>
Stacked button group, mobile-friendly
<pre><code>[quick_download_button_group layout="stack" alignment="left" gap="8"]
 [quick_download_button title="Windows" url_external="https://example.com/app-win.zip"]
 [quick_download_button title="macOS" url_external="https://example.com/app-mac.zip"]
 [quick_download_button title="Linux" url_external="https://example.com/app-linux.tar.gz"]
[/quick_download_button_group]<h3>For Developers: Using in a Theme or Template File</h3>
echo do_shortcode('[quick_download_button title="Download" url="https://yoursite.com/wp-content/uploads/file.pdf"]');<h3>Shortcode Attributes Reference</h3>
</code></pre>
<h4>[quick_download_button]</h4>
 Attribute 
 Description 
 Default 
 Example value
 `title` 
 Button label text 
 `”Download”` 
 `”Download Now”`
 `url` 
 URL of a file in your WordPress uploads folder 
 — 
 `”https://yoursite.com/wp-content/uploads/file.pdf”`
 `url_external` 
 URL of a file hosted outside WordPress 
 — 
 `”https://example.com/file.zip”`
 `file_size` 
 `”1″` auto-detects size; any other value is displayed as-is 
 — 
 `”1″` or `”14.5 MB”`
 `extension` 
 Show (`”1″`) or hide (`”0″`) the file type icon 
 `”1″` 
 `”0″`
 `extension_text` 
 Also show the extension as text next to the icon 
 `”0″` 
 `”1″`
 `open_new_window` 
 Open link in a new tab 
 `”false”` 
 `”true”`
 `wait` 
 Seconds before the download starts 
 `0` 
 `”15″`
 `msg` 
 Message shown during the countdown 
 `”Please wait…”` 
 `”Loading…”`
 `button_type` 
 Button style 
 `”large”` 
 `large` / `mid` / `small` / `basic` / `pill` / `card` / `ghost`
 `color_bg` 
 Button background colour 
 — 
 `”#ffc107″`
 `panel_color` 
 Panel/card background colour (pill, card, ghost styles) 
 — 
 `”#f0f8ff”`
 `color_font` 
 Button text colour 
 — 
 `”#ffffff”`
 `color_icon_dark` 
 Use dark icon (`”true”`) or light icon (`”false”`) 
 `”true”` 
 `”false”`
 `icon_id` 
 Built-in download icon 
 `”default”` 
 `default` / `cloud` / `circle` / `file-dl` / `inbox` / `save` / `bolt` / `folder` / `archive` / `info` / `chip`
 `file_size_icon_id` 
 Built-in file size icon 
 `”folder”` 
 same set as `icon_id`
 `icon_position` 
 Icon side of the button label 
 `”left”` 
 `”right”`
 `border_width` 
 Border thickness in pixels 
 — 
 `”2″`
 `border_style` 
 CSS border style 
 — 
 `”solid”`
 `border_color` 
 Border colour 
 — 
 `”#333333″`
 `border_radius` 
 Corner rounding in pixels 
 — 
 `”9″`
 `align` 
 Button alignment on the page 
 — 
 `left` / `center` / `right`
 `padding` 
 Vertical padding in pixels 
 — 
 `”12″`
 `user_must_be` 
 Restrict access by role or login 
 — 
 `”loggedin”` / `”subscriber”`
 `validate_msg` 
 Error message shown when access is denied 
 — 
 `”Members only.”`
 `popup_closable` 
 Allow (`”1″`) or prevent (`”0″`) dismissing the popup before countdown ends 
 — 
 `”1″`
The <code>popup_content</code> is passed as enclosed shortcode content (between the opening and closing tags), not as an attribute. This allows unrestricted HTML, ad code, and nested shortcodes.
<h4>[quick_download_button_group]</h4>
 Attribute 
 Description 
 Default 
 Example value
 `layout` 
 `”horizontal”` (side by side) or `”stack”` (column) 
 `”horizontal”` 
 `”stack”`
 `stack_on_mobile` 
 Automatically stack buttons vertically on small screens 
 `”true”` 
 `”false”`
 `alignment` 
 Justify the buttons within the row 
 `”left”` 
 `left` / `center` / `right`
 `gap` 
 Gap between buttons in pixels 
 `”12″` 
 `”20″`
<h3>Donations</h3>
If Quick Download Button saves you time and you’d like to support its development, <a href="https://www.buymeacoffee.com/kusimo" rel="nofollow ugc">buy me a coffee</a>. Thank you!
<h3>Documentation & Source Code</h3>
To report issues or contribute, visit the <a href="https://github.com/kusimo/quick-download-button" rel="nofollow ugc">GitHub repository</a>.

Quick Download Button

Add stylish download buttons to any post or page — 7 styles, countdown, popup modal, access control. Gutenberg block and shortcode.

OhmTang SD (Simple Download) for WooCommerce vs Quick Download Button