Download the PHP package samkitano/laragrowl without Composer
On this page you can find all versions of the php package samkitano/laragrowl. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download samkitano/laragrowl
More information about samkitano/laragrowl
Files in samkitano/laragrowl
Package laragrowl
Short Description Flash Notifications with jGrowl for Laravel
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laragrowl
Laravel Flash Messages with jGrowl
All the awesomeness and functionality of jGrowl made simple, for your Laravel project.
jGrowl is "an unobtrusive notification system for web applications", by Stan Lemon. If you are not acquainted with this marvelous notification system, I encourage you to pay a visit and read the documentation.
I find this notification system to be primus inter pares. Very well documented and mantained, "unobtrusive" as advertised, lightweight, flexible, and easy to use. Since I constantly use it, particularly in the Admin sections of my projects, I wrote Laragrowl to easily include it in my Laravel apps.
The main goal of Laragrowl, rather than fully exploit jGrowl's capabilities, is to provide an out-of-the-box, easy-to-use, consistent notification system within Laravel. I believe this is fully achieved with single-liners like Laragrowl::success('Your model has been updated');.
Furthermore, with Laravel's awesome ability to use Aliases for the facades, you can even "rename" Laragrowl into something like Notify or Inform. I.e. Inform::error('Validation Failed'). Whatever suits your taste.
Requirements
-Laravel >= 5.2.X
-PHP >= 5.6
-jQuery >= 1.9.0Installation
1 - Require with Composer: composer require samkitano/laragrowl
2 - Include the service provider in the 'providers' array within config/app.php.
3 - Scroll down config/app.php and add an alias of your convenience (i.e. 'Notify') for the facade:
3 - At this point, you must decide whether to a) download jGrowl; b) use a CDN; or c) publish the included version of jGrowl (1.4.5)
a) Download jGrowl, copy the files to a directory of your convenience and include them in your template:
b) Using a CDN:
If you decide to download, or to use a CDN, you'll have to provide your own styling for the notifications. A basic theme is included in this package in src\assets\css\jquery.jgrowl.theme.css Feel free to use it "as is", or as a boilerplate to suit your own needs.
c) Publish included jGrowl version:
4 - Include the CSS files within your master template <head> section, and the core jGrowl script file right before the closing </body> tag.
5 - Publish the message view:
6 - Include the view after the jGrowl <script> tag in your master template:
REMEMBER: jGrowl is a jQuery plugin, so you MUST have jQuery loaded before your jGrowl source.
If you are comfortable with elixir, and/or you like to master your own assets, you know what to do next.
By all means, feel free to modify the provided view resources\vendor\laragrowl\message.blade.php to fit your own requirements.
Usage
Where? Where you'd usually place a Session::flash('important message').
How? You can either use the facade Laragrowl::message or the alias you have provided (if so):
Methods
| Method | Arguments | Description | Example |
|---|---|---|---|
| ::message | message, type, header, sticky, life, group |
Displays a notification according to parameters. If type is not provided, theme will be "default". |
Laragrowl::message('Welcome, User!', 'default', 'HI THERE') |
| ::default | message, header, sticky |
Displays a "default" themed notification. | Laragrowl::default('Welcome, User!'); |
| ::info | message, header, sticky |
Displays an "info" themed notification. Ideal for quickly provide an informational message. | Laragrowl::info('Please fill out this form') |
| ::success | message, header, sticky |
Displays a "success" themed notification. Ideal for quickly provide a success message. | Laragrowl::success('Data Saved!', 'SUCCESS!') |
| ::warning | message, header, sticky |
Displays a "warning" themed notification. Ideal for quickly provide a warning message. | Laragrowl::warning('FYI: Third party service is not available at this time.', 'HEY!') |
| ::error | message, header, sticky |
Displays an "error" themed notification. Ideal for quickly provide an error message. | Laragrowl::error('Validation Failed! Please correct form erros', 'ERROR', 'sticky') |
Arguments
| Argument | Type | Default value | Description |
|---|---|---|---|
message |
String | The message to display. | |
type |
String | 'success' | The default theme for messages. Available: 'default', 'info', 'success', 'warning' and 'error'. |
header |
String | '' | The message prefix, i.e. 'Error'. |
sticky |
Boolean or String | False | Weather or not the message will display forever until closed. |
life |
Integer or String | 6000 | Lifetime of a non-sticky message, in milisseconds. |
group |
String | '' | An extra CSS selector useful to group messages. |
License
Laragrowl is open-sourced software licensed under the MIT license.
