jgill88 / medialibrary
此包在页面右下角添加了一个小图标,允许您上传和查看您的媒体
此包的官方仓库似乎已消失,因此该包已被冻结
Requires
- php: ~5.6|~7.0
- illuminate/support: ~5.1
Requires (Dev)
- friendsofphp/php-cs-fixer: ^1.0
- mockery/mockery: 0.9.*
- orchestra/testbench-browser-kit: ~3.1
- phpunit/phpunit: ~4.0||~5.0
This package is not auto-updated.
Last update: 2019-02-14 04:41:39 UTC
README
此包在您的页面右下角添加了一个小图标,允许用户上传和浏览他们的媒体。
结构
src/
tests/
vendor/
依赖关系
此包已在L5.4上进行了测试。它可能与更早的版本兼容。如果您需要,我很乐意测试/使它工作在更早的版本上,只需提出要求即可。
您必须配置文件系统。默认情况下,它使用public,但可以按以下说明自定义。
前端使用纯javascript,因此不会干扰jQuery或其他任何您已加载的内容。
类名都以前缀medialibrary-*
开头,因此CSS也不应该干扰。
该包注入了font-awesome 4.7.0。如果这是一个问题,请发布视图并编辑resources/vendor/jgill88/MediaLibrary/resources/views/media-bar.blade.php
来更改fontawesome包含。
安装
通过Composer
$ composer require jgill88/medialibrary
用法
将服务提供者安装到config/app.php提供者数组中
$providers = [ ..... jgill88\MediaLibrary\MediaLibraryServiceProvider::class, ], $aliases = [ ..... 'MediaLibrary' => jgill88\MediaLibrary\MediaLibraryFacade::class, ]
完成此操作后,MediaLibrary将被注入到返回的响应中。它将跳过JSON响应和javascript响应。按照以下步骤配置此包。
文件系统
默认文件系统配置为使用您的"public"文件系统。如果您尚未设置符号链接,则应该
$ php artisan storage:link
设置您的存储符号链接。
发布供应商资产
$ php artisan publish --provider=jgill88\MediaLibrary\MediaLibraryServiceProvider
自定义行为
认证用户
如果您只想要求认证用户,请更改
'requireAuthentication' => true,
如果应用程序处于生产模式,则要求认证是一个好主意。
默认情况下,如果需要认证,插件将为每个用户提供自己的媒体目录。它使用认证用户的电子邮件属性来创建此目录。您可以通过编辑来自定义此功能
//property of the user model you want to use 'authenticatedPrefix' => 'email',
基本目录
如果您想修改文件上传到的目录,请编辑
'directory' => 'your-base-dir-here',
配置文件,并将文件上传到/your-base-dir-here/目录。
文件系统
如果您想使用除了public之外的文件系统,只需修改配置中的文件系统名称。确保您的文件系统已在config/filesystems.php中定义。
'filesystem' => 's3',
生产
默认情况下,插件在生产中是禁用的。如果您想在生产环境中启用媒体库,请修改
'disableInProduction' => false,
再次提醒,在这种情况下要求身份验证可能是个好主意。
禁用插件
如果你希望禁用插件的视图或路由,请确保你已经在app.php中注册了外观,然后在你的视图中简单地包含以下内容。你还可以在控制器中调用MediaLibrary::disable()
;
{{ MediaLibrary::disable() }}
测试
$ composer install
$ composer test
安全
如果你发现任何安全相关的问题,请通过电子邮件josh.dgill@gmail.com联系我们,而不是使用问题跟踪器。
许可协议
MIT 许可协议 (MIT)。有关更多信息,请参阅许可文件。
增强功能
- 更多可扩展的文件类型图标
- 根据配置进行更好的上传文件MIME类型验证
- 前端测试 -- 我没有编写前端测试的经验。如果有人有这方面的经验,我非常欢迎他们提交PR。
- 前端清理 -- JavaScript代码不是最漂亮的。我也欢迎在这里进行一些清理。
- 测试中的更好的DSL docblocks