Документация по макросам и шаблонам UMI.CMS

Пример вызова

udata://webforms/add/832

XML-ответ UData

<udata form_id="832" module="webforms" method="add" generation-time="0.501507">
  <items>
    <item id="27683">Письмо администраторам</item>
    <item id="27686">Письмо в рекламный отдел</item>
  </items>
  <groups>
    <group name="lichnye_dannye" title="личные данные">
      <field name="imya" title="имя" input_name="data[new][imya]"
       type="string" id="9263" required="required"/>
      <field name="familiya" title="фамилия" input_name="data[new][familiya]"
       type="string" id="9264"/>
      <field name="email" title="e-mail" input_name="data[new][email]"
       type="string"  tip="это подсказка" id="9265" required="required"/>
      <field name="soobwenie" title="сообщение" input_name="data[new][soobwenie]" 
       type="text" id="9267" required="required"/>
    </group>
  </groups>
</udata>

В случае если указан параметр who конкретного списка адресов, то вместо ветви items будет присутствовать 2 элемента (address_select и res_to). Содержимое любого из них необходимо указать при верстке формы:

<address_select>
  <input type="hidden" name="system_email_to" value="27683" />
</address_select>
<res_to>
  <input type="hidden" name="system_email_to" value="27683" />
</res_to>

Элементы и атрибуты

Примеры использования

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

В том месте, где необходимо отобразить форму, вызовем макрос:

<xsl:apply-templates select="document('udata://webforms/add/832')/udata" mode="mywebform"/>

Теперь необходимо описать шаблоны обработки результатов макроса. Создаем форму:

<xsl:template match="udata[@module = 'webforms'][@method = 'add']" mode="mywebform">

  <form method="post" action="/webforms/send/">

    
    <input type="hidden" name="system_form_id" value="{@form_id}" />

    
    
    <input type="hidden" name="ref_onsuccess" value="/webforms/posted/" />
    <table>

      <tr>
        <td>Куда отправить:</td>
        <td>
           <select name="system_email_to">
             
             <xsl:apply-templates select=".//item" mode="form-select"/>
           </select>
        </td>
      </tr>
    
      
      <xsl:apply-templates select=".//field" mode="form-fields"/>

      
      <xsl:apply-templates select="document('udata://system/captcha')/udata[url]" />
  
   </table>

   <p><input type="submit" value="Отправить" /></p>

  </form>

</xsl:template>

Далее необходимо описать шаблон, выводящий набор списков адресов:

<xsl:template match="item" mode="form-select">
  <option value="{@id}">
    <xsl:value-of select="." />
  </option>
</xsl:template>

А также, например, 2 шаблона для полей типа string (для ввода таких данных как Имя, Фамилия, e-mail) и text (для ввода самого сообщения):

<xsl:template match="field[@type = 'string']" mode="form-fields">
  <tr>
    <td><xsl:value-of select="@title"/>:</td>
    <td><input type="text" name="{@input_name}"/></td>
  </tr>
</xsl:template>

<xsl:template match="field[@type = 'text']" mode="form-fields">
  <tr>
    <td><xsl:value-of select="@title"/>:</td>
    <td><textarea name="{@input_name}"/></td>
  </tr>
</xsl:template>

Для того, чтобы использовать защитный код, вставлен вызов макроса %system captcha()%, где проверка на наличие элемента url будет гарантировать, что зарегистрированные пользователи CAPTCHA не увидят:

<xsl:apply-templates select="document('udata://system/captcha')/udata[url]" />

Для которого необходимо описать шаблон, например, следующим образом:

<xsl:template match="udata[@method='captcha']">
   <tr>
      <td><label for="{@input_id}">Защитный код:</label></td>
      <td><img src="{url}{@random_string}"/>
      <input type="text" name="captcha"/></td>
   </tr>
</xsl:template>

Используемые шаблоны

Макрос оперирует шаблонами, находящимися в каталоге /tpls/data/reflection/

Используемые блоки шаблона

Примеры использования

