/MeioUpload

Behavior for upload to CakePHP - DEPRECATED! Please use https://github.com/josegonzalez/upload instead

Primary LanguagePHP

Deprecated Project

This project is no longer being maintained by me. I have no time to keep updating and adding more features. Also, the code is very tied and hard to add features or fix bugs without broke some backward compatibility. By this reason, I am helping Jose Gonzalez to improve his upload plugin to contain the current features from MeioUpload. I strictly recommend you to migrate to his project when you have time.

Check Jose's upload plugin: https://github.com/josegonzalez/upload

Sorry for any inconvenience.

MeioUpload 4.0 Behavior Plugin

This behavior provides to upload files in your application, as well as the possibility to translate the error message (originally only in portuguese) and the use of phpThumb as a better thumbnail generator.

You can also use it in No-DB mode, which means that no data for the upload is stored within the database. You can further this by setting var $useTable = false in the model, which will both trigger No-DB mode AND allow quick uploads.

Installation

  • Clone from github : in your app directory type git clone git://github.com/jrbasso/MeioUpload.git Plugin/MeioUpload
  • Add as a git submodule : in your app directory type git submodule add git://github.com/jrbasso/MeioUpload.git Plugin/MeioUpload
  • Download an archive from github and extract it in app/Plugin/MeioUpload
  • If you require thumbnails for image generation, download the latest copy of phpThumb and extract it into your vendors directory. Should end up like: /vendors/phpThumb/{files}. (http://phpthumb.sourceforge.net)

Usage

In a model that needs uploading, replace the class declaration with something similar to the following:

<?php
class Image extends AppModel {
	var $name = 'Image';
	var $actsAs = array(
		'MeioUpload.MeioUpload' => array('filename')
	);
}
?>

You also need to specify the fields in your database like so

``	CREATE TABLE `images` (``
``		`id` int(8) unsigned NOT NULL auto_increment,``
``		`filename` varchar(255) default NULL,``
``		`dir` varchar(255) default NULL,``
``		`mimetype` varchar(255) NULL,``
``		`filesize` int(11) unsigned default NULL,``
``		`created` datetime default NULL,``
``		`modified` datetime default NULL,``
``		PRIMARY KEY  (`id`)``
``	) ENGINE=MyISAM  DEFAULT CHARSET=utf8;``

Create your upload view, make sure it's a multipart/form-data form, and the filename field is of type 'file':

<?php
	echo $this->Form->create('Image', array('type' => 'file'));
	echo $this->Form->input('filename', array('type' => 'file'));
	echo $this->Form->input('dir', array('type' => 'hidden'));
	echo $this->Form->input('mimetype', array('type' => 'hidden'));
	echo $this->Form->input('filesize', array('type' => 'hidden'));
	echo $this->Form->end('Submit');
?>

You'll want to include any other fields in your Model as well :)

Make sure your directory (app/webroot/uploads/image/ in this case, image changes to the name of your model) is at least CHMOD 775, also check your php.ini MAX_FILE_SIZE is enough to support the filesizes you are uploading (default in the behavior is 2MB, can be configured)

The behavior code will save the uploaded file's name in the 'filename' field in database, it will not overwrite existing files, instead it will create a new filename based on the original plus a counter. For thumbnails, when the file is uploaded, it will automatically create 3 thumbnail sizes (this can be configured) and prepend the name to the thumbfiles as directories(i.e. app/webroot/uploads/image/image_001.jpg will produced app/webroot/uploads/thumb/small/image/image_001.jpg, app/webroot/uploads/thumb/medium/image/image_001.jpg, app/webroot/uploads/thumb/large/image/image_001.jpg)

Deleting an uploaded file while keeping the record

Flag the file for deletion by setting data[Model][filename][remove] to something non-empty, e.g. TRUE. The uploaded file including possible thumbnails will then be deleted together with adherent database fields upon save. Note that the record will be preserved, only the file meta-data columns will be reset.

Regenerating all thumbnails for a Model

The method regenerateThumbnails() will regenerate all thumbnails, for all fields using MeioUpload, in a given model. It can be called from your controller like this:

$this->MyModel->regenerateThumbnails();

This can be used in the situation where, for example, you upload 1000 records with 200x400 thumbnails, but then later re-design the website to have 100x150 thumbnails.

Note:

  • regenerateThumbnails will not delete redundant thumbnails - so this should be done manually, if needed.
  • regenerateThumbnails will overwrite existing thumbnails, if they exist
  • it's a good idea to backup all thumbnails before calling regenerateThumbnails

How to run unit tests for Cake 2.0 Models which use MeioUpload 4.0 as Behavior

Assuming we have a Model called Image which use MeioUpload 4.0 as Behavior.

Before we run the save function in the unit test for Image, ensure that this piece of code is executed

	// turn off the check to see if HTTP POST is used to upload the source file
	$this->Image->validate['filename'] = array(
		'HttpPost' => array(
			'check' => false
		)
	);