Download the PHP package jeffersongoncalves/laravel-whatsapp-widget without Composer
On this page you can find all versions of the php package jeffersongoncalves/laravel-whatsapp-widget. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jeffersongoncalves/laravel-whatsapp-widget
More information about jeffersongoncalves/laravel-whatsapp-widget
Files in jeffersongoncalves/laravel-whatsapp-widget
Package laravel-whatsapp-widget
Short Description This Laravel package provides a simple yet customizable WhatsApp widget for your website. It allows you to easily add a clickable WhatsApp button or floating widget to connect visitors directly with your WhatsApp account. The widget is designed to be easily integrated into your Laravel application and is fully customizable to match your website's design.
License MIT
Homepage https://github.com/jeffersongoncalves/laravel-whatsapp-widget
Informations about the package laravel-whatsapp-widget
Laravel Whatsapp Widget
This Laravel package provides a simple yet customizable WhatsApp widget for your website. It allows you to easily add a clickable WhatsApp button or floating widget to connect visitors directly with your WhatsApp account. The widget is designed to be easily integrated into your Laravel application and is fully customizable to match your website's design.
Features
- ๐ Multi-agent support: Add multiple WhatsApp agents with different phone numbers and names
- โ๏ธ Side selection: Place the floating widget on the left or right of the screen
- ๐จ Themeable colors: Customize the button, modal and online status colors via config (no asset rebuild required)
- ๐ช Modal customization: Control the popup background, text and muted colors independently
- ๐ Redirect screen styling: Customize the loading/redirect page background, text, accent and spinner colors
- ๐ผ๏ธ Custom icons: Replace the trigger, fallback avatar and redirect icons with your own
- ๐ Audio notifications: Optional sound alert when the widget loads (configurable)
- ๐ฑ Mobile-friendly: Responsive design that works on all devices
- ๐ Localization support: Easily translate the widget to any language
- ๐ Pre-defined messages: Set default text messages for each agent
- ๐ผ๏ธ Custom agent avatars: Add profile pictures for each agent
Screenshots
Widget Position: Right (Default)
| Closed | Open |
|---|---|
Widget Position: Left
| Closed | Open |
|---|---|
Redirect Page
Requirements
- PHP 8.2 or higher
- Laravel 11.0 or higher
Installation
You can install the package via composer:
Usage
1. Publish the package assets
Publish config file:
Publish migration file:
Publish assets files:
Publish translations files:
Publish views files:
2. Run the migrations
3. Add the widget to your layout
Add the head template in your layout's <head> section:
Add the body template before the closing </body> tag:
4. Add WhatsApp agents
You need to add WhatsApp agents to your database. You can do this through your application's admin panel or by creating a seeder.
Example seeder:
Configuration
After publishing the configuration file, you can customize the widget by editing the config/whatsapp-widget.php file:
Customization
Translations
The package currently supports the following languages:
- ๐ธ๐ฆ Arabic (
ar) - ๐จ๐ฟ Czech (
cs) - ๐ฉ๐ช German (
de) - ๐บ๐ธ English (
en) - ๐ช๐ธ Spanish (
es) - ๐ฎ๐ท Persian (
fa) - ๐ซ๐ท French (
fr) - ๐ฎ๐ฑ Hebrew (
he) - ๐ฎ๐ฉ Indonesian (
id) - ๐ฎ๐น Italian (
it) - ๐ฏ๐ต Japanese (
ja) - ๐ณ๐ฑ Dutch (
nl) - ๐ต๐ฑ Polish (
pl) - ๐ต๐น Portuguese (
pt) - ๐ง๐ท Portuguese (Brazil) (
pt_BR) - ๐ต๐น Portuguese (Portugal) (
pt_PT) - ๐ธ๐ฐ Slovak (
sk) - ๐น๐ท Turkish (
tr)
You can customize the widget's text by editing the translation files in resources/lang/vendor/whatsapp-widget/.
Position
By default, the widget appears in the bottom-right corner of the page. You can change this by modifying the position value in the config/whatsapp-widget.php file.
Example for left position:
| Closed | Open |
|---|---|
Example for right position:
| Closed | Open |
|---|---|
Colors
The widget and the modal that opens are fully themeable through the colors array in config/whatsapp-widget.php. Colors are applied through CSS custom properties, so changing them does not require rebuilding the assets.
The redirect (loading) screen has its own palette:
Icons
You can replace the default icons with your own by pointing the icons array to a public URL or path. Leave a value as null to keep the bundled default.
Redirect Page
When a user clicks on an agent, they are redirected to a temporary page before being sent to WhatsApp. Its colors and icon are configurable via the redirect and icons arrays above, and the full page can be further customized by publishing the package views.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Jรจfferson Gonรงalves
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-whatsapp-widget with dependencies
laravel/framework Version ^12.61.1|^13.12.0
spatie/laravel-package-tools Version ^1.14.0