Merge branch 'release/v2.3.0'

README.md

@@ -62,26 +62,64 @@
 * Events (v2.2)
 * Supported locales : ru, en, ar
 
-## Upgrading to version 2.2
+## In new version 2.3
 
-If you using ACL change namespace in config file for 'aclRepository'
+In new version you can set default disk and default path
+
+You have two variants for how to do it:
+
+1. Add this params to the config file (config/file-manager.php)
 
 ```php
-// From
-'aclRepository' => Alexusmai\LaravelFileManager\ACLService\ConfigACLRepository::class,
+/**
+ * Default path for left manager
+ * null - root directory
+ */
+'leftPath'  => 'directory/sub-directory',
+
+/**
+ * Default path for right manager
+ * null - root directory
+ */
+'rightPath' => null,
+```
 
-// To
-'aclRepository' => Alexusmai\LaravelFileManager\Services\ACLService\ConfigACLRepository::class,
+2 Or you can add this params in URL
+
+```
+http://site.name/?leftDisk=diskName&leftPath=directory
+http://site.name/?leftDisk=diskName&leftPath=directory2&rightDisk=diskName2&rightPath=images
 ```
 
-if you create your own repository for ACL rules, don't be forget change namespace to:
+leftDisk and leftPath is default for the file manager windows configuration - 1,2
+
+
+## Upgrading to version 2.3
+
+Update pre-compiled css and js files and config file - file-manager.php 
+
 
 ```php
-// From
-Alexusmai\LaravelFileManager\ACLService;
+// config
+php artisan vendor:publish --tag=fm-config --force
+// js, css
+php artisan vendor:publish --tag=fm-assets --force
+```
+
+You can update the config file manually - add new params:
 
-// To
-Alexusmai\LaravelFileManager\Services\ACLService;
+```php
+/**
+ * Default path for left manager
+ * null - root directory
+ */
+'leftPath'  => null,
+
+/**
+ * Default path for right manager
+ * null - root directory
+ */
+'rightPath' => null,
 ```
 
 

config/file-manager.php

@@ -20,6 +20,18 @@
      */
     'rightDisk' => null,
 
+    /**
+     * Default path for left manager
+     * null - root directory
+     */
+    'leftPath'  => null,
+
+    /**
+     * Default path for right manager
+     * null - root directory
+     */
+    'rightPath' => null,
+
     /**
      * Image cache ( Intervention Image Cache )
      * set null, 0 - if you don't need cache (default)

docs/configuration.md

@@ -10,6 +10,59 @@ Open configuration file - config/file-manager.php
 
 **Don't forget to configure your php and Nginx**
 
+### You can set default disk and default path
+
+You have two variants for how to do it:
+
+1. Add this params to the config file (config/file-manager.php)
+
+```php
+/**
+ * Default disk for left manager
+ * null - auto select the first disk in the disk list
+ */
+'leftDisk'  => 'public',
+
+/**
+ * Default disk for right manager
+ * null - auto select the first disk in the disk list
+ */
+'rightDisk' => null,
+
+/**
+ * Default path for left manager
+ * null - root directory
+ */
+'leftPath'  => 'directory/sub-directory',
+
+/**
+ * Default path for right manager
+ * null - root directory
+ */
+'rightPath' => null,
+```
+
+2 Or you can add this params in URL
+
+```
+http://site.name/?leftDisk=public
+
+http://site.name/?leftDisk=public&rightDisk=images
+
+http://site.name/?leftDisk=public&leftPath=directory/sub-directory
+
+http://site.name/?leftDisk=public&leftPath=directory2&rightDisk=images&rightPath=cars/vw/golf
+// %2F - /, %20 - space
+http://site.name/?leftDisk=public&leftPath=directory2&rightDisk=images&rightPath=cars%2Fvw%2Fgolf
+```
+
+leftDisk and leftPath is default for the file manager windows configuration - 1,2
+
+**You can't add a disk that does not exist in the diskList array !**
+
+**! Params in URL have more weight than params in config file. It means that URL params can overwrite your config params. !**
+
+
 ```
 // PHP
 upload_max_filesize,
@@ -59,18 +112,6 @@ client_max_body_size
 'diskList'  => ['images', 'public'],
 ```
 
->If you want to change default disk at runtime, you can add search params to the URL:
-
-```
-// !!! The disk must be in diskList !!!
-
-// one window
-http://site-name.com/your-url?leftDisk=public
-
-// two windows
-http://site-name.com/your-url?leftDisk=public&rightDisk=images
-```
-
 ## What's next
 
 [ACL](./acl.md)

src/FileManager.php

@@ -36,6 +36,8 @@ public function initialize()
             'acl',
             'leftDisk',
             'rightDisk',
+            'leftPath',
+            'rightPath',
             'windowsConfig',
         ]);