Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cakephp-bootstrap/cakephp4-bootstrap-helpers
CakePHP 4.x Helpers for Bootstrap 3 and 4.
https://github.com/cakephp-bootstrap/cakephp4-bootstrap-helpers
Last synced: 2 months ago
JSON representation
CakePHP 4.x Helpers for Bootstrap 3 and 4.
- Host: GitHub
- URL: https://github.com/cakephp-bootstrap/cakephp4-bootstrap-helpers
- Owner: CakePHP-Bootstrap
- License: mit
- Created: 2020-11-16T10:29:02.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-23T11:05:37.000Z (about 1 year ago)
- Last Synced: 2024-06-15T12:05:44.316Z (7 months ago)
- Language: PHP
- Size: 846 KB
- Stars: 3
- Watchers: 3
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
CakePHP 4.x Helpers for Bootstrap
=================================
[](LICENSE)
[](https://travis-ci.com/Holt59/cakephp3-bootstrap-helpers)
[](https://packagist.org/packages/holt59/cakephp3-bootstrap-helpers)
CakePHP 4.x Helpers to generate HTML with @Twitter Boostrap style: `Breadcrumbs`, `Flash`, `Form`, `Html`, `Modal`, `Navbar`,
`Card` and `Paginator` helpers available!
How to... ?
===========
#### Installation
If you want the **Bootstrap 4** version of the plugin:
- Add the plugin to your `composer.json`:
```bash
# Stable version:
composer require holt59/cakephp3-bootstrap-helpers:4.0.3
```
- [Load the helpers](https://book.cakephp.org/3.0/en/views/helpers.html#configuring-helpers) you want in your `View/AppView.php`:
```php
$this->loadHelper('Html', [
'className' => 'Bootstrap.Html',
// Other configuration options...
]);
```
#### Breaking changes from previous versions
- `FormHelper`:
- it is not possible to place error message in a separate column in horizontal form, the error message
will always be put below the input.
- `NavbarHelper`:
- the following options of the `create()` methods have been removed or have had their meaning changed:
- `static` is now `sticky`
- `responsive` has been dropped and replace by a `collapse` option with the following meaning: `true`
for always collapsed, `false` for never collapsed, or a string representing indicating when the content
should collapse (`'lg'` is the default).
- `fluid` has been dropped.
- `container` is a new option (`bool`, default is `false`) to indicate if the content of the navbar
should be wrapped inside a `
`.
- `inverse` has been dropped.
- a new `theme` option has been added to the `create()` method to control, possible values are `'light'`,
`'dark'`, `false` (no theme), or an array `[$theme, $bg]`.
- when adding a `link()` to an inner menu, the `$linkOptions` parameters is not usable anymore and the
`$options` parameters should be used directly (their are no wrapping `The full plugin documentation is available at https://cakephp-bootstrap.github.io/cakephp3-bootstrap-helpers/.
#### Table of version and requirements
| Version | Bootstrap version | CakePHP version | Information |
|---------|-------------------|-----------------|-------------|
| [master](https://github.com/Holt59/cakephp3-bootstrap-helpers/tree/master) | 4 | >= 3.7.0 | Current active V4 branch. |
| [4.0.3](https://github.com/Holt59/cakephp3-bootstrap-helpers/tree/v4.0.3) | 4 | >= 3.7.0 | Current active V4 branch. |
| [4.0.2](https://github.com/Holt59/cakephp3-bootstrap-helpers/tree/v4.0.2) | 4 | >= 3.7.0 | Latest V4 release. |
| [3.1.4](https://github.com/Holt59/cakephp3-bootstrap-helpers/tree/v3.1.2) | 3 | >= 3.7.0 | Open issue(s) if necessary. |
| <= [3.1.2](https://github.com/Holt59/cakephp3-bootstrap-helpers/tree/v3.1.1) | 3 | < 3.4.0 | Deprecated. |
#### Contributing
Do not hesitate to [**post a github issue**](https://github.com/Holt59/cakephp3-bootstrap-helpers/issues/new) or [**submit a pull request**](https://github.com/Holt59/cakephp3-bootstrap-helpers/pulls) if you find a bug or want a new feature.
Who is using it?
================
Non-exhaustive list of projects using these helpers, if you want to be in this list, do not hesitate to [email me](mailto:[email protected]) or post a comment on [this issue](https://github.com/Holt59/cakephp3-bootstrap-helpers/issues/32).
- [**CakeAdmin**] (https://github.com/cakemanager/cakeadmin-lightstrap), LightStrap Theme for CakeAdmin
Copyright and license
=====================
The MIT License (MIT)
Copyright (c) 2013-2020, Mikaël Capelle.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
See [LICENSE](LICENSE).