Download the PHP package paulredmond/chosen-cakephp without Composer
On this page you can find all versions of the php package paulredmond/chosen-cakephp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download paulredmond/chosen-cakephp
More information about paulredmond/chosen-cakephp
Files in paulredmond/chosen-cakephp
Package chosen-cakephp
Short Description Chosen CakePHP plugin for CakePHP 2
License MIT
Homepage https://github.com/paulredmond/chosen-cakephp
Informations about the package chosen-cakephp
ChosenHelper for CakePHP 2
ChosenHelper is a class for integrating HarvestHQ Chosen select boxes in CakePHP 2. Check out HarvestHQ's demo for documentation and usage.
Changelog
A Changelog Wiki page is now available. Review it carefully to make sure you do not upgrade permaturely. For example: the latest version (2.1.0) includes a backwards compatability break with CakePHP 2.0.x.
Installation
Chosen CakePHP 2 plugin supports Composer and Packagist. After you download composer.phar and put it in your path:
Composer will take care of installing the plugin into the correct location. Include the following composer.json
file at path/to/app
Use a sensible stable version for the plugin. The above '*' is only intended as an example.
Bootstrap the plugin in app/Config/bootstrap.php:
Optional webroot symlink
Setup
In /app/Controller/AppController.php:
Out of the box, the ChosenHelper will work with jQuery; but you might want prototype or a custom class:
Now all classes rendered with the helper, or other inputs with your configured class will be targeted.
JQuery / Prototype
Make sure that you are loading JQuery (1.4+) or Prototype however you want:
- Note: Chosen CSS/JS files are only loaded if the helper select method is called at least once.*
Pull Requests
Chosen CakePHP plugin has contributions from the Github communitiy. I am grateful for the suggestions, fixes, and improvements. If you'd like to submit a pull request, follow these simple instructions:
- Pull requests for the 2.1.x version should be submitted to the
2.1
branch - If the supported
2.0
branch (for CakePHP 2.0.x) could benefit from your Pull Request, consider opening another Pull Request for that branch. - The
master
branch reflects the latest stable version available.
Testing
You can run tests for Chosen with phpunit from the folder. Learn more about Testing in CakePHP 2
Ensure that you have installed the vendor dependencies for this plugin through composer or some other means.
Examples
Chosen inputs behave identically to the FormHelper::input() method.
Multi-select:
Default selected:
Grouped:
Deselect on Single Select:
Do not use attribute with deselect, use instead.
License
Copyright 2013 Paul Redmond. It is free software, and may be redistributed under the terms specified in the LICENSE file. License is also available online.