escuccim / recordcollection
一个用于维护可搜索黑胶唱片数据库的包
Requires
- php: ~5.6|~7.0
- illuminate/support: ~5.1
- laracasts/flash: ^2.0
Requires (Dev)
- phpunit/phpunit: ~4.0||~5.0
- squizlabs/php_codesniffer: ^2.3
This package is not auto-updated.
Last update: 2024-09-28 20:20:12 UTC
README
这是一个Laravel包,用于维护我的收藏中的黑胶唱片数据库,具有可搜索的HTML界面和API接口。目前支持英文和法语,易于扩展以支持其他语言。
安装
通过Composer
$ composer require escuccim/recordcollection
在config/app.php中注册服务提供者
Escuccim\RecordCollection\RecordCollectionServiceProvider::class Laracasts\Flash\FlashServiceProvider::class,
运行迁移以创建数据库表
php artisan migrate
该包使用中间件来确定用户是否有权执行管理任务。您可以使用我的或创建自己的,代码引用了中间件'admin',除非已注册具有该名称的中间件,否则将引发错误。要使用我的中间件,请在app/Http/Kernel.php中注册它
'admin' => \Escuccim\RecordCollection\Http\Middleware\AdminMiddleware::class,
为了启用一些JavaScript功能,您需要将以下内容添加到布局文件app.blade.php的头部
<script src="/js/app.js"></script> @stack('scripts')
并且您需要从布局文件的底部移除引用app.js的脚本标签。
您必须使用以下命令发布配置和分页文件
php artisan vendor:publish --tag=config
如果您想编辑语言或视图文件,也可以发布这些文件
php artisan vendor:publish
注意 - 您必须发布配置文件,以便搜索界面可以正常工作。有一些JavaScript资产需要放入public目录,以便搜索界面可以工作,并且它还会发布Laravel分页文件的一些轻微修改,这些修改对于页面的正常工作是必要的。
有多个文件组需要发布,您可以通过在命令中添加--tags=[group]来选择
- config - 将配置文件发布到/config/records.php
- migrations - 将数据库迁移发布到/database/migrations
- lang - 将翻译文件发布到/resources/lang/vendor - 目前我有英文和法语的文件
- views - 发布视图到/resoures/vendor/views
使用方法
此包包含自己的路由、模型、控制器和视图,因此应该直接运行。要启用管理页面中的JavaScript功能,您需要在app.blade.php的头部添加以下内容
@yield('header')
安装完毕后,/records路由应将您带到唱片列表,您可以在其中添加或编辑唱片。我没有删除功能,因为我永远不会丢弃我的任何唱片。
HTML界面将显示到Discogs的链接以及数据库表中存在该信息的缩略图。如果没有,我编写了从Discogs提取信息的脚本,但由于许多黑胶唱片的变体数量庞大,通常需要一些手动操作才能填充可用的数据。
在records.php配置文件中有一个名为'use_rich_cards'的键。这允许您显示带有唱片信息的丰富卡片。如果启用此选项,将使用唱片的缩略图作为图像。
变更日志
有关最近更改的更多信息,请参阅CHANGELOG
贡献
有关详细信息,请参阅CONTRIBUTING和CONDUCT
安全
如果您发现任何安全相关的问题,请通过电子邮件skooch@gmail.com而不是使用问题跟踪器。
鸣谢
许可证
MIT许可证(MIT)。请参阅许可证文件获取更多信息。