Создайте файл sample.tpl в директории /tpls/data/reflection/ и напишите в нем следующий код:

<?php

$FORMS = Array();

$FORMS['error_no_form'] = '<b>Форма не определена</b><br />Обратитесь к администрации ресурса';

$FORMS['send_successed'] = 'Ваше сообщение отправлено';

$FORMS['form_block'] = <<<END
<form enctype="multipart/form-data" method="post" action="/webforms/send/">
 <input type="hidden" name="system_form_id" value="%form_id%" />
 <input type="hidden" name="system_template" value="%template%" />
 %address_select%
 %groups%
</form>
END;

$FORMS['address_select_block']  = <<<END
<table border="0" width="500">
    <tr>
        <td>
            Получатель
        </td>

        <td>
            <select name="system_email_to" style="width: 200px">
                %options%
            </select>
        </td>
    </tr>
</table>
END;

$FORMS['address_select_block_line']  = <<<END
 <option value="%id%">%text%</option>
END;

$FORMS['reflection_block'] = <<<END
 %groups%
 %system captcha()%
 <input type="submit" value="Отправить" />
END;

$FORMS['reflection_group'] = <<<END

 <b>%title%</b><br />

 <table border="0" width="500">
  %fields%
 </table>

END;

$FORMS['reflection_group_address'] = <<<END

<table border="0" width="500">
    <tr>
        <td>
            Получатель
        </td>

        <td>
            <select name="system_email_to" style="width: 200px">
                %options%
            </select>
        </td>
    </tr>
</table>

END;

$FORMS['reflection_field_string'] = <<<END

 <tr>
  <td>
   %title%:
  </td>

  <td>
   <input type="text" name="%input_name%" value="%value%" size="50" />
  </td>
 </tr>

END;

$FORMS['reflection_field_text'] = <<<END

 <tr>
  <td>
   %title%:
  </td>

  <td>
   <textarea name="%input_name%" style="width: 200px">%value%</textarea>
  </td>
 </tr>

END;

END;

$FORMS['reflection_field_boolean'] = <<<END

 <tr>
  <td>
   %title%:
  </td>

  <td>
   <input type="hidden" id="%input_name%" name="%input_name%" value="%value%" />
   <input onclick="javascript:document.getElementById('%input_name%').value = this.checked;" type="checkbox" %checked% value="1" />
  </td>
 </tr>

END;

$FORMS['reflection_field_file'] = <<<END

 <tr>
  <td>
   %title%:
  </td>

  <td>
            <input type="file" name="%input_name%" />
  </td>
 </tr>
END;

$FORMS['reflection_field_relation'] = <<<END
    <tr>
        <td>
            %title%:
        </td>

        <td>
            <select name="%input_name%" style="width: 205px" class="textinputs">
                <option />
                %options%
            </select>
        </td>
    </tr>

END;

$FORMS['reflection_field_relation_option'] = <<<END
    <option value="%id%">%name%</option>
END;

$FORMS['reflection_field_relation_option_a'] = <<<END
    <option value="%id%" selected="selected">%name%</option>
END;

$FORMS['reflection_field_multiple_relation'] = <<<END
    <tr>
        <td>
            %title%:
        </td>

        <td>
            <select name="%input_name%" class="textinputs" multiple>
                <option />
                %options%
            </select>
        </td>
    </tr>

END;

$FORMS['reflection_field_multiple_relation_option'] = <<<END
    <option value="%id%">%name%</option>
END;

$FORMS['reflection_field_multiple_relation_option_a'] = <<<END
    <option value="%id%" selected="selected">%name%</option>
END;

?>

В шаблоне можно использовать любое количество полей ввода информации, где имя полей ввода строится по шаблону: data[any_field_name]. Для того, чтобы указать метку (label) поля, используйте <input type="hidden" name="labels[any_field_name]" value="Метка поля" />.

Создайте страницу «Обратная связь» в модуле «Структура». В редакторе содержимого страницы введите макрос %webforms add('','', 'sample')%. Сохраните страницу.