Merge branch 'master' of https://github.com/modx-pro/Docs

Author: Ivan Bochkarev

docs/components/scxcaptchaajaxform.md

@@ -0,0 +1,72 @@
+---
+title: scxcaptchaAjaxForm
+description: Неблокирующая числовая CAPTCHA (5 цифр) для AjaxForm и FormIt. Простая для человека, сложнее для ботов.
+logo: https://sait-modx.by/assets/images/components/scxcaptchaajaxform/logo_captha.png
+author: sait-modx.by
+---
+
+# scxcaptchaAjaxForm
+
+Неблокирующая числовая CAPTCHA (5 цифр) для **AjaxForm** и **FormIt**.  
+Простая для человека, сложнее для ботов. Все имена и классы имеют префикс `scx_`.
+
+**Документация:** 
+
+## Быстрый старт
+
+```modx
+[[!ScxCaptchaAjaxForm]]
+```
+
+### AjaxForm
+
+```modx
+[[!AjaxForm?
+  &snippet=`FormIt`
+  &form=`tpl.AjaxForm.example`
+  &hooks=`ScxCaptchaAjaxFormHook,email`
+  &validate=`name:required,email:required:email,scx_code:required`
+]]
+```
+
+### FormIt
+
+```modx
+[[!FormIt?
+  &hooks=`ScxCaptchaAjaxFormHook,email`
+  &validate=`name:required,email:required:email,scx_code:required`
+]]
+[[!ScxCaptchaAjaxForm]]
+```
+
+## Требования
+
+MODX Revolution 2.8+ или 3.x
+
+PHP 7.2+ (рекомендуется 7.4)
+
+GD + TrueType (для TTF-шрифта)
+
+## Ключевые особенности
+- Некэшируемый вызов сниппета.
+- Поддержка ассетов: head (по умолчанию), inline, none.
+- Валидация через хук ScxCaptchaAjaxFormHook.
+- Поля формы: scx_hp, scx_ts, scx_code, scx_token.
+
+### Параметры сниппета
+
+| Параметр      | По умолчанию | Описание                                                                 |
+|---------------|--------------|--------------------------------------------------------------------------|
+| ttl           | 1200         | Время жизни токена (сек.)                                                |
+| includeAssets | head         | Как подключать CSS/JS: head, inline, none                                |
+| render        | 1            | Возвращать HTML капчи (1) или только ассеты (0)                          |
+
+## Отладка
+
+Добавьте `&debug=1` к URL `captcha.php?...&debug=1` — выведет служебные данные.
+
+Если видите **Bad token**, проверьте:
+- некэшируемый вызов,
+- один хост/поддомен,
+- корректное подключение ассетов,
+- наличие скрытого af_action у AjaxForm.

docs/components/sendit/events.md

@@ -148,7 +148,28 @@ switch ($modx->event->name){
 ```php:line-numbers
 switch ($modx->event->name){
   case 'senditOnGetWebConfig':
-    $object->webConfig['myparam'] = 'test;
+    $object->webConfig['myparam'] = 'test';
+    break;
+}
+```
+
+:::
+
+#### senditOnSetValue - генерируется перед присвоением нового значения ключу в $_POST
+
+Доступные параметры:
+
+* **$key** - имя поля.
+* **$value** - оригинальное значение.
+* **$SendIt** - экземпляр класса SendIt.
+
+::: details Пример плагина
+
+```php:line-numbers
+switch ($modx->event->name){
+  case 'senditOnSetValue':
+    // устанавливаем оригинальное значение без каких-либо проверок
+    $SendIt->newValue = $value;
     break;
 }
 ```