8.4. Vícenásobný výběr a vlastní hodnota

<?php

declare(strict_types=1);

namespace App\Components\Docs\Columns\EnumFilterOptionsGridControl;

use App\Enum\OrderPayment;
use App\Enum\OrderStatus;
use Xart\Grid\Button\ButtonManager;
use Xart\Grid\Column\ColumnManager;
use Xart\Grid\Control\GridControl;
use Xart\Grid\DataOutput\Row;
use Xart\Grid\DataSource\DataSource;
use Xart\Grid\DataSource\SQL\SQLDataSource;

/**
 * Dokumentace, kapitola 8.4 – Vícenásobný výběr a vlastní hodnota.
 *
 * Tři nabídky filtru nad týmiž daty: vícenásobná (výchozí), jediná hodnota a nabídka, do které smí
 * uživatel dopsat i něco, co v enumu není.
 */
class EnumFilterOptionsGridControl extends GridControl
{
    public function createDataSource(): DataSource
    {
        return new SQLDataSource(__DIR__ . '/EnumFilterOptionsGridControl.sql');
    }


    public function columns(ColumnManager $cm): void
    {
        $cm->add('number', 'Číslo');

        // Výchozí chování: ve filtru jde zatrhnout víc stavů naráz (skládají se přes OR).
        $cm->addEnum('status', 'Stav', OrderStatus::class);

        // Jediná hodnota – nabídka se chová jako přepínač.
        $cm->addEnum('payment', 'Platba (jedna)', OrderPayment::class, multi: false);

        // Objednávky bez platby mají v tomhle sloupci „unknown“, což enum nezná. S custom: true si
        // takovou hodnotu uživatel do filtru dopíše sám.
        $cm->addEnum('payment_any', 'Platba (i vlastní)', OrderPayment::class, custom: true);

        $cm->addNumber('total_price', 'Celkem', 2, 'Kč');
    }


    public function buttons(ButtonManager $bm): void
    {
    }


    public function rows(Row $row): void
    {
    }


    public function render(): void
    {
        $this->template->render(__DIR__ . '/EnumFilterOptionsGridControl.latte');
    }
}

SELECT
    o.id,
    o.number,
    o.status,
    o.payment,
    IFNULL(o.payment, 'unknown') AS payment_any,
    o.total_price / 100 AS total_price
FROM `order` o