Quick Download Button
| 开发者 | kusimo |
|---|---|
| 更新时间 | 2026年3月20日 23:35 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.7 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Large — full-width panel with prominent icon area
- Mid — compact horizontal layout
- Small — minimal inline style
- Basic — clean, no-frills button
- Pill — modern rounded pill shape
- Card — elevated card with a panel background
- Ghost — outlined transparent style
- Works with both the Gutenberg block editor and the Classic Editor via shortcode
- Button Row block and
[quick_download_button_group]shortcode — place multiple buttons side by side with gap, alignment, and stack-on-mobile controls - Countdown timer — configurable wait time in seconds with a custom message
- Popup modal during countdown — show ads or custom HTML/shortcodes while the timer runs; optionally prevent dismissal until the download starts
- File size display — auto-calculated from the WordPress uploads folder, or enter any text manually (works with external URLs too)
- File type icon — automatically detected for common extensions
- Custom download icons — choose from 10 built-in icons or supply your own SVG
- Custom file size icons — same built-in set or custom SVG
- Icon position — left or right of the button label
- Access control — restrict downloads to logged-in users or specific roles
- External URL support — link to files hosted anywhere
- Hidden download links — the real file URL is never exposed in the page source
- Force download — bypasses the browser's open-in-tab behaviour for supported file types
- Open in new tab or same window
- Custom button colour, font colour, border, border-radius, padding, and alignment
- Panel colour for Card, Pill, and Ghost styles
- Multisite compatible
- Optimised loading — CSS and JS only enqueue on pages that contain a download button
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).
Developer-friendly
The plugin exposes several action and filter hooks so add-on plugins can extend it without editing core files:
qdb_editor_localize_data— add data to the Gutenberg editor scriptqdb_localize_script_data— add data to the frontend scriptqdb_shortcode_atts— modify parsed shortcode attributesqdb_user_can_access— override or extend the access checkqdb_button_data_atts— inject extradata-*attributes onto the button elementqdb_shortcode_output— filter the final button HTML before output
安装:
- Upload the
quick-download-buttonfolder to/wp-content/plugins/. - Activate Quick Download Button through the Plugins menu in WordPress.
- Add a download button using the Gutenberg block or the
[quick_download_button]shortcode.
屏幕截图:
常见问题:
Can this plugin protect / hide download links?
Yes. When a file is hosted in your WordPress uploads folder, the plugin stores the attachment ID rather than the URL. The real file URL is never printed in the page source. Downloads pass through a server-side check before the file is served.
Does the countdown popup work with Google AdSense?
Yes. Paste your AdSense or any other ad embed code as the shortcode content or enter it in the Popup Content textarea in the Gutenberg block. The plugin renders the content inside a modal overlay while the countdown runs. When the timer reaches zero the download fires and the popup closes automatically.
Can I stop visitors from closing the popup early?
Yes. Set popup_closable="0" in the shortcode or toggle Allow user to close popup off in the block settings. When disabled, the close button, overlay click, and Escape key are all inactive. The popup disappears only when the countdown ends.
What happens when the timer finishes?
The download opens automatically (in the same tab or a new one, depending on your setting), the loading indicator is removed, and the popup modal (if active) closes. No action is required from the visitor.
Does it work with the Classic Editor?
Yes. Use the [quick_download_button] shortcode in the Classic Editor or any text/HTML widget.
Can I display the file size for an external URL?
Yes. Enter the file size manually using the file_size attribute or the Manual file size field in the block editor. Auto-detection only works for files stored in the WordPress uploads folder.
Can I group multiple buttons in one row?
Yes. Use the Button Row block in Gutenberg (add it, then add Download Button blocks inside it), or wrap shortcodes in [quick_download_button_group].
Can I restrict who can download the file?
Yes. Use user_must_be="loggedin" to require login, or user_must_be="subscriber" (or any role slug) to require a specific role. Visitors who do not meet the requirement see a configurable error message.
Does loading the plugin slow down every page?
No. The plugin's CSS and JavaScript only load on pages that actually contain a download button (block or shortcode). All other pages are unaffected.
How do I hide the file size in the Gutenberg block?
Toggle the Show file size option off in the block settings sidebar. In the shortcode, simply omit the file_size attribute.
Can I use my own SVG icon?
Yes. Both the download icon and the file size icon support custom SVG. In the shortcode use custom_file_type_icon or custom_file_size_icon. In the block editor use the Custom SVG textarea in the icon picker panel.
更新日志:
- New: Three additional button styles — Pill, Card, and Ghost — joining the original Large, Mid, Small, and Basic.
- New: Button Row block (Gutenberg) and
[quick_download_button_group]shortcode — arrange multiple buttons horizontally or stacked, with gap and alignment controls and an optional stack-on-mobile mode. - New: Popup modal during countdown — display ads, custom HTML, shortcodes, or any embed code in an overlay modal while the timer counts down. Configured via an enclosed shortcode or a textarea in the block editor.
- New: Popup closable control — choose whether visitors can dismiss the popup early (close button, overlay click, Escape key) or whether it stays until the download fires. Default: closable.
- New: Manual file size — override auto-detected file size with any text, or set a file size for external URLs where auto-detection is not possible.
- New: Built-in icon picker for both the download icon and the file size icon — choose from 11 icons (default arrow, cloud, circle, file-dl, inbox, save, bolt, folder, archive, info, chip) or supply a custom SVG.
- New: Icon position — place the download icon to the left or right of the button label.
- New: Panel colour — separate background colour for the info panel on Pill, Card, and Ghost styles.
- Fixed: File type icons (PDF, ZIP, MP3, etc.) not rendering correctly inside Pill, Card, and Ghost buttons due to overflow clipping.
- Fixed: File size icon and text not properly aligned on the Large, Small, Mid, and Basic styles (missing flex layout on
p.down). - Improved: Frontend JavaScript fully rewritten — single interval timer drives both the inline spinner countdown and the popup countdown simultaneously, preventing double-trigger on fast clicks.
- Improved:
data-qdb-runningguard prevents countdown from stacking if the button is clicked while a timer is already running.
- Fixed: Fatal "ValueError: Path cannot be empty" when using the download block with internally hosted files.
- Technical: Removed incorrect
esc_url()sanitisation that stripped local file paths.
- Optimised: CSS and JavaScript now only load on pages that contain a download button, improving performance site-wide.
- Fixed: 404 error when the Quick Download Button redirect page was deleted. Deactivate and reactivate the plugin to recreate it.
- Fixed: Nonce verification failure when the download link is an external URL.
- New: Access control — restrict downloads by user role and login status.
- Fixed: Large button style CSS broken after upgrade.
- New: Small, Mid, and Basic button styles.
- New: Button alignment — left, centre, right.
- Fixed: Wait message not displaying during the countdown timer.
- New: Multisite support.
- New:
waitandcolor_bgshortcode attributes.