Download the PHP package escuccim/recordcollection without Composer
On this page you can find all versions of the php package escuccim/recordcollection. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package recordcollection
RecordCollection
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.
Install
Via Composer
Register service provider in config/app.php:
Run migrations to create the database table:
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:
To enable some Javascript features you need to add the following to the header of your layouts/app.blade.php file:
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:
If you wish to edit the language or view files you can also publish those:
Note - You must publish the config files for the search interface to work properly. There are some Javascript assets which need to be put into the public directory for the search interface to work, and it will also publish the Laravel pagination files have some slight modifications which are necessary for proper functioning of the page.
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
Usage
This package contains its own routes, models, controllers and views so should run out of the box. To enable the Javascript functions in the admin pages you need to add the following to your layouts/app.blade.php in the header:
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.
Change log
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONDUCT for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.