PHP code example of mariojgt / builder

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

mariojgt / builder example snippets

use Mariojgt\Builder\Controllers\TableBuilderApiController;

Route::controller(TableBuilderApiController::class)->group(function () {
    Route::post('/admin/api/generic/table', 'index')->name('admin.api.generic.table');
    Route::post('/admin/api/generic/table/create', 'store')->name('admin.api.generic.table.create');
    Route::post('/admin/api/generic/table/update', 'update')->name('admin.api.generic.table.update');
    Route::post('/admin/api/generic/table/delete', 'delete')->name('admin.api.generic.table.delete');
});

namespace App\Controllers;

use Inertia\Inertia;
use App\Models\Alert;
use App\Http\Controllers\Controller;
use Mariojgt\Builder\Enums\FieldTypes;
use Mariojgt\Builder\Helpers\FormHelper;

class AlertController extends Controller
{
    public function index()
    {
        $form = new FormHelper();
        $formConfig = $form
            ->addIdField()
            ->addField('Title', 'title', type: FieldTypes::TEXT->value)
            ->addField('Status', 'status', type: FieldTypes::TEXT->value)
            ->withConditionalStyling([
                'active' => 'bg-green-500 text-white',
                'inactive' => 'bg-red-500 text-white'
            ])
            ->addField('Created At', 'created_at', type: FieldTypes::TIMESTAMP->value)
            ->setEndpoints(
                listEndpoint: route('admin.api.generic.table'),
                deleteEndpoint: route('admin.api.generic.table.delete'),
                createEndpoint: route('admin.api.generic.table.create'),
                editEndpoint: route('admin.api.generic.table.update')
            )
            ->setModel(Alert::class)
            ->build();

        return Inertia::render('Admin/Generic/Index', [
            'title' => 'Alerts',
            'table_name' => 'alerts',
            ...$formConfig
        ]);
    }
}

// Simple link
->addField('Component Name', 'reportedData.comp_name', type: FieldTypes::TEXT->value)
->withLink('https://nvd.nist.gov/search?q={value}', true) // true = new tab

// Link from another field
->addField('Component Name', 'reportedData.comp_name', type: FieldTypes::TEXT->value)
->withLinkFromField('reportedData.comp_link', true)

// Edit link
->addField('Actions', 'id', type: FieldTypes::TEXT->value)
->withEditLink('/admin/edit')

// Predefined styles
->withButtonLink('https://example.com/{value}')                    // Button outline
->withPrimaryButtonLink('https://example.com/{value}')             // Primary button
->withBadgeLink('https://example.com/{value}')                     // Badge style
->withExternalLink('https://example.com/{value}', 'underline')     // Always underlined

// Custom CSS classes
->withCustomLink('https://example.com/{value}', 'px-4 py-2 bg-red-500 text-white rounded-lg hover:bg-red-600')
->withCustomLinkFromField('reportedData.link', 'btn btn-lg btn-success shadow-lg', true)

// Add classes to predefined styles
->withButtonLink('https://example.com/{value}', false, 'shadow-xl border-2')
->withPrimaryButtonLink('/edit/{id}', false, 'animate-pulse glow-effect')

protected function getFormConfig(): FormHelper
{
    return (new FormHelper())
        ->addIdField()

        // Component as gradient button
        ->addField('Component Name', 'reportedData.comp_name', type: FieldTypes::TEXT->value)
        ->withCustomLinkFromField(
            'reportedData.comp_link',
            'bg-gradient-to-r from-purple-600 to-blue-600 hover:from-purple-700 hover:to-blue-700 text-white font-bold py-2 px-4 rounded-lg shadow-lg transform transition hover:scale-105',
            true
        )

        // Status as animated badge
        ->addField('Status', 'status', type: FieldTypes::TEXT->value)
        ->withBadgeLink('/status/{id}', false, 'animate-pulse shadow-md')
        ->withConditionalStyling([...])

        // CVSS Score as danger button
        ->addField('CVSS Score', 'cvss_score', type: FieldTypes::TEXT->value)
        ->withButtonLink('https://nvd.nist.gov/calculator?score={value}', true, 'btn-error btn-sm gap-2')

        // Custom icon button
        ->addField('Actions', 'id', type: FieldTypes::TEXT->value)
        ->withCustomLink('/admin/edit/{id}', 'inline-flex items-center justify-center w-8 h-8 text-gray-400 bg-white border border-gray-300 rounded-full hover:text-gray-500 hover:bg-gray-100');
}

