✨ Introducing Deeplancer - The Best Freelancing Platform

Getting Started

Admin Panel

For Developers

Extending Features

Learn how to extend and add new features to Deeplancer

Extending Features

This guide shows you how to add new features and extend existing functionality in Deeplancer.

Adding New Admin Features

Create Admin Component

Component Class:

// app/Livewire/Admin/CustomFeature/CustomFeatureComponent.php
namespace App\Livewire\Admin\CustomFeature;
 
use Livewire\Component;
use Livewire\Attributes\Layout;
use Artesaos\SEOTools\Facades\SEOMeta;
 
#[Layout('components.layouts.admin')]
class CustomFeatureComponent extends Component
{
    public function mount(): void
    {
        if (!auth()->user()->can('custom_feature.view')) {
            abort(403);
        }
    }
 
    public function render()
    {
        SEOMeta::setTitle(seo_title(__('admin.custom_feature_title')));
        return view('livewire.admin.custom-feature.custom-feature');
    }
}

Blade View:

{{-- resources/views/livewire/admin/custom-feature/custom-feature.blade.php --}}
<div>
    <x-deep.heading>
        {{ __('admin.custom_feature_title') }}
    </x-deep.heading>
    
    {{-- Your content --}}
</div>

Add Route:

// routes/admin.php
Route::get('custom-feature', CustomFeatureComponent::class)
    ->name('admin.custom-feature.index');

Add Permission:

// database/seeders/PermissionSeeder.php
Permission::create(['name' => 'custom_feature.view']);

Adding New Models

Create Model

// app/Models/CustomModel.php
namespace App\Models;
 
use Illuminate\Database\Eloquent\Model;
 
class CustomModel extends Model
{
    protected $fillable = [
        'name',
        'description',
    ];
}

Create Migration

// database/migrations/xxxx_create_custom_models_table.php
Schema::create('custom_models', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->text('description')->nullable();
    $table->timestamps();
});

Adding API Endpoints

Create API Controller

// app/Http/Controllers/Api/CustomController.php
namespace App\Http\Controllers\Api;
 
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
 
class CustomController extends Controller
{
    public function index()
    {
        // Your logic
    }
}

Add API Route

// routes/api.php
Route::get('/custom', [CustomController::class, 'index']);

Creating Services

Service Class

// app/Services/CustomService.php
namespace App\Services;
 
class CustomService
{
    public function processData($data)
    {
        // Your business logic
    }
}

Using Services

// In components
use App\Services\CustomService;
 
$service = new CustomService();
$result = $service->processData($data);

Adding Middleware

Create Middleware

// app/Http/Middleware/CustomMiddleware.php
namespace App\Http\Middleware;
 
use Closure;
use Illuminate\Http\Request;
 
class CustomMiddleware
{
    public function handle(Request $request, Closure $next)
    {
        // Your logic
        return $next($request);
    }
}

Register Middleware

// bootstrap/app.php
$middleware->alias([
    'custom' => \App\Http\Middleware\CustomMiddleware::class,
]);

Extending Existing Components

Override Methods

// Extend existing component
class ExtendedGigsComponent extends GigsComponent
{
    public function customMethod()
    {
        // Your custom logic
    }
}

Add Properties

// In component class
public $customProperty = '';
 
public function updatedCustomProperty()
{
    // Handle property update
}

Database Relationships

Add Relationships

// In model
public function customRelation()
{
    return $this->hasMany(CustomModel::class);
}

Eager Loading

// In component
$items = Model::with('customRelation')->get();

Event System

Create Events

// app/Events/CustomEvent.php
namespace App\Events;
 
use Illuminate\Foundation\Events\Dispatchable;
 
class CustomEvent
{
    use Dispatchable;
 
    public function __construct(public $data)
    {
    }
}

Listen to Events

// In component or service
event(new CustomEvent($data));

Notifications

Create Notification

// app/Notifications/CustomNotification.php
namespace App\Notifications;
 
use Illuminate\Notifications\Notification;
 
class CustomNotification extends Notification
{
    public function via($notifiable)
    {
        return ['mail', 'database'];
    }
 
    public function toMail($notifiable)
    {
        // Email content
    }
}

Send Notification

$user->notify(new CustomNotification());

File Handling

Add Media Collection

// In model
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;
 
public function registerMediaCollections(): void
{
    $this->addMediaCollection('custom')
        ->singleFile();
}

Upload Files

// In component
if ($file instanceof TemporaryUploadedFile) {
    $model->addMedia($file->getRealPath())
        ->toMediaCollection('custom');
}

Testing Your Extensions

Test Checklist:

Component renders correctly
Permissions work
Data saves properly
Validation works
Errors handled
UI is responsive
Translations work

Common Patterns

CRUD Operations:

List component
Create component
Edit component
Delete method

Form Handling:

Validation rules
Save method
Success/error messages
Redirect after save

Search & Filter:

Search property
Filter properties
Query building
Clear filters method

