Impera CMS • уроки • Подключение модуля "Обратный звонок" в шаблон сайта

  <div  class="over-page"  id="callme-box">
      <form  action=""  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          <div  class="success">
              <!-- уведомление об успехе -->
          </div>

          <div  class="error">
              <!-- ошибка, если была -->
          </div>

          <input  name=""  type="text"  value="Введите ваш номер телефона"  onfocus="">
          <input  name=""  type="submit"  value="Готово">

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div>

  .over-page {
      display: none;
      position: absolute;
  }

  <a  onclick=""  href="">
      Заказать обратный звонок
  </a>

  <a  onclick=""  href="{$site}callme">
      Заказать обратный звонок
  </a> 
               Комментарий: Здесь мы указали абсолютный адрес страницы функции Обратный звонок. Кроме
               прочих переменных, движок передает в шаблонизатор Smarty переменную $site, равную url корневой
               папки магазина на сайте. Скажем, если движок установлен в корень сайта, то значение этой переменной
               будет равно например http://myshop.com/, и тогда полный адрес страницы получился бы
               http://myshop.com/callme. При склейке абсолютного адреса страницы важно не забывать, что
               содержимое этой переменной всегда завершается слешем.
               


               Впрочем мы могли бы вместо {$site}callme записать адрес просто как callme, то есть
               в относительном виде. Обе записи справедливы, однако рекомендуется писать абсолютные адреса, чтобы
               всегда быть уверенным, что человек попадет на нужную страницу вне зависимости от строения человеко-понятных
               url на сайте.
               


               Кроме того, идеальное написание шаблонов под Smarty рекомендует защищать вывод переменных от
               случаев неинициализирования и попадания в нее разметочных символов. Первое достигается указанием через
               знак вертикальной черты | вслед за именем переменной модификатора default:'' - после двоеточия
               в кавычках пишут, какое значение считать по умолчанию, если такую переменную не инициализировали, вообще
               не передали в шаблон. Второе достигается указанием модификатора escape - заменить в значении переменной
               все специальные символы (угловые скобки, кавычки, амперсанды) их html сущностями (кодовыми аналогами).
               


               Таким образом, вместо {$site}callme правильнее делать все же безопасную запись {$site|default:''|escape}callme.
               Мы тоже станем придерживаться этой рекомендации, просто ниже по коду сначала будем вводить правки в
               упрощенной записи, чтобы было понятно, а на следующем шаге предыдущую правку заменять полной, безопасной
               записью.
             

  <a  {if  $smarty.request.module  !=  'CallMe'}
           onclick=""
      {/if}  href="{$site|default:''|escape}callme">
      Заказать обратный звонок
  </a> 
               Комментарий: В любом файле шаблона доступна переменная $smarty. В числе прочих элементов,
               она также содержит в себе элемент request - это копия известного массива $_REQUEST, где содержатся
               переданные текущей странице параметры. Система трансляции человеко-понятных адресов страниц, реализованная
               на модуле mod_rewrite веб сервера, добавляет в этот массив элемент module с именем модуля текущей
               страницы.
               


               Следовательно конструкцией $smarty.request.module на самом деле обращаемся к содержимому элемента
               module в массиве $_REQUEST и проверяем, равен ли он системному названию модуля Обратный звонок.
               Если не равен, то есть сейчас находимся не на собственной странице этой функции, тогда в тело ссылки
               пропускаем обработчик ее нажатия, иначе исключаем обработчик из ссылки.
               


               Еще лучше была бы запись {if $smarty.request.module|lower != 'callme'}. Здесь модификатором
               lower - перевести содержимое строковой переменной в нижний регистр - моделируем регистро-независимое
               сравнение с именем модуля. Ну и с модификатором default запись станет вообще безопасной, ведь
               нет гарантии, что в корневом файле .htaccess прописаны правила трансляции человеко-понятных адресов
               каждому типу страниц. Как пример, движок модифицирован третьей стороной с обретением новых страниц,
               логика которых не завязана на трансляцию адресов через mod_rewrite. Тогда на новых страницах ссылка
               получила бы ошибку, ибо в массиве $_REQUEST отсутствует элемент module, а запись сравнения
               не страховала от подобной ситуации.
             

  <a  {if  $smarty.request.module|default:''|lower  !=  'callme'}
           onclick="javascript:  jQuery('#callme-box').show();  return false;"
      {/if}  href="{$site|default:''|escape}callme">
      Заказать обратный звонок
  </a>

  <a  {if  $smarty.request.module|default:''|lower  !=  'callme'}
           onclick="javascript:  jQuery('#callme-box').show();  return false;"
      {/if}  href="{$site|default:''|escape}callme">
      Заказать обратный звонок
  </a>

  {if  $smarty.request.module  !=  'CallMe'}
      {include  file = 'callme.tpl'}
  {/if} 
                                       Комментарий: Чтобы подключить в тело одного файла содержимое другого файла, в шаблонизаторе
                                       Smarty предусмотрен тег include. Обязательным параметром в нем должен быть file
                                       с указанием имени подключаемого файла. В этот момент шаблонизатор переходит на разбор того файла,
                                       и результирующий контент вставляет вместо подключающего тега. В теге допустимо объявить произвольный
                                       набор параметров, причем внутри подключенного файла они будут выглядеть так, словно эти переменные были
                                       установлены самим движком. Поддержано наследование видимости переменных, то есть если из текущего
                                       файла доступна переменная, она же будет доступна из подключенного файла. Примечательно также перекрытие
                                       видимости переменных. Если в теге подключения объявить переменную с таким же именем, какая доступна
                                       из текущего файла, то в подключенном файле будет доступна именно эта вновь объявленная, как бы на время
                                       разбора закрывая собой оригинальную переменную.
                                     

  {$notCallme  =  $smarty.request.module|default:''|lower  !=  'callme'}

  <a  {if  $notCallme}
           onclick="javascript:  jQuery('#callme-box').show();  return false;"
      {/if}  href="{$site|default:''|escape}callme">
      Заказать обратный звонок
  </a>

  {if  $notCallme}
      {include  file = 'callme.tpl'}
  {/if}

  <div  {if  $smarty.request.module  !=  'CallMe'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action=""  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          <div  class="success">
              <!-- уведомление об успехе -->
          </div>

          <div  class="error">
              <!-- ошибка, если была -->
          </div>

          <input  name=""  type="text"  value="Введите ваш номер телефона"  onfocus="">
          <input  name=""  type="submit"  value="Готово">

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div>

  <div  {if  $smarty.request.module|default:''|lower  !=  'callme'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action="{$site}callme"  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          <div  class="success">
              <!-- уведомление об успехе -->
          </div>

          <div  class="error">
              <!-- ошибка, если была -->
          </div>

          <input  name=""  type="text"  value="Введите ваш номер телефона"  onfocus="">
          <input  name=""  type="submit"  value="Готово">

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div>

  <div  {if  $smarty.request.module|default:''|lower  !=  'callme'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action="{$site|default:''|escape}callme"  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          {if  $message  !=  ''}
              <div  class="success">
                  {$message}
              </div>
          {else}

              <div  class="error">
                  <!-- ошибка, если была -->
              </div>

              <input  name=""  type="text"  value="Введите ваш номер телефона"  onfocus="">
              <input  name=""  type="submit"  value="Готово">
          {/if}

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div>

  <div  {if  $smarty.request.module|default:''|lower  !=  'callme'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action="{$site|default:''|escape}callme"  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          {if  $message|default:''  !=  ''}
              <div  class="success">
                  {$message}
              </div>
          {else}

              {if  $error  !=  ''}
                  <div  class="error">
                      {$error}
                  </div>
              {/if}

              <input  name=""  type="text"  value="Введите ваш номер телефона"  onfocus="">
              <input  name=""  type="submit"  value="Готово">
          {/if}

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div> 
                 Комментарий: Обратите внимание, что в точках вывода переменных $message и $error
                 вообще не используется модификатор escape. Дело в том, что эти переменные предполагаются
                 содержать фрагменты HTML-текста. Например, ошибок может оказаться несколько, их строки могут
                 быть перечислены через переводы строк <br>. Если использовать модификатор, переводы
                 строк станут печатными символами и внешний вид сообщения испортится.
               

  <div  {if  $smarty.request.module|default:''|lower  !=  'callme'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action="{$site|default:''|escape}callme"  method="post"  onsubmit="">
          <h3>
              Обратный звонок
          </h3>

          {if  $message|default:''  !=  ''}
              <div  class="success">
                  {$message}
              </div>
          {else}

              {if  $error|default:''  !=  ''}
                  <div  class="error">
                      {$error}
                  </div>
              {/if}

              {$hint  =  'Введите ваш номер телефона'}
              <input  name="post_phone"  type="text"  value="{$post_phone|default:$hint}"
                      onfocus="">
              <input  name="post_submit"  type="submit"  value="Готово">
              <input  name="post_copystop"  type="hidden"  value="{$post_copystop}">
          {/if}

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div> 
                 Комментарий: Обратите внимание на обработку текущего транзитного содержимого поля ввода.
                 Мы создали непустую переменную-подсказку $hint и с помощью модификатора default назначили ее
                 текстом по умолчанию для переменной $post_phone. При первом открытии формы в поле ввода
                 будет текст подсказки, при открытии формы, отклоненной из-за ошибки, в поле ввода будет последнее
                 ее содержимое.
               

  <div  {if  $smarty.request.module|default:''|lower  !=  'callme'}
             class="over-page"
        {/if}  id="callme-box">
      <form  action="{$site|default:''|escape}callme"  method="post"
             onsubmit="javascript:  return true;">
          <h3>
              Обратный звонок
          </h3>

          {if  $message|default:''  !=  ''}
              <div  class="success">
                  {$message}
              </div>
          {else}

              {if  $error|default:''  !=  ''}
                  <div  class="error">
                      {$error}
                  </div>
              {/if}

              {$hint  =  'Введите ваш номер телефона'}
              <input  name="post_phone"  type="text"  value="{$post_phone|default:$hint|escape}"
                      onfocus="javascript:  if  (this.value  ==  '{$hint}')  this.value = '';">
              <input  name="post_submit"  type="submit"  value="Готово">
              <input  name="post_copystop"  type="hidden"
                                            value="{$post_copystop|default:''|escape}">
          {/if}

          Мы перезвоним вам в течении часа. Так же вы можете <br>
          связаться с нами по телефону: 7(495) 222-22-22
      </form>
  </div>