A non-intrusive support bubble that can be displayed on any page

Using this package you can quickly add a chat bubble that opens a support form on any page. It comes with batteries included:

• TailwindCSS styling out of the box
• Won't ask user information if there's a logged in user
• Includes some meta data like URL and IP address
• Easily extendable using custom views, language files and event listeners
• Honeypot included and set-up to keep spammers at bay

You can see it in action below and on Flare!

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Installation

You can install the package via composer:

composer require spatie/laravel-support-bubble

Include TailwindCSS

The views included in this package all use TailwindCSS classes. We've stuck to the default Tailwind config classes. If you're not already using TailwindCSS, you can easily include it from their CDN:

<link href="https://unpkg.com/tailwindcss@^2/dist/tailwind.min.css" rel="stylesheet">

Add the component to your view

After installing the package, you need to add the Blade component in your relevant view files. If you want it to show up on all pages you can add it to your layout.blade.php file.

Next, you need to register the support form's route. Add the following macro in your routes/api.php file:

Route::supportBubble();

This will register a route at /support-bubble

⚠️ This package is not using CSRF tokens so make sure you add the route macro to your apps API routes or add an exclusion in the VerifyCsrfToken middleware.

// in app/Http/Middleware/VerifyCsrfToken.php

namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;

class VerifyCsrfToken extends Middleware
{
    protected $except = [
        'support-bubble',
        // other entries
    ];
    
    // ...
}

Configure message destination

Finally, you need to decide where you want to send the support bubble's submission to.

Out of the box, the package can mail the submissions to a given email address. To go this route, publish the config file and enter the email in mail_to.

Alternately, you can register an event listener to listen for the Spatie\SupportBubble\Events\SupportBubbleSubmittedEvent event and handle it yourself. This event has submitted form values as public properties.

The config file can be published with:

php artisan vendor:publish --provider="Spatie\SupportBubble\SupportBubbleServiceProvider" --tag="support-bubble-config"

These are the default contents of the published config file:

return [
    /*
     * Use this setting to completely disable the support bubble.
     */
    'enabled' => env('SUPPORT_BUBBLE_ENABLED', true),

    /*
     * The default route and controller will be registered using this route name.
     * This is a good place to hook in your own route and controller if necessary.
     */
    'form_action_route' => 'supportBubble.submit',

    /*
     * Enable or disable fields in the support bubble.
     * Keep in mind that `name` and `email` will be hidden automatically
     * when a logged in user is detected and `prefill_logged_in_user` is set.
     */
    'fields' => [
        'name' => true,
        'email' => true,
        'subject' => true,
        'message' => true,
    ],

    /*
     * When set to true we'll use currently logged in user to fill in
     * the name and email fields. Both fields will also be hidden.
     */
    'prefill_logged_in_user' => true,

    /*
     * If configured, we'll set-up an event listener that will
     * send any chat bubble responses to this e-mail address.
     *
     * Default: null
     */
    'mail_to' => null,

    /*
     * We can try to impersonate the user that submitted the support form.
     * The mail sent to the `mail_to` address will appear as if it came
     * from the email address that was submitted in the support form.
     *
     * This is useful when sending mails directly to a support desk.
     */
    'impersonate_mail_from_user' => false,
];

Customization options

The support bubble should look pretty good out of the box. However, we've documented a couple ways to customize labels, text, views and functionality.

Customizing form fields

It is currently not possible to add new fields to the support bubble's form. You can however disable any fields you do not like in the config file.

Customizing text / localisation

If you're just looking to customize the field labels, intro text or success text (after the form submitted), you can publish the package's language files:

php artisan vendor:publish --provider="Spatie\LaravelSupportBubble\LaravelSupportBubbleServiceProvider" --tag=support-bubble-translations

These published files can be found and changed in resources/lang/vendor/laravel-support-bubble/en/.

Customizing styles

You can customize the TailwindCSS classes used for the bubble pop-up, input fields and submit button by changing the support-bubble.class config keys. This is the ideal place to change the bubble's default purple color or use your own .input or .button classes.

You you're looking to change any more advanced styles, keep reading to learn how to publish and customize the Blade views used in the support bubble component.

Customizing views

You can publish and change all views (including the JavaScript code) in this package:

php artisan vendor:publish --provider="Spatie\LaravelSupportBubble\LaravelSupportBubbleServiceProvider" --tag=support-bubble-views

These published views can be found and changed in resources/views/vendor/laravel-support-bubble/.

Please keep in mind that it's not possible (or at least pretty difficult and convoluted) to add new fields to the support bubble.

Customizing support form destination

If you don't want to send the support messages to the mail_to email configured in the config file, you can define your own event listener and listen for the Spatie\SupportBubble\Events\SupportBubbleSubmittedEvent. The event contains all data submitted in the support form and can be used to, for example, make an API request to Freshdesk.

Customizing behaviour after submitting (advanced)

If you really want to, you can send the submitted form data to your own endpoint. The support form uses the route configured in the support-bubble.form_action_route config key. You can override this route by removing the Route::supportBubble() macro from your routes file and setting the form_action_route to any other route name in your application.

The incoming request on this route will be a \Spatie\SupportBubble\Http\Requests\SupportBubbleRequest.

Testing

composer test

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

• Alex Vanderbist
• Freek Van der Herten
• Ruben Van Assche
• All Contributors

Alternatives

If you need more options for your support bubble, consider using one of these:

• Freddy Feedback
• Beacon by Help Scout

License

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