PHPackages                             vertexinvo/support-widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. vertexinvo/support-widget

ActiveLibrary

vertexinvo/support-widget
=========================

Vertexinvo Support Widget

v1.0.0(today)04↑2900%MITPHP

Since Jul 31Pushed todayCompare

[ Source](https://github.com/salahshakeel/vertex-support-widget)[ Packagist](https://packagist.org/packages/vertexinvo/support-widget)[ RSS](/packages/vertexinvo-support-widget/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (5)Versions (2)Used By (0)

VertexInvo Support Widget
=========================

[](#vertexinvo-support-widget)

[![Latest Version](https://camo.githubusercontent.com/c9b5d668b9658f66ffae61ceb64eea40b45b2cb171192e9a1b77473773693b2e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766572746578696e766f2f737570706f72742d7769646765742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vertexinvo/support-widget)[![Total Downloads](https://camo.githubusercontent.com/e2de51e6d33af18edc500701d527c2acc1d208ddc719d9d4149b0f293a0b4149/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766572746578696e766f2f737570706f72742d7769646765742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vertexinvo/support-widget)[![License](https://camo.githubusercontent.com/8c2b3cb16c161d216d9cff2134a5071c7aa2db941f03b5b38ceb14dae53358de/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f766572746578696e766f2f737570706f72742d7769646765742e7376673f7374796c653d666c61742d737175617265)](https://github.com/salahshakeel/vertex-support-widget)

A Laravel package that adds a floating support widget to your application and securely authenticates logged-in users into the VertexInvo Support Portal using Single Sign-On (SSO).

The package allows your users to open support directly from your application without requiring a separate login. Authentication is securely handled through your Laravel backend.

---

Features
--------

[](#features)

- 🚀 Easy installation via Composer
- 🔐 Secure server-side SSO authentication
- 👤 Widget visible only to authenticated users
- 🎨 Customizable widget colors
- 📍 Customizable widget position
- ⚙️ Laravel package auto-discovery
- 🛡️ API key never exposed to the browser
- 🔄 Supports Laravel 10, 11, 12, and 13

---

Requirements
------------

[](#requirements)

RequirementVersionPHP8.1+Laravel10.x, 11.x, 12.x, 13.x### Compatibility

[](#compatibility)

LaravelPHPLaravel 10PHP 8.1+Laravel 11PHP 8.2+Laravel 12PHP 8.2+Laravel 13PHP 8.3+---

Installation
============

[](#installation)

Install the package using Composer:

```
composer require vertexinvo/support-widget
```

Laravel will automatically discover and register the package service provider.

---

Configuration
=============

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=vertex-support-config
```

This will create:

```
config/vertex-support.php

```

---

Assets
======

[](#assets)

Publish the widget assets:

```
php artisan vendor:publish --tag=vertex-support-assets
```

---

Environment Setup
=================

[](#environment-setup)

Add your VertexInvo Support API key to your `.env` file:

```
VERTEX_SUPPORT_API_KEY=your_api_key
```

---

Configuration Example
=====================

[](#configuration-example)

`config/vertex-support.php`

```
return [

    /*
    |--------------------------------------------------------------------------
    | Enable Widget
    |--------------------------------------------------------------------------
    */

    'enabled' => true,

    /*
    |--------------------------------------------------------------------------
    | API Key
    |--------------------------------------------------------------------------
    */

    'api_key' => env('VERTEX_SUPPORT_API_KEY'),

    /*
    |--------------------------------------------------------------------------
    | SSO Endpoint
    |--------------------------------------------------------------------------
    */

    'endpoint' => 'https://support.vertexinvo.com/api/v1/sso',

    /*
    |--------------------------------------------------------------------------
    | Widget Position
    |--------------------------------------------------------------------------
    |
    | Available:
    | bottom-right
    | bottom-left
    |
    */

    'position' => 'bottom-right',

    /*
    |--------------------------------------------------------------------------
    | Widget Colors
    |--------------------------------------------------------------------------
    */

    'button_color' => '#000000',

    'icon_color' => '#ffffff',

];
```

---

Add Widget To Your Layout
=========================

[](#add-widget-to-your-layout)

Add the widget component before the closing `` tag in your main Blade layout:

```
@include('vertex-support::widget')
```

Example:

```

    {{ $slot ?? '' }}

    @include('vertex-support::widget')

```

The widget automatically checks authentication and only displays for logged-in users.

---

Widget Visibility
=================

[](#widget-visibility)

UserWidgetGuest❌ HiddenAuthenticated User✅ Visible---

SSO Authentication Flow
=======================

[](#sso-authentication-flow)

When a user clicks the support widget:

1. Laravel receives the request.
2. Laravel sends a secure server-side request to VertexInvo.
3. VertexInvo validates the API key.
4. A temporary secure redirect URL is generated.
5. The user is redirected to the Support Portal.

Your API key is never exposed to the frontend.

---

API Request
===========

[](#api-request)

The package communicates with:

```
POST https://support.vertexinvo.com/api/v1/sso

```

Request:

```
{
    "api_key": "YOUR_API_KEY",
    "email": "user@example.com",
    "name": "John Doe"
}
```

---

API Response
============

[](#api-response)

Success:

```
{
    "redirect_url": "https://support.vertexinvo.com/...",
    "expires_in": 600
}
```

Error:

```
{
    "error": "Invalid or inactive product API key."
}
```

---

Security
========

[](#security)

This package is designed with security in mind:

- API keys remain server-side.
- No sensitive credentials are sent to the browser.
- All SSO requests are performed by Laravel.
- Users receive only a temporary redirect URL.
- Access is limited to authenticated users.

---

Updating
========

[](#updating)

Update the package:

```
composer update vertexinvo/support-widget
```

Clear Laravel cache after updating:

```
php artisan optimize:clear
```

---

Troubleshooting
===============

[](#troubleshooting)

If the widget does not appear:

1. Confirm the user is authenticated.
2. Confirm the Blade include exists.
3. Publish the package assets.
4. Check your `.env` API key.
5. Clear Laravel cache.

---

Support
=======

[](#support)

For issues, feature requests, or questions:

GitHub Repository:

---

License
=======

[](#license)

The VertexInvo Support Widget package is open-source software licensed under the MIT License.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance100

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4aea88f9a6f7203d6349115db6df2b749f7f5038b31e22a6622f4c806700e15b?d=identicon)[salahshakeel](/maintainers/salahshakeel)

---

Top Contributors

[![salahshakeel](https://avatars.githubusercontent.com/u/99357263?v=4)](https://github.com/salahshakeel "salahshakeel (12 commits)")

### Embed Badge

![Health badge](/badges/vertexinvo-support-widget/health.svg)

```
[![Health](https://phpackages.com/badges/vertexinvo-support-widget/health.svg)](https://phpackages.com/packages/vertexinvo-support-widget)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.4M350](/packages/psalm-plugin-laravel)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45844.8k1](/packages/pressbooks-pressbooks)[moonshine/moonshine

Laravel administration panel

1.3k268.2k86](/packages/moonshine-moonshine)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9872.4M139](/packages/roots-acorn)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

78727.1M203](/packages/laravel-mcp)[hasinhayder/tyro-dashboard

Tyro Dashboard - Beautiful admin dashboard for managing Tyro roles, privileges, users, and settings

5495.1k](/packages/hasinhayder-tyro-dashboard)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
