diff --git a/ru/extras/formit/formit.formitcountryoptions.md b/ru/extras/formit/formit.formitcountryoptions.md index 4e4735e56..afd4de33d 100644 --- a/ru/extras/formit/formit.formitcountryoptions.md +++ b/ru/extras/formit/formit.formitcountryoptions.md @@ -35,7 +35,7 @@ FormItCountryOptions имеет некоторые свойства по умо | selected | Код страны для отметки, что она выбрана | | | selectedAttribute | Необязательный. Атрибут HTML, добавляемый в выбранную страну. | selected="selected" | | tpl | Необязательный. Код, используемый для каждого варианта раскрывающегося списка стран | | -| useIsoCode | If 1, для значения будет использоваться аббревиатура (код страны)). Если 0, будет использоваться полное имя | 1 | +| useIsoCode | Если 1, для значения будет использоваться аббревиатура (код страны). Если 0, будет использоваться полное имя | 1 | | prioritized | Необязательный. Разделенный запятыми список кодов ISO для стран, которые можно поместить в приоритетную optiongroup вверху раскрывающегося списка. Это можно использовать для часто выбираемых стран. | | | prioritizedGroupText | Необязательный. Если установлено и используется `&prioritized`, будет добавлена текстовая метка для группы опций с приоритетом. | | allGroupText | Необязательный. Если установлено и используется `&prioritized`, будет добавлена текстовая метка для группы опций для всех остальных стран. | @@ -57,9 +57,7 @@ FormItCountryOptions имеет некоторые свойства по умо  -You simply pass the ISO codes of the countries you wish to prioritize in the &prioritized parameter. You can also adjust the text of the option groups with the `&prioritizedGroupText` and `&allGroupText` properties. - -Вы просто передаете коды ISO стран, которым вы хотите присвоить приоритет, в параметре `&prioritized`. Вы также можете настроить текст `optiogroup` с помощью свойств `&prioritizedGroupText` и` &allGroupText`. +Вы просто передаете коды ISO стран, которым вы хотите присвоить приоритет, в параметре `&prioritized`. Вы также можете настроить текст `optiongroup` с помощью свойств `&prioritizedGroupText` и `&allGroupText`. ## Смотрите также diff --git a/ru/extras/formit/formit.formitretriever.md b/ru/extras/formit/formit.formitretriever.md index 9606f457c..39ca6d5a6 100644 --- a/ru/extras/formit/formit.formitretriever.md +++ b/ru/extras/formit/formit.formitretriever.md @@ -19,7 +19,7 @@ FormItRetriever - это вспомогательный [Сниппет](buildin А затем отобразите данные формы с плейсхолдерами, относящимися к именам полей, например: ```php -
<Благодарим [[!+fi.name]] за сообщение. Письмо будет отправлено вам на ящик [[!+fi.email]].
+Благодарим [[!+fi.name]] за сообщение. Письмо будет отправлено вам на ящик [[!+fi.email]].
``` Не забудьте установить `&store=1` в вызове FormIt, чтобы сниппет понимал, что нужно хранить значение. @@ -68,7 +68,7 @@ FormItRetriever имеет некоторые свойства по умолча ```php [[!FormItRetriever? &redirectToOnNotFound=`444`]] -Спасибо [[!+fi.name]] за ваше обращение. Вам будет отправлен автоматически электронное письмо на адрес [[!+fi.email]]. Текст вашего обращения:
+Спасибо [[!+fi.name]] за ваше обращение. Вам будет автоматически отправлено электронное письмо на адрес [[!+fi.email]]. Текст вашего обращения:
[[!+fi.message]] ``` diff --git a/ru/extras/formit/formit.formitstateoptions.md b/ru/extras/formit/formit.formitstateoptions.md index 98432c183..cbf9bdf94 100644 --- a/ru/extras/formit/formit.formitstateoptions.md +++ b/ru/extras/formit/formit.formitstateoptions.md @@ -39,7 +39,7 @@ FormItStateOptions имеет некоторые свойства по умол | selected | Код штата/региона для отметки, что он выбран | | | selectedAttribute | Необязательный. Атрибут HTML, добавляемый в выбранный штат. | selected="selected" | | tpl | Необязательный. Код, используемый для каждого варианта раскрывающегося списка регионов. | | -| useAbbr | Если указано '1', для значения будет использоваться аббревиатура(код региона)). Если 0, будет использоваться полное имя | 1 | +| useAbbr | Если указано '1', для значения будет использоваться аббревиатура (код региона). Если 0, будет использоваться полное имя | 1 | | toPlaceholder | Необязательный. Используйте это, чтобы установить вывод в качестве плейсхолдера вместо вывода напрямую. | | ## Смотрите также diff --git a/ru/extras/formit/formit.hooks/email.md b/ru/extras/formit/formit.hooks/email.md index 0cdf93935..3d353a4c0 100644 --- a/ru/extras/formit/formit.hooks/email.md +++ b/ru/extras/formit/formit.hooks/email.md @@ -14,7 +14,7 @@ Email хук отправит содержимое вашей HTML формы н | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | emailTpl | Обязательный. Чанк tpl для сообщения электронной почты. Если он не указан, будет отправлен список полей с их значениями. | | emailSubject | Тема письма. | -| emailUseFieldForSubject | Если указано "1" и передано поле "тема", то значение этого поля будет использоваться в качестве строки темы электронного письма. | +| emailUseFieldForSubject | Если указано "1" и передано поле "subject", то значение этого поля будет использоваться в качестве строки темы электронного письма. | | emailTo | Список адресов получателей электронной почты, разделенных запятыми. | | emailToName | Необязательный. Список имен, разделенных запятыми, для попарного сопряжения со значениями `emailTo`. | | emailFrom | Необязательный. Если установлено, будет указан адрес отправителя "From:" для электронного письма. Если не установлен, сначала будет осуществлен поиск поля формы "email". Если ничего не найдено, по умолчанию будет установлена системная настройка `emailsender`. **ПРИМЕЧАНИЕ**. Всегда устанавливайте для системной настройки `emailFrom` действительный адрес электронной почты (который разрешен для отправки с вашего сервера), чтобы избежать отклонения писем из-за нарушений SPF/DMARC. | @@ -84,7 +84,7 @@ FormIt, начиная с версии 4.2.5+, мог выбирать полу ``` -Если выбран Адрес 1, почта будет отправляться на `mail1@my.domain,mail2@my.domain`, если же выбран Адрес 2, почта будет отправлена на`different@my.domain`. +Если выбран Адрес 1, почта будет отправляться на `mail1@my.domain,mail2@my.domain`, если же выбран Адрес 2, почта будет отправлена на `different@my.domain`. ### Использование поля Темы в качестве строки Темы электронного письма @@ -97,7 +97,7 @@ FormIt, начиная с версии 4.2.5+, мог выбирать полу ]] ``` -Будет выполнен поиск поля с именем "тема", которое будет использоваться в электронном письме. Если он не будет найден или окажется пуст, по умолчанию будет использовано значение `&emailSubject`. +Будет выполнен поиск поля с именем "subject", которое будет использоваться в электронном письме. Если оно не будет найдено или окажется пустым, по умолчанию будет использовано значение `&emailSubject`. ### Работа с чекбоксами и множественным выбором в электронном письме diff --git a/ru/extras/formit/formit.hooks/formitsaveform.md b/ru/extras/formit/formit.hooks/formitsaveform.md index ac4658d6e..276a6dadf 100644 --- a/ru/extras/formit/formit.hooks/formitsaveform.md +++ b/ru/extras/formit/formit.hooks/formitsaveform.md @@ -21,6 +21,26 @@ FormIt 3.0 представляет обновление методов шифр | formFields | Список полей, разделенных запятыми, которые будут сохранены. По умолчанию будут сохранены все поля, включая кнопку отправки. | | | fieldNames | Измените имя поля внутри CMP. Например, если имя поля - "email2", вы можете изменить имя на "дополнительный адрес электронной почты". | &fieldnames=\`fieldname==Название поля,anotherone==Другое название поля\` | +## Очистка старых форм + +В зависимости от местного законодательства, хранение отправленных форм на неопределённый срок может вызывать проблемы с конфиденциальностью. + +Для решения этой проблемы FormIt предлагает простой способ удаления отправленных форм по истечении заданного количества дней с помощью настройки задания cron. + +По умолчанию задание cron удаляет все отправленные формы старше 30 дней при каждом запуске. + +Это значение можно изменить, установив другое количество дней в системной настройке: `formit.cleanform.days`. + +### Настройка cron + +Используйте следующий путь: `/(полный_путь_до)/assets/components/formit/cronjob/cron.php` + +Подсказка: полный путь можно увидеть во время установки: + + + +*Примечание:* cron.php принимает запросы только через CLI. Вы можете сделать это, добавив новое задание cron через SSH или используя [cronmanager](https://jako.github.io/CronManager/usage/) для запуска процедуры очистки. + ## Смотрите также 1. [FormIt хук email](extras/formit/formit.hooks/email) diff --git a/ru/extras/formit/formit.hooks/index.md b/ru/extras/formit/formit.hooks/index.md index 84ae81b17..a6aadf246 100644 --- a/ru/extras/formit/formit.hooks/index.md +++ b/ru/extras/formit/formit.hooks/index.md @@ -6,7 +6,7 @@ translation: "extras/formit/formit.hooks" ## Хуки FormIt -Хуки это скрипты, которые запускаются во время обработки FormIt. Они всегда выполняются в том порядке, в котором они указаны в свойстве. Если, например, у вас есть ловушка электронной почты, за которой следует ловушка проверки, электронное письмо будет отправлено до того, как произойдет проверка. Если какой-либо хук не сработает, последующие за ним не будут выполняться. +Хуки это скрипты, которые запускаются во время обработки FormIt. Они всегда выполняются в том порядке, в котором они указаны в свойстве. Если, например, у вас есть хук электронной почты, за которым следует хук проверки, электронное письмо будет отправлено до того, как произойдет проверка. Если какой-либо хук не сработает, последующие за ним не будут выполняться. Хуки также могут быть именами Сниппетов, которые затем будут выполнять сниппет в качестве хука. Сниппет должен возвращать true в случае успеха и false в случае неудачи. @@ -97,7 +97,7 @@ $modx->toPlaceholder('extraFields', implode(PHP_EOL, $fields)); ## Произвольные хуки -Любой Cниппет можно использовать как настраиваемый хук с Formit. Сниппет должен возвращать true в случае успеха и либо false, либо массив сообщений об ошибках в случае неудачи (см. ниже). Если фрагмент возвращает false, хуки, перечисленные после сниппета в параметре `hooks`, не будут выполняться. Если фрагмент не найден, _будут_ выполняться следующие за ним в списке хуки. +Любой Cниппет можно использовать как настраиваемый хук с Formit. Сниппет должен возвращать true в случае успеха и либо false, либо массив сообщений об ошибках в случае неудачи (см. ниже). Если сниппет возвращает false, хуки, перечисленные после сниппета в параметре `hooks`, не будут выполняться. Если сниппет не найден, _будут_ выполняться следующие за ним в списке хуки. ### Использование пользовательских хуков diff --git a/ru/extras/formit/formit.hooks/math.md b/ru/extras/formit/formit.hooks/math.md index d2ac58a12..b72bdbe5a 100644 --- a/ru/extras/formit/formit.hooks/math.md +++ b/ru/extras/formit/formit.hooks/math.md @@ -18,7 +18,7 @@ translation: "extras/formit/formit.hooks/math" | mathMaxRange | Максимальное значение для каждого числа в уравнении. | 100 | | mathField | Имя поля ввода для ответа. | math | | mathOp1Field | Имя поля/плейсхолдера для 1-го числа в уравнении. | op1 | -| mathOp2Field | Имя поля/плейсхолдера для 1-го числа в уравнении. | op2 | +| mathOp2Field | Имя поля/плейсхолдера для 2-го числа в уравнении. | op2 | | mathOperatorField | Имя поля/плейсхолдера для оператора в уравнении. | operator | ## Использование diff --git a/ru/extras/formit/formit.hooks/prehooks.formitloadsavedform.md b/ru/extras/formit/formit.hooks/prehooks.formitloadsavedform.md index 766bc2e69..43205d172 100644 --- a/ru/extras/formit/formit.hooks/prehooks.formitloadsavedform.md +++ b/ru/extras/formit/formit.hooks/prehooks.formitloadsavedform.md @@ -28,7 +28,7 @@ translation: "extras/formit/formit.hooks/prehooks.formitloadsavedform" ## Поддерживаемые параметры -Прехук имеет следующие свойства, которые нужно передать в вызов фрагмента FormIt: +Прехук имеет следующие свойства, которые нужно передать в вызов сниппета FormIt: | Имя | Описание | | --------------------- | --------------------------------------------------------------------------------------------- | diff --git a/ru/extras/formit/formit.hooks/recaptcha.md b/ru/extras/formit/formit.hooks/recaptcha.md index 4dd7ee43c..d7e69bf62 100644 --- a/ru/extras/formit/formit.hooks/recaptcha.md +++ b/ru/extras/formit/formit.hooks/recaptcha.md @@ -6,7 +6,7 @@ translation: "extras/formit/formit.hooks/recaptcha" ## Хук recaptcha для FormIt -The recaptcha хук включит поддержку reCaptcha для форм FormIt. +Хук recaptcha включит поддержку reCaptcha для форм FormIt. ## Использование diff --git a/ru/extras/formit/formit.hooks/spam.md b/ru/extras/formit/formit.hooks/spam.md index 687185e3a..e0d26f4a7 100644 --- a/ru/extras/formit/formit.hooks/spam.md +++ b/ru/extras/formit/formit.hooks/spam.md @@ -8,13 +8,13 @@ translation: "extras/formit/formit.hooks/spam" Хук проверяет все поля, указанные в свойстве `spamEmailFields`, на соответствие фильтру спама через [StopForumSpam](http://www.stopforumspam.com/). Если пользователь отмечен как спамер, будет показано сообщение об ошибке для этого отмеченного поля. -Для хука требуется поддержка `cURL` или `Sockets` в вашей установке PHP (те же требования для [Управление пакетами](development-in-modx/advanced-development/package-management «Управление пакетами»)). +Для хука требуется поддержка `cURL` или `Sockets` в вашей установке PHP (те же требования для [Управления пакетами](developing-in-modx/advanced-development/package-management "Управление пакетами")). -## Возможные параметры +## Поддерживаемые параметры | имя | описание | | --------------- | -------------------------------------------------------------------------------------------------------------------------- | -| spamEmailFields | Опциональный. Список полей,где указана адреса электронной почты, разделенных запятыми, для проверки. По умолчанию "email". | +| spamEmailFields | Опциональный. Список полей, где указаны адреса электронной почты, разделенных запятыми, для проверки. По умолчанию "email". | | spamCheckIp | Если 'true', также будет проверяться IP отправителя. По умолчанию 'false'. | ## Использование diff --git a/ru/extras/formit/formit.tutorials-and-examples/examples.custom-hook.md b/ru/extras/formit/formit.tutorials-and-examples/examples.custom-hook.md index 40e7e6e47..d17187443 100644 --- a/ru/extras/formit/formit.tutorials-and-examples/examples.custom-hook.md +++ b/ru/extras/formit/formit.tutorials-and-examples/examples.custom-hook.md @@ -29,7 +29,7 @@ description: "Пользовательский произвольный хук" ## Сниппет customhook -Имя хука соответствует имени Сниппета. Итак, мы создаем сниппет с именем `customhook`. При написании пользовательского хука полезно сначала провести некоторое тестирование, чтобы убедиться, что он срабатывает. Поскольку настраиваемый обработчик должен только _возвращать_ либо истинное, либо ложное значение, распечатать отладочную информацию непросто. Но вместо этого мы можем записать что-нибудь в лог MODX с помощью функции [$modx->log()](extends-modx/xpdo/class-reference/xpdo/xpdo.log). +Имя хука соответствует имени Сниппета. Итак, мы создаем сниппет с именем `customhook`. При написании пользовательского хука полезно сначала провести некоторое тестирование, чтобы убедиться, что он срабатывает. Поскольку настраиваемый обработчик должен только _возвращать_ либо истинное, либо ложное значение, распечатать отладочную информацию непросто. Но вместо этого мы можем записать что-нибудь в лог MODX с помощью функции [$modx->log()](extending-modx/xpdo/class-reference/xpdo/xpdo.log). Помните, что вы должны вернуть **true**, если хотите, чтобы ваша форма была подтверждена! Вот наш пример кода для нашего нового Сниппета `customhook`: @@ -43,7 +43,7 @@ $modx->log(xPDO::LOG_LEVEL_ERROR,'Тестирование моего хука') return true; //<-- если вы не укажете это или вернете "ложь", ваша форма не будет проверяться ``` -Сохраните свой Сниппет и попробуйте отправить форму. Проверьте системный журнал MODX (** Управление -> Отчеты -> Журнал ошибок **), чтобы убедиться, что ваш Сниппет был исполнен. Среди записей журнала должны увидеть что-то вроде этого: +Сохраните свой Сниппет и попробуйте отправить форму. Проверьте системный журнал MODX (**Управление -> Отчеты -> Журнал ошибок**), чтобы убедиться, что ваш Сниппет был исполнен. Среди записей журнала должны увидеть что-то вроде этого: ```php [2011-10-24 11:23:20] (ERROR @ /index.php) Тестирование моего хука. @@ -70,11 +70,11 @@ return true; Дата отправки: [[+datestamp_submitted]][[!+fi.validation_error_message]]
-`]] +[[!+fi.validation_error_message:notempty=`[[!+fi.validation_error_message]]
`]]