README

AppToast for QCubed-4

The AppToast plugin is a lightweight wrapper around the excellent Toastify JS library, allowing developers to display elegant toast notifications in QCubed-4 applications.

Unlike many existing QCubed plugins, this component demonstrates that QCubed-4 can seamlessly integrate modern Vanilla JavaScript libraries, without relying on jQuery.

The plugin provides a simple QCubed API while delegating rendering, animation and stacking to Toastify JS.

Features

• Wrapper around the Toastify JS library
• No jQuery dependency
• Lightweight and reusable
• Supports success, warning, error and info notifications
• Configurable duration, position, gravity and offset
• Compatible with PHP 8.3+

Credits

This plugin uses the open source Toastify JS library created by Apoorv Varun.

GitHub: https://github.com/apvarun/toastify-js

Documentation & examples: https://apvarun.github.io/toastify-js/

Requirements

• PHP 8.3 or newer
• QCubed-4

Installation

This plugin is installed via Composer:

composer require kukrik/qcubed-apptoast

Basic usage

$objToast = new AppToast($this);

$objToast->Type = 'warning';
$objToast->Text = 'Please enter at least 3 characters.';

Available toast types:

• success
• warning
• error
• info

AppToast is a reusable notification component for QCubed-4. It can be used throughout the application for validation messages, Ajax callbacks, success notifications, and error reporting.