6. Sloupce a presety

<?php

declare(strict_types=1);

namespace App\Components\Docs\Columns\ColumnTypesGridControl;

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 6 – Sloupce a presety.
 *
 * Seznam zákazníků, ve kterém je od každého presetu jeden sloupec. Dvojice sloupců nad touž
 * hodnotou (spent/spent_raw a is_active/is_active_text) ukazují, co preset dělá navíc proti add().
 */
class ColumnTypesGridControl extends GridControl
{
    public function createDataSource(): DataSource
    {
        return new SQLDataSource(__DIR__ . '/ColumnTypesGridControl.sql');
    }


    public function columns(ColumnManager $cm): void
    {
        // Bez presetu: hodnota jde do buňky tak, jak přišla z databáze, filtr je textový.
        $cm->add('name', 'Zákazník');

        $cm->addEmail('email', 'E-mail');
        $cm->addPhone('phone', 'Telefon');

        // Číslo bez desetinných míst a bez jednotky.
        $cm->addNumber('orders_count', 'Objednávek', 0);

        // Dvě desetinná místa a jednotka za číslem.
        $cm->addNumber('spent', 'Utraceno', 2, 'Kč');

        // Tatáž hodnota obyčejným add() – pro srovnání, co všechno preset udělá navíc.
        $cm->add('spent_raw', 'Utraceno přes add()');

        // Ano/ne jako ikona, a hned vedle totéž jako text.
        $cm->addCheck('is_active', 'Aktivní');
        $cm->addBoolean('is_active_text', 'Aktivní textem');

        $cm->addDate('registered_on', 'Registrace');
        // Sloupec typu TIME přijde z databáze jako DateInterval a preset pro něj formatter nemá –
        // proto je čas složený už v dotazu (DATE_FORMAT), tedy jako řetězec „HH:MM“.
        $cm->addTime('registered_at', 'Čas registrace');

        // Odstup od teď („před 3 dny“); přesný okamžik je v titulku buňky.
        $cm->addDatetime('last_order_at', 'Poslední objednávka', true);
    }


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


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


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

SELECT
    c.id,
    CONCAT(c.first_name, ' ', c.last_name) AS name,
    c.email,
    c.phone,
    (SELECT COUNT(*) FROM `order` o WHERE o.id_customer = c.id) AS orders_count,
    (SELECT COALESCE(SUM(o.total_price), 0) FROM `order` o WHERE o.id_customer = c.id) / 100 AS spent,
    (SELECT COALESCE(SUM(o.total_price), 0) FROM `order` o WHERE o.id_customer = c.id) / 100 AS spent_raw,
    c.is_active,
    c.is_active AS is_active_text,
    DATE(c.created_at) AS registered_on,
    DATE_FORMAT(c.created_at, '%H:%i') AS registered_at,
    (SELECT MAX(o.created_at) FROM `order` o WHERE o.id_customer = c.id) AS last_order_at
FROM `customer` c