Ultimate Downloadable Products for WooCommerce
| 开发者 |
ethereumicoio
freemius |
|---|---|
| 更新时间 | 2026年11月7日 18:52 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
It can be a valuable addition to your NFT selling store with the NFT WordPress Plugin Kit!
安装:
- Install and activate it as you would any other plugin.
- Have either WooCommerce or Easy Digital Downloads installed and active — one of the two is enough, and WooCommerce is used when both are.
- Make a new downloadable product (WooCommerce) or a new download (Easy Digital Downloads) and add its files.
屏幕截图:
![The `[ultimate-downloadable-list]` shortcode inside a product description](https://cdn.jsdelivr.net/wp/ultimate-downloadable-products-for-woocommerce/assets/screenshot-16.png)
常见问题:
Does it work with Easy Digital Downloads?
Yes. Since 4.0.0 the plugin shows the download list on Easy Digital Downloads' own download pages as well as on WooCommerce product pages, and the Professional previews (thumbnails, archive contents, audio/video/document samples) work on both. What changed is the activation rule: the plugin no longer declares a hard WooCommerce dependency and no longer refuses to activate without it, because the platform is now picked at runtime — WooCommerce when it is active, Easy Digital Downloads when it is the one that is active.
Can I run WooCommerce and Easy Digital Downloads on the same site?
Please don't: the plugin works with one shop platform per site. On a site where both are active it uses WooCommerce and leaves Easy Digital Downloads alone, which means EDD downloads get no file list, no previews, no per-product settings and no release schedule. The plugin does not break anything in that state — it prints one admin notice naming the platform it is using and what the other one loses, so the situation is visible instead of silent. Deactivate the platform you are not selling with.
What happens if neither WooCommerce nor Easy Digital Downloads is active?
The plugin activates, does nothing on the front end, and prints one admin notice in the dashboard naming the platforms it can work with and linking to the plugins screen. The settings and diagnostics screens keep working, so the notice is not the only place to read the state: wp udp status says Platform: none.
Why do EDD price options appear as several lists?
Because that is how Easy Digital Downloads stores files. A download with variable prices has files attached to a price option, and a file whose condition is all belongs to every option — so EDD itself considers it part of each price, and the plugin prints it under each one, exactly as EDD would hand it out. WooCommerce variable products behave the same way: one list per variation.
Are per-file preview settings kept when I reorder EDD files?
Yes. On Easy Digital Downloads a file has no id of its own, so a per-file setting is attached to the file's condition plus the file itself, never to its row number. Adding, removing or reordering files in the EDD download keeps every setting with the file it was made for.
What is the shortcode?
[ultimate-downloadable-list] prints the download list of the product being displayed. The Downloads tab renders the same list, so the tab and the shortcode never disagree.
Does it work with variable products?
Yes, in the PRO version: each downloadable variation is listed under its own name.
Can I use the shortcode or the block in a block theme?
Yes, both. The block needs no shortcode at all in a single-product template and is the expected way in the site editor; the shortcode still works inside a block template, and outside the loop with product_id. Both render the same list.
Is there an API for a headless storefront?
Yes: GET /wp-json/wc/v3/products/{id}/downloads returns the five public fields of each file. See the REST section above — a scheduled file comes back without its download_url, exactly as it would be hidden on the product page.
How do I see which previews customers actually open?
In the PRO version every preview opened and every sample played is counted per product. WooCommerce → Download analytics lists them with the last 30 days per product, wp udp stats (with the product id) prints one product's counters, and wp udp status prints one summary line. The counts are a plain product meta row, so they survive an update of the plugin, and a preview being opened is never a download: the counters say what was looked at, not what was bought.
Does this stop a customer from downloading before the date?
Yes, for the shop's own download link. Until the unlock instant WooCommerce's download URL answers 403 with a page that says when the file opens and links back to My Account, and the My Account list shows "Available in N days" as text instead of a link. A refused attempt costs the customer nothing: it does not consume a download, does not appear in the download log, does not change the remaining count, and a media or range request (Range: bytes=...) is refused the same way instead of being served in slices. What the plugin controls is the link WooCommerce hands out — the file itself is the next question.
Can a customer download a file before the date?
Not through the shop; and on a protected server, not by copying the file URL either. The plugin writes a rule that blocks direct requests to wp-content/uploads/woocommerce_uploads/, checks once a day that the rule really works, and shows the result on its settings screen. On servers that ignore .htaccess (nginx, most CDNs) the plugin cannot write the rule: it shows you the exact snippet to paste and keeps a warning in your dashboard until the check passes. Use "Force downloads" rather than "Redirect only" — the redirect method hands the file URL to the browser by design, so no rule can protect it. This is not encryption: a file that was already downloaded stays downloaded.
Why did the unlock email arrive late?
The unlock email is a WP-Cron event scheduled for the unlock instant, and WP-Cron runs when somebody visits the site. If DISABLE_WP_CRON is set in wp-config.php and no system cron calls wp-cron.php, the event stays pending in the cron option — it is late, never lost, and it goes out with the next cron run whenever that happens. So that a waiting customer is not made to wait for a cron run, the same check also runs on the My Account downloads page: the mail leaves the first time the customer looks there, at most once an hour per site. Two switches have to be on: "Email the customer when a download unlocks" in the plugin settings, and the "Download ready" email in WooCommerce → Settings → Emails. Turn either off and the schedule still works, silently.
Do I need WooCommerce Subscriptions?
Only for the subscription-aware lock, which is a Professional feature. Without WooCommerce Subscriptions the plugin never looks at subscriptions and a schedule counts from the order. With it, a file stays locked while the subscription is on hold, cancelled or expired, and a renewal does not restart the schedule: the delay counts from the subscription's start, not from the last payment. Verified against WooCommerce Subscriptions 7.6.0.
Why are my image thumbnails missing?
The GD PHP module is required to generate them. The settings screen ends with a Server capabilities report, and wp udp status prints the same matrix from WP-CLI — both are the first thing to check.
What do the audio, video and document previews need?
Audio samples need both the ffmpeg and the ffprobe commands, and video samples need them too; without both, audio and video downloads keep the file type icon, the file size and the file count. Document page images need poppler-utils (the pdftoppm command) or the Imagick PHP extension built with its PDF delegate; when only pdftotext is available the download shows a text excerpt instead of an image. Documents are PDF only — DOCX, ODT and other office formats keep the file type icon row, because rendering them would need a separate office suite on the server.
The samples are also bounded on purpose: the file must be stored under wp-content (a remote download is never sampled), and a source shorter than the sample length plus ten seconds is never sampled, because the sample would be the product. Generation runs in the background, so a freshly saved product may show icons until WP-Cron catches up; wp udp previews media generates the samples from WP-CLI, and the product panel's readiness line says how many are still pending. The settings screen and wp udp status report which of these tools this server actually has.
What are the requirements?
PHP 8.1 or newer, WordPress 6.0 or newer, and either WooCommerce 7.0 or newer or Easy Digital Downloads 3.7.2 or newer (the version this release was tested against; 3.6 and earlier are not verified). Thumbnails need the GD module, the RAR and ISO formats need the matching PHP modules (see below). Audio, video and document previews need extra command line tools — see the preview question above.
Why does the plugin need to write a file to my uploads folder?
Because the link is not the only way to a file. WooCommerce keeps downloads in wp-content/uploads/woocommerce_uploads/, which your web server serves without PHP — no plugin hook is in that path, so a copied URL would work no matter what the schedule says. On an Apache-compatible server (Apache, LiteSpeed) the plugin therefore adds its own marked block to the .htaccess in that folder, adds an index.php there when the folder has none, and on uninstall removes exactly its own block. Lines it did not write are never touched: a php_value directive or a hotlink rule your host put there survives verbatim. Files stored on a remote host or a CDN are not in that folder and are not covered.
What if my server is nginx?
nginx ignores .htaccess, and the plugin does not write server configuration it does not own. The settings screen shows the exact snippet for nginx — location ^~ /wp-content/uploads/woocommerce_uploads/ { deny all; }, or internal; when you use X-Sendfile / X-Accel-Redirect — plus the Caddy and the IIS web.config versions, and it keeps a warning in your dashboard until the check passes. That warning is printed by Ultimate Downloadable Products for WooCommerce itself, because it is this plugin's own daily check that produced it — it is not a WordPress or WooCommerce notice. After saving the snippet, reload the web server and press "Check again".
Why is the warning still there after I added the rule?
Because the plugin believes a measurement, not the file it wrote. Once a day — and every time you press "Check again" — it puts a small temporary .txt file into the downloads folder and requests it over HTTP. 403 or 404 means protected; a 200 or a redirect means a browser can still fetch the file; a timeout, a 401 or a server error means it could not verify, and "could not verify" is never shown as protected. So if the warning survives, one of three things is true: the web server was not reloaded, it is not reading that file, or the site cannot reach itself over HTTP. The same state is written to the WooCommerce log and printed by wp udp status.
Are the downloads protected behind a CDN?
Partly, and the plugin says so where it matters. The rule protects the origin folder. A copy a CDN has already cached keeps being served from the CDN's own URL until that cache is purged — the rule cannot purge it. A file stored on a remote host (a CDN URL in the product's download row) was never in the uploads folder, so no rule on your server applies to it at all; the settings screen names such a file when your shop has one.
How to configure server to support RAR, 7z or ISO?
Follow recommendations from this guide please. Contact the PRO version support for help.
更新日志:
- New: the release schedule works on Easy Digital Downloads — the Free half of 3.1.0 ("files unlock N days after purchase") now applies to EDD downloads as well, and a Professional per-file schedule and absolute date work there too. The merchant sets it on the download exactly as on a WooCommerce product
- New: the buyer is told before clicking. On the receipt EDD prints after payment, and in the purchase history, the plugin adds its own line under each file —
Available in 5 days/Available from 12 March— because EDD prints those links itself and offers no way to replace them. A click still explains itself: the file is refused with a403naming the exact date, and the refusal does not use up the buyer's download count - New: a per-order release override (
wp udp schedule unlock <order> <product> <file> <date>) works on both platforms, so support can open or hold one file of one order without touching the product schedule - Fix: with Easy Digital Downloads the Professional build could answer a blank page — the analytics beacon asked WooCommerce where it was on every page. Fixed, and the same class of defect in
wp udp schedule(which called a WooCommerce function to load the order) is gone too - Changed: the plugin works with one shop platform per site. When both WooCommerce and Easy Digital Downloads are active it uses WooCommerce and prints one admin notice saying which platform is in use and what the other one loses
- Changed: download protection is unchanged and still applies to local files; a file stored as a media-library attachment has a public URL of its own, which no rule can close — the product panel says so
- Requires WooCommerce 7.0 or Easy Digital Downloads 3.7.2, WordPress 6.0 and PHP 8.1
- New: the plugin is no longer WooCommerce-only — the public layer was ported onto a platform seam, and Easy Digital Downloads is the second supported platform. The same download list now appears on an EDD download page, through EDD's own
edd_after_download_contenthook and through the shortcode - New: EDD price options are listed as separate groups, one list per price option, with the group's own label above it. A file whose
conditionisallappears under every option, because that is EDD's own rule - New: the Professional previews work on EDD too — thumbnails, archive contents and the audio, video and document samples. EDD stores its files locally, so the pipeline reads them unchanged; a file size on EDD is measured, because EDD stores none. Per-file preview settings are keyed to the file's
conditionplus the file, not to its row number, so your existing per-file settings are untouched and a reordered file keeps its settings - Changed: the plugin header no longer declares
Requires Plugins: woocommerce. A runtime check now picks the platform after all plugins have loaded (WooCommerce first, Easy Digital Downloads when WooCommerce is absent), and with neither active the plugin activates, does nothing on the front end and prints one admin notice naming what to install — the settings and diagnostics screens stay usable - New:
wp udp statusprints the selected platform as aPlatform:line, so support can see which one a site is running without guessing - Uninstall now also removes the per-user banner-dismissal meta (
udp_platform_notice_dismissed,udp_protection_dismissed), so a site that deletes the plugin keeps no residue - Requires WooCommerce 7.0 or Easy Digital Downloads 3.7.2, WordPress 6.0 and PHP 8.1
- New: a
Downloadable files (UDP)block (ultimate-downloadable-products/downloadable-list) for block themes and the site editor — it renders the download list of the product being viewed, with the same markup as the shortcode, so a single-product template needs no shortcode. It is in both the Free and the PRO build - New:
[ultimate-downloadable-list]takes attributes —product_id,show_size,columns,typesandlayout.columns="3"is a real CSS grid built from a custom property rather than a table,types="audio,video"filters before the summary counts, and the attribute-less shortcode prints byte-for-byte what it printed in 3.2.1 - New:
GET /wp-json/wc/v3/products/{id}/downloadsfor headless storefronts —id,name,type,mimeandsizeper file, and nothing that is not already public. It withholds two things:download_urlisnull, withlocked: true, until a release schedule unlocks the file, andunlock_atis published to the shop owner only. The route reads no order, no user and no download key, and answers404for a product that does not exist or is not downloadable - New (PRO): preview analytics — preview opens and sample plays are counted per product, on a
Download analyticsscreen under WooCommerce (capabilitymanage_woocommerce), inwp udp stats(with the product id) and as one line ofwp udp status. The Free build has no counter, no route and no screen - Documented: the shortcode attribute table, the block name and the REST route, in this readme and in
docs/work/rest-downloads.md - Requires WooCommerce 7.0, WordPress 6.0 and PHP 8.1 (unchanged)
- Fix (PRO): the
Downloads previewblock fits the product form a marketplace vendor edits - the per-file columns no longer push the grid past the panel border, file names wrap at their spaces instead of breaking mid-word, and the block is capped at a readable width so a wide form does not stretch the labels away from their fields - Tested with Dokan 5.3.1: the block is rendered by the marketplace's own product form (its legacy editor,
Settings -> Appearance -> Vendor Product Editor), which is the form that carries the downloadable files; Dokan's new React editor does not render a file list at all, so there is nothing there for a per-file setting to sit on - The gallery now shows the feature: the same settings on a marketplace seller's own product form (screenshot 22)
- New (PRO): marketplace vendor forms - a WCFM, WC Vendors (free or PRO) or Dokan vendor gets the
Downloads previewfields in the front-end product form and can set them for their own product: thumbnail width, blur and blur strength, the media preview, theDownloadstab, and a column per download - The vendor form writes exactly the same meta through the same writer as the product screen, so an administrator sees and can change what a vendor set, and a marketplace re-saving a product never erases it
- The
wp udp statusoutput and the log name the marketplace a save came from - Requires WooCommerce 7.0, WordPress 6.0 and PHP 8.1 (unchanged)
- New: scheduled downloads - a product's files unlock a number of days after purchase, set in WooCommerce's own
Downloadsblock on the product - New: until a file unlocks, My Account shows "Available in N days" instead of a link, the product page says when the files unlock, and a refused download explains itself and uses up nothing
- New: an unlock email when a scheduled file opens - a "Download ready" WooCommerce email under WooCommerce → Settings → Emails, switchable in the plugin settings
- New (PRO): unlock on a fixed date, a separate schedule per file, and an unlock date for one order on the order screen and from
wp udp schedule unlock|status - New (PRO): subscription-aware schedules - files stay locked while the WooCommerce Subscription is not active, and a renewal does not restart the schedule
- New: download protection - the plugin blocks direct requests to the downloads folder on Apache-compatible servers, re-checks once a day that the rule really works, and shows the state, the last check and the exact nginx / Caddy / IIS snippet on the settings screen
- New: a dashboard warning on every admin screen while downloads are not protected - it can be postponed for 7 days and comes back, and the settings row stays red until the check passes
- New:
wp udp statusprints the protection state, and the product panel warns the merchant when a file unlocks after its downloads expire
- New: audio downloads can play a short sample right in the downloads list
- New: video downloads show a blurred poster and play a short sample in a modal window
- New: PDF downloads show their first page as an image, or their opening lines as a text excerpt when no page renderer is available
- New: a per product
Media previewchoice and a per filePreviewcolumn in theDownloads previewpanel, with aSamples readyline for the samples still being generated - New: the settings screen and
wp udp statustell you whether this server can make the samples, andwp udp previews mediagenerates them from WP-CLI - Samples are generated in the background - a product save never starts one - and every sample is a short excerpt, never the product file
- Samples need
ffmpegandffprobe(audio and video) or poppler / Imagick with the PDF delegate (documents); without them every download keeps its icon, size and count
- New: per product preview settings - thumbnail width, blur and blur strength can be set on a single product and inherit the plugin options by default
- New: per file overrides - one download can use its own width, blur or strength
- New: the
Downloadstab can be shown or hidden per product - The product data panel gains a
Downloads previewtab with all of the above
- New: file type icons, file sizes and a file count in the downloads list
- Thumbnails are generated when a product is saved and served as files from the uploads directory, instead of being generated on the first visit and inlined as base64 in the product meta
- New:
wp udp previews regeneratefills the previews of an existing catalogue - The thumbnail cache now includes the download id, so two downloads of one product can point at the same file
- Restructured into layered modules (the plugin behaves exactly as 1.3.5; this release moves code)
- Requires PHP 8.1, WordPress 6.0 and WooCommerce 7.0
- New:
wp udp statusprints the plugin version, the settings and the server capabilities - New: the settings screen ends with a server capability report (GD, ZipArchive, RAR, ISO, ffmpeg)
- freemius library version update
- tested up to WordPress 7.1 and WooCommerce 11.2
- freemius library version update
- freemius library version update
- freemius library version update
- freemius library version update
- Option to show image thumbnails for downloads of type image released in a free plugin version
- Zip and other archive types content display added
- RAR and ISO archive type upload support
- Variable Downloadable products support
- Initial release.