Not Found

The requested URL was not found on this server.
Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.
1#@!#!123s
: / home / kashyapgreen / public_html / vendor / cloudinary-labs / cloudinary-laravel /
Filename : README.md
back
<div align="center">
    <h1> Cloudinary Laravel Package</h1>
</div>

<p align="center">
    <a href="https://packagist.org/packages/cloudinary-labs/cloudinary-laravel">
        <img src="https://img.shields.io/packagist/dt/cloudinary-labs/cloudinary-laravel.svg?style=flat-square" alt="Total Downloads">
    </a>
    <a href="https://packagist.org/packages/cloudinary-labs/cloudinary-laravel">
        <img src="https://poser.pugx.org/cloudinary-labs/cloudinary-laravel/v/stable.svg" alt="Latest Stable Version">
    </a>
    <a href="https://packagist.org/packages/cloudinary-labs/cloudinary-laravel">
        <img src="https://poser.pugx.org/cloudinary-labs/cloudinary-laravel/license.svg" alt="License">
    </a>
</p>

> A Laravel Package for uploading, optimizing, transforming and delivering media files with Cloudinary. Furthermore, it provides a fluent and expressive API to easily attach your media files to Eloquent models.

## Disclaimer

> _This software/code provided under Cloudinary Labs is an unsupported pre-production prototype undergoing further development and provided on an “AS IS” basis without warranty of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. Furthermore, Cloudinary is not under any obligation to provide a commercial version of the software.</br> </br> Your use of the Software/code is at your sole risk and Cloudinary will not be liable for any direct, indirect, incidental, special, exemplary, consequential or similar damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of the Software, even if advised of the possibility of such damage.</br> </br> You should refrain from uploading any confidential or personally identifiable information to the Software. All rights to and in the Software are and will remain at all times, owned by, or licensed to Cloudinary._

## Contributions
Contributions from the community via PRs are welcome and will be fully credited. For details, see [contributions.md](contributing.md).


## Usage

**Upload** a file (_Image_, _Video_ or any type of _File_) to **Cloudinary**:

```php

/**
*  Using the Cloudinary Facade
*  Import the Facade in your Class like so:
*/
use CloudinaryLabs\CloudinaryLaravel\Facades\Cloudinary;

// access the admin api
(https://cloudinary.com/documentation/admin_api)
Cloudinary::admin();

// access the search api
(https://cloudinary.com/documentation/search_api)
Cloudinary::search();

// access the upload api
(https://cloudinary.com/documentation/image_upload_api_reference)
Cloudinary::uploadApi();

// Upload an Image File to Cloudinary with One line of Code
$uploadedFileUrl = Cloudinary::upload($request->file('file')->getRealPath())->getSecurePath();

// Upload a Video File to Cloudinary with One line of Code
$uploadedFileUrl = Cloudinary::uploadVideo($request->file('file')->getRealPath())->getSecurePath();

// Upload any File to Cloudinary with One line of Code
$uploadedFileUrl = Cloudinary::uploadFile($request->file('file')->getRealPath())->getSecurePath();

// get url from a file
$url = Cloudinary::getUrl($publicId);


/**
 *  This package also exposes a helper function you can use if you are not a fan of Facades
 *  Shorter, expressive, fluent using the
 *  cloudinary() function
 */

// access the admin api
(https://cloudinary.com/documentation/admin_api)
cloudinary()->admin();

// access the search api
(https://cloudinary.com/documentation/search_api)
cloudinary()->search();

// access the upload api
(https://cloudinary.com/documentation/image_upload_api_reference)
cloudinary()->uploadApi();

// Upload an image file to cloudinary with one line of code
$uploadedFileUrl = cloudinary()->upload($request->file('file')->getRealPath())->getSecurePath();

// Upload a video file to cloudinary with one line of code
$uploadedFileUrl = cloudinary()->uploadVideo($request->file('file')->getRealPath())->getSecurePath();

// Upload any file  to cloudinary with one line of code
$uploadedFileUrl = cloudinary()->uploadFile($request->file('file')->getRealPath())->getSecurePath();

// Upload an existing remote file to Cloudinary with one line of code
$uploadedFileUrl = cloudinary()->uploadFile($remoteFileUrl)->getSecurePath();

// get url from a file
$url = cloudinary()->getUrl($publicId);

/**
 *  You can also skip the Cloudinary Facade or helper method and laravel-ize your uploads by simply calling the
 *  storeOnCloudinary() method on the file itself
 */

// Store the uploaded file on Cloudinary
$result = $request->file('file')->storeOnCloudinary();

// Store the uploaded file on Cloudinary
$result = $request->file->storeOnCloudinary();

// Store the uploaded file in the "lambogini" directory on Cloudinary
$result = $request->file->storeOnCloudinary('lambogini');

// Store the uploaded file in the "lambogini" directory on Cloudinary with the filename "prosper"
$result = $request->file->storeOnCloudinaryAs('lambogini', 'prosper');

$result->getPath(); // Get the url of the uploaded file; http
$result->getSecurePath(); // Get the url of the uploaded file; https
$result->getSize(); // Get the size of the uploaded file in bytes
$result->getReadableSize(); // Get the size of the uploaded file in bytes, megabytes, gigabytes or terabytes. E.g 1.8 MB
$result->getFileType(); // Get the type of the uploaded file
$result->getFileName(); // Get the file name of the uploaded file
$result->getOriginalFileName(); // Get the file name of the file before it was uploaded to Cloudinary
$result->getPublicId(); // Get the public_id of the uploaded file
$result->getExtension(); // Get the extension of the uploaded file
$result->getWidth(); // Get the width of the uploaded file
$result->getHeight(); // Get the height of the uploaded file
$result->getTimeUploaded(); // Get the time the file was uploaded


**Attach Files** to Laravel **Eloquent Models**:

First, import the `CloudinaryLabs\CloudinaryLaravel\MediaAlly` trait into your Model like so:

```php
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use CloudinaryLabs\CloudinaryLaravel\MediaAlly;

