zanysoft/laravel-responsive-filemanager

将Alberto Peripolli的Responsive File Manager与Laravel集成

3.0.0 2024-09-15 10:14 UTC

This package is auto-updated.

Last update: 2024-09-15 10:20:20 UTC


README

Downloads GitHub license GitHub license Maintenance GitHub tag

此软件包含Responsive File Manager(RFM)的修改版本 Responsive File Manager 参见 官方网站

Responsive File Manager (RFM)采用CC BY-NC 3.0许可,这意味着软件不能用于商业用途的再分发。

CC BY-NC 3.0

如果您想用于商业目的,请查看作者(Alberto Peripolli)的网站

此仓库受MIT许可证的约束,除非文件中明确指出其他许可证。

这里的Laravel插件代码部分受MIT许可证保护。

RFM作者提供其代码的商业版本(修改后的include.js)。如果您在Laravel应用程序中使用CSRF检查,需要修改此文件,在AJAX调用中添加_token: jQuery('meta[name="csrf-token"]').attr('content')。您可以使用www.diffchecker.com检查您需要应用到您的include.commercial.js文件中的修改。我不能提供RFM用于商业用途的许可证

如果您有任何更正、建议或其他意见,请告知我。

阅读Responsive File Manager文档

如何安装?

在项目中安装

composer require zanysoft/laravel-responsive-filemanager

现在有一个新的配置文件 rfm.php

config/app.php 中安装

'providers' => [
        /*
         * Laravel Framework Service Providers...
         */
        ...
        // Responsive File Manager
        ZanySoft\ResponsiveFileManager\FileManagerServiceProvider::class
],

app/Http/Kernel.php 中需要使用StartSession,也可以使用并推荐使用CSRF Token

protected $middlewareGroups = [
    ...
    'web' => [
        ...
        \Illuminate\Session\Middleware\StartSession::class,
        // Responsive File Manager supports CSRF Token usage
        \App\Http\Middleware\VerifyCsrfToken::class
    ]
    ...
];

然后执行以下操作

php artisan vendor:publish --provider="ZanySoft\ResponsiveFileManager\FileManagerServiceProvider"

生成用于URL识别的私钥

php artisan rfm:generate

所有配置都已包括,以便直接使用。文件应存储在public文件夹中。

别忘了在配置文件中设置上传目录

$upload_dir = 'media/';
$thumbs_upload_dir = 'thumbs/'; //this will create inside upload directory

在配置文件中设置路由前缀

'route_prefix' => 'filemanager/',
//or
'route_prefix' => 'admin/filemanager/',  

出于安全目的,在配置文件中设置中间件

'middleware' => 'auth', //defaualt is web

作为独立使用

使用助手函数编写文件管理器URL

<a href="@filemanager_get_resource(dialog.php)?field_id=imgField&lang=en_EN&akey=@filemanager_get_key()">Open RFM</a>
// OR
<a href="@filemanager_dialog(['field_id'=>'imgField'])">Open RFM</a>    
// OR
<a href="@filemanager_dialog()">Open RFM</a>

请参阅 Responsive File Manager文档 中的 USE AS STAND-ALONE FILE MANAGER

包含在TinyMCE或CKEDITOR中

包含JS

  • 对于CKEDITOR

将#MYTEXTAREAJS替换为您的textarea输入

<script src='{{ asset('/vendor/unisharp/laravel-ckeditor/ckeditor.js') }}'></script>
<script>
    $(document).ready(function() {
        if($("#MYTEXTAREAID").length) {
            CKEDITOR.replace( 'postBody', {
                filebrowserBrowseUrl : '@filemanager_get_resource(dialog.php)?akey=@filemanager_get_key()&type=2&editor=ckeditor&fldr=',
                filebrowserUploadUrl : '@filemanager_get_resource(dialog.php)?akey=@filemanager_get_key()&type=2&editor=ckeditor&fldr=',
                filebrowserImageBrowseUrl : '@filemanager_get_resource(dialog.php)?akey=@filemanager_get_key()&type=1&editor=ckeditor&fldr=',
                language : '<?php App::getLocale() ?>'
            });
        }
    })
</script>
  • 对于TinyMCE

使用tinymce参数

$(document).ready(() => {
    $('textarea').first().tinymce({
        script_url : '/tinymce/tinymce.min.js',
        width: 680,height: 300,
        plugins: [
            "advlist autolink link image lists charmap print preview hr anchor pagebreak",
            "searchreplace wordcount visualblocks visualchars insertdatetime media nonbreaking",
            "table contextmenu directionality emoticons paste textcolor filemanager code"
    ],
    toolbar1: "undo redo | bold italic underline | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | styleselect",
    toolbar2: "| responsivefilemanager | link unlink anchor | image media | forecolor backcolor  | print preview code ",
    image_advtab: true ,
    filemanager_access_key: '@filemanager_get_key()',
    filemanager_relative_url: true,
    filemanager_sort_by: '',
    filemanager_descending: '',
    filemanager_basefolder: '',
    filemanager_subfolder: '',
    filemanager_crossdomain: '',
    external_filemanager_path: '@external_filemanager_path()',
    filemanager_title:"Responsive Filemanager" ,
    external_plugins: { "filemanager" : "/vendor/responsivefilemanager/plugin.min.js"}
    });
});

为了使用私有文件夹,请使用.htaccess并设置Deny from all