PHPackages                             lisa-fehr/gallery - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. lisa-fehr/gallery

ActiveProject[Framework](/categories/framework)

lisa-fehr/gallery
=================

Gallery package for existing site

3.0(2y ago)011MITPHPPHP ^8.1

Since Apr 13Pushed 1y ago1 watchersCompare

[ Source](https://github.com/lisa-fehr/gallery)[ Packagist](https://packagist.org/packages/lisa-fehr/gallery)[ RSS](/packages/lisa-fehr-gallery/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (6)Dependencies (3)Versions (9)Used By (0)

Gallery
=======

[](#gallery)

Packaged version of the recreate gallery project

[![Screen Shot 2024-05-19 at 3 41 36 AM](https://private-user-images.githubusercontent.com/6653340/331855480-fd768d85-75fa-4c76-bebe-27a5b88e9e98.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU2ODg2NTgsIm5iZiI6MTc3NTY4ODM1OCwicGF0aCI6Ii82NjUzMzQwLzMzMTg1NTQ4MC1mZDc2OGQ4NS03NWZhLTRjNzYtYmViZS0yN2E1Yjg4ZTllOTgucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDhUMjI0NTU4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YTRjZDVjMTlmZmFmZmZmZTdiMzg0NDcyNDFkMDI2MTkzMWZlMTE2ZDJkNjNjZTcwZTk5Mjg3M2FlMDg2MmVjOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.uoAd6KVq1mCXDn18OvGsMvXSoyd6FvbSSvOS2mxAm2E)](https://private-user-images.githubusercontent.com/6653340/331855480-fd768d85-75fa-4c76-bebe-27a5b88e9e98.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU2ODg2NTgsIm5iZiI6MTc3NTY4ODM1OCwicGF0aCI6Ii82NjUzMzQwLzMzMTg1NTQ4MC1mZDc2OGQ4NS03NWZhLTRjNzYtYmViZS0yN2E1Yjg4ZTllOTgucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDhUMjI0NTU4WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YTRjZDVjMTlmZmFmZmZmZTdiMzg0NDcyNDFkMDI2MTkzMWZlMTE2ZDJkNjNjZTcwZTk5Mjg3M2FlMDg2MmVjOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.uoAd6KVq1mCXDn18OvGsMvXSoyd6FvbSSvOS2mxAm2E)Requirements
------------

[](#requirements)

- PHP ^8.1
- Laravel 9 and up
- GD Library \*

Getting Started
---------------

[](#getting-started)

```
composer require lisa-fehr/gallery
```

CommandDescription`php artisan storage:link`Connect the \[public/storage\] link to \[storage/app/public\]`php artisan gallery:install`Publish Gallery Assets and Config. Gives access to the gallery vue components. Can use `gallery-originals` and `gallery` filesystems. Adds a gallery file under /config for custom routes`php artisan images:generate`Creates the missing image placeholders. Place images under storage/gallery in a nested folder structure like: Photos/California, `{parent}`/`{tag}`Usage
-----

[](#usage)

### Add the css and js files to your layout file

[](#add-the-css-and-js-files-to-your-layout-file)

```

...

```

### Add gallery component to a view called `portfolio`

[](#add-gallery-component-to-a-view-called-portfolio)

```

```

You can also override routes with inconsistent patterns:

```
{
    "tag": "path from root - no starting slash needed"
}
```

```

```

### Add to web routes file

[](#add-to-web-routes-file)

The landing page doesn't take any filters and should show everything.

```
Route::get('portfolio', function () {
    return view('portfolio');
})->name('portfolio');
```

Additional pages: Route name must match the `name` field in the `uber_tags` table. Must include the current tag at the beginning.

```
Route::get('photos', function () {
    return view('portfolio')
        ->with('filter', [
            'tags' => 'photos,California,California2005,California2009,California2014'
        ]);
})->name('photos');
```

Or use the Tag model to get all the children:

```
Route::get('California', function () {
    $children = UberTags::where('name', 'california')->allChildren()->pluck('name')->implode(',');
    return view('portfolio')
        ->with('filter', [
            'tags' => 'california,' . $children
        ]);
})->name('California');
```

If the named route for the tag doesn't exist, it will not show up in navigation to prevent broken links.

Development
-----------

[](#development)

Run the migrations

```
php artisan migrate --path=vendor/lisa-fehr/gallery/src/database/migrations
```

Run the seeders

```
php artisan db:seed --class=LisaFehr\\Gallery\\Database\\Seeders\\GalleryDatabaseSeeder
```

Troubleshooting
---------------

[](#troubleshooting)

### The missing thumbnail or image is broken

[](#the-missing-thumbnail-or-image-is-broken)

- Check that the `APP_URL` in the .env is correct. IE: Contains the port number.
- Make sure these were run: `php artisan storage:link` and `php artisan images:generate`

### Using the UberTags model returns error

[](#using-the-ubertags-model-returns-error)

> Illuminate\\Database\\QueryException SQLSTATE\[HY000\]: General error: 1 HAVING clause on a non-aggregate query

Don't use sqlite. Check the .env file and fill in:

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~84 days

Total

6

Last Release

990d ago

Major Versions

2.1.2 → 3.02023-08-22

PHP version history (2 changes)2.0.0PHP ^7.3|^8.0

3.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/f73f7ef1e839fc6c9f5bd9d6e6522dcc1b97db0890ad5b697d38b7e2fd0f5c29?d=identicon)[lisa-fehr](/maintainers/lisa-fehr)

---

Top Contributors

[![lisa-fehr](https://avatars.githubusercontent.com/u/6653340?v=4)](https://github.com/lisa-fehr "lisa-fehr (12 commits)")

---

Tags

laravel-packagetailwindcssvueframeworklaravel

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/lisa-fehr-gallery/health.svg)

```
[![Health](https://phpackages.com/badges/lisa-fehr-gallery/health.svg)](https://phpackages.com/packages/lisa-fehr-gallery)
```

###  Alternatives

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[marketplacekit/marketplacekit

Open source Marketplace Platform

8185.2k](/packages/marketplacekit-marketplacekit)[kompo/kompo

Laravel & Vue.js FullStack Components for Rapid Application Development

11812.4k21](/packages/kompo-kompo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)