class Page extends Model
{
    use MediaAlly;

    ...
}
```

Next, publish the package's migration file using this command:

```bash
php artisan vendor:publish --provider="CloudinaryLabs\CloudinaryLaravel\CloudinaryServiceProvider" --tag="cloudinary-laravel-migration"
```

**Note:** Once this has been published, run `php artisan migrate` to create the required table in your Database.

You can now attach media assets to your model like so:

```php
/**
 *  How to attach a file to a Model by model creation
 */
$page = Page::create($this->request->input());
$page->attachMedia($file);   // Example of $file is $request->file('file');

/**
 *  How to attach a file to a Model by retrieving model records
 */
$page = Page::find(2);
$page->attachMedia($file);  // Example of $file is $request->file('file');

/**
 *  How to retrieve files that were attached to a Model
 */
$filesBelongingToSecondPage = Page::find(2)->fetchAllMedia();

/**
 *  How to retrieve the first file that was attached to a Model
 */
$fileBelongingToSecondPage = Page::find(2)->fetchFirstMedia();

/**
 *  How to retrieve the last file that was attached to a Model
 */
$fileBelongingToSecondPage = Page::find(2)->fetchLastMedia();

/**
 *  How to replace/update files attached to a Model
 */
$page = Page::find(2);
$page->updateMedia($file);  // Example of $file is $request->file('file');

/**
*  How to detach a file from a Model
*/
$page = Page::find(2);
$page->detachMedia($file)  // Example of $file is $request->file('file');
```

**Upload Files Via An Upload Widget**:

Use the `x-cld-upload-button` Blade upload button component that ships with this Package like so:

```html
<!DOCTYPE html>
<html>
    <head>
        ...
        @cloudinaryJS
    </head>
    <body>
        <x-cld-upload-button>
            Upload Files
        </x-cld-upload-button>
    </body>
</html>
````

Other Blade components you can use are:

