Improve documentation for session_cookie_domain with IDN (umlaut) domains (#566)

* Update session_cookie_domain documentation

Add important notes and recommendations for using session_cookie_domain with IDN domains.

* Обновить раздел о session_cookie_domain для IDN

Добавлены рекомендации по использованию настройки session_cookie_domain с международными доменными именами (IDN), включая примеры и поведение при различных конфигурациях.

* Update default value for session_cookie_domain

Changed default value for session_cookie_domain from 'localhost' to '' and updated the description.

* Change default session cookie domain to empty string

Updated the default value of the session cookie domain from 'localhost' to an empty string.

* Update session_cookie_domain documentation with recommendations

Added recommendations for using session_cookie_domain with IDN domains and clarified behavior in testing.

* Update session_cookie_domain.md with recommendations

Added recommendations for handling session cookie domains, including the use of punycode for IDN domains and the behavior of different domain types.

Author: ant-tar

en/building-sites/settings/session_cookie_domain.md

@@ -1,14 +1,14 @@
 ---
 title: "session_cookie_domain"
-_old_id: "276"
-_old_uri: "2.x/administering-your-site/settings/system-settings/session_cookie_domain"
+description: "Session Cookie Domain setting"
+
 ---
 
 ## session\_cookie\_domain
 
-**Name**: Session Cookie Domain
-**Type**: String
-**Default**: localhost
+-   **Name**: Session Cookie Domain
+-   **Type**: String
+-   **Default**: ''
 
 Use this setting to customize the session cookie domain.
 
@@ -21,3 +21,27 @@ This setting is useful to change if you are running multiple Contexts on one top
 will allow all MODX sessions to persist across any \*.mydomain.com site, allowing logins to work across subdomains.
 
 This setting isn't in MODX by default, as it's best to let PHP calculate this on its own. Only set this if you are sure of what you are doing.
+
+### Important note for IDN (internationalized) domains
+
+When using the `session_cookie_domain` setting with internationalized domain names (IDN), such as domains containing umlauts (e.g. `müller-example.de`), session handling may fail depending on the server and PHP configuration.
+
+HTTP cookies (including session cookies) are based on ASCII-compatible domain names. In practice, this means that IDN domains are typically represented in **punycode (A-label)** form when used at the protocol level.
+
+Example:
+
+- Unicode: `müller-example.de`
+- Punycode: `xn--mller-example-9db.de`
+
+In testing, the following behavior was observed:
+
+- ASCII domain - works as expected
+- Unicode IDN domain in `session_cookie_domain` - may break sessions
+- Empty `session_cookie_domain` - works reliably
+
+**Recommendations:**
+
+- Avoid setting `session_cookie_domain` unless explicitly required, leave it empty to let PHP handle it automatically
+- If using IDN domains, prefer the punycode (ASCII) representation
+
+Note: Behavior may vary depending on PHP version, browser, and server configuration.

ru/building-sites/settings/session_cookie_domain.md

@@ -7,7 +7,7 @@ translation: "building-sites/settings/session_cookie_domain"
 
 -   **Имя**: Домен для сессионных куки
 -   **Тип**: String
--   **По умолчанию**: localhost
+-   **По умолчанию**: ''
 
 Используйте этот параметр для настройки домена cookie сеанса.
 Вам нужно будет очистить локальные куки в вашем браузере после изменения этого параметра.
@@ -17,3 +17,27 @@ translation: "building-sites/settings/session_cookie_domain"
 
 Позволит всем сеансам MODX сохраняться на любом сайте \*.mydomain.com, позволяя логинам работать на поддоменах.
 Этот параметр по умолчанию отсутствует в MODX, так как лучше позволить PHP рассчитать его самостоятельно. Установите это, только если вы уверены, что делаете.
+
+### Важное замечание для IDN-доменов (международных доменных имён)
+
+При использовании настройки `session_cookie_domain` с международными доменными именами (IDN), например с доменами, содержащими umlaut (например, `müller-example.de`), работа сессий может нарушаться в зависимости от конфигурации сервера и PHP.
+
+HTTP cookies (включая сессионные cookies) основаны на ASCII-совместимых доменных именах. На практике это означает, что IDN-домены обычно представляются в виде **punycode (A-label)** при использовании на уровне протокола.
+
+Пример:
+
+- Unicode: `müller-example.de`
+- Punycode: `xn--mller-example-9db.de`
+
+В ходе тестирования наблюдалось следующее поведение:
+
+- ASCII-домен - работает корректно
+- Unicode IDN-домен в `session_cookie_domain` - может приводить к сбоям сессий
+- Пустое значение `session_cookie_domain` - работает стабильно
+
+**Рекомендации:**
+
+- Не задавайте `session_cookie_domain`, если в этом нет явной необходимости, оставьте значение пустым, чтобы PHP автоматически обработал домен
+- При использовании IDN-доменов предпочтительно использовать представление в punycode (ASCII)
+
+Примечание: поведение может отличаться в зависимости от версии PHP, браузера и конфигурации сервера.