Customization Guide Deep UI Components

Extending Features

Learn how to extend and add new features to Deeplancer

Extending Features

This guide shows you how to add new features and extend existing functionality in Deeplancer.

Adding New Admin Features

Create Admin Component

Component Class:

// app/Livewire/Admin/CustomFeature/CustomFeatureComponent.php
namespace App\Livewire\Admin\CustomFeature;
 
use Livewire\Component;
use Livewire\Attributes\Layout;
use Artesaos\SEOTools\Facades\SEOMeta;
 
#[Layout('components.layouts.admin')]
class CustomFeatureComponent extends Component
{
    public function mount(): void
    {
        if (!auth()->user()->can('custom_feature.view')) {
            abort(403);
        }
    }
 
    public function render()
    {
        SEOMeta::setTitle(seo_title(__('admin.custom_feature_title')));
        return view('livewire.admin.custom-feature.custom-feature');
    }
}

Blade View:

{{-- resources/views/livewire/admin/custom-feature/custom-feature.blade.php --}}
<div>
    <x-deep.heading>
        {{ __('admin.custom_feature_title') }}
    </x-deep.heading>
    
    {{-- Your content --}}
</div>

Add Route:

// routes/admin.php
Route::get('custom-feature', CustomFeatureComponent::class)
    ->name('admin.custom-feature.index');

Add Permission:

// database/seeders/PermissionSeeder.php
Permission::create(['name' => 'custom_feature.view']);

Adding New Models

Create Model

// app/Models/CustomModel.php
namespace App\Models;
 
use Illuminate\Database\Eloquent\Model;
 
class CustomModel extends Model
{
    protected $fillable = [
        'name',
        'description',
    ];
}

Create Migration

// database/migrations/xxxx_create_custom_models_table.php
Schema::create('custom_models', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->text('description')->nullable();
    $table->timestamps();
});

Adding API Endpoints

Create API Controller

// app/Http/Controllers/Api/CustomController.php
namespace App\Http\Controllers\Api;
 
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
 
class CustomController extends Controller
{
    public function index()
    {
        // Your logic
    }
}

Add API Route

// routes/api.php
Route::get('/custom', [CustomController::class, 'index']);

Creating Services

Service Class

// app/Services/CustomService.php
namespace App\Services;
 
class CustomService
{
    public function processData($data)
    {
        // Your business logic
    }
}

Using Services

// In components
use App\Services\CustomService;
 
$service = new CustomService();
$result = $service->processData($data);

Adding Middleware

Create Middleware

// app/Http/Middleware/CustomMiddleware.php
namespace App\Http\Middleware;
 
use Closure;
use Illuminate\Http\Request;
 
class CustomMiddleware
{
    public function handle(Request $request, Closure $next)
    {
        // Your logic
        return $next($request);
    }
}

Register Middleware

// bootstrap/app.php
$middleware->alias([
    'custom' => \App\Http\Middleware\CustomMiddleware::class,
]);

Extending Existing Components

Override Methods

// Extend existing component
class ExtendedGigsComponent extends GigsComponent
{
    public function customMethod()
    {
        // Your custom logic
    }
}

Add Properties

// In component class
public $customProperty = '';
 
public function updatedCustomProperty()
{
    // Handle property update
}

Database Relationships

Add Relationships

// In model
public function customRelation()
{
    return $this->hasMany(CustomModel::class);
}

Eager Loading

// In component
$items = Model::with('customRelation')->get();

Event System

Create Events

// app/Events/CustomEvent.php
namespace App\Events;
 
use Illuminate\Foundation\Events\Dispatchable;
 
class CustomEvent
{
    use Dispatchable;
 
    public function __construct(public $data)
    {
    }
}

Listen to Events

// In component or service
event(new CustomEvent($data));

Notifications

Create Notification

// app/Notifications/CustomNotification.php
namespace App\Notifications;
 
use Illuminate\Notifications\Notification;
 
class CustomNotification extends Notification
{
    public function via($notifiable)
    {
        return ['mail', 'database'];
    }
 
    public function toMail($notifiable)
    {
        // Email content
    }
}

Send Notification

$user->notify(new CustomNotification());

File Handling

Add Media Collection

// In model
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;
 
public function registerMediaCollections(): void
{
    $this->addMediaCollection('custom')
        ->singleFile();
}

Upload Files

// In component
if ($file instanceof TemporaryUploadedFile) {
    $model->addMedia($file->getRealPath())
        ->toMediaCollection('custom');
}

Testing Your Extensions

Test Checklist:

Component renders correctly
Permissions work
Data saves properly
Validation works
Errors handled
UI is responsive
Translations work

Common Patterns

CRUD Operations:

List component
Create component
Edit component
Delete method

Form Handling:

Validation rules
Save method
Success/error messages
Redirect after save

Search & Filter:

Search property
Filter properties
Query building
Clear filters method

Customization Guide Deep UI Components