Use Cases

Features

Requirements

Live Demo

Quick Start

Installation

Step 1. Install a Laravel project if you don't have one already

Step 2. Make sure you have set up authentication in your project

Step 3. Require the current package using composer:

composer require venturedrake/laravel-crm

Step 4. Publish the migrations, config & assets

php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="migrations"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="config"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="assets" --force

Step 5. Update the various config settings in the published config file:

Laravel 7 and below:

<?phpuseIlluminate\Support\Facades\Route;Auth::routes();Route::get('/home',function (){returnredirect('/');});

Laravel 8+:

<?phpuseIlluminate\Support\Facades\Route;Route::middleware(['auth:sanctum','verified'])->get('/dashboard',function () {returnredirect('/');})->name('dashboard');

Step 6. Run migrations:

php artisan migrate

Step 7. Run database seeder:

php artisan db:seed --class="VentureDrake\LaravelCrm\Database\Seeders\LaravelCrmTablesSeeder"

Step 8. Update User Model

useIlluminate\Foundation\Auth\UserasAuthenticatable;useSpatie\Permission\Traits\HasRoles;useVentureDrake\LaravelCrm\Traits\HasCrmAccess;useVentureDrake\LaravelCrm\Traits\HasCrmTeams;useLab404\AuthChecker\Models\HasLoginsAndDevices;useLab404\AuthChecker\Interfaces\HasLoginsAndDevicesInterface;class Userextends Authenticatableimplements HasLoginsAndDevicesInterface{use HasRoles;use HasCrmAccess;use HasCrmTeams;use HasLoginsAndDevices;// ...}

Step 9. Register at least one user and log in or if you already have a user login with the crm owner you set in step 5

Upgrade

Upgrading from >= 0.2

Step 1. Run the following to the update migrations and publish assets:

composer require venturedrake/laravel-crmphp artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="migrations"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="config"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="assets" --forcephp artisan migrate

Step 2. Run the database seeder

php artisan db:seed --class="VentureDrake\LaravelCrm\Database\Seeders\LaravelCrmTablesSeeder"

Step 3. If using teams support then run the following permissions update command

php artisan laravelcrm:permissions

Step 4. Run update command to update database

php artisan laravelcrm:update

Upgrading from < 0.2

Step 1. Run the following to the update package:

composer require venturedrake/laravel-crmphp artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="migrations"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="config"php artisan vendor:publish --provider="VentureDrake\LaravelCrm\LaravelCrmServiceProvider" --tag="assets" --forcephp artisan migrate

Step 2. Delete previously published package views located inresources/views/vendor/laravel-crm/*

Step 3. Add HasCrmAccess, HasCrmTeams & HasRoles traits to App\User model, see installation Step 8.

Testing

composertest

Changelog

Roadmap

Feedback

Contributing

Security

Credits

License