escuccim/recordcollection

一个用于维护可搜索黑胶唱片数据库的包

v0.1.0-beta.1 2017-02-15 12:17 UTC

This package is not auto-updated.

Last update: 2024-09-28 20:20:12 UTC


README

Latest Version on Packagist Software License Build Status Total Downloads

这是一个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

贡献

有关详细信息,请参阅CONTRIBUTINGCONDUCT

安全

如果您发现任何安全相关的问题,请通过电子邮件skooch@gmail.com而不是使用问题跟踪器。

鸣谢

许可证

MIT许可证(MIT)。请参阅许可证文件获取更多信息。