[miniShop2] Кнопка печати заказа из бек-энда

Часто приходится реализовывать максимально простую распечатку заказа из бек-энда для админов. Делается это в 3 простых и лёгких шага!

Дисклеймер

Сразу оговорюсь, что данное решение никак не может конкурировать с компонентом orderPrint, ибо последний куда более функционален:
— множество шаблонов документов,
— генерация PDF-документа,
— использование компонента с фронта,
— поддержка miniShop2, Shopkeeper,
— и т.д.

Решение

Как говорил выше, данное решение состоит из 3 шагов, а если быть точнее, из PHP файла, плагина и чанка.

Шаг 1

Создаём файл /assets/custom/ms2print.php с таким содержимым:

<?php
/** @var modX $modx */
if (!isset($modx)) {
    define('MODX_API_MODE', true);
    require_once dirname(dirname(dirname(__FILE__))) . '/index.php';
    $modx->getService('error', 'error.modError');
    $modx->getRequest();
    $modx->setLogLevel(modX::LOG_LEVEL_ERROR);
    $modx->setLogTarget('FILE');
    $modx->error->message = null;
    $modx->lexicon->load('default');
}
$ctx = !empty($_REQUEST['ctx']) ? $_REQUEST['ctx'] : $modx->context->get('key');
if ($ctx != $modx->context->get('key')) {
    $modx->switchContext($ctx);
}
$pdoTools = $modx->getService('pdoTools');

$order_id = (int)$_REQUEST['order'];
if (empty($order_id) || !$order = $modx->getObject('msOrder', ['id' => $order_id])) {
    $response = 'Заказ не найден!';
} elseif ($order->user_id != $modx->user->id && !$modx->user->hasSessionContext('mgr')) {
    $response = 'У вас нет прав на просмотр заказа!';
} else {
    $params = [
        'order' => $order->toArray(),
        'user' => !empty($order->UserProfile) ? $order->UserProfile->toArray() : [],
        'address' => !empty($order->Address) ? $order->Address->toArray() : [],
        'delivery' => !empty($order->Delivery) ? $order->Delivery->toArray() : [],
        'payment' => !empty($order->Payment) ? $order->Payment->toArray() : [],
        'products' => [],
    ];
    /** @var msOrderProduct $product */
    foreach ($order->Products as $product) {
        $params['products'][] = array_merge($product->toArray(), [
            'article' => $product->Product->Data->get('article'),
        ]);
    }
    $response = $pdoTools->getChunk('tpl.msGetOrder.print', $params);
}
@session_write_close();
exit($response);

К этому файлу мы будем обращаться для получения нашего заказа на печать.

Шаг 2

Создаём плагин на событие msOnManagerCustomCssJs с кодом:

<?php
$controller->addHtml("<script>
    Ext.ComponentMgr.onAvailable('minishop2-window-order-update', function () {
        var w = this;
        var order_id = w.record['id'] || 0;
        w['buttonAlign'] = 'left';
        w['buttons'].unshift({
            id: w['id'] + '-button-check',
            text: 'Распечатать',
            cls: 'primary-button',
            handler: function (btn) {
                window.open('/assets/custom/ms2print.php?order=' + order_id, '_blank').focus();
            },
            scope: w,
        }, '->');
    });
</script>");

Здесь мы внедряем нашу кнопку «Распечатать» в модальное окно заказа.

Шаг 3

Создаём чанк tpl.msGetOrder.print и выводим в нём все возможные переменные, чтобы понимать, с чем работать при создании шаблона на печать:

{$order | print}
{$user | print}
{$address | print}
{$delivery | print}
{$payment | print}
{$products | print}

Итого

Конечно, пытливый ум доработает это решение и для работы на фронте, но в любом случае оно будет уступать вышеупомянутому компоненту.