PHPackages canerdogan/laravel-mixpanel - 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. canerdogan/laravel-mixpanel ActiveLibrary[Utility & Helpers](/categories/utility) canerdogan/laravel-mixpanel =========================== MixPanel wrapper for Laravel 5.\* 0.7.4(9y ago)0183MITPHPPHP >=7.0.0 Since May 30Pushed 9y ago1 watchersCompare [ Source](https://github.com/canerdogan/laravel-mixpanel)[ Packagist](https://packagist.org/packages/canerdogan/laravel-mixpanel)[ RSS](/packages/canerdogan-laravel-mixpanel/feed)WikiDiscussions master Synced yesterday READMEChangelog (6)Dependencies (8)Versions (70)Used By (0) MixPanel for Laravel 5 ====================== [](#mixpanel-for-laravel-5) Features -------- [](#features) - Asynchronous data transmission to Mixpanel's services. This prevents any delays to your application if Mixpanel is down, or slow to respond. - Drop-in installation and configuration into your Laravel app, tracking the most common events out of the box. - Simple Stripe integration allowing you to track revenues at the user level. - Front-end-ready Mixpanel JS library, both for Laravel Elixir inclusion or Blade template use. Requirements and Compatibility ------------------------------ [](#requirements-and-compatibility) - PHP 7 - Laravel 5.1 (LTS) - Laravel 5.3 - Laravel 5.4 (current) ### Legacy Versions [](#legacy-versions) - [Laravel 5.2](https://github.com/CanErdogan/laravel-mixpanel/tree/afcf3737412c1aebfa9dd1d7687001f78bdb3956) - [Laravel 5.0](https://github.com/CanErdogan/laravel-mixpanel/tree/ce110ebd89658cbf8a91f2cfb5db57e2b449e7f3) Installation ------------ [](#installation) ``` composer require canerdogan/laravel-mixpanel ``` Add the service provider entry in `config\app.php`: ``` CanErdogan\LaravelMixpanel\Providers\LaravelMixpanelService::class, ``` Verify that your auth configuration file `config/auth.php` has the user model specified in `auth.providers.users.model` (or in `auth.model` for L5.1). If that entry is missing, go ahead and add it. ``` // Laravel 5.3 'providers' => [ 'users' => [ 'driver' => '...', 'model' => App\User::class, ], // Laravel 5.1 'model' => App\User::class, ``` Lastly, add your Mixpanel API token to your `.env` file: ``` MIXPANEL_TOKEN=xxxxxxxxxxxxxxxxxxxxxx ``` Configuration ------------- [](#configuration) ### Default Values [](#default-values) - `services.mixpanel.token`: pulls the 'MIXPANEL\_TOKEN' value from your `.env`file. - `services.mixpanel.enable-default-tracking`: (default: true) enable or disable Laravel user event tracking. - `services.mixpanel.consumer`: (default: socket) set the Guzzle adapter you want to use. - `services.mixpanel.connect-timeout`: (default: 2) set the number of seconds after which connections timeout. - `services.mixpanel.timeout`: (default: 2) set the number of seconds after which event tracking times out. Upgrade Notes ------------- [](#upgrade-notes) ### Page Views [](#page-views) - Page view tracking has been removed in favor of Mixpanels in-built Autotrack functionality, which tracks all page views. To turn it on, visit your Mixpanel dashboard, click *Applications > Autotrack > Web > etc.* and enable Autotracking. Usage ----- [](#usage) \###Track ``` event( new MixpanelEvent( 'Dashboard' ) ); ``` OR ``` event( new MixpanelEvent( 'Welcome Modal', Auth::user() ) ); ``` OR With parameters ``` event( new MixpanelEvent( 'Send Invitation', ['Status' => 'Done'] ) ); ``` \###Increment ``` event( new MixpanelEvent( 'increment', ['Login Count', 1] ) ); ``` ### PHP Events [](#php-events) ### Stripe Web-Hook [](#stripe-web-hook) If you wish to take advantage of the Stripe web-hook and track revenue per user, you should install Cashier: - [Laravel 5.4](https://www.laravel.com/docs/5.4/billing) - [Laravel 5.3](https://www.laravel.com/docs/5.3/billing) - [Laravel 5.1](https://www.laravel.com/docs/5.1/billing) Once that has been completed, exempt the web-hook endpoint from CSRF-validation in `/app/Http/Middleware/VerifyCsrfToken.php`: ``` protected $except = [ 'canerdogan/laravel-mixpanel/stripe', ]; ``` The only other step remaining is to register the web-hook with Stripe: Log into your Stripe account: , and open your account settings' webhook tab: Enter your MixPanel web-hook URL, similar to the following: `http:///canerdogan/laravel-mixpanel/stripe`: [![screen shot 2015-05-31 at 1 35 01 pm](https://cloud.githubusercontent.com/assets/1791050/7903765/53ba6fe4-079b-11e5-9f92-a588bd81641d.png)](https://cloud.githubusercontent.com/assets/1791050/7903765/53ba6fe4-079b-11e5-9f92-a588bd81641d.png) Be sure to select "Live" if you are actually running live (otherwise put into test mode and update when you go live). Also, choose "Send me all events" to make sure Laravel Mixpanel can make full use of the Stripe data. ### JavaScript Events & Auto-Track [](#javascript-events--auto-track) #### Laravel Elixir [](#laravel-elixir) Add the following lines to your `/resources/js/app.js` (or equivalent), and don't forget to replace `YOUR_MIXPANEL_TOKEN` with your actual token: ``` require('./../../../public/canerdogan-laravel-mixpanel/js/mixpanel.js'); mixpanel.init("YOUR_MIXPANEL_TOKEN"); ``` #### Blade Template [](#blade-template) First publish the necessary assets: ``` php artisan mixpanel:publish --assets ``` Then add the following to the head section of your layout template: ``` @include ('canerdogan-laravel-mixpanel::partials.mixpanel') ``` Usage ----- [](#usage-1) MixPanel is loaded into the IoC as a singleton. This means you don't have to manually call $mixPanel::getInstance() as described in the MixPanel docs. This is already done for you in the ServiceProvider. Common user events are automatically recorded: - User Registration - User Deletion - User Login - User Login Failed - User Logoff - Cashier Subscribed - Cashier Payment Information Submitted - Cashier Subscription Plan Changed - Cashier Unsubscribed To make custom events, simple get MixPanel from the IoC using DI: ``` use CanErdogan\LaravelMixPanel\LaravelMixPanel; class MyClass { protected $mixPanel; public function __construct(LaravelMixPanel $mixPanel) { $this->mixPanel = $mixPanel; } } ``` If DI is impractical in certain situations, you can also manually retrieve it from the IoC: ``` $mixPanel = app('mixpanel'); ``` After that you can make the usual calls to the MixPanel API: - `$mixPanel->identify($user->id);` - `$mixPanel->track('User just paid!');` - `$mixPanel->people->trackCharge($user->id, '9.99');` - `$mixPanel->people->set($user->id, [$data]);` And so on ... ### Laravel Integration [](#laravel-integration) Out of the box it will record the common events anyone would want to track. Also, if the default `$user->name` field is used that comes with Laravel, it will split up the name and use the last word as the last name, and everything prior for the first name. Otherwise it will look for `first_name` and `last_name` fields in the users table. - User registers: ``` Track: User: - Status: Registered People: - $first_name: - $email: - $last_name: - $created: ``` - User is deleted: ``` Track: User: - Status: Deactivated ``` - User is restored (from soft-deletes): ``` Track: User: - Status: Reactivated ``` - User logs in: ``` Track: Session: - Status: Logged In People: - $first_name: - $email: - $last_name: - $created: ``` - User logs out: ``` Track: Session: - Status: Logged Out ``` ### Stripe Integration (test needed) [](#stripe-integration-test-needed) Many L5 sites are running Cashier to manage their subscriptions. This package creates an API webhook endpoint that keeps vital payment analytics recorded in MixPanel to help identify customer churn. Out of the box it will record the following Stripe events in MixPanel for you: #### Charges [](#charges) - Authorized Charge (when only authorizing a payment for a later charge date): ``` Track: Payment: - Status: Authorized - Amount: ``` - Captured Charge (when completing a previously authorized charge): ``` Track: Payment: - Status: Captured - Amount: People TrackCharge: ``` - Completed Charge: ``` Track: Payment: - Status: Successful - Amount: People TrackCharge: ``` - Refunded Charge: ``` Track: Payment: - Status: Refunded - Amount: People TrackCharge: - ``` - Failed Charge: ``` Track: Payment: - Status: Failed - Amount: ``` ### Subscriptions [](#subscriptions) - Customer subscribed: ``` Track: Subscription: - Status: Created People: - Subscription: ``` - Customer unsubscribed: ``` Track: Subscription: - Status: Canceled - Upgraded: false Churn! :( People: - Subscription: None - Churned: - Plan When Churned: - Paid Lifetime: days ``` - Customer started trial: ``` Track: Subscription: - Status: Trial People: - Subscription: Trial ``` - Customer upgraded plan: ``` Track: Subscription: - Upgraded: true Unchurn! :-) People: - Subscription: ``` - Customer downgraded plan (based on dollar value compared to previous plan): ``` Track: Subscription: - Upgraded: false Churn! :-( People: - Subscription: - Churned: - Plan When Churned: ``` ### Health Score 29 — LowBetter than 57% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community11 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 95.7% 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 Every ~10 days Recently: every ~0 days Total 69 Last Release 3364d ago PHP version history (3 changes)0.1.2PHP >=5.4.0 0.3.3PHP >=5.5.0 0.6.0-RCPHP >=7.0.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/ee030ea353e879f8e20fdfb1ef38d9bb05e7f9dc862acdc44aa20e83182665c2?d=identicon)[canerdogan](/maintainers/canerdogan) --- Top Contributors [![mikebronner](https://avatars.githubusercontent.com/u/1791050?v=4)](https://github.com/mikebronner "mikebronner (179 commits)")[![canerdogan](https://avatars.githubusercontent.com/u/620056?v=4)](https://github.com/canerdogan "canerdogan (6 commits)")[![igorsantos07](https://avatars.githubusercontent.com/u/532299?v=4)](https://github.com/igorsantos07 "igorsantos07 (1 commits)")[![mglinski](https://avatars.githubusercontent.com/u/78872?v=4)](https://github.com/mglinski "mglinski (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/canerdogan-laravel-mixpanel/health.svg) ``` [![Health](https://phpackages.com/badges/canerdogan-laravel-mixpanel/health.svg)](https://phpackages.com/packages/canerdogan-laravel-mixpanel) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3345.1M337](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k14.1M123](/packages/laravel-pulse)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9772.3M122](/packages/roots-acorn)[flarum/core Delightfully simple forum software. 201.4M2.2k](/packages/flarum-core)[laravel-notification-channels/apn Apple APN Push Notification Channel 2022.1M6](/packages/laravel-notification-channels-apn)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)