Download the PHP package ww-site/filament-gallery without Composer
On this page you can find all versions of the php package ww-site/filament-gallery. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ww-site/filament-gallery
More information about ww-site/filament-gallery
Files in ww-site/filament-gallery
Package filament-gallery
Short Description Reusable Filament gallery plugin for media source browsing and picking.
License proprietary
Homepage https://github.com/ww-site/filament-gallery
Informations about the package filament-gallery
WwGallery — Filament Gallery
Reusable Filament 5 gallery plugin built around two simple ideas:
- a
media_sourcesentity describing where files live (disk + directory) - a set of Filament UI primitives to upload, browse, pick and display those files
Install from Packagist or via a Composer path repository during local development.
- Package:
ww-site/filament-gallery - Namespace:
WwGallery\FilamentGallery\ - Author: Гончаров Степан — https://wwsite.ru — [email protected]
What's included
| Layer | Class | Purpose |
|---|---|---|
| Model | WwGallery\FilamentGallery\Models\MediaSource |
Parent entity (name, slug, is_active) |
| Model | WwGallery\FilamentGallery\Models\MediaSourceSetting |
Key/value settings (e.g. disk, directory) |
| Service | WwGallery\FilamentGallery\Services\MediaSourceBrowserService |
List / upload / delete files on a source |
| Resource | WwGallery\FilamentGallery\Filament\Resources\MediaSources\MediaSourceResource |
Admin CRUD for media sources and settings |
| Page | WwGallery\FilamentGallery\Filament\Pages\GalleryContent |
Filament page to browse & manage files |
| Form field | WwGallery\FilamentGallery\Forms\Components\MediaPicker |
Upload + pick image from a media source |
| Column | WwGallery\FilamentGallery\Tables\Columns\MediaPreviewColumn |
Table preview resolving disk from a source |
| Entry | WwGallery\FilamentGallery\Infolists\Components\MediaPreviewEntry |
Infolist preview resolving disk from a source |
| Plugin | WwGallery\FilamentGallery\FilamentGalleryPlugin |
Filament panel plugin entry point |
| Provider | WwGallery\FilamentGallery\FilamentGalleryServiceProvider |
Loads migrations, config, views, langs |
Installation in a host project
-
Install via Composer from Packagist:
Or, for local development from a path repository:
- Run
composer update ww-site/filament-gallery. -
Register the plugin inside the target panel provider:
- Run migrations:
php artisan migrate. - (Optional) publish config/translations:
Filament admin theme & Tailwind (styling)
Filament 5 builds the panel CSS with Vite and Tailwind CSS v4. Your panel theme.css only includes utilities for files listed in @source directives. This package ships Blade views and HTML built from PHP (e.g. gallery thumbnails inside the MediaPicker modal). If you do not extend Tailwind’s content paths, those screens look unstyled (oversized images, missing layout).
In your host app, open the Filament theme file you pass to ->viteTheme(...) (for example resources/css/filament/admin/theme.css) and add both lines (paths are relative to that file; adjust if your theme lives elsewhere):
Then rebuild assets:
After every composer update ww-site/filament-gallery, run the build again if the package added or changed Tailwind classes.
Usage
Seed a media source
Pick an image inside a form
Render a preview in a table
Render a preview in an infolist
Render a resized image URL
If only width or only height is passed, the helper keeps the original image ratio.
Configuration
Default config is in config/filament-gallery.php:
page.accepted_file_types/page.max_upload_size— uploads on the gallery pagepicker.accepted_file_types/picker.max_upload_size— uploads via the MediaPickerimage.cache_disk/image.cache_directory— where resized images are cachedimage.default_quality/image.default_format/image.default_crop— default image processing optionsregister_gallery_page/register_media_sources_resource— toggles to hide pieces from a panel
Per-panel overrides live on the plugin:
Translations
Package ships with en and ru. Add your own by publishing translations and
editing lang/vendor/filament-gallery/<locale>/filament-gallery.php.
Testing
Automated tests live in this package (PHPUnit + Orchestra Testbench). They are not installed in host applications — only require-dev when you work on the package itself.
From the package root (e.g. a git clone or your monorepo packages/ww-gallery):
composer test runs phpunit using phpunit.xml.dist.
What is covered today:
MediaSource— settings,getDisk()/getDirectory(), defaultsMediaSourceBrowserService— listing, image filter, upload, delete with path prefix rulesFilamentGalleryPlugin— stable plugin id
Contributors: add cases under tests/Unit/ and keep declare(strict_types=1); on new files.
Roadmap
- lightbox/viewer for the gallery page
- multi-file MediaPicker mode
- per-source policies / authorization hooks
- PSR-4 autodiscovery inside the panel provider
- broader Filament/Livewire feature tests (optional)
All versions of filament-gallery with dependencies
filament/filament Version ^5.5
intervention/image Version ^3.0
illuminate/contracts Version ^12.0
illuminate/database Version ^12.0
illuminate/support Version ^12.0