Skip to content

Commit 6342feb

Browse files
committed
update documents for v2.0.0
1 parent 0d017dd commit 6342feb

File tree

7 files changed

+57
-64
lines changed

7 files changed

+57
-64
lines changed

.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,4 @@
22
composer.lock
33
/docs/Gemfile.lock
44
/docs/_site
5+
.DS_Store

README.md

+18-55
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
<p align="center"><img src="https://unisharp.github.io/laravel-filemanager/images/logo_vertical_colored.png"></p>
22

33
<p align="center">
4-
<a target="_blank" href="https://travis-ci.org/UniSharp/laravel-filemanager"><img src="https://img.shields.io/travis/UniSharp/laravel-filemanager.svg"></a>
54
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://poser.pugx.org/unisharp/laravel-filemanager/downloads"></a>
65
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://img.shields.io/packagist/dm/unisharp/laravel-filemanager.svg"></a>
6+
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://img.shields.io/badge/stable-2.0.0-blue.svg"></a>
7+
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://poser.pugx.org/unisharp/laravel-filemanager/license"></a>
8+
<br>
9+
<a target="_blank" href="https://travis-ci.org/UniSharp/laravel-filemanager"><img src="https://img.shields.io/travis/UniSharp/laravel-filemanager.svg"></a>
710
<a target="_blank" href="https://scrutinizer-ci.com/g/UniSharp/laravel-filemanager/"><img src="https://scrutinizer-ci.com/g/UniSharp/laravel-filemanager/badges/quality-score.png?b=master"></a>
811
<a target="_blank" href="https://codeclimate.com/github/UniSharp/laravel-filemanager/maintainability"><img src="https://api.codeclimate.com/v1/badges/e51f2ef8f4d9f97268db/maintainability" /></a>
9-
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://img.shields.io/badge/unstable-v2.0.0--alpha8-orange.svg"></a>
10-
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://poser.pugx.org/unisharp/laravel-filemanager/v/stable"></a>
11-
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://poser.pugx.org/unisharp/laravel-filemanager/license"></a>
12+
<a target="_blank" href="https://packagist.org/packages/unisharp/laravel-filemanager"><img src="https://img.shields.io/badge/unstable-dev-master-orange.svg"></a>
1213
</p>
1314

1415
<p align="center">
@@ -31,63 +32,25 @@
3132
<a href="https://github.com/UniSharp/laravel-filemanager/wiki">FAQ</a>
3233
</p>
3334

34-
## Installing alpha version
35-
The alpha version of `v2.0` contains support for cloud storage and fresh new UI with RWD.
36-
37-
* Run `composer require unisharp/laravel-filemanager:dev-master` to get the latest code.
38-
* Run `composer require unisharp/laravel-filemanager:v2.0.0-alpha8` to get the latest release of alpha version.
35+
![RWD demo](https://unisharp.github.io/laravel-filemanager/images/screenshots-v2.png)
3936

4037
## v2.0 progress
41-
* [x] (done) Unit test
42-
* [x] (done) Integrate with Laravel Storage
43-
* [x] (done) Multiple selection
44-
* [x] (done) Responsive design
45-
* [x] (done) Config refactoring
46-
* [x] (done) JSON APIs
47-
* [x] (done) Move to folder function
48-
* [x] (done) Applying MIME icon generator
49-
* [x] (done) Refactor floating action buttons
50-
* [x] (done) Configurable disk of storage
51-
* [x] (done) Bootstrap 4 support
52-
* [x] (done) Remove bootbox
53-
* [ ] Documents for v2.0
54-
* [x] (done) Resize function RWD refactor
55-
* [ ] ConfigHandler should overwrite most configs
56-
* [ ] Events should pass object instead of only file path
57-
* [ ] Add more events for files and folders manipulation
58-
59-
## Documents of V1
60-
https://github.com/UniSharp/laravel-filemanager/tree/v1/docs
38+
🎉 Finally v2.0.0 has been released! 🎉
6139

62-
## Errors with namespace
63-
We have changed namespace from `Unisharp` to `UniSharp`, and change the first character of every namespace into capital.
40+
These are primary features of this update:
41+
* Redesigned RWD user interface.
42+
* Supporting multiple files selection.
43+
* Supporting cloud storages integration(with Laravel file system).
44+
* Refactored code and increased test coverage.
6445

65-
If you are updating this package and encounter any errors like `Class not found`, please remove this package entirely and reinstall again.
46+
Although it is not perfect enough, we decided to release it. Now users who want the above features won't need to install alpha versions anymore.
6647

67-
## v1.8 released
68-
* Please follow the intructions in [upgrade document](https://unisharp.github.io/laravel-filemanager/upgrade).
69-
* Important changes :
70-
* Fix Windows compatibility (utf-8 file names and folder names).
71-
* New feature : Copy & Crop. Thanks [gwleuverink](https://github.com/gwleuverink).
72-
* [Config document](https://unisharp.github.io/laravel-filemanager/config) is refactored.
73-
74-
## Security
75-
76-
It is important to note that if you use your own routes **you must protect your routes to Laravel-Filemanager in order to prevent unauthorized uploads to your server**. Fortunately, Laravel makes this very easy.
77-
78-
If, for example, you want to ensure that only logged in users have the ability to access the Laravel-Filemanager, simply wrap the routes in a group, perhaps like this:
79-
80-
```php
81-
Route::group(['middleware' => 'auth'], function () {
82-
Route::get('/laravel-filemanager', '\UniSharp\LaravelFilemanager\Controllers\LfmController@show');
83-
Route::post('/laravel-filemanager/upload', '\UniSharp\LaravelFilemanager\Controllers\UploadController@upload');
84-
// list all lfm routes here...
85-
});
86-
```
87-
88-
This approach ensures that only authenticated users have access to the Laravel-Filemanager. If you are using Middleware or some other approach to enforce security, modify as needed.
48+
There are still some thing we need to do make this package better:
49+
* [ ] Documents for v2.0.0
50+
* [ ] Events should pass object instead of only file path
51+
* [ ] Add more events for files and folders manipulation
8952

90-
**If you use the laravel-filemanager default route, make sure the `auth` middleware (set in config/lfm.php) is enabled and functional**.
53+
We are also going to gain more integration like vue.js and Laravel Nova. Any PR is welcome!
9154

9255
## Contributors & Credits
9356

docs/_layouts/default.html

+1
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,7 @@ <h2 class="project-tagline">{{ site.description | default: site.github.project_t
110110
<span><a href="events">Events</a></span>
111111
<span><a href="upgrade">Upgrade</a></span>
112112
<span><a href="contribution">Contribution</a></span>
113+
<span><a href="security">Security</a></span>
113114
</nav>
114115
</section>
115116

docs/images/screenshots-v2.png

172 KB
Loading

docs/index.md

+5-7
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
[![Total Downloads](https://poser.pugx.org/unisharp/laravel-filemanager/downloads)](https://packagist.org/packages/unisharp/laravel-filemanager)
33
[![License](https://poser.pugx.org/unisharp/laravel-filemanager/license)](https://packagist.org/packages/unisharp/laravel-filemanager)
44

5+
This is the document of v2 version, v1 document can be found here: [https://github.com/UniSharp/laravel-filemanager/tree/v1/docs](https://github.com/UniSharp/laravel-filemanager/tree/v1/docs)
6+
57
## Features
68
* CKEditor and TinyMCE integration
79
* Standalone button
@@ -12,18 +14,14 @@
1214
* Supports two types : files and images. Each type works in different directory.
1315
* Supported locales : ar, bg, de, el, en, es, fa, fr, it, he, hu, nl, pl, pt-BR, pt_PT, ro, ru, sv, tr, zh-CN, zh-TW
1416

15-
PR is welcome!
17+
PRs are welcome!
1618

1719
## Screenshots
1820
> Standalone button :
1921
2022
![Standalone button demo](https://unisharp.github.io/laravel-filemanager/images/lfm01.png)
2123

22-
> Grid view :
23-
24-
![Grid view demo](https://unisharp.github.io/laravel-filemanager/images/lfm02.png)
25-
26-
> List view :
24+
> Responsive design :
2725
28-
![List view demo](https://unisharp.github.io/laravel-filemanager/images/lfm03.png)
26+
![RWD demo](https://unisharp.github.io/laravel-filemanager/images/screenshots-v2.png)
2927

docs/installation.md

+17-2
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,23 @@
66
* Laravel 5
77
* requires [intervention/image](https://github.com/Intervention/image) (to make thumbs, crop and resize images).
88

9-
## Installation
9+
## TL;DR
10+
1. Run these lines
11+
12+
```bash
13+
composer require unisharp/laravel-filemanager
14+
php artisan vendor:publish --tag=lfm_config
15+
php artisan vendor:publish --tag=lfm_public
16+
php artisan storage:link
17+
```
18+
19+
1. Edit `APP_URL` in `.env`.
20+
21+
## Full Installation Guide
1022
1. Install package
1123

1224
```bash
13-
composer require unisharp/laravel-filemanager:~1.8
25+
composer require unisharp/laravel-filemanager
1426
```
1527

1628
1. (optional) Edit `config/app.php` :
@@ -57,6 +69,9 @@
5769
5870
1. Edit `APP_URL` in `.env`.
5971
72+
## Installing alpha version
73+
* Run `composer require unisharp/laravel-filemanager:dev-master` to get the latest developer version.
74+
6075
## What's next
6176

6277
1. Check the [integration document](http://unisharp.github.io/laravel-filemanager/integration) to see how to apply this package.

docs/security.md

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
## Security
2+
3+
It is important to note that if you use your own routes **you must protect your routes to Laravel-Filemanager in order to prevent unauthorized uploads to your server**. Fortunately, Laravel makes this very easy.
4+
5+
If, for example, you want to ensure that only logged in users have the ability to access the Laravel-Filemanager, simply wrap the routes in a group, perhaps like this:
6+
7+
```php
8+
Route::group(['middleware' => 'auth'], function () { // auth middleware is important!
9+
\UniSharp\LaravelFilemanager\Lfm::routes();
10+
});
11+
```
12+
13+
This approach ensures that only authenticated users have access to the Laravel-Filemanager. If you are using Middleware or some other approach to enforce security, modify as needed.
14+
15+
**If you use the laravel-filemanager default route, make sure the `auth` middleware (set in config/lfm.php) is enabled and functional**.

0 commit comments

Comments
 (0)