PHPackages                             boostly-hu/laravel - 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. [Utility & Helpers](/categories/utility)
4. /
5. boostly-hu/laravel

ActiveLibrary[Utility & Helpers](/categories/utility)

boostly-hu/laravel
==================

Boostly integráció Laravelhez — kampány-snippet beágyazása és lead-webhookok fogadása aláírás-ellenőrzéssel.

v0.3.0(1mo ago)08MITPHPPHP ^8.1

Since May 28Pushed 1mo agoCompare

[ Source](https://github.com/boostly-hu/laravel)[ Packagist](https://packagist.org/packages/boostly-hu/laravel)[ Docs](https://github.com/boostly-hu/laravel)[ RSS](/packages/boostly-hu-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (4)Versions (6)Used By (0)

Boostly for Laravel
===================

[](#boostly-for-laravel)

Boostly-integráció Laravelhez: kampány-snippet beágyazása egy Blade-direktívával, és lead-webhookok fogadása beépített HMAC-aláírás-ellenőrzéssel.

Telepítés
---------

[](#telepítés)

```
composer require boostly-hu/laravel
```

A csomag auto-discovery-vel regisztrálódik. A config publikálása opcionális:

```
php artisan vendor:publish --tag=boostly-config
```

Konfiguráció
------------

[](#konfiguráció)

`.env`:

```
BOOSTLY_URL=https://boostly.hu
BOOSTLY_SITE_TOKEN=az-oldalad-publikus-tokenje
BOOSTLY_WEBHOOK_SECRET=a-webhook-vegpont-titka
```

- **`BOOSTLY_URL`** — a Boostly alap-URL-je (innen töltődik a `snippet.js`). Alapból `https://boostly.hu`, így általában el is hagyható; csak saját példánynál kell felülírni.
- **`BOOSTLY_SITE_TOKEN`** — az oldalhoz tartozó publikus token (Boostly admin → oldal).
- **`BOOSTLY_WEBHOOK_SECRET`** — a webhook-végpont titka (Boostly admin → webhook). Enélkül minden beérkező webhook **403**-at kap.

1) Snippet beágyazása
---------------------

[](#1-snippet-beágyazása)

A layout `` (vagy a `` elé) Blade-sablonjába:

```
@boostlySnippet
```

Ez ezt rendereli:

```

```

Másik tokent is megadhatsz (pl. multi-site):

```
@boostlySnippet($oldal->boostly_token)
```

Vagy a facade-dal, programból:

```
use Boostly\Laravel\Facades\Boostly;

Boostly::snippetTag();          // \Illuminate\Support\HtmlString
Boostly::snippetUrl('token');   // string
```

2) Lead-webhook fogadása
------------------------

[](#2-lead-webhook-fogadása)

A csomag automatikusan regisztrál egy route-ot:

```
POST /boostly/webhook

```

Ezt add meg a Boostly adminban a webhook-végpont URL-jeként (pl. `https://sajat-oldalad.hu/boostly/webhook`). Az útvonal és a route engedélyezése a configban állítható (`boostly.webhook.path`, `boostly.webhook.enabled`).

A beérkező (és aláírás-ellenőrzött) leadre a `BoostlyLeadReceived` event sül el. Iratkozz fel rá, és innen küldd tovább a leadet (CRM, hírlevél, saját tábla, stb.):

```
use Boostly\Laravel\Events\BoostlyLeadReceived;
use Illuminate\Support\Facades\Event;

Event::listen(function (BoostlyLeadReceived $event) {
    $lead = $event->lead;

    $lead->email;            // string|null
    $lead->name;             // string|null
    $lead->fields;           // array — beküldött mezők
    $lead->coupon;           // string|null
    $lead->consentAccepted;  // bool
    $lead->consentText;      // string|null  (GDPR audit)
    $lead->consentAt;        // string|null  (a beleegyezés ideje, ISO 8601 UTC)
    $lead->ip;               // string|null  (a feliratkozó IP-je)
    $lead->userAgent;        // string|null
    $lead->campaignId;
    $lead->campaignName;     // string|null  (ember által olvasható kampánynév)
    $lead->variantId;
    $lead->siteId;
    $lead->raw;              // a teljes nyers payload
});
```

> A `BoostlyLeadReceived` egy egyszerű event-osztály — kösd hozzá a listenered az `EventServiceProvider`-ben is, ha úgy kényelmesebb.

> A `consentAt`, `ip`, `userAgent` és `campaignName` mezőket a Boostly szerver a payload-bővítő verziótól felfelé tölti; régebbi szerverrel ezek `null`-ok (a csomag visszafelé kompatibilis).

### Aláírás-ellenőrzés

[](#aláírás-ellenőrzés)

Minden beérkező kérés átmegy a `VerifyBoostlySignature` middleware-en, ami az `X-Boostly-Signature: sha256=` fejlécet ellenőrzi a **nyers** kérés-body-n, HMAC-SHA256-tal, a `BOOSTLY_WEBHOOK_SECRET` titkkal (timing-safe `hash_equals`). Hibás vagy hiányzó aláírás → **403**.

Extra middleware-t a configban adhatsz (az aláírás-ellenőrzés mindig fut):

```
// config/boostly.php
'webhook' => [
    'middleware' => ['throttle:60,1'],
],
```

Multi-tenant / több webáruház
-----------------------------

[](#multi-tenant--több-webáruház)

Ha egy kódbázison több webáruház (tenant) fut, és **tenant-onként más a webhook secret** (jellemzően adatbázisban tárolva, nem `.env`-ben), két opciód van.

### A) Saját webhook-endpoint

[](#a-saját-webhook-endpoint)

Kapcsold ki a beépített route-ot, és vidd a webhookot a host-appban (így a csomagból csak a `BoostlyLead` DTO-t + a `BoostlyLeadReceived` eventet használod):

```
BOOSTLY_WEBHOOK_ENABLED=false
```

### B) Beépített route + per-tenant secret-resolver

[](#b-beépített-route--per-tenant-secret-resolver)

Ha a beépített route-ot szeretnéd használni, de a secret futásidőben, tenant-onként dől el, írd felül a `BoostlySecretResolver`-t a host-app egy service providerében. A middleware ezen keresztül oldja fel a titkot a beérkező request alapján; `null` válasz → **403** (nincs integráció ehhez a kéréshez):

```
use Boostly\Laravel\Contracts\BoostlySecretResolver;
use Illuminate\Http\Request;

$this->app->bind(BoostlySecretResolver::class, function () {
    return new class implements BoostlySecretResolver {
        public function resolve(Request $request): ?string
        {
            // pl. a kérés domainjéből feloldott tenant secretje
            $tenant = app(\App\Services\Tenancy\TenantResolver::class)
                ->fromHost($request->getHost());

            return $tenant?->boostly_webhook_secret;
        }
    };
});
```

> Alapból a `ConfigSecretResolver` fut, ami a `BOOSTLY_WEBHOOK_SECRET`-et használja — vagyis az egyszeri `.env`-es beállítás változtatás nélkül működik.

Tesztek
-------

[](#tesztek)

```
composer install
vendor/bin/phpunit
```

Licenc
------

[](#licenc)

MIT

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance89

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

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

Every ~0 days

Total

5

Last Release

57d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4653410?v=4)[Kevin Krizsánszki](/maintainers/hletick)[@hletick](https://github.com/hletick)

---

Tags

laravelwebhookmarketingpopupleadsboostly

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/boostly-hu-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/boostly-hu-laravel/health.svg)](https://phpackages.com/packages/boostly-hu-laravel)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)

PHPackages © 2026

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