Forms with chart from VAB

Часто задаваемые вопросы

У вас есть вопросы или проблемы с формами с диаграммой от VAB? Используйте эти каналы поддержки.

1. Обратная связь
2. Домашняя страница

Могу ли я добавить атрибуты id и class к элементу формы?

Да. Вы можете добавить любой идентификатор и класс в форму, добавив атрибуты form_id и form_class в шорткод [VABFWC].
Например:

[VABFWC id="2228" form_id="ThisID" form_class="new-class two-new-class"]

Как вывести результаты формы в любом другом месте с помощью шорткода?

Для отображения результатов формы в любом другом месте необходимо добавить шорткод «VABFWC_Graphic».
Например.

1. Для редактора страниц и записей.

[VABFWC_Graphic id="2228" title="Title for shortcode" tag="h4" class="my_class"]

2. PHP код

echo do_shortcode( '[VABFWC_Graphic id="2228" title="Title for shortcode" tag="h4" class="my_class"]' );

Где:

• id — идентификатор формы (обязательный);
• title — текст перед отображением результатов формы (необязательный);
• tag — тег, в который будет обернут title (необязательный). Разрешенные теги — h1, h2, h3, h4, h5, h6, div, p, center;
• class — Задает стилевой класс для тега (необязательный);

Какие фильтры существуют?

• VABFWC_validate_filter — Возвращает либо true(истина), либо false(ложь). Если по какому-либо условию возвращается true (истина), форма остановит работу(сообщение не будет отправлено)
• VABFWC_fields_filter — Возвращает строку для вывода на экран. Разрешен Элемент HTML input с атрибутами «type», «id», «class», «name», «value», «checked», «onfocus», «onchange»
• VABFWC_message_filter — Возвращает строку для вывода на экран как текст(сообщение)
• VABFWC_message_after_filter — Возвращает строку для вывода на экран как текст(сообщение). Срабатывает после успешной отправки электронного сообщения.

Как использовать фильтры?

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

1. VABFWC_fields_filter. Код ниже добавит скрытое поле за счет стилей через класс «formInput», которое будет со значением по умолчанию «WordPress». Будет выведен только тег «input» без «label» (см. описание выше для VABFWC_fields_filter).

add_filter( 'VABFWC_fields_filter', 'VABFWC_fields_filter', 10 );
if ( !function_exists(  'VABFWC_fields_filter'  ) ){
 function VABFWC_fields_filter( $str ){
  $str  = '<label for="new_field" >' .
           '<input id="new_field" name="new_field" type="text" class="formInput" value="WordPress"/>' .
          '</label>';
  return $str;
 }}

2. VABFWC_validate_filter. Код ниже остановить отправку формы, если хоть одно условие вернет «true» (истину).

add_filter( 'VABFWC_validate_filter', 'VABFWC_filter_function', 10 );
if ( !function_exists( 'VABFWC_filter_function' ) ) {
 function VABFWC_filter_function( $str ){
  if ( !isset( $_COOKIE['my_cookie_agree'] ) || $_COOKIE['my_cookie_agree'] !== 'agree' ) { // first
   return true;
  }
  if ( sanitize_text_field( $_POST['new_field'] ) !== 'WordPress' ) { // second
   return true;
  }
 }}

Где:

• Первое условие проверяет наличие установленной «cookie» со значением «agree». Предположим у Вас на сайте есть кнопка «Я согласен», при нажатии на которую устанавливается «cookie» со значением «agree», что означает, что пользователь дал согласие на использование «cookie». Таким образом пока пользователь не нажмет кнопку «Я согласен», форма не будет работать, кроме того и усложнится жизнь ботам;
• Второе условие проверяет значение скрытого поля, если оно отлично от значения по умолчаниею («WordPress»), дальнейшая обработка формы будет остановлена;

3. VABFWC_message_filter. Если «cookie» со значением «agree» не будет присутствовать (пользователь не дал согласие на использование «cookie»), код ниже выведет сообщение пользователю.

add_filter( 'VABFWC_message_filter', 'VABFWC_message_filter', 10 );
if ( !function_exists(  'VABFWC_message_filter' ) ){
 function VABFWC_message_filter( $str ){
  if ( !isset( $_COOKIE['my_cookie_agree'] ) || $_COOKIE['my_cookie_agree'] !== 'agree' ) {
   return $str = esc_html__( 'Использование cookie отключено в настройках безопасности Вашего браузера, либо не дано согласие на их использование', 'VAB' );
  }
 }}

4. Если необходимо добавить фильтры для конкретной формы, Мы можем использовать глобальную переменную «post» и проверить идентификатор записи/страницы:

add_filter( 'VABFWC_validate_filter', 'my_filter_function', 10 );
function my_filter_function( $str ){
 global $post;
 if ( $post->ID == 1652 ) {
  if ( !isset( $_COOKIE['my_cookie_agree'] ) || $_COOKIE['my_cookie_agree'] !== 'agree' ) {
   return true;
  }}}

5. VABFWC_message_after_filter. После успешной отправки электронного письма мы можем выполнить какие-либо свои подсчеты и вывести их результаты на экран

add_filter( 'VABFWC_message_after_filter', 'VABFWC_message_after_filter', 10 );
if ( !function_exists('VABFWC_message_after_filter') ){
    function VABFWC_message_after_filter( $str ){
     global $post;
     if ( $post->ID == 11057 ) {
        // do something
        $str .= 'Hellow';

     }
     if ( $post->ID == 11052 ) {
        // do something
        $str .= 'World';
     }
        return $str ;
}}

Где находятся лог файлы?

Лог файлы находятся в папке uploads. Пример структуры папок:

...
├── your.site.com
    ...
    ├── wp-content
    │       ├── languages
    │       ├── plugins
    │       ├── themes
    │       ├── upgrade
    │       ├── uploads
    │       │       ...
    │       │       ├── VABFWC
    │       │       │       ├── your-site-com
    │       │       │       │       └── Diagram
    │       │       │       │               ├── «form ID»
    │       │       │       │               │       ├── .htaccess
    │       │       │       │               │       ...
    │       │       │       │               │       ├── «log files»
    │       │       │       │               │       ...
    │       │       │       │               │       └── index.php
    │       │       ...
    │       └── index.php
    ├── wp-config.php
    ...