Download the PHP package todi1979/cakephp3-media-plugin without Composer
On this page you can find all versions of the php package todi1979/cakephp3-media-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package cakephp3-media-plugin
Media plugin for CakePHP 3
About
The aim of this plugin is to give you the ability to create and associate any kind of medias in your application. This plugin is the adapation from Grafikart's Media Plugin for CakePHP 3.
Overview
- BelongsTo and hasMany Media association for you model;
- Upload using drag & drop based on dropzone.js;
- Image uploader integrated with tinymce 4.2 and CKEditor 4.5
Installation
Requirements
Steps to install
-
Run :
- Import The file
config\schema\medias.sql
in your database
How to use
In your config\bootstrap.php
file, add this line
Security purpose
By default, the plugin is blocked for everyone. To set proper permissions, you can implement canUploadMedia() method in your YourApp\AppController
.
For exemple :
Behavior
To use this plugin, you must load the MediaBehavior
in your tables. Form instance, if you want to manage medias for your posts :
For the path option, you have numerous parameters :
- %y Year
- %m Month
- %f Sluggified filename
- %id Media Id
- %cid Media Id /100
- %mid Media Id /1000
Helper
In order to add media upload and edit capabilities in your views, you can use MediaHelper
.
To do so, add in your AppController
Or in your AppView
For example, you can add an iframe to manage medias:
Or you can add text editor (tinymce for instance) inside form :
This method take the same array $options
than native FormInput
helper.
Thumb
If you want to add thumb for your posts, you must add media_id
field in your 'Model' database table.
Notice
In order to upload pictures, you should implement draft system for your model.
ToDo
- Add the ability to edit a media when clicked;
- Add resize, crop, flip and rotate functions;
- Finish unit test...
How to contribute
- You have find a bug ? You can open an issue
- Clearly describe the issue including steps to reproduce when it is a bug.
- Make sure you fill in the earliest version that you know has the issue.
- Screenshots and code exemple are welcome in the issues.
- You want to implement a new feature or fix a bug ? Please follow this guide :
- Your code must follow the Coding Standard of CakePHP. Check the cakephp-codesniffer repository to setup the CakePHP standard.
- You must add Test Cases for your new feature. Test Cases ensure that the application will continue to working in the future.
- Your PR should be on the
dev
branch.
Special thanks
- Grafikart for the first version of this plugin !