Download the PHP package imsyuan/filament-image-caption-upload without Composer
On this page you can find all versions of the php package imsyuan/filament-image-caption-upload. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download imsyuan/filament-image-caption-upload
More information about imsyuan/filament-image-caption-upload
Files in imsyuan/filament-image-caption-upload
Download imsyuan/filament-image-caption-upload
More information about imsyuan/filament-image-caption-upload
Files in imsyuan/filament-image-caption-upload
Vendor imsyuan
Package filament-image-caption-upload
Short Description Filament v5 FileUpload component with per-image caption support
License MIT
Homepage https://github.com/imsyuan/filament-image-caption-upload
Package filament-image-caption-upload
Short Description Filament v5 FileUpload component with per-image caption support
License MIT
Homepage https://github.com/imsyuan/filament-image-caption-upload
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package filament-image-caption-upload
Filament Image Caption Upload
English | 繁體中文
A Filament v3 form component that extends the built-in FileUpload to attach a per-image caption beneath each uploaded file — with no build step required.
Features
- Drop-in replacement — extends Filament's native
FileUpload, so every existing option (->image(),->multiple(),->reorderable(),->disk(),->directory(),->maxFiles(), …) works unchanged - Zero build step — no npm, no Vite, no esbuild; pure Blade + Alpine.js inline
- Reorder-safe — captions follow their image through drag-and-drop reordering
- Duplicate-filename safe — maps FilePond internal IDs to Filament UUIDs directly, so ten files all named
banner.jpgeach keep their own caption - Race-condition safe — captions typed before an upload finishes are preserved and migrated to the final UUID automatically
- Simple storage — saved as a plain
[{image, caption}]JSON array in a single column; no extra tables or relationships needed
Requirements
- PHP 8.2+
- Laravel 10+
- Filament 3.x
Installation
Choose the version that matches your Filament installation:
| Filament | Version |
|---|---|
| 3.x | ^1.0 |
| 4.x | ^2.0 |
| 5.x | ^3.0 |
Laravel auto-discovers the service provider — no manual registration needed.
Usage
Cast the column as an array in your model:
Each field saves an array of {image, caption} pairs:
Options
captionPlaceholder(string|Closure $placeholder)
Sets the placeholder text shown inside each caption input. Accepts a plain string or a closure. Defaults to 'Caption...'.
All native FileUpload options
Because ImageCaptionUpload extends Filament's FileUpload directly, every built-in option is available:
How it works
- Hydration —
[{image, caption}]from the database is split on load: file paths go into Filament's UUID-keyed state; captions are stored in a sibling Livewire key (_icap_<fieldname>). - Alpine — A
MutationObserverwatches for FilePond item additions and injects a caption<input>beneath each file panel. Typing syncs directly to Livewire state via$wire.set(). - UUID mapping — FilePond's internal IDs are mapped to Filament UUIDs by reading the FilePond instance directly (
pond.getFiles()), ensuring correctness regardless of stored filename or UUID-based disk naming. - Dehydration — On save,
{uuid: path}and{uuid: caption}are zipped back into[{image, caption}].
License
MIT — see LICENSE.
All versions of filament-image-caption-upload with dependencies
PHP Build Version
Package Version
The package imsyuan/filament-image-caption-upload contains the following files
Loading the files please wait ...