optimuscms/media

Thursday, July 12, 2018
by optimuscms
Repository
1 Watchers
0 Stars
29 Installations

PHP
1 Dependents
0 Suggesters
0 Forks
0 Open issues
1 Versions
0 % Grown

Media

This package provides the core backend functionality within the CMS to upload media (image) files and organise them into folders., _(*1)

Installation

This package can be installed through Composer., _(*2)

composer require optimuscms/media

In Laravel 5.5 and above the package will autoregister the service provider., _(*3)

In Laravel 5.4 you must install this service provider:, _(*4)

// config/app.php
'providers' => [
    ...
    Optimus\Media\MediaServiceProvider::class,
    ...
];

API Routes

The API follows standard RESTful conventions, with responses being returned in JSON. Appropriate HTTP status codes are provided, and these should be used to check the outcome of an operation., _(*5)

Folders - List folders - Get folder - Create folder - Update folder - Delete folder, _(*6)

Media Items - List media items - Get media item - Create media item - Update media item - Delete media item, _(*7)

, _(*8)

List folders

GET /admin/api/media-folders

List all available folders that media items can be added to., _(*9)

Parameters, _(*10)

Parameter	Required?	Type	Description
parent	✗	int	A folder ID. When provided will only show folders nested inside this folder.

Example Response, _(*11)

[
    {
        "id": 12,
        "parent_id": null, 
        "name": "Product Images", 
        "created_at": "2017-12-24 09:36:23",
        "updated_at": "2017-12-25 10:15:12"
    },
    {
        "id": 13,
        "parent_id": 12, 
        "name": "Product Thumbnails", 
        "created_at": "2019-02-19 09:36:23",
        "updated_at": "2019-02-19 09:36:23"
    }
]

, _(*12)

Get folder

GET /admin/api/media-folders/{id}

Retrieve details for a specific folder., _(*13)

Parameters, _(*14)

Parameter	Required?	Type	Description
id	✓	int	The ID of the folder

Example Response, _(*15)

{
    "id": 12,
    "parent_id": null, 
    "name": "Product Images", 
    "created_at": "2017-12-24 09:36:23",
    "updated_at": "2017-12-25 10:15:12"
}

, _(*16)

Update folder

PUT/PATCH /admin/api/media-folders/{id}

Update the details of a folder., _(*17)

Parameters, _(*18)

Parameter	Required?	Type	Description
parent_id	✗	int	The ID of the parent folder. Set to empty to move the folder into the root
name	✗	string	The name of the folder

Example Response, _(*19)

{
    "id": 12,
    "parent_id": null, 
    "name": "Product Images", 
    "created_at": "2017-12-24 09:36:23",
    "updated_at": "2017-12-25 10:15:12"
}

, _(*20)

Create folder

POST /admin/api/media-folders

Create a new folder., _(*21)

Parameters, _(*22)

Parameter	Required?	Type	Description
parent_id	✓	int	The ID of the parent folder. Set to null to move the folder into the root
name	✓	string	The name of the folder

Example Response, _(*23)

{
    "id": 12,
    "parent_id": null, 
    "name": "Product Images", 
    "created_at": "2017-12-24 09:36:23",
    "updated_at": "2017-12-25 10:15:12"
}

, _(*24)

Delete folder

DELETE /admin/api/media-folders/{id}

Delete a folder., _(*25)

Parameters, _(*26)

Parameter	Required?	Type	Description
id	✓	int	The ID of the folder

Example Response, _(*27)

The HTTP status code will be 204 if successful., _(*28)

, _(*29)

List media items

GET /admin/api/media

List available media items., _(*30)

Parameters, _(*31)

Parameter	Required?	Type	Description
folder	✗	int	Folder ID. When provided will only show media items from this folder.

Example Response, _(*32)

[
    {
        "id": 356,
        "folder_id": 12, 
        "name": "My Image", 
        "file_name": "my_image.jpg",
        "disk": "local",
        "mime_type": "image/jpeg", 
        "size": 102400,
        "created_at": "2017-12-24 09:36:23",
        "updated_at": "2017-12-25 10:15:12"
    },
    {
        "id": 513,
        "folder_id": 4, 
        "name": "Landscape", 
        "file_name": "landscape.png",
        "disk": "local",
        "mime_type": "image/png", 
        "size": 219462,
        "created_at": "2019-02-19 09:36:23",
        "updated_at": "2019-02-19 09:36:23"
    }
]

, _(*33)

Get media item

GET /admin/api/media/{id}

Retrieve details of a specific media item., _(*34)

Parameters, _(*35)

Parameter	Required?	Type	Description
id	✓	int	The ID of the media item

Example Response, _(*36)

{
    "id": 513,
    "folder_id": 4, 
    "name": "Landscape", 
    "file_name": "landscape.png",
    "disk": "local",
    "mime_type": "image/png", 
    "size": 219462,
    "created_at": "2019-02-19 09:36:23",
    "updated_at": "2019-02-19 09:36:23"
}

, _(*37)

Update media item

PUT/PATCH /admin/api/media/{id}

Update the details of a single media item., _(*38)

Parameters, _(*39)

Parameter	Required?	Type	Description
name	✗	string	A user-facing name for the media item
folder_id	✗	int	The ID of the folder in which to store the media. If an empty value is provided, the media will be moved into the root folder.

Example Response, _(*40)

{
    "id": 513,
    "folder_id": 4, 
    "name": "Landscape", 
    "file_name": "landscape.png",
    "disk": "local",
    "mime_type": "image/png", 
    "size": 219462,
    "created_at": "2019-02-19 09:36:23",
    "updated_at": "2019-02-19 09:36:23"
}

, _(*41)

Create media item

POST /admin/api/media

Create and store a new media item., _(*42)

Parameters, _(*43)

Parameter	Required?	Type	Description
file	✓	file	The file that is being uploaded
folder_id	✗	int	The ID of the folder in which to store the media. If not provided, the media will be stored in the root folder.

Example Response, _(*44)

{
    "id": 513,
    "folder_id": 4, 
    "name": "Landscape", 
    "file_name": "landscape.png",
    "disk": "local",
    "mime_type": "image/png", 
    "size": 219462,
    "created_at": "2019-02-19 09:36:23",
    "updated_at": "2019-02-19 09:36:23"
}

, _(*45)

Delete media item

DELETE /admin/api/media/{id}

Delete a media item., _(*46)

Parameters, _(*47)

Parameter	Required?	Type	Description
id	✓	int	The ID of the media item to delete

Example Response, _(*48)

The HTTP status code will be 204 if successful., _(*49)

License

The MIT License (MIT). Please see License File for more information., _(*50)

12/07 2018

dev-master

9999999-dev

Sources Download

MIT

library media