README

Выводит страницу контактов и форму обратной связи Использует сервис statpage в которой должна быть страница с системным именем KONTAKT и иметь статус "Для внутренних целей". Форма обратной связи просто отправляется на почту менеджеру. Адрес менеджера указывается в config с ключем admin_emails, в виде массива. Обратный адрес хранится в ключе email_robot общего конфига

Как дополнительные опции предоставляет работу всплывающих окон для обратного звонка и подписки на чего-либо

Установка composer require masterflash-ru/kontakt

Для отправки сообщений используется пакет masterflash-ru/emailer - если он установился после обновления, не забудьте загрузить в базу дамп.

Конфигурация полей хранится config/forma.ХХХХ.config.php, при необходимости вы можете добавить новые поля, указав новый файл с конфигом формы. Важно! имена captcha, submit, security не менять. Все поля просто отправляются на почту, подписи полей берутся из меток. ХХХХ - имя элемента: kontakt, call, subs

Модуль имеет вызовы для генерации карты сайта sitemap.xml, возвращает информацию для модуля masterflash-ru/sitemap для генерации индексного файла и для самой карты, пока только для ru_RU. Принцип поиска маршрутов производится по начальному слову kontakt в имени маршрута.

для мультиязычных сайтов все готово для работы, и как правило не требуется измнений (ПОКА НЕ ТЕСТИЛ!!!): 1 - добавить маршрут по аналогии с дефолтным, например,

            'kontakt_en_US' => [
                'type' => Segment::class,
                'options' => [
                    'route'    => '/en/kontakt',
                    'defaults' => [
                        'controller' => Controller\IndexController::class,
                        'action'    => 'index',
                        'locale'    => 'en_US'
                    ],
                ],
            ],

2 - добавить в конфиг приложения секцию транслятора, наподобие:

  'translator' => [
    'locale' => 'en_US',
    'translation_file_patterns' => [
        [
            'type'     => 'phparray',
            'base_dir' => __DIR__ .  '/../locale',
            'pattern'  => '%s.php',
        ],
    ],
  ],

3 - добавить языковой перевод в файл, например, en_US.php, наподобие:

return [
  "Ваш email адрес"=>"Your email address",
  
];

Настройки модуля (ниже по умолчанию), определите новые опции в своем приложении. Все поля кроме 'captcha','security',"submit" отправляются на почту. Имя поля берется из опции label конфига формы

  "kontakt"=>[
        /*конфиг элементов ленты*/
        "categories"=>[
            'kontakt_page' =>[
                'description'=>'Страница контактов + форма',
                'tpl' => [
                    'index' => 'kontakt/index/index',     //шаблон вывода страницы
                    'ok' => 'kontakt/index/ok',           //шаблон вывода страницы после отправки формы
                ],
                'layout' => null,                       //макет вывода, по умолчанию текущий
                /*конфигурация формы*/
                "forma"=>__DIR__."/forma.kontakt.config.php",
            ],
            'subs' =>[
                'description'=>'Всплывающее окно для подписок',
                'tpl' => [
                    'index' => 'kontakt/subs/index',     //шаблон вывода страницы
                    'ok' => 'kontakt/subs/ok',           //шаблон вывода страницы после отправки формы
                ],
                /*конфигурация формы*/
                "forma"=>__DIR__."/forma.subs.config.php",
            ],
            'call' =>[
                'description'=>'Всплывающее окно для обратного звонка',
                'tpl' => [
                    'index' => 'kontakt/call/index',     //шаблон вывода страницы
                    'ok' => 'kontakt/call/ok',           //шаблон вывода страницы после отправки формы
                ],
                /*конфигурация формы*/
                "forma"=>__DIR__."/forma.call.config.php",
            ],
        ],
      /*какие элементы разрешено использовать, укажите в конфиге своего приложения */
      "enables"=>[ 
          "kontakt_page"=>true,
          "subs"        =>false,
          "call"        =>false
      ],
  ],

Сценарий вывода форм использует bootstrap4, при необходимости используйте свои, указав в сценарии имена в формате Laminas Для работы со всплыващими окнами:

1 - подключите в макете файл jquery.form.min.js для обрабоки асинхронных запросов

2 - ипользуйте диалоги bootstrap4:

<button class="btn btn-primary subs mt-2 btn-sm" data-toggle="modal" data-target="#subsModal">Подписаться на рассылку</button>



<div class="modal fade" id="subsModal" tabindex="-1" role="dialog" aria-labelledby="SModalLabel" aria-hidden="true">
  <div class="modal-dialog modal-lg" role="dialog">
    <div class="modal-content">
      <div class="modal-header">
          <p class="modal-title h5 text-primary" id="exampleModalCenterTitle">Подписаться на рассылку</p>
        <button type="button" class="close bg-danger" data-dismiss="modal" aria-label="Close">
          <span aria-hidden="true">&times;</span>
        </button>
      </div>
      <div class="modal-body">
        </div>
    </div>
  </div>
</div>


<script>
/*диалог подписаться, в момент открытия загружается форма*/
$('#subsModal').on('show.bs.modal', function (event) {
  $(this).find('.modal-body').load("/subs");
})
</script>

3 - разумеется все библиотеки bootstrap4 должны быть подключены

masterflash-ru / kontakt

Maintainers

Details

README