// Pass any CSS classes as the style parameter
->withLink('https://example.com/{value}', false, 'bg-red-500 hover:bg-red-600 text-white px-4 py-2 rounded')
->withLinkFromField('reportedData.link', true, 'btn btn-ghost btn-sm underline')

->addField('Status', 'status', type: FieldTypes::TEXT->value)
->withConditionalStyling([
    'active' => 'bg-green-500 text-white border-green-600',
    'inactive' => 'bg-red-500 text-white border-red-600',
    'pending' => 'bg-yellow-500 text-black border-yellow-600'
], 'bg-gray-200 text-gray-800') // Default style

->addField('CVSS Score', 'cvss_score', type: FieldTypes::NUMBER->value)
->withAdvancedStyling([
    ['operator' => 'between', 'min' => 9.0, 'max' => 10.0, 'classes' => 'bg-red-600 text-white font-bold animate-pulse'],
    ['operator' => 'between', 'min' => 7.0, 'max' => 8.9, 'classes' => 'bg-red-500 text-white'],
    ['operator' => 'between', 'min' => 4.0, 'max' => 6.9, 'classes' => 'bg-orange-500 text-white'],
    ['operator' => 'less_than', 'value' => 4.0, 'classes' => 'bg-green-500 text-white']
])

// Built-in presets for common patterns
->withStatusStyling()      // Common status values
->withCVSSStyling()        // CVSS scoring (0-10 scale)
->withSeverityStyling()    // Severity levels
->withPercentageStyling()  // Percentage-based colors

return (new FormHelper())
    ->addIdField()
    ->addField('Status', 'status')
    ->addField('Priority', 'priority')

    // Style entire rows based on conditions
    ->withAdvancedRowStyling([
        [
            'field' => 'status',
            'operator' => 'equals',
            'value' => 'critical',
            'classes' => 'bg-red-50 border-red-300 border-l-4'
        ],
        [
            'field' => 'priority',
            'operator' => 'equals',
            'value' => 'high',
            'classes' => 'bg-orange-50 border-orange-200'
        ]
    ], 'bg-white hover:bg-gray-50') // Default row styling
    ->build();

// Security vulnerability table
->withAdvancedRowStyling([
    // Critical vulnerabilities
    [
        'field' => 'cvss_score',
        'operator' => 'greater_than_equal',
        'value' => 9.0,
        'classes' => 'bg-red-100 border-red-400 border-l-4 shadow-sm'
    ],
    // Duplicate entries
    [
        'field' => 'status',
        'operator' => 'equals',
        'value' => 'duplicate',
        'classes' => 'bg-gray-100 border-gray-300 opacity-60'
    ],
    // Completed items
    [
        'field' => 'status',
        'operator' => 'equals',
        'value' => 'finished',
        'classes' => 'bg-green-50 border-green-200'
    ]
], 'bg-white hover:bg-gray-50')

// Enable filtering on fields
->addField('Name', 'name', type: FieldTypes::TEXT->value, filterable: true)
->addField('Status', 'status', type: FieldTypes::SELECT->value, filterable: true,
    options: [
        'select_options' => [
            ['value' => 'active', 'label' => 'Active'],
            ['value' => 'inactive', 'label' => 'Inactive']
        ]
    ]
)
->addField('Created At', 'created_at', type: FieldTypes::TIMESTAMP->value, filterable: true)
->addField('Is Active', 'is_active', type: FieldTypes::BOOLEAN->value, filterable: true)

