Download the PHP package stats4sd/laravel-backpack-section-title without Composer
On this page you can find all versions of the php package stats4sd/laravel-backpack-section-title. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download stats4sd/laravel-backpack-section-title
More information about stats4sd/laravel-backpack-section-title
Files in stats4sd/laravel-backpack-section-title
Package laravel-backpack-section-title
Short Description A custom Backpack Field that lets you easily add custom headings and information boxes to split up the form.
License MIT
Homepage https://github.com/stats4sd/laravel-backpack-section-title
Informations about the package laravel-backpack-section-title
LaravelBackpackSectionTitle
This package provides a new section-title
Backpack field type for use in your create/edit forms that lets you easily add a nicely styled header and/or information text to your Backpack forms.
This package was created using the Laravel Backpack Addon Skeleton provided by the Backpack team.
Screenshots
Code used to generate the screenshot: example-for-screenshot.php
Installation
Via Composer
Usage
Notice the attribute - make sure that is exactly as above, to tell Backpack to load the field from this addon package, instead of assuming it's inside the Backpack\CRUD package.
Optional properties:
title
(string or closure) - text to be displayed inside an<h4>
tag.content
(string or closure) - text to be displayed inside a padded callout box. You can use any html here, and it will be rendered without stipping tags.variant
(string) - You can use any of the Bootstrap 4 keywords to change the colour of the left border. (e.g. primary, secondary, success, info, warning, danger, light, dark). It defaults to 'info' if left null.divider
(boolean) - If set to TRUE, this adds an<hr>
tag above the header, in case you want an even clearer visual divide between content sections.
NOTE: The content box is rendered with
{!! !!}
, so there is no safety net! Make sure you never pass user content directly into the content field without sanitising it first...
Injecting $entry variables into the text
When doing an Update Operation, you may want to use some properties of the existing record in the title or content of the field. You can do this by making either property a closure with a single parameter "$entry". Your function should return the string you want rendered. For example:
Note that if you include this in the Create operation, $entry will be null, so write your closure to account for that. For example:
Overwriting
If you need to change the field in any way, you can easily publish the file to your app, and modify that file any way you want. But please keep in mind that you will not be getting any updates.
Step 1. Copy-paste the blade file to your directory:
Step 2. Remove the vendor namespace wherever you've used the field:
Step 3. Uninstall this package. Since it only provides one file, and you're no longer using that file, it makes no sense to have the package installed:
Change log
Changes are documented here on Github. Please see the Releases tab.
Contributing
Please see contributing.md for a todolist and howtos.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Dave Mills
- All Contributors
License
This project was released under MIT, so you can install it on top of any Backpack & Laravel project. Please see the license file for more information.
However, please note that you do need Backpack installed, so you need to also abide by its YUMMY License. That means in production you'll need a Backpack license code. You can get a free one for non-commercial use (or a paid one for commercial use) on backpackforlaravel.com.