A package to maintain a searchable database of vinyl records
A Laravel package to maintain my database of vinyl records in my collection, with a searchable HTML interface and an API interface. Currently has English and French language, easily expandable with additional languages.
$ composer require escuccim/recordcollection
Register service provider in config/app.php:
Run migrations to create the database table:
php artisan migrate
This uses a middleware to determine if the user is authorized to perform administrative tasks. You can use mine or create your own, the code references middleware 'admin', so unless there is a middleware with this name registered will throw errors. To use mine register it in app/Http/Kernel.php:
'admin' => \Escuccim\RecordCollection\Http\Middleware\AdminMiddleware::class,
<script src="/js/app.js"></script> @stack('scripts')
And you need to remove the script tag referencing app.js from the bottom of the layout file.
You must publish the config and pagination files with:
php artisan vendor:publish --tag=config
If you wish to edit the language or view files you can also publish those:
php artisan vendor:publish
There are multiple groups of files to be published, which you can choose by adding --tags=[group] to the command:
- config - publishes the config file to /config/records.php
- migrations - publishes the database migrations to /database/migrations
- lang - publishes the translation files to /resources/lang/vendor - currently I have files for English and French
- views - publishes the views /resoures/vendor/views
Once you have everything installed the route /records should take you to the list of records, where you can add or edit records. I do not have a delete function as I would never get rid of any of my records.
The HTML interface will display a link to discogs and a thumbnail from discogs if you have that info in the database table. If not I wrote scripts I used to pull the info from Discogs, but due to the large numbers of variations of many vinyl releases it usually needs a bit of hand-holding to populate usable data.
In the records.php config file is a key called 'use_rich_cards'. This allows you to display a Rich Card with the record information. The thumbnail from the record will be used as an image if this is on.
Please see CHANGELOG for more information on what has changed recently.
If you discover any security related issues, please email firstname.lastname@example.org instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.