Download the PHP package singlephon/hotification without Composer

Hotification

Hotification is a powerful and flexible package for managing notifications in Laravel applications. It provides a convenient API for sending notifications, adding observers, and handling events.

Key Features

• Easy configuration through a single file: config/hotification.php.
• Extensibility with custom sender and observer classes.
• Instant sending of notifications to the database.
• Dynamic addition of observers for models.
• Execute any logic upon model changes.

Installation

1. Install via Composer:

2. Register the service provider and alias:

Add the following to config/app.php:

Quick Start

Sending Notifications

Use the HotificationSender class for instant sending of notifications to the database:

This will add a record to the notifications table.

Automating Notification Sending with Observers

Define observers and scheduled notifications directly in App\Hotification\Models and App\Hotification\Schedules classes.

Example: Configuring Observers

The example below demonstrates how to define observers for models in the App\Hotification\Models class:

Using Observers for Models

The example below shows how to configure observers for the Post and User models using hooks like onCreated, onUpdated, and onDeleted:

⚠️ Note: Notification classes must extend the Singlephon\Hotification\Notifications\AbstractHotification class.

Advantages of Using Observers

• Centralized Logic: Allows all logic related to model events to be concentrated in one place.
• Easy Management: Easily add or change behavior on events by simply updating observer configuration.
• Extensibility: Use both built-in notifications and custom callbacks, providing flexibility in event handling.

Recommendations

• Use hooks only when necessary to avoid unnecessary complexity in logic.
• Avoid overloading a single hook with too many actions to maintain performance and ease of debugging.
• For complex logic, consider moving it into separate services or classes to maintain clean and readable code.

Using Scheduled Notifications

Scheduled notifications are defined in the App\Hotification\Schedules class. You can specify tasks to be performed on a schedule, such as sending notifications or executing custom logic.

Example: Configuring Scheduled Notifications

⚠️ Note: Notification classes must extend the Singlephon\Hotification\Notifications\AbstractHotification class.

Advantages of Using scheduled_notifications

• Flexibility: Combine notifications and custom callbacks in a single task.
• Convenience: Easily add and modify tasks using configuration files.
• Automation: Automatically perform routine tasks like sending reports or performing regular updates.

Recommendations

• Test your tasks: Ensure schedules are set correctly and tasks run at the intended times.
• Avoid overly frequent tasks: Schedule tasks at reasonable intervals to avoid overloading the system.
• Use callbacks for complex logic: If a task requires complex processing, move that logic into callbacks or separate services.

Dynamic Addition of Observers at Runtime

One of the key aspects of using Hotification is the ability to dynamically add observers (handlers) to models directly at runtime, not only through configuration files. This provides high flexibility and allows for programmatic management of notification behavior depending on context or business logic.

Example Code

Consider the following example, which dynamically adds an observer for the User model:

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Rakhat Bakytzhanov
• All Contributors

License

The MIT License (MIT). Please see License File for more information.