https://github.com/clevertech/yiibooster
YiiBooster
https://github.com/clevertech/yiibooster
Last synced: about 1 year ago
JSON representation
YiiBooster
- Host: GitHub
- URL: https://github.com/clevertech/yiibooster
- Owner: clevertech
- License: bsd-2-clause
- Created: 2012-09-19T17:42:09.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2019-08-17T23:28:58.000Z (almost 7 years ago)
- Last Synced: 2025-04-10T09:43:54.451Z (about 1 year ago)
- Language: JavaScript
- Size: 9.33 MB
- Stars: 543
- Watchers: 111
- Forks: 304
- Open Issues: 116
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
YiiBooster
==========
[](https://gitter.im/clevertech/YiiBooster?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://travis-ci.org/clevertech/YiiBooster)
[](https://scrutinizer-ci.com/g/clevertech/YiiBooster/?branch=master)
[](https://scrutinizer-ci.com/g/clevertech/YiiBooster/?branch=master)
[](https://insight.sensiolabs.com/projects/efb55e52-aaf3-4692-abf7-729e8aa0eb1a)
[](https://github.com/clevertech/YiiBooster/releases/tag/v4.0.1)
[](https://github.com/clevertech/YiiBooster/tree/master)
[](https://packagist.org/packages/clevertech/yii-booster)
[](https://github.com/clevertech/YiiBooster/blob/master/LICENSE)
YiiBooster is a widget toolkit for [Yii web framework](http://www.yiiframework.com).
Its main purpose is to ease building UI in Yii-based web applications utilizing the beauty of [Twitter Bootstrap][twitter-bootstrap]
and several other great UI plugins developed over time by the community.
Twitter Bootstrap wrapping is based over the excellent job of [Christoffer Niska](https://twitter.com/Crisu83) called [Yii-Bootstrap](http://www.cniska.net/yii-bootstrap/).
We at [Clevertech](http://clevertech.biz) included his library into our own Yii project startup library, [YiiBoilerplate](http://github.com/clevertech/yiiboilerplate),
and started improving it in order to satisfy some of our customers' project requirements.
YiiBooster is an end result of this effort.
We tried very hard in past to accommodate to radical changes between successive versions of Twitter Bootstrap,
but starting from November 2016 we will just follow the latest stable version published by Twitter.
This means that when you upgrade YiiBooster, you upgrade Twitter Bootstrap as well.
## Widgets at a glance
Overall, the following is included in YiiBooster:
* All of most current [Twitter Bootstrap][twitter-bootstrap] goodness we were able to integrate with.
* [FontAwesome icons pack](http://fortawesome.github.io/Font-Awesome/) for Twitter Bootstrap.
* [jQuery File Upload](https://github.com/blueimp/jQuery-File-Upload) widget for fancy file uploads.
* [jQueryUI/Bootstrap](http://addyosmani.github.io/jquery-ui-bootstrap/) integration.
* [Select2](http://ivaynberg.github.io/select2/) widget for fancy selectors.
* [X-Editable](http://vitalets.github.io/x-editable/) plugin for in-place editing of table cells values.
* Absolutely crazy custom grid views called [TbExtendedGridView](http://yii-booster.clevertech.biz/extended-grid.html) and [TbJsonGridView](http://yii-booster.clevertech.biz/json-grid.html), packed with features to the brim.
* *Four* different WYSIWYG editors for you to choose:
* [wysihtml5](https://github.com/xing/wysihtml5) [with Bootstrap integration](https://github.com/jhollingworth/bootstrap-wysihtml5),
* [jQuery Markdown](https://github.com/arhpreston/jquery-markdown),
* [CKEditor](http://ckeditor.com/) and
* [Redactor](http://imperavi.com/redactor/).
And don't be afraid to use Redactor, because Yii community bought an ORM license for it.
* And several other little and not-so-little widgets for you to use.
## Quick Start
If you want, you can clone the [github repo](https://github.com/clevertech/YiiBooster) and get the full codebase
to build the distributive or documentation or just to hack something.
If you just want to _use_ YiiBooster, you need to [download the latest distributive archive](https://sourceforge.net/projects/yiibooster/files/latest/download?source=files).
After that, consult the [YiiBooster documentation website][booster-docs] or the `INSTALL.md` file included in the package.
## Widgets end-user documentation
Check out [YiiBooster documentation website][booster-docs].
## Contributing
Long story short: make pull requests from separate branches dedicated for individual features to `master`.
Please see the [wiki page about how to contribute to YiiBooster](https://github.com/clevertech/YiiBooster/wiki/How-to-contribute-to-this-repository) for details.
## Requirements
YiiBooster as a project requires (and supports) PHP 5.3 and Yii 1.1.15.
We know that PHP 5.3 is deprecated for several years already and Yii has version 2 released a year ago.
A major overwrite is planned, but as for YiiBooster as it is, the dependencies versions stand as they are.
For development we specify explicitly that you'll need [PHPUnit 4.8, because it's the last version to support PHP 5.3](https://github.com/sebastianbergmann/phpunit/wiki/Release-Announcement-for-PHPUnit-4.8.0).
## Bug tracker
If you find any bugs, please create an issue at [issue tracker for project Github repository][booster-issues].
## License
This work as a whole is licensed under a BSD license. Full text is included in the `LICENSE` file in the root of codebase.
> Well-built beautifully designed web applications.
>
> [www.clevertech.biz](http://www.clevertech.biz)
[twitter-bootstrap]: http://twitter.github.com/bootstrap/
[booster-docs]: http://yii-booster.clevertech.biz/
[booster-issues]: https://github.com/clevertech/YiiBooster/issues