Coywolf Files
| 开发者 | jonhenshaw |
|---|---|
| 更新时间 | 2026年8月31日 20:36 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- Coywolf File block — upload a new file or browse to one you have already uploaded, then rename it and add a description for that placement, just like any other block. Per-block toggles control the file-type icon, description, meta line, and the Download / Copy-link buttons.
- Any-sized uploads — files upload directly from the browser to your bucket using presigned URLs, with large files sent in resumable chunks. Nothing passes through PHP, so the maximum size is your bucket's, not your host's.
- Download card — a clean card with a colored file-type badge, the file name, a "type · size · uploaded date" line, and Download and Copy-link controls, with light and dark themes.
- Two providers, one connection — Cloudflare R2 and Amazon S3 both speak the S3 API, so you connect one bucket with an access key, secret key, bucket name, and region (or Cloudflare account ID).
- Private or public buckets — keep your bucket private (the default) and files are served through short-lived signed links behind a stable URL on your own site, or point downloads at a public bucket / CDN URL.
- All Files library — a table of the files currently added to posts and pages, with per-file counts of how many posts and pages use each one (each count links to a filtered list) and a download counter. Deleting a file here removes it from storage and from every post or page that used it.
- Secure credentials — the secret key is stored encrypted, or kept entirely out of the database in wp-config.php.
安装:
- Upload the plugin to wp-content/plugins/coywolf-files or install the zip from Plugins > Add New > Upload Plugin.
- Activate it.
- Go to Files > Settings and connect your Cloudflare R2 or Amazon S3 bucket (access key, secret key, bucket, and region or Cloudflare account ID), then click Test connection.
- Add a CORS rule to your bucket so the browser can upload to it — the exact policy is on the Files > Documentation screen.
- Add the Coywolf File block to a post or page and upload or select a file.
屏幕截图:
常见问题:
Where are my files stored?
In your own object-storage bucket — Cloudflare R2 or Amazon S3. WordPress stores only a small record of each file (name, size, type, and which posts and pages use it) and your settings. Files are not copied into the WordPress media library.
Is there an upload size limit?
The plugin itself imposes no size limit. Files upload directly from the browser to your bucket, so PHP's upload_max_filesize and memory limits do not apply — the limit is whatever your storage provider allows.
Why do I need to set a CORS rule on my bucket?
Because the browser uploads directly to your bucket, the bucket has to allow cross-origin uploads from your site. It is a one-time setting; the Documentation screen gives you the exact policy to paste in.
Can visitors see my storage credentials?
No. The secret key never reaches the browser. Uploads use short-lived presigned URLs, and downloads go through a link on your own site that redirects to a short-lived signed URL (or your public bucket URL, if you configure one).
What happens when I delete a file?
Deleting a file from the All Files screen removes the object from your bucket and strips its block from every post or page that used it. Deleting the plugin does not delete your files from the bucket.
更新日志:
- Point the Plugin URI at the plugin's home page and add plugin screenshots.
- Packaging: the WordPress.org build now passes Plugin Check with zero errors and warnings and carries no self-updater references. No functional change.
- Confirm WordPress 7.1 compatibility (Tested up to: 7.1) (#9).
- Code quality: inline the option and settings-group names at their call sites (WordPress.org prefix-visibility best practice). No functional or data change.
- Rename the block to "Coywolf File" to avoid confusion with WordPress's built-in File block.
- Streamline storage support to Cloudflare R2 and Amazon S3.
- Settings: constrain the appearance preview to a card-like width so it no longer spans the full row.
- Settings: add a live appearance preview — a sample download card that updates as you change the color scheme, accent color, and display toggles.
- Settings: hide the access key, secret key, bucket, storage location, advanced, and connection fields until a provider is selected, so the form reveals itself step by step.
- Settings: show only the storage-location field relevant to the selected provider — Region for Amazon S3, Cloudflare account ID for Cloudflare R2.
- Add a Check CORS button to Settings that runs a real test upload from the browser and reports exactly what to fix (including a missing ExposeHeaders: ETag).
- Expand Documentation with per-provider, step-by-step instructions for getting credentials and configuring the bucket CORS rule (Cloudflare R2, Amazon S3).
- Initial release: the Coywolf File block, direct-to-storage uploads for Cloudflare R2 / Amazon S3, the download card with light and dark themes, and the All Files library.