danthedj/laravel-mixpanel

MixPanel wrapper for Laravel 5.

Wednesday, April 11, 2018
by danthedj
Repository
1 Watchers
0 Stars
19 Installations

PHP
0 Dependents
0 Suggesters
22 Forks
0 Open issues
79 Versions
27 % Grown

The README.md

MixPanel for Laravel 5

, _(*1)

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

PHP >= 7.1.3
Laravel >= 5.5

Legacy Versions

Installation

composer require genealabs/laravel-mixpanel

Only if you are running Laravel 5.4 or below: Add the service provider entry in config\app.php:, _(*2)

GeneaLabs\LaravelMixpanel\Providers\Service::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., _(*3)

// Laravel 5.3
'providers' => [
    'users' => [
        'driver' => '...',
        'model' => App\User::class,
    ],

// Laravel 5.1
'model' => App\User::class,

Lastly, add your Mixpanel token to your .env file:, _(*4)

MIXPANEL_TOKEN=xxxxxxxxxxxxxxxxxxxxxx

Configuration

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

Version 0.7.0 for Laravel 5.5

Remove the service provider from /config/app.php. The service provider is now auto-discovered in Laravel 5.5.

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

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., _(*5)

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, _(*6)

To make custom events, simple get MixPanel from the IoC using DI:, _(*7)

use GeneaLabs\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:, _(*8)

$mixPanel = app('mixpanel'); // using app helper
$mixPanel = Mixpanel::getFacadeRoot(); // using facade

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]);, _(*9)

And so on ..., _(*10)

### Stripe Web-Hook If you wish to take advantage of the Stripe web-hook and track revenue per user, you should install Cashier: https://www.laravel.com/docs/5.5/billing, _(*11)

Once that has been completed, exempt the web-hook endpoint from CSRF-validation in /app/Http/Middleware/VerifyCsrfToken.php: php protected $except = [ 'genealabs/laravel-mixpanel/stripe', ];, _(*12)

The only other step remaining is to register the web-hook with Stripe: Log into your Stripe account: https://dashboard.stripe.com/dashboard, and open your account settings' webhook tab:, _(*13)

Enter your MixPanel web-hook URL, similar to the following: `http://<your server.com>/genealabs/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)

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 #### Blade Template (Recommended) First publish the necessary assets: sh php artisan mixpanel:publish --assets, _(*14)

Then add the following to the head section of your layout template (already does the init call for you, using the token from your .env file): blade @include('genealabs-laravel-mixpanel::partials.mixpanel'), _(*15)

#### 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: js require('./../../../public/genealabs-laravel-mixpanel/js/mixpanel.js'); mixpanel.init("YOUR_MIXPANEL_TOKEN");, _(*16)

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., _(*17)

User registers:, _(*18)

Track:
User:
  - Status: Registered
People:
- $first_name: <user's first name>
- $last_name: <user's last name>
- $email: <user's email address>
- $created: <date user registered>

User is updated:, _(*19)

People:
- $first_name: <user's first name>
- $last_name: <user's last name>
- $email: <user's email address>
- $created: <date user registered>

User is deleted:, _(*20)
```
Track:
User:
  - Status: Deactivated
```
User is restored (from soft-deletes):, _(*21)
```
Track:
User:
  - Status: Reactivated
```

User logs in:, _(*22)

Track:
Session:
  - Status: Logged In
People:
- $first_name: <user's first name>
- $last_name: <user's last name>
- $email: <user's email address>
- $created: <date user registered>

User login fails:, _(*23)

Track:
Session:
  - Status: Login Failed
People:
- $first_name: <user's first name>
- $last_name: <user's last name>
- $email: <user's email address>
- $created: <date user registered>

User logs out:, _(*24)
```
Track:
Session:
  - Status: Logged Out
```

Stripe Integration

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., _(*25)

Out of the box it will record the following Stripe events in MixPanel for you:, _(*26)

Charges

Authorized Charge (when only authorizing a payment for a later charge date):, _(*27)
```
Track:
Payment:
  - Status: Authorized
  - Amount: <amount authorized>
