Inspired by the harrystech/prelaunchr Ruby on Rails app and a blog post by Tim Ferriss, Prelaunchr-Laravel provides similar functionality for those working with a PHP/Laravel technology stack.
The app provides an email signup, referral links, private referral status page, and prize levels for various numbers of referrals. The app was written for the launch of midwestfit.com to gather referrals and offer free membership extensions to users. By default, the HTML/CSS for MidwestFit is included in this repository. A demo version of the app can be found here with emails disabled.
Prelaunchr-Laravel has a main mechanic from which everything else is derived: Every User is given a unique referral_code which is how the application knows who referred a signing up user. Based on the amount of referrals a User has brought to the site, they are put into a different "prize group". The groups, amounts, and prizes are completely up to you to set.
Users additionally have a referral_secret. This allows for a permanent, private referral status page for each user to see prizes earned. Otherwise, users automatically see this private page as long as their session remains alive in the browser which originated the email signup. As a testing feature you may leave the status page and return to the homepage by visiting /homepage
Rewards are given based on confirmed emails. An email is confirmed by clicking on a link sent to each new email address entered on the main site page.
Multiple signups from the same IP address may be blocked. This number is configurable via the IP_LIMIT .env.php property.
composer install- Copy .env.example to .env and set your database connection properties.
php artisan migratephp artisan db:seednpm installgulp watchphp artisan serve
A simple Laravel Administrator administrator panel is available at /admin. You may customize this by following their documentation.
An admin user is provided in this project's seed file.
There is currently no automated teardown method to collect referrals. This may be done easily by connecting your live launched app to the prelaunch-laravel database and creating a new model with a few Eloquent relationships:
<?php namespace App;
use Illuminate\Database\Eloquent\Model;
class PrelaunchUser extends Model {
protected $connection = 'prelaunch';
protected $table = 'users';
public function referrer()
{
return $this->belongsTo('App\PrelaunchUser', 'referrer_id');
}
public function referrals()
{
return $this->hasMany('App\PrelaunchUser', 'referrer_id');
}
public function confirmedReferrals()
{
return $this->hasMany('App\PrelaunchUser', 'referrer_id')->whereValidEmail(true);
}
}Count referrals with:
PrelaunchUser::referrals()->count();The code, documentation, non-branded copy and configuration are released under the MIT license. Any branded assets are included only to illustrate and inspire.
Please change the artwork to use your own brand! MidwestFit does not give you permission to use its logos, brand, or trademarks in your own marketing. Stock images are protected by copyright and may not be used in any manner.