Notific is a simple, and minimal, static notification system for Laravel. It stores notification data based on user_id, and fetch notifications for the user_id. It's not that feature rich.
The package has no UI, it just a database based cached data-driven mechanism of organized methods. You have to build you own UI.
License: GPL-2.0+
Requires: Laravel 5.8
Tested up to: Laravel 8.x
Developers: Mayeenul Islam, Nazmul Hasan
The package is developed for the organization's internal use only. If it helps you, that's why it's here. We might not support the package full throttle. But bug reports are welcome.
- Database table creation using migration
- Store notifications into the database
- Fetch notifications from the database
- Store and fetch any types of additional information for notification with metadata
- Cached data to save some valuable resources - configurable
Features that are not present:
- Event listener and real-time notification (but you can easily extend into those)
Open up the command console on the root of your app and run:
composer require technovistalimited/notificAdd the following string to the config/app.php under providers array:
Technovistalimited\Notific\NotificServiceProvider::class,Add the following line to the config/app.php under aliases array:
'Notific' => Technovistalimited\Notific\Facades\Notific::class,Make the configuration and migration files ready first; in the command console, type and hit enter:
php artisan vendor:publish --tag=notificOpen up the command console on the root of your app and run the migrations:
php artisan migrateChange configuration in config/notific.php.
Set whether to use the cache or not, under 'cache' => ['is_cache']. Accepted value: true (enabled), false (disabled)
Default: true - enabled
Change the time under 'cache' => ['cache_time']. Accepted value: any positive integer to denote seconds.
Default: 10 minutes
If you defined the helper class correctly, the package is easy to use:
To store notification, simply place the following method where you want to plug it into. The method will also clear the cache for the user to update the notification history.
Notific::notify( $userId, $message, $notificationType, $metaData, $createdBy );$userID : integer/array
User ID or array of user IDs to notify.$message : string
The message with which you want to notify with.$notificationType : string : (optional)
The notification type if you have any, other than notification.
default:'notification'$metaData : integer/string/array : (optional)
Whatever additional information you want to pass with. Whether pass them as integer, string or as an array.
default: empty$createdBy : integer : (optional)
If you want to keep trace who issued the notification.
default: empty
Get the notifications by user ID.
Notific::getNotifications( $userId, $arguments );$userID : integer
User ID for which to fetch the notifications.$arguments : array : (optional)
Array of Query parameters. default:array()- fetch notifications based on default settings$read_status : string
The notification read status. Accepts:'all','read','unread'.
default:'all'$order : string
Designates ascending or descending order of notifications. Accepts'ASC','DESC'.
default:'DESC'$orderby : string
Sort retrieved posts by parameter. Single option can be passed. Accepts any valid column name from db table.
default:'created_at'$paginate : boolean
Whether to enable pagination or not.
default:false- pagination DEactivated$items_per_page : integer
Fetch the number of items. Accepts any positive integer.
default:-1- fetch everything
Get the total count of notifications by user ID.
Notific::getNotificationCount( $userId, $status );$userID : integer
User ID for which to fetch the notifications.$status : string : (optional)
The notification read status. Accepts:'all','read','unread'.
default:all- fetch all the notification count
Mark the notification as read when actually they are. You might need AJAX to mark them read on the fly.
Notific::markNotificationRead( $userId, $notificationId );$userID : integer
User ID to mark the notification as read for.$notificationId : integer : (optional)
If you want to mark each of the notification as read, pass the notification ID
default: empty - mark all as read
With the following examples, a user with the ID 21 will be notified accordingly:
// Notified with a simple message.
Notific::notify( 21, 'Your application submitted.' ) );
// Notified with a message and date.
Notific::notify( 21, sprintf( 'Your application submitted on %s is approved.', date('d F Y') ) );
// Notified with a different type of notification.
Notific::notify( 21, 'Your application submitted.', 'message' ) );
// Notified with some meta data incorporated.
Notific::notify( 21, 'Your application is approved. Click to see it.', 'notification', array('link' => 'http://link.to/the/application/' ) ) );
// Notified with someone who (with ID 8) assigned the notification
Notific::notify( 21, 'Your application submitted.', 'notification', '', 8 ) );
// Notify multiple users (with ID 21, 4, and 5) at a time
Notific::notify( [21, 4, 5], 'An application is submitted. Please check.' );With the following examples, we're fetching the notifications assigned to a user with ID 21:
// Get all the notifications.
Notific::getNotifications( 21 );
// Get unread notifications only.
Notific::getNotifications( 21, array( 'read_status' => 'unread' ) );
// Get read notifications only.
Notific::getNotifications( 21, array( 'read_status' => 'read' ) );
// Get read notifications and maximum 10 of them only.
Notific::getNotifications( 21, array( 'read_status' => 'all', 'items_per_page' => 10 ) );
// Get all notifications and paginate them to 50 per page only.
Notific::getNotifications( 21, array( 'paginate' => true, 'items_per_page' => 50 ) );With the following examples, we're fetching the count of notifications assigned to a user with ID 21:
// Get all notifications of the user ID 21.
Notific::getNotificationCount( 21 );
Notific::getNotificationCount( 21, 'all' );
// Get only the 'unread' notifications of the user ID 21.
Notific::getNotificationCount( 21, 'unread' );
// Get only the 'read' notifications of the user ID 21.
Notific::getNotificationCount( 21, 'read' );// Mark all the notifications as 'read' for the user with ID 21.
Notific::markNotificationRead( 21 );
// Mark notification number 56 as 'read' for the user with ID 21.
Notific::markNotificationRead( 21, 56 );Adopted from WordPress, this function can detect whether to unserialize a string or not and serialize, if it's a serialized data. If you make custom methods, you might need to convert the serialized meta data back into array - this method will help you then.
// Unserialize if serialized.
Notific::maybeUnserialize( $string );Any bug report is welcome. We might not support the package as you might require. But we will definitely try to fix the bugs as long as they meet our leisure.
If you want to contribute code, feel free to add Pull Request.
- Search the whole project of any declaration of
Notific::, and remove the functions from the source, or comment them out. Otherwise, they will generate a fatal error after uninstallation. - Open
config/app.phpand remove the line...NotificServiceProvider::classunderprovidersandaliasesarray. - Remove the configuration file
notific.phpinconfig/notific.php - Remove the notific migration files from
database/migrations/ - Delete the two database tables manually (as the package is not released): table:
notifications, and table:user_notifications
Now, open up the command console, and type:
composer remove technovistalimited/notificYou are done!
All the credit goes to the almighty God first. Thanks to Mr. Amiya Kishore Saha who let both of us make our first Laravel package. Thanks to Mr. Kamrul Hasan for reviewing the progress and suggesting his ideas. And thanks to TechnoVista Limited for supporting the initiative. Thanks to Notifynder - a Laravel notification package available at Packagist from Fabrizio - we followed them to learn. Thanks to WordPress - a GPL licensed web framework - we took some of their code thankfully.