[MODX, MiniShop2] Отредактировать письмо о заказе - добавить ТВ поле, или что-то еще

Отредактировать письмо, которые отправляется при совершении заказа в Minishop2 может оказаться не такой простой задачей, как кажется на первый взгляд. На этой странице я постараюсь собрать каверзные вопросы, ответы на которые мне приходилось находить.

• Где находится чанк письма, отправляемого покупателю

  tpl.msEmail.new.user, который расширяет чанк tpl.msEmail

• Где находится чанк письма, отправляемого администратору (менеджеру)?

  tpl.msEmail.new.manager, который расширяет чанк tpl.msEmail

• Как поменять почтовый ящик админа?

  Системные настройки -> minishop2 -> Почтовые адреса менеджеров (ms2_email_manager)

• Как поменять почтовый ящик отправителя?

  Системные настройки -> core -> Адрес электронной почты (emailsender)

• Не приходят письма, что делать?

  Базовое решение — указать почтовый адрес отправителя (emailsender), который был бы в формате [что-то]@[ваш домен]. Например, info@webstool.ru. И не так важно существует ли он в реальности, но если этого не сделать, то спам фильтры могут жестко заблокировать письмо, которые отправляется от имени i-love-modx@gmail.com или другого «левого» ящика. Причем так, что даже до папки «Спам» оно не долетит, а просто канет в Лету.

• Как поменять заголовок письма

  Управление словарями -> minishop2 / default / ru -> (отфильтровать) mail. В настройках можно использовать теги MODX, например вот так, чтобы изменить формат номера заказа в заголовке письма: У вас новый заказ №[[+num:replace=`/==`]] Если нужна более продвинутая кастомизация, то знайте, что тема письма в итоге формируется в файле core/components/minishop2/model/minishop2/minishop2.class.php, методе changeOrderStatus — $subject = $this->pdoTools->getChunk....

• Как добавить контактную информацию, информацию о доставке и оплате в письмо пользователю и админу

  Об этом написано в статье [MODX, MiniShop2] Добавить в письмо контактную информацию

• Где формируется письмо? В каком сниппете?
  Какие плейсхолдеры доступны в письме по-умолчанию?

  Давайте поищем...

  1. Данные о заказе формируются тут — core/components/minishop2/model/minishop2/msorderhandler.class.php внутри метода public function submit, и передаются на отправку в почту строчкой $response = $this->ms2->changeOrderStatus($order->get('id'), 1);
  2. Метод changeOrderStatus находится в файле core/components/minishop2/model/minishop2/minishop2.class.php
  3. Далее мы видим строчку $body = $this->modx->runSnippet('msGetOrder',array_merge($pls, array('tpl' => $tpl)));, которая указывает на то, что тело письма будет сформировано в сниппете msGetOrder
  4. В msGetOrder находим ближе к концу срочку $pls = array_merge($scriptProperties, array( и видим те элементы, которые будут доступны в итоге в шаблоне письма — order, products, user, address, delivery, payment, total.
  5. Проверить это можно модифицировав переменую $output в этом же сниппете — $output = $pdoFetch->getChunk($tpl, array_merge($pls,array("ppllss" => $pls)));, а в теле письма указав <pre>{$ppllss | print_r}</pre>.

• Как добавить TV-поле в письмо

  В пердыдущем пункте мы выяснили, что письмо формируется сниппетом msGetOrder. Соответственно ему мы и должны передать указание подцепить нужное дополнительное поле. Я просто вписал название доп. поля в значение по-умолчанию includeTVs для этого сниппета. Доступно оно стало в шаблоне письма в цикле $products, и вызывается вот так: $product.my_custom_tv_name

Если в заметки есть ошибка, или если вы нашли опечатку — напишите об этом в комментариях.