```html

/**
 *
 *  TRANSFORMATION ACTIONS CATEGORIES:
 *
 *  1. RESIZE
 * - Scale
 * - Limit Fit
 * - Fill
 * - Fit
 * - Crop
 * - Thumbnail
 * - Pad
 * - Limit Fill
 * - Limit Pad
 * - Minimum Fit
 * - Minimum Pad
 *
 *
 *  2. ADJUST
 * - Improve
 * - Unsharp Mask
 * - Saturation
 * - Contrast
 * - Brightness
 * - Gamma
 *
 *
 *  3. EFFECT
 * - Colorize
 * - Blur
 * - Trim
 * - Grayscale
 * - Blackwhite
 * - Sepia
 * - Red Eye
 * - Negate
 * - Oil Paint
 * - Vignette
 * - Simulate Colorblind
 * - Pixelate
 * - Shadow
 *
 *
 *  4. DELIVERY
 * - Format
 * - Quality
 * - Color Space
 * - DPR
 *
 *  5. LAYERS
 * - Image Layer
 * - Text Layer
 *
 *
 */
<x-cld-image public-id="prosper" width="300" height="300"></x-cld-image> // Blade Image Component for displaying images

<x-cld-video public-id="awesome"></x-cld-video> // Blade Video Component for displaying videos

/**
 *  ARTISTIC Filters
 *  Possible values: al_dente, athena, audrey, aurora, daguerre, eucalyptus, fes, frost, hairspray, hokusai, incognito, linen, peacock, primavera, quartz, red_rock, refresh, sizzle, sonnet, ukulele, zorro
 *  Reference: https://cloudinary.com/documentation/transformation_reference#e_art
 */
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' effect="art|sizzle"></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' effect="art|audrey"></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' effect="art|incognito"></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' art="incognito"></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' art="audrey"></x-cld-image>


/**
 *  Colorize
 */
<x-cld-image public-id="couple" colorize='rgb:0000_35'></x-cld-image>

/**
 *  Blur - Applies a blurring filter to an asset.
 *  The strength ranges from 1 to 2000
 */
<x-cld-image public-id="couple" blur='599'></x-cld-image>

/**
 *  Grayscale
 *  Converts an image to grayscale (multiple shades of gray).
 */
<x-cld-image public-id="couple" grayscale></x-cld-image>

/**
 *  sepia
 *  Changes the color scheme of an image to sepia.
 */
<x-cld-image public-id="couple" sepia-50></x-cld-image>

/**
 *  redeye
 *  Automatically removes red eyes in an image.
 */
<x-cld-image public-id="couple" redeye></x-cld-image>

/**
 *  negate
 *  Creates a negative of an image.
 */
<x-cld-image public-id="couple" negate></x-cld-image>

/**
 *  oil-paint
 *  Applies an oil painting effect.
 */
<x-cld-image public-id="couple" oil-paint></x-cld-image>
<x-cld-image public-id="couple" oil-paint=78></x-cld-image>

/**
 *  vignette
 *  Applies a vignette effect to an image.
 *  The strength level of the vignette. Range: 0 to 100
 */
<x-cld-image public-id="couple" vignette></x-cld-image>
<x-cld-image public-id="couple" vignette=78></x-cld-image>


/**
 *  simulate-colorblind
 *  Simulates the way an image would appear to someone with the specified color blind condition.
 *  The color blind condition to simulate.Possible values: deuteranopia, protanopia, tritanopia, tritanomaly, deuteranomaly, cone_monochromacy, rod_monochromacy
 */
<x-cld-image public-id="couple" simulate-colorblind></x-cld-image>
<x-cld-image public-id="couple" simulate-colorblind=protanopia></x-cld-image>


/**
 *  pixelate
 *  Applies a pixelation effect.
 *  The width in pixels of each pixelation square. Range: 1 to 200. Default: Determined by an algorithm based on the image dimensions.
 */
<x-cld-image public-id="couple" pixelate></x-cld-image>
<x-cld-image public-id="couple" pixelate=5></x-cld-image>

/**
 *  shadow
 *  Adds a gray shadow to the bottom right of an image. You can change the color and location of the shadow using the color and x,y qualifiers.
 *  The format of the shadow is color_offsetX_offsetY_strength
 */
<x-cld-image public-id="couple" shadow='rgb:999_-15_-15_50'></x-cld-image>

/**
 *  unsharp-mask
 *  Applies an unsharp mask filter to the image.
 *  The strength of the filter. (Range: 1 to 2000, Server default: 100)
 */
<x-cld-image public-id="couple" unsharp-mask=1799></x-cld-image>

/**
 *  saturation
 *  Adjusts the color saturation.
 *  The level of color saturation (Range: -100 to 100, Server default: 80).
 */
<x-cld-image public-id="couple" saturation=79></x-cld-image>

/**
 *  brightness
 *  Adjusts the brightness.
 *  The level of brightness (Range: -99 to 100).
 */
<x-cld-image public-id="couple" brightness=80></x-cld-image>

/**
 *  gamma
 *  Adjusts the gamma level.
 *  The level of gamma (Range: -50 to 150, Server default: 0).
 */
<x-cld-image public-id="couple" gamma=100></x-cld-image>

/**
 *  trim
 *  Detects and removes image edges whose color is similar to the corner pixels.
 *  The level of tolerance for color similarity. Range: 0 to 100
 *  The color to trim as a named color or an RGB/A hex code.
 *  e.g 50_yellow
 *  50 is for color similarity
 *  yellow is for color override
 */
<x-cld-image public-id="casual_yellow_red_corners" trim="50_yellow"></x-cld-image>


/**
 *  improve-mode
 *  Adjusts an image's colors, contrast and brightness to improve its appearance.
 *  Possible values: mode is 'indoor', 'outdoor'
 *  blend is withing the range of 0 to 100.
 *
 */
<x-cld-image public-id="couple" improve-mode='indoor_99'></x-cld-image>


/**
 *  Blackwhite
 *  Converts an image to black and white.
 *  Threshold - The balance between black (100) and white (0).
 */
<x-cld-image public-id="couple" blackwhite></x-cld-image>
<x-cld-image public-id="couple" blackwhite=47></x-cld-image>



/**
 *  CARTOON Filters
 */
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' cartoonify></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' cartoonify="70:bw"></x-cld-image>

/**
 *  ROTATE
 */
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' rotate=80></x-cld-image>

/**
 *  ROUNDED CORNERS
 */
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' rounded-corners></x-cld-image>


/**
 *  Borders
 */
// Adds a solid border around an image or video.
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' rounded-corners border=4_solid_brown></x-cld-image>
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' rounded-corners border=4_solid_rgb:999></x-cld-image>

/**
 *  Background Color
 */
<x-cld-image public-id="eifrfdh65qvn8rbby3cs" crop='thumb' rotate=40 bg-color='red' rounded-corners border='4_solid_rgb:999'></x-cld-image>


/**
 *  Face detection-based image cropping
 *  Crop "thumb" or "crop" and gravity must be used together
 *  Faces will target all the faces
 *  Face will target only one face
 *  You can specify width and height or not
 *  You can use compass to define a fixed location within an asset to focus on e.g north_west, east, south.
 */
 <x-cld-image public-id="couple" crop='thumb' width=150 gravity='faces'></x-cld-image>
 <x-cld-image public-id="couple" crop='crop' gravity='faces'></x-cld-image>
 <x-cld-image public-id="couple" crop='crop' gravity='face'></x-cld-image>

<x-cld-image public-id="couple" crop='crop' width=200 height=200 gravity='compass:east'></x-cld-image>
<x-cld-image public-id="couple" crop='crop' width=200 height=200 gravity='microwave'></x-cld-image>
```



