Project Essentials Demo

use Codenzia\ProjectEssentials\Traits\IconColoredEnum;

enum StatusEnum: string
{
    use IconColoredEnum;

    case ACTIVE = 'active';

    public static function getLabels(): array
    {
        return [self::ACTIVE->value => 'Active'];
    }

    public static function getIcons(): array
    {
        return [self::ACTIVE->value => 'heroicon-o-check-circle'];
    }

    public static function getColors(): array
    {
        return [self::ACTIVE->value => 'success'];
    }
}

use Codenzia\ProjectEssentials\Traits\Userstamps;

class Invoice extends Model
{
    use Userstamps;
}

// $invoice->createdByUser
// $invoice->updatedByUser

use Codenzia\ProjectEssentials\Traits\HasPageSettings;

class ListInvoices extends ListRecords
{
    use HasPageSettings;

    protected function getHeaderActions(): array
    {
        return [$this->settings([
            Toggle::make('show_archived'),
            Select::make('default_view')
                ->options(['table' => 'Table', 'grid' => 'Grid']),
        ])];
    }

    // $this->getPageSetting('show_archived', false)
}

use Codenzia\ProjectEssentials\Traits\HasDashboardDateFilter;

class RevenueChart extends ChartWidget
{
    use HasDashboardDateFilter;

    protected function getData(): array
    {
        $startDate = $this->getFilterStartDate();
    }
}

use Codenzia\ProjectEssentials\Traits\HasHeaderFormActions;

class EditUser extends EditRecord
{
    use HasHeaderFormActions;
    // Save/Cancel appear in header too
}

use Codenzia\ProjectEssentials\Traits\CanLogsActivity;

class Invoice extends Model
{
    use CanLogsActivity;

    public function getActivityLogFieldMappings(): array
    {
        return ['client_user_id' => 'client'];
    }
}

use Codenzia\ProjectEssentials\Traits\CanFixFilamentActionCancel;

class ViewUser extends ViewRecord
{
    use CanFixFilamentActionCancel;
}

use Codenzia\ProjectEssentials\Traits\CanToggleColumns;

class ListUsers extends ListRecords
{
    use CanToggleColumns;

    public function table(Table $table): Table
    {
        return $table->columns(
            $this->makeColumnsForToggle($columns)
        );
    }
}

use Codenzia\ProjectEssentials\Helpers\DateHelper;

DateHelper::readableDateFormat();          // "dd/mm/yyyy"
DateHelper::readableDateTimeFormat();      // "dd/mm/yyyy hh:mm"
DateHelper::getHumanReadableDuration($start, $end); // "30 days (15 left)"
DateHelper::getDelayPeriods();             // [1 => '1 month', ...]

use Codenzia\ProjectEssentials\Helpers\DateRangeHelper;

DateRangeHelper::make('2024-01-01', '2024-12-31');
// "01/01/2024 - 31/12/2024"

DateRangeHelper::makeShort('2024-01-01', '2024-03-15');
// "1 Jan - 15 Mar '24"

DateRangeHelper::parse('01/01/2024 - 31/12/2024');
// ['start_date' => ..., 'end_date' => ...]

use Codenzia\ProjectEssentials\Helpers\FileHelper;

FileHelper::getFileType('photo.jpg');   // "image"
FileHelper::getFileType('report.pdf');  // "document"
FileHelper::getFileType('song.mp3');    // "audio"
FileHelper::getFileType('movie.mp4');   // "video"

use Codenzia\ProjectEssentials\Helpers\FormatHelper;

FormatHelper::truncateText('Long text...', 10);    // "Long text ..."
FormatHelper::hexToRgba('#FF5733', 0.8);           // "rgba(255, 87, 51, 0.8)"
FormatHelper::getFormattedIdString(42, 'INV');      // "#INV0042"

use Codenzia\ProjectEssentials\Helpers\TailwindHelper;

TailwindHelper::text('primary');         // "text-primary-500"
TailwindHelper::text('danger', '600');   // "text-danger-600"
TailwindHelper::bg('success', '100');    // "bg-success-100"
TailwindHelper::border('warning');       // "border-warning-500"

use Codenzia\ProjectEssentials\Tables\FilamentTableHelper;

// Append stamp columns to a table
FilamentTableHelper::appendStampColumns($table);

// Merge with column array
$columns = FilamentTableHelper::withStampColumns([
    TextColumn::make('name'),
    TextColumn::make('email'),
]);

// Add search filter
$filters = FilamentTableHelper::withSearchFilter([], 'name', 'Search');