```

Captured Charge (when completing a previously authorized charge):, _(*28)

Track:
Payment:
  - Status: Captured
  - Amount: <amount of payment>
People TrackCharge: <amount of intended payment>

Completed Charge:, _(*29)

Track:
Payment:
  - Status: Successful
  - Amount: <amount of payment>
People TrackCharge: <amount of payment>

Refunded Charge:, _(*30)

Track:
Payment:
  - Status: Refunded
  - Amount: <amount of refund>
People TrackCharge: -<amount of refund>

Failed Charge:, _(*31)

Track:
Payment:
  - Status: Failed
  - Amount: <amount of intended payment>

Subscriptions

Customer subscribed:, _(*32)

Track:
Subscription:
  - Status: Created
People:
- Subscription: <plan name>

Customer unsubscribed:, _(*33)

Track:
Subscription:
  - Status: Canceled
  - Upgraded: false
Churn! :(
People:
- Subscription: None
- Churned: <date canceled>
- Plan When Churned: <subscribed plan when canceled>
- Paid Lifetime: <number of days from subscription to cancelation> days

Customer started trial:, _(*34)

Track:
Subscription:
  - Status: Trial
People:
- Subscription: Trial

Customer upgraded plan:, _(*35)

Track:
Subscription:
  - Upgraded: true
Unchurn! :-)
People:
- Subscription: <new plan name>

Customer downgraded plan (based on dollar value compared to previous plan):, _(*36)

Track:
Subscription:
  - Upgraded: false
Churn! :-(
People:
- Subscription: <new plan name>
- Churned: <date plan was downgraded>
- Plan When Churned: <plan name prior to downgrading>

The Fine Print

Commitment to Quality

During package development I try as best as possible to embrace good design and development practices to try to ensure that this package is as good as it can be. My checklist for package development includes:, _(*37)

✅ Achieve as close to 100% code coverage as possible using unit tests.
✅ Eliminate any issues identified by SensioLabs Insight and Scrutinizer.
✅ Be fully PSR1, PSR2, and PSR4 compliant.
✅ Include comprehensive documentation in README.md.
✅ Provide an up-to-date CHANGELOG.md which adheres to the format outlined at http://keepachangelog.com.
✅ Have no PHPMD or PHPCS warnings throughout all code.

Contributing

Please observe and respect all aspects of the included Code of Conduct https://github.com/GeneaLabs/laravel-model-caching/blob/master/CODE_OF_CONDUCT.md., _(*38)

Reporting Issues

When reporting issues, please fill out the included template as completely as possible. Incomplete issues may be ignored or closed if there is not enough information included to be actionable., _(*39)

Submitting Pull Requests

Please review the Contribution Guidelines https://github.com/GeneaLabs/laravel-model-caching/blob/master/CONTRIBUTING.md. Only PRs that meet all criterium will be accepted., _(*40)

❤️ Open-Source Software - Give ⭐️

We have included the awesome symfony/thanks composer package as a dev dependency. Let your OS package maintainers know you appreciate them by starring the packages you use. Simply run composer thanks after installing this package. (And not to worry, since it's a dev-dependency it won't be installed in your live environment.), _(*41)

The Versions

11/04 2018

dev-master

9999999-dev

MixPanel wrapper for Laravel 5.

library laravel-mixpanel

MixPanel wrapper for Laravel 5.

danthedj/laravel-mixpanel

The README.md

MixPanel for Laravel 5

Features

Requirements and Compatibility

Legacy Versions

Installation

Configuration

Default Values

Upgrade Notes

Version 0.7.0 for Laravel 5.5

Page Views

Usage

Laravel Integration

Stripe Integration

Charges

Subscriptions

The Fine Print

Commitment to Quality

Contributing

Reporting Issues

Submitting Pull Requests

❤️ Open-Source Software - Give ⭐️

The Versions

dev-master

The Requires

The Development Requires

by Dan Coleman

0.7.6

The Requires

The Development Requires

by Dan Coleman

0.7.5

The Requires

The Development Requires

by Mike Bronner

dev-laravel-5.6

The Requires

The Development Requires

by Mike Bronner

0.7.4

The Requires

The Development Requires

by Mike Bronner

dev-laravel-5.5

The Requires

The Development Requires

by Mike Bronner

0.7.3

The Requires

The Development Requires

by Mike Bronner

0.7.2

The Requires

The Development Requires

by Mike Bronner

0.7.0

The Requires

The Development Requires

by Mike Bronner

0.6.11

The Requires

The Development Requires

by Mike Bronner

0.6.10

The Requires

The Development Requires

by Mike Bronner

0.6.9

The Requires

The Development Requires

by Mike Bronner

0.6.8

The Requires

The Development Requires

by Mike Bronner

0.6.7

The Requires