# Kropify - Image Cropping Package
+ Author: Sawa Stacks - GitHub
+ License: MIT License
+ Initial version: 10/03/2023
This package (Kropify class) handles the server-side file upload and saving. The Kropify.js script integrates with the frontend to provide cropping, previewing, and uploading of images with your [`Laravel`](https://laravel.com/) backend.
This package is built using vanilla JavaScript, so it doesn't require jQuery as a dependency. It's lightweight, easy to integrate into your project without adding any extra library overhead, and supports multiple instances on a single page.
## Requirements
- PHP >= 7.2
- [Composer](https://getcomposer.org/) is required
- Laravel 8.x, 9.x , 10.x, 11.x and 12.x
## Installation
This package can be installed through `composer require` command. Before install this, make sure that your are working with PHP >= 7.2 in your system.
Just run the following command in your cmd or terminal:
1. Install the package via Composer:
```bash
composer require sawastacks/kropify-laravel
```
The package will automatically register its service provider if your Laravel framework is 8.x or above.
2. Optionally, After you have installed **Kropify**, open your Laravel config file **`config/app.php`** and add the following lines.
In the **`$providers`** array, add the service providers for this package.
```php
SawaStacks\Utils\KropifyServiceProvider::class,
```
3. After **Kropify** package installed, you need to publish its css and js minified files in Laravel public folder by running the following command in terminal:
```bash
php artisan vendor:publish --tag=kropify-assets
> **NOTE:** **`Kropify`** package assets files can be included on blade file via CDN links instead of using published files. If you need to use CDN links, just use below links:
```html
```
```html
```
### Updating Package
When new **Kropify** version released and try to update the current package to the latest version, you will need to use `composer update` command:
```bash
composer update sawastacks/kropify-laravel
```
When package not updated by using the above command, use below command that will remove current package version and install new version of package.
```bash
composer remove sawastacks/kropify-laravel && composer require sawastacks/kropify-laravel
```
After Kropify package updated, you need also to update its assets (**css** and **js** minified files) by running the following command in terminal:
```bash
php artisan vendor:publish --tag=kropify-assets --force
```
For `Kropify` directives, you have to run this command to get immediately changes in views.
```bash
php artisan view:clear
```
Finally, It is neccessary to run the following command to autoload package files.
```bash
composer dump-autoload
```
# Usage
This package uses **css** and **js** minified files, that is why you first need to include this package assets on your blade file. Place the following directive inside **``** tag of your blade file to including Kropify css file on page. So, if you are using published file, use package style directive as shown below:
```html
Page title
@kropifyStyles
......
...
```
When you're using CDN links, no need of using any directive, just use below way:
```html
Page title
......
...
```
`NOTICE:` Don't forgot to add `CSRF` meta tags to every blade file included **Kropify** assets as shown in above example.
For **Kropify** Js file, you need to add the following directive inside **``** tag but before closing **``** tag as shown in below example:
```html
..........
.....
@kropifyScripts
```
But when you're using CDN links, use it in way below:
```html
..........
.....
[](https://packagist.org/packages/sawastacks/kropify-laravel) [](LICENSE) 