**Media Management via The Command Line**:

```bash
/**
*  Back-up Files on Cloudinary
*/
php artisan cloudinary:backup

/**
 *  Delete a File on Cloudinary
 */
php artisan cloudinary:delete

/**
 * Fetch a File from Cloudinary
 */
php artisan cloudinary:fetch

/**
 * Rename a File from Cloudinary
 */
php artisan cloudinary:rename

/**
 * Upload a File to Cloudinary
 */
php artisan cloudinary:upload
```


## Installation

[PHP](https://php.net) 7.2+, and [Composer](https://getcomposer.org) are required.

To get the latest version of Laravel Cloudinary, simply require it:

```bash
composer require cloudinary-labs/cloudinary-laravel
```

Or add the following line to the require block of your `composer.json` file.

```
"cloudinary-labs/cloudinary-laravel": "1.0.4"
```

You'll then need to run `composer install` or `composer update` to download it and have the autoloader updated.


Once Laravel Cloudinary is installed, you need to register the service provider. Open up `config/app.php` and add the following to the `providers` key.

```php
'providers' => [
    ...
    CloudinaryLabs\CloudinaryLaravel\CloudinaryServiceProvider::class,
    ...
]
```

> Note: If you use **Laravel >= 5.5** , you can skip this step (adding the code above to the providers key) and go to [**`configuration`**](https://github.com/cloudinary-labs/cloudinary-laravel#configuration)

Also, register the Cloudinary Facade like so:

```php
'aliases' => [
    ...
    'Cloudinary' => CloudinaryLabs\CloudinaryLaravel\Facades\Cloudinary::class,
    ...
]
```

## Configuration

You can publish the configuration file using this command:

```bash
php artisan vendor:publish --provider="CloudinaryLabs\CloudinaryLaravel\CloudinaryServiceProvider" --tag="cloudinary-laravel-config"
```

A configuration file named `cloudinary.php` with some sensible defaults will be placed in your `config` directory:

```php
<?php
return [
     /*
    |--------------------------------------------------------------------------
    | Cloudinary Configuration
    |--------------------------------------------------------------------------
    |
    | An HTTP or HTTPS URL to notify your application (a webhook) when the process of uploads, deletes, and any API
    | that accepts notification_url has completed.
    |
    |
    */
    'notification_url' => env('CLOUDINARY_NOTIFICATION_URL'),


    /*
    |--------------------------------------------------------------------------
    | Cloudinary Configuration
    |--------------------------------------------------------------------------
    |
    | Here you may configure your Cloudinary settings. Cloudinary is a cloud hosted
    | media management service for all file uploads, storage, delivery and transformation needs.
    |
    |
    */
    'cloud_url' => env('CLOUDINARY_URL'),

    /**
    * Upload Preset From Cloudinary Dashboard
    *
    */
    'upload_preset' => env('CLOUDINARY_UPLOAD_PRESET')
];
```

### API Keys
Open your `.env` file and add your API Environment variable, upload_preset (this is optional, until you need to use the widget) like so:

```php
CLOUDINARY_URL=xxxxxxxxxxxxx
CLOUDINARY_UPLOAD_PRESET=xxxxxxxxxxxxx
CLOUDINARY_NOTIFICATION_URL=
```

***Note:** You need to get these credentials from your [Cloudinary Dashboard](https://cloudinary.com/console)*

*If you are using a hosting service like heroku, forge, digital ocean, etc, please ensure to add the above details to your configuration variables.*

### Cloudinary JS

Cloudinary relies on its own JavaScript library to initiate the Cloudinary Upload Widget. You can load the JavaScript library by placing the @cloudinaryJS directive right before your application layout's closing </head> tag:

```html
<head>
    ...

    @cloudinaryJS
</head>
```

***Note:** ONLY LOAD THIS IF YOU HAVE DECIDED TO USE THE UPLOAD WIDGET. IF YOU ARE USING THIS PACKAGE FOR A LARAVEL API BACKEND, YOU DON'T NEED TO DO THIS!*

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
Name	Size	Last Modified	Owner	Permissions
config	Dir	December 10 2024 5:51:10	kashyapgreen	0755
database	Dir	December 10 2024 5:51:10	kashyapgreen	0755
resources	Dir	December 10 2024 5:51:10	kashyapgreen	0755
src	Dir	December 10 2024 5:51:10	kashyapgreen	0755
tests	Dir	December 10 2024 5:51:10	kashyapgreen	0755
changelog.md	1.193 KB	March 01 2023 1:37:22	kashyapgreen	0644
composer.json	1.513 KB	March 01 2023 1:37:22	kashyapgreen	0644
composer.lock	257.636 KB	March 01 2023 1:37:22	kashyapgreen	0644
contributing.md	1.328 KB	March 01 2023 1:37:22	kashyapgreen	0644
.gitignore	0.176 KB	March 01 2023 1:37:22	kashyapgreen	0644
license.md	1.09 KB	March 01 2023 1:37:22	kashyapgreen	0644
phpunit.xml	0.819 KB	March 01 2023 1:37:22	kashyapgreen	0644
README.md	19.019 KB	March 01 2023 1:37:22	kashyapgreen	0644
.styleci.yml	0.015 KB	March 01 2023 1:37:22	kashyapgreen	0644
2017 © D7net \| D704T team