// Automatically loads 'reportedData' relationship
->addField('Component Name', 'reportedData.comp_name', type: FieldTypes::TEXT->value)

// Nested relationships
->addField('User Profile', 'user.profile.name', type: FieldTypes::TEXT->value)

// Try first field, fall back to second if empty
->addField('Version', 'reportedTempData.affected_in|reportedData.vuln_version', type: FieldTypes::TEXT->value)

// Multiple fallbacks
->addField('Contact', 'user.email|user.profile.email|contact.email', type: FieldTypes::TEXT->value)

namespace App\Controllers;

use Inertia\Inertia;
use App\Models\Vulnerability;
use App\Http\Controllers\Controller;
use Mariojgt\Builder\Enums\FieldTypes;
use Mariojgt\Builder\Helpers\FormHelper;

class VulnerabilityController extends Controller
{
    public function index()
    {
        $form = new FormHelper();
        $formConfig = $form
            ->addIdField()
            ->tab('Vulnerability Details')

            // Component with custom button link
            ->addField('Component Name', 'reportedData.comp_name', type: FieldTypes::TEXT->value)
            ->withPrimaryButtonLinkFromField('reportedData.comp_link', true, 'shadow-lg')

            // Status with conditional styling and badge link
            ->addField('Status', 'status', type: FieldTypes::TEXT->value, filterable: true)
            ->withConditionalStyling([
                'duplicate' => 'bg-red-500 text-white border-red-600',
                'finished' => 'bg-green-500 text-white border-green-600',
                'pending' => 'bg-yellow-500 text-black border-yellow-600'
            ])
            ->withBadgeLink('/status/{id}')

            // CVSS Score with advanced styling and external link
            ->addField('CVSS Score', 'cvss_score', type: FieldTypes::NUMBER->value)
            ->withCVSSStyling()
            ->withButtonLink('https://nvd.nist.gov/calculator?score={value}', true, 'btn-sm btn-outline-primary')

            // Vulnerability type with custom styling
            ->addField('Type', 'vuln_type', type: FieldTypes::TEXT->value)
            ->withAdvancedStyling([
                ['operator' => 'contains', 'value' => 'sql injection', 'classes' => 'bg-red-600 text-white font-bold'],
                ['operator' => 'contains', 'value' => 'xss', 'classes' => 'bg-red-500 text-white'],
                ['operator' => 'contains', 'value' => 'csrf', 'classes' => 'bg-orange-500 text-white']
            ])

            // Created date with filtering
            ->addField('Created At', 'created_at', type: FieldTypes::TIMESTAMP->value, filterable: true)

            // Row-level styling for critical items
            ->withAdvancedRowStyling([
                [
                    'field' => 'cvss_score',
                    'operator' => 'greater_than_equal',
                    'value' => 9.0,
                    'classes' => 'bg-red-50 border-red-300 border-l-4 shadow-md'
                ],
                [
                    'field' => 'status',
                    'operator' => 'equals',
                    'value' => 'duplicate',
                    'classes' => 'bg-gray-100 border-gray-300 opacity-60'
                ]
            ], 'bg-white hover:bg-gray-50')

            ->setEndpoints(
                listEndpoint: route('admin.api.generic.table'),
                deleteEndpoint: route('admin.api.generic.table.delete'),
                createEndpoint: route('admin.api.generic.table.create'),
                editEndpoint: route('admin.api.generic.table.update')
            )
            ->setModel(Vulnerability::class)
            ->build();

        return Inertia::render('Admin/Vulnerabilities/Index', [
            'title' => 'Vulnerabilities',
            'table_name' => 'vulnerabilities',
            ...$formConfig
        ]);
    }
}

bash
composer install::builder