From 18e9ec7700040428bb3f24a1ed591e345b71abb5 Mon Sep 17 00:00:00 2001 From: Ivan Bochkarev Date: Mon, 17 Aug 2026 18:35:50 +0600 Subject: [PATCH 1/4] docs: scrub @EVAL tutorials and sync MODX 3 settings pages Align Gallery/MIGXdb/GridClassKey examples with 3.x bindings, fix stale setting defaults and removed-setting pages, and drop manager/min troubleshooting that no longer applies. Refs #121. --- .../settings/automatic_template_assignment.md | 10 +++- en/building-sites/settings/enable_gravatar.md | 7 +-- .../settings/manager_favicon_url.md | 14 +++--- .../settings/manager_js_cache_file_locking.md | 12 +++-- .../settings/manager_js_cache_max_age.md | 12 +++-- .../settings/manager_js_document_root.md | 22 +++++---- .../settings/manager_time_format.md | 12 +++-- .../settings/preserve_menuindex.md | 8 ++-- en/building-sites/settings/server_protocol.md | 15 ++++-- .../modx.util.format.datefromtimestamp.md | 2 +- ...g-a-gallery-album-to-a-specifc-resource.md | 46 ++++++------------- en/extras/gridclasskey/index.md | 8 +++- .../add-image-tagging.md | 4 +- .../maintenance/upgrading/troubleshooting.md | 4 +- .../settings/automatic_template_assignment.md | 16 +++++-- ru/building-sites/settings/enable_gravatar.md | 14 +++--- .../settings/manager_favicon_url.md | 12 +++-- .../settings/manager_js_cache_file_locking.md | 16 ++++--- .../settings/manager_js_cache_max_age.md | 16 ++++--- .../settings/manager_js_document_root.md | 26 ++++++----- .../settings/manager_time_format.md | 10 ++-- .../settings/preserve_menuindex.md | 14 +++--- ru/building-sites/settings/server_protocol.md | 13 ++++-- .../modx.util.format.datefromtimestamp.md | 2 +- ...g-a-gallery-album-to-a-specifc-resource.md | 42 ++++++----------- ru/extras/gridclasskey/index.md | 8 +++- .../add-image-tagging.md | 4 +- .../maintenance/upgrading/troubleshooting.md | 4 +- 28 files changed, 205 insertions(+), 168 deletions(-) diff --git a/en/building-sites/settings/automatic_template_assignment.md b/en/building-sites/settings/automatic_template_assignment.md index f084d9a9b..5c4e5722f 100644 --- a/en/building-sites/settings/automatic_template_assignment.md +++ b/en/building-sites/settings/automatic_template_assignment.md @@ -5,6 +5,12 @@ description: "Choose how templates are assigned to new Resources on creation" **Name**: Automatic Template Assignment **Type**: String -**Default**: parent +**Default**: `sibling` (MODX 3.0+; was `parent` in earlier 2.x defaults) -Choose how templates are assigned to new Resources on creation. Options include: **system** (default template from system settings), **parent** (inherits the parent template), or **sibling** (inherits the most used sibling template) +Choose how templates are assigned to new Resources on creation: + +- **system** — default template from System Settings +- **parent** — inherit the parent Resource template +- **sibling** — inherit the most used sibling template + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/enable_gravatar.md b/en/building-sites/settings/enable_gravatar.md index 134fc2e5f..0d8e933be 100644 --- a/en/building-sites/settings/enable_gravatar.md +++ b/en/building-sites/settings/enable_gravatar.md @@ -3,10 +3,11 @@ title: "enable_gravatar" description: "Enable Gravatar usage" --- - **Name**: Enable Gravatar **Type**: Yes/No -**Default**: Yes +**Default**: No (MODX 3.0+ for new installs; was Yes in 2.x) **Available In**: Revolution 2.3.1+ -Enable [Gravatar](https://en.gravatar.com/) usage \ No newline at end of file +When Yes, Gravatar supplies the profile image if the user has no uploaded photo. + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/manager_favicon_url.md b/en/building-sites/settings/manager_favicon_url.md index 8e3650a86..6038b3ccb 100644 --- a/en/building-sites/settings/manager_favicon_url.md +++ b/en/building-sites/settings/manager_favicon_url.md @@ -4,11 +4,13 @@ _old_id: "190" _old_uri: "2.x/administering-your-site/settings/system-settings/manager_favicon_url" --- -## manager\_favicon\_url +## manager_favicon_url -**Name**: Manager Favicon URL -**Type**: Textfield -**Default**: -**Available In:** 2.1+ +**Name**: Manager Favicon URL +**Type**: Textfield +**Default**: `favicon.ico` (MODX 3.0+; earlier defaults were often empty) +**Available In**: 2.1+ -If set, will load this URL as a favicon for the MODX manager. Must be a relative URL to the manager/ directory, or an absolute URL. +URL of the favicon for the MODX Manager. Relative to the `manager/` directory, or an absolute URL. + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/manager_js_cache_file_locking.md b/en/building-sites/settings/manager_js_cache_file_locking.md index 125013e80..91fe62545 100644 --- a/en/building-sites/settings/manager_js_cache_file_locking.md +++ b/en/building-sites/settings/manager_js_cache_file_locking.md @@ -1,11 +1,15 @@ --- title: "manager_js_cache_file_locking" -description: "Cache file locking. Set to No if filesystem is NFS." +description: "Removed in MODX 3.0. Formerly controlled file locking for manager JS/CSS cache." +--- + +**Removed in MODX 3.0.** Dynamic manager JS/CSS minification and its cache settings are gone. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + --- **Name**: Enable File Locking for Manager JS/CSS Cache **Type**: Yes/No -**Default**: Yes -**Available In**: Revolution 2.2.0+ +**Default**: Yes +**Available In**: Revolution 2.2.0–2.x only -Cache file locking. Set to No if filesystem is NFS. \ No newline at end of file +On 2.x: cache file locking. Set to No on NFS filesystems. diff --git a/en/building-sites/settings/manager_js_cache_max_age.md b/en/building-sites/settings/manager_js_cache_max_age.md index 6940e9e05..6023531e2 100644 --- a/en/building-sites/settings/manager_js_cache_max_age.md +++ b/en/building-sites/settings/manager_js_cache_max_age.md @@ -1,11 +1,15 @@ --- title: "manager_js_cache_max_age" -description: "Maximum age of browser cache of manager CSS/JS compression in seconds" +description: "Removed in MODX 3.0. Formerly the max age of the manager JS/CSS compression browser cache." +--- + +**Removed in MODX 3.0.** Dynamic manager JS/CSS minification and its cache settings are gone. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + --- **Name**: Manager JS/CSS Compression Cache Age **Type**: String -**Default**: 3600 -**Available In**: Revolution 2.2.0+ +**Default**: 3600 +**Available In**: Revolution 2.2.0–2.x only -Maximum age of browser cache of manager CSS/JS compression in seconds. After this period, the browser will send another conditional GET. Use a longer period for lower traffic. \ No newline at end of file +On 2.x: maximum age of the browser cache for manager CSS/JS compression, in seconds. diff --git a/en/building-sites/settings/manager_js_document_root.md b/en/building-sites/settings/manager_js_document_root.md index 45b3b15c8..2409fb1c5 100644 --- a/en/building-sites/settings/manager_js_document_root.md +++ b/en/building-sites/settings/manager_js_document_root.md @@ -1,18 +1,22 @@ --- title: "manager_js_document_root" -description: "If your server does not handle the DOCUMENT_ROOT server variable, set it explicitly here to enable the manager CSS/JS compression" +description: "Removed in MODX 3.0. Formerly set DOCUMENT_ROOT for manager CSS/JS compression." +--- + +**Removed in MODX 3.0.** Dynamic manager JS/CSS minification and its cache settings are gone. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + --- **Name**: Manager JS/CSS Compression Document Root **Type**: String -**Default**: -**Available In**: Revolution 2.2.0+ +**Default**: (empty) +**Available In**: Revolution 2.2.0–2.x only -If your server does not handle the `DOCUMENT_ROOT` server variable, set it explicitly here to enable the manager CSS/JS compression. Do not change this unless you know what you are doing. +On 2.x: if the server did not provide `DOCUMENT_ROOT`, set it here so manager CSS/JS compression could run. -## See also +## See also (2.x) -- PHP Array [$\_SERVER](https://www.php.net/manual/en/reserved.variables.server.php) -- [manager_js_cache_file_locking](building-sites/settings/manager_js_cache_file_locking) -- [manager_js_cache_max_age](building-sites/settings/manager_js_cache_max_age) -- [manager_js_zlib_output_compression](building-sites/settings/manager_js_zlib_output_compression) \ No newline at end of file +- PHP [`$_SERVER`](https://www.php.net/manual/en/reserved.variables.server.php) +- [manager_js_cache_file_locking](building-sites/settings/manager_js_cache_file_locking) +- [manager_js_cache_max_age](building-sites/settings/manager_js_cache_max_age) +- [manager_js_zlib_output_compression](building-sites/settings/manager_js_zlib_output_compression) diff --git a/en/building-sites/settings/manager_time_format.md b/en/building-sites/settings/manager_time_format.md index d5aa097a9..8ce61dcf7 100644 --- a/en/building-sites/settings/manager_time_format.md +++ b/en/building-sites/settings/manager_time_format.md @@ -4,10 +4,12 @@ _old_id: "194" _old_uri: "2.x/administering-your-site/settings/system-settings/manager_time_format" --- -## manager\_time\_format +## manager_time_format -**Name**: Manager Time Format -**Type**: String -**Default**: g:i a +**Name**: Manager Time Format +**Type**: String +**Default**: `H:i` (MODX 3.0+; was `g:i a` in earlier 2.x defaults) -The format string, in PHP date() format, for the time settings represented in the manager. +PHP `date()` format string for times shown in the Manager. + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/preserve_menuindex.md b/en/building-sites/settings/preserve_menuindex.md index a50e91e0b..3ed6de390 100644 --- a/en/building-sites/settings/preserve_menuindex.md +++ b/en/building-sites/settings/preserve_menuindex.md @@ -1,11 +1,13 @@ --- title: "preserve_menuindex" -description: "When duplicating Resources, the menu index order will also be preserved" +description: "When duplicating Resources, keep the menu index order" --- **Name**: Preserve Menu Index When Duplicating Resources **Type**: Yes/No -**Default**: Yes +**Default**: No (MODX 3.0+; was Yes in 2.x) **Available In**: Revolution 2.5.0+ -When duplicating Resources, the menu index order will also be preserved. \ No newline at end of file +When Yes, duplicating Resources also keeps their menu index order. + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/server_protocol.md b/en/building-sites/settings/server_protocol.md index d97f6f4a7..268119c36 100644 --- a/en/building-sites/settings/server_protocol.md +++ b/en/building-sites/settings/server_protocol.md @@ -4,10 +4,15 @@ _old_id: "275" _old_uri: "2.x/administering-your-site/settings/system-settings/server_protocol" --- -## server\_protocol +## server_protocol -**Name**: Server Protocol -**Type**: String -**Default**: http +**Removed in MODX 3.0.** Use your web server / reverse-proxy HTTPS configuration instead. Listed under removed settings in [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). -If your site is on a normal http or secure https connection. +--- + +**Name**: Server Protocol +**Type**: String +**Default**: `http` +**Available In**: Revolution 2.x only + +On 2.x: whether the site ran on `http` or `https`. diff --git a/en/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md b/en/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md index 2b398d94a..539c0daec 100644 --- a/en/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md +++ b/en/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md @@ -4,7 +4,7 @@ title: "MODx.util.Format.dateFromTimestamp" ## MODx.util.Format.dateFromTimestamp -Available in MODX **3.x**. Turns a Unix timestamp into a string that follows the manager date and time formats from System Settings (`manager_date_format`, `manager_time_format`). +Available in MODX **3.0+** (added with the manager date/time helpers). Turns a Unix timestamp into a string that follows the manager date and time formats from System Settings (`manager_date_format`, `manager_time_format`). Use it in CMP grids and panels when you show file times or other Unix timestamps and want the same look as the core manager UI. diff --git a/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md b/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md index 79cac2cab..7e28b7b98 100644 --- a/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md +++ b/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md @@ -1,51 +1,35 @@ --- -title: "Assigning a Gallery album to a specifc resource" +title: "Assigning a Gallery album to a specific resource" _old_id: "1757" _old_uri: "revo/gallery/gallery.gallery/assinging-a-gallery-album-to-a-specifc-resource" --- -One thing Gallery lacks out-of-box is assigning albums to a resources. To get this, you'll need to create a Listbox [tv](making-sites-with-modx/customizing-content/template-variables) and use [EVAL-binding](making-sites-with-modx/customizing-content/template-variables/bindings/eval-binding) to create the Listbox items dynamically. +Gallery does not assign albums to Resources out of the box. Use a Listbox TV whose options come from the album table. -To assign a gallery to a specific resource, do the following. +`@EVAL` bindings are removed in MODX 3. Prefer `@SELECT` (below) or an [`@SNIPPET`](building-sites/elements/template-variables/bindings/snippet-binding) that returns `label==id` pairs. -1\. Install [Gallery](https://rtfm.modx.com/extras/revo/gallery/gallery.gallery) extension +1. Install the [Gallery](extras/gallery) Extra. -2\. Create some galleries, and fill them with images. +2. Create albums and add images. -3\. Create a chunk named "galleryDropdownList" for instance. +3. Create a Listbox TV named `assignedGallery` (single or multi, depending on how many albums you need per Resource). -``` php -[[+name]]==[[+id]]|| -``` - -4\. Create a new [tv](making-sites-with-modx/customizing-content/template-variables) with a name "assignedGallery". **Input options:** - -Input type = Listbox (single- or multi- - depends on how many galleries you want to assign to a resource). +**Input Option Values** — load active albums from the Gallery tables (adjust the table prefix if yours is not `modx_`): -Input Option Values (just copy-paste the following code): - -``` php -$output = $modx->runSnippet("GalleryAlbums",array("rowTpl"=>"galleryDropdownList"))."none==0"; return $output; -``` - -OR as an alternative to point 3 and 4, use this Select as Input Option Values (benefit: no need of @EVAL and no need of a chunk): - -``` sql +```sql @SELECT GROUP_CONCAT(name, '==', id SEPARATOR '||') FROM `modx_gallery_albums` WHERE active=1 ``` -Default Value: 0 - -Enable Type-Ahead: Yes - -Force Selection to List: Yes +- Default Value: `0` +- Enable Type-Ahead: Yes +- Force Selection to List: Yes -5\. Assign your tv to a templates of a desired resources, and select some category for it. Save. +4. Assign the TV to the templates that should pick an album. Save. -6\. Open target resource in manager, go to Template Variables, and locate your tv. Choose proper gallery album for it, and click Save, when you done. +5. Edit a Resource, open Template Variables, choose the album, Save. -7\. In your page template, place the following code where you expect your gallery to be rendered: +6. In the page Template, render the album: -``` php +```php [[!Gallery? &album=`[[*assignedGallery]]`]] ``` diff --git a/en/extras/gridclasskey/index.md b/en/extras/gridclasskey/index.md index 150767b4b..d58ee1951 100644 --- a/en/extras/gridclasskey/index.md +++ b/en/extras/gridclasskey/index.md @@ -94,7 +94,13 @@ On this example, let's named it "author". ![](authortv.png) -We need a snippet that will list the users from this particular user group, we use [@EVAL binding](making-sites-with-modx/customizing-content/template-variables/bindings/eval-binding) feature for this. +Create a snippet that lists users from that usergroup (next step), then set the TV Input Option Values to: + +```php +@SNIPPET authorListTV +``` + +`@EVAL` bindings are removed in MODX 3. Use [`@SNIPPET`](building-sites/elements/template-variables/bindings/snippet-binding) instead. ##### 3. Create snippet to list the authors on Template Variable's values diff --git a/en/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md b/en/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md index 6a44ee3a1..e67551e3a 100644 --- a/en/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md +++ b/en/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md @@ -45,10 +45,10 @@ Add a new Tab with caption 'Tags' Add new Field to this Tab with fieldname 'tags' and inputTVtype 'listbox-multiple' -into Input Option Values of this field put: +into Input Option Values of this field put (`@SNIPPET` binding; `@EVAL` is gone in MODX 3): ``` php -@EVAL return $modx->runSnippet('migxLoopCollection',array('classname'=>'mygalTag','sortConfig'=>'[{"sortby":""tag}]','tpl'=>'@CODE:[[+tag]]==[[+id]]','outputSeparator'=>'||')); +@SNIPPET migxLoopCollection {"classname":"mygalTag","sortConfig":"[{\"sortby\":\"tag\"}]","tpl":"@CODE:[[+tag]]==[[+id]]","outputSeparator":"||"} ``` Create another field with the fieldname 'newtag' diff --git a/en/getting-started/maintenance/upgrading/troubleshooting.md b/en/getting-started/maintenance/upgrading/troubleshooting.md index d7fcc98ff..61b2e54c7 100644 --- a/en/getting-started/maintenance/upgrading/troubleshooting.md +++ b/en/getting-started/maintenance/upgrading/troubleshooting.md @@ -25,9 +25,7 @@ If you didn't backup, you can try creating a new core/config/config.inc.php from Make sure to clear your browser cache. Browsers cache the JS and CSS in the manager to have it load faster, and this often causes issues when upgrading, as the browser persists in using the old files. (Note: this is less of an issue post-2.0.2, as JS files are now prefixed with the version to make them non-cacheable after upgrades.) -### Some manager pages are blank due to 400 Bad Request from manager/min/ - -If you've never had problems with min before and you happen to have installed the ACE Extra, make sure the files it refers to in manager/components/ace/ exist. +On MODX 3.x the Manager ships prebuilt asset bundles. There is no `manager/min/` compressor path anymore (removed in 3.0). If a page looks blank after upgrade, clear the browser cache for the manager host and confirm your Extra still loads its own assets under `manager/components/`. ## Still Problems? diff --git a/ru/building-sites/settings/automatic_template_assignment.md b/ru/building-sites/settings/automatic_template_assignment.md index 673b8191e..beb3fb3bf 100644 --- a/ru/building-sites/settings/automatic_template_assignment.md +++ b/ru/building-sites/settings/automatic_template_assignment.md @@ -1,11 +1,17 @@ --- title: "automatic_template_assignment" +description: "Как назначается шаблон новым ресурсам при создании" translation: "building-sites/settings/automatic_template_assignment" -description: "Выберите, как шаблон будет присваиваться при создании нового ресурса" --- -- **Имя**: Автоматическое присвоение шаблона -- **Тип**: String -- **По умолчанию**: parent +**Name**: Automatic Template Assignment +**Type**: String +**Default**: `sibling` (MODX 3.0+; в ранних 2.x по умолчанию было `parent`) -Выберите, как Шаблон будет присваиваться при создании нового Ресурса. Опции включают: «system» (шаблон по умолчанию из Системных настроек), «parent» (наследуется шаблон родительского ресурса), или «sibling» (наследуется наиболее используемый шаблон соседних ресурсов) +Как назначается шаблон новым ресурсам при создании: + +- **system** — шаблон по умолчанию из системных настроек +- **parent** — шаблон родительского ресурса +- **sibling** — самый частый шаблон среди соседних ресурсов + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/enable_gravatar.md b/ru/building-sites/settings/enable_gravatar.md index c659d5731..6a2090bdd 100644 --- a/ru/building-sites/settings/enable_gravatar.md +++ b/ru/building-sites/settings/enable_gravatar.md @@ -1,12 +1,14 @@ --- title: "enable_gravatar" +description: "Включение Gravatar" translation: "building-sites/settings/enable_gravatar" -description: "Включить использование Gravatar" --- -- **Имя**: Включить использование Gravatar -- **Тип**: Да/Нет -- **По умолчанию**: Да -- **Доступен в**: Revolution 2.3.1+ +**Name**: Enable Gravatar +**Type**: Yes/No +**Default**: No (MODX 3.0+ на новых установках; в 2.x было Yes) +**Available In**: Revolution 2.3.1+ -Включить использование [Gravatar](https://ru.gravatar.com/) \ No newline at end of file +Если Yes, Gravatar подставляет фото профиля, когда у пользователя нет загруженного аватара. + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/manager_favicon_url.md b/ru/building-sites/settings/manager_favicon_url.md index 2698e68f6..13bc65961 100644 --- a/ru/building-sites/settings/manager_favicon_url.md +++ b/ru/building-sites/settings/manager_favicon_url.md @@ -5,9 +5,11 @@ translation: "building-sites/settings/manager_favicon_url" ## manager_favicon_url -- **Имя**: URL фавиконки панели управления -- **Тип**: Textfield -- **По умолчанию**: -- **Доступно в**: 2.1+ +**Name**: Manager Favicon URL +**Type**: Textfield +**Default**: `favicon.ico` (MODX 3.0+; раньше часто оставляли пустым) +**Available In**: 2.1+ -Если установлено, этот URL будет загружен как значок для менеджера MODX. Должен быть относительным URL-адресом manager/ каталога или абсолютным URL-адресом. +URL favicon для менеджера MODX. Относительный путь от каталога `manager/` или абсолютный URL. + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/manager_js_cache_file_locking.md b/ru/building-sites/settings/manager_js_cache_file_locking.md index e34838017..dcdd2d63f 100644 --- a/ru/building-sites/settings/manager_js_cache_file_locking.md +++ b/ru/building-sites/settings/manager_js_cache_file_locking.md @@ -1,12 +1,16 @@ --- title: "manager_js_cache_file_locking" translation: "building-sites/settings/manager_js_cache_file_locking" -description: "Блокировка файла кеша" +description: "Удалено в MODX 3.0. Раньше включало блокировку файла кеша JS/CSS менеджера." --- -- **Имя**: Включение блокировки JS/CSS файлов кеша Менеджера -- **Тип**: Да/Нет -- **По умолчанию**: Да -- **Доступен в**: Revolution 2.2.0+ +**Удалено в MODX 3.0.** Динамическая минификация JS/CSS менеджера и связанные настройки кеша больше не существуют. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Блокировка файла кеша. Установите значение "Нет", если файловая система - NFS. \ No newline at end of file +--- + +**Имя**: Включение блокировки JS/CSS файлов кеша Менеджера +**Тип**: Да/Нет +**По умолчанию**: Да +**Доступен в**: только Revolution 2.2.0–2.x + +В 2.x: блокировка файла кеша. Ставьте «Нет» на NFS. diff --git a/ru/building-sites/settings/manager_js_cache_max_age.md b/ru/building-sites/settings/manager_js_cache_max_age.md index c98e159c9..71870aa4c 100644 --- a/ru/building-sites/settings/manager_js_cache_max_age.md +++ b/ru/building-sites/settings/manager_js_cache_max_age.md @@ -1,12 +1,16 @@ --- title: "manager_js_cache_max_age" translation: "building-sites/settings/manager_js_cache_max_age" -description: "Максимальный возраст кеша браузера для сжатия файлов CSS/JS Менеджера в секундах" +description: "Удалено в MODX 3.0. Раньше задавало срок кеша сжатия JS/CSS менеджера в браузере." --- -- **Имя**: Возраст кэша сжатия JS/CSS файлов Менеджера -- **Тип**: String -- **По умолчанию**: 3600 -- **Доступен в**: Revolution 2.2.0+ +**Удалено в MODX 3.0.** Динамическая минификация JS/CSS менеджера и связанные настройки кеша больше не существуют. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Максимальный возраст кеша браузера для сжатия CSS/JS Менеджера в секундах. По истечении этого периода браузер отправит еще один условный GET. Используйте более длительный период для меньшего трафика. \ No newline at end of file +--- + +**Имя**: Срок кеша сжатия JS/CSS менеджера +**Тип**: String +**По умолчанию**: 3600 +**Доступен в**: только Revolution 2.2.0–2.x + +В 2.x: максимальный возраст браузерного кеша сжатия CSS/JS менеджера, в секундах. diff --git a/ru/building-sites/settings/manager_js_document_root.md b/ru/building-sites/settings/manager_js_document_root.md index 336554709..7f7ff28c6 100644 --- a/ru/building-sites/settings/manager_js_document_root.md +++ b/ru/building-sites/settings/manager_js_document_root.md @@ -1,19 +1,23 @@ --- title: "manager_js_document_root" translation: "building-sites/settings/manager_js_document_root" -description: "Если ваш сервер не обрабатывает серверную переменную DOCUMENT_ROOT, задайте ее здесь явно, чтобы включить сжатие файлов CSS/JS в Менеджере" +description: "Удалено в MODX 3.0. Раньше задавало DOCUMENT_ROOT для сжатия CSS/JS менеджера." --- -- **Имя**: Отладка -- **Тип**: String -- **По умолчанию**: -- **Доступен в**: Revolution 2.2.0+ +**Удалено в MODX 3.0.** Динамическая минификация JS/CSS менеджера и связанные настройки кеша больше не существуют. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Если ваш сервер не обрабатывает серверную переменную `DOCUMENT_ROOT`, задайте ее здесь явно, чтобы включить сжатие файлов CSS/JS в Менеджере. Не меняйте это, если вы не знаете точно, что делаете. +--- + +**Имя**: Document Root для сжатия JS/CSS менеджера +**Тип**: String +**По умолчанию**: (пусто) +**Доступен в**: только Revolution 2.2.0–2.x + +В 2.x: если сервер не отдавал `DOCUMENT_ROOT`, его задавали здесь, чтобы сжатие CSS/JS менеджера работало. -## Посмотрите также +## См. также (2.x) -- PHP Массив [$\_SERVER](https://www.php.net/manual/ru/reserved.variables.server.php) -- [manager_js_cache_file_locking](building-sites/settings/manager_js_cache_file_locking) -- [manager_js_cache_max_age](building-sites/settings/manager_js_cache_max_age) -- [manager_js_zlib_output_compression](building-sites/settings/manager_js_zlib_output_compression) \ No newline at end of file +- PHP [`$_SERVER`](https://www.php.net/manual/ru/reserved.variables.server.php) +- [manager_js_cache_file_locking](building-sites/settings/manager_js_cache_file_locking) +- [manager_js_cache_max_age](building-sites/settings/manager_js_cache_max_age) +- [manager_js_zlib_output_compression](building-sites/settings/manager_js_zlib_output_compression) diff --git a/ru/building-sites/settings/manager_time_format.md b/ru/building-sites/settings/manager_time_format.md index 597fe3e5e..65d21833a 100644 --- a/ru/building-sites/settings/manager_time_format.md +++ b/ru/building-sites/settings/manager_time_format.md @@ -5,8 +5,10 @@ translation: "building-sites/settings/manager_time_format" ## manager_time_format -- **Имя**: Формат времени в панели управления -- **Тип**: String -- **По умолчанию**: `g:i a` +**Name**: Manager Time Format +**Type**: String +**Default**: `H:i` (MODX 3.0+; в ранних 2.x по умолчанию было `g:i a`) -Строка формата в формате PHP `date()` для настроек времени, представленных в менеджере. +Строка формата PHP `date()` для времени в менеджере. + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/preserve_menuindex.md b/ru/building-sites/settings/preserve_menuindex.md index 15134a84b..3a6285887 100644 --- a/ru/building-sites/settings/preserve_menuindex.md +++ b/ru/building-sites/settings/preserve_menuindex.md @@ -1,12 +1,14 @@ --- title: "preserve_menuindex" +description: "При дублировании ресурсов сохранять порядок menuindex" translation: "building-sites/settings/preserve_menuindex" -description: "При дублировании Ресурсов порядок расположения Меню также будет сохранен" --- -- **Имя**: Сохранять индекс Меню при дублировании Ресурсов -- **Тип**: Да/Нет -- **По умолчанию**: Да -- **Доступен в**: Revolution 2.5.0+ +**Name**: Preserve Menu Index When Duplicating Resources +**Type**: Yes/No +**Default**: No (MODX 3.0+; в 2.x было Yes) +**Available In**: Revolution 2.5.0+ -При дублировании Ресурсов порядок расположения Меню также будет сохранен. \ No newline at end of file +Если Yes, при дублировании ресурсов сохраняется и порядок menuindex. + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/server_protocol.md b/ru/building-sites/settings/server_protocol.md index e8bdd01a2..b2574acc7 100644 --- a/ru/building-sites/settings/server_protocol.md +++ b/ru/building-sites/settings/server_protocol.md @@ -5,8 +5,13 @@ translation: "building-sites/settings/server_protocol" ## server_protocol -- **Имя**: Тип сервера -- **Тип**: String -- **По умолчанию**: http +**Удалено в MODX 3.0.** HTTPS настраивайте на веб-сервере / reverse proxy. Список удалённых настроек: [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Если ваш сайт использует защищенное https соединение, укажите это. +--- + +**Имя**: Тип сервера +**Тип**: String +**По умолчанию**: `http` +**Доступен в**: только Revolution 2.x + +В 2.x: сайт на `http` или `https`. diff --git a/ru/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md b/ru/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md index 2dadd92ae..80ad0a0cf 100644 --- a/ru/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md +++ b/ru/extending-modx/custom-manager-pages/modext/modx.util.format.datefromtimestamp.md @@ -5,7 +5,7 @@ translation: "extending-modx/custom-manager-pages/modext/modx.util.format.datefr ## MODx.util.Format.dateFromTimestamp -Доступен в MODX **3.x**. Превращает Unix-время в строку по форматам даты и времени менеджера из системных настроек (`manager_date_format`, `manager_time_format`). +Доступен в MODX **3.0+** (хелперы даты/времени менеджера). Превращает Unix-время в строку по форматам даты и времени менеджера из системных настроек (`manager_date_format`, `manager_time_format`). Вызывайте в сетках и панелях CMP, когда показываете время файлов или другие Unix-метки и хотите тот же вид, что в ядре менеджера. diff --git a/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md b/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md index c0295d667..c01b00727 100644 --- a/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md +++ b/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md @@ -1,50 +1,34 @@ --- title: "Привязка альбома Gallery к конкретному ресурсу" -description: "Как привязать альбом Gallery к ресурсу через TV Listbox и EVAL-binding" +description: "Как привязать альбом Gallery к ресурсу через TV Listbox и @SELECT" translation: "extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource" --- -В Gallery из коробки нет привязки альбомов к ресурсам. Чтобы получить её, создайте Listbox [tv](making-sites-with-modx/customizing-content/template-variables) и используйте [EVAL-binding](making-sites-with-modx/customizing-content/template-variables/bindings/eval-binding) для динамической генерации пунктов списка. +В Gallery из коробки нет привязки альбомов к ресурсам. Сделайте Listbox TV, пункты которого берутся из таблицы альбомов. -Чтобы привязать галерею к конкретному ресурсу, выполните следующие шаги. +Привязки `@EVAL` в MODX 3 удалены. Используйте `@SELECT` (ниже) или [`@SNIPPET`](building-sites/elements/template-variables/bindings/snippet-binding), который возвращает пары `label==id`. -1\. Установите extra [Gallery](https://rtfm.modx.com/extras/revo/gallery/gallery.gallery) +1. Установите Extra [Gallery](extras/gallery). -2\. Создайте несколько галерей и загрузите в них изображения. +2. Создайте альбомы и загрузите изображения. -3\. Создайте чанк, например «galleryDropdownList». +3. Создайте TV типа Listbox с именем `assignedGallery` (single или multi — сколько альбомов нужно на ресурс). -```php -[[+name]]==[[+id]]|| -``` - -4\. Создайте новый [tv](making-sites-with-modx/customizing-content/template-variables) с именем «assignedGallery». **Параметры ввода:** - -Input type = Listbox (single- или multi-, в зависимости от того, сколько галерей вы хотите привязать к ресурсу). - -Input Option Values (скопируйте и вставьте следующий код): - -```php -$output = $modx->runSnippet("GalleryAlbums",array("rowTpl"=>"galleryDropdownList"))."none==0"; return $output; -``` - -Или вместо пунктов 3 и 4 используйте этот Select как Input Option Values (плюс: не нужны @EVAL и чанк): +**Input Option Values** — активные альбомы из таблиц Gallery (если префикс таблиц не `modx_`, поправьте его): ```sql @SELECT GROUP_CONCAT(name, '==', id SEPARATOR '||') FROM `modx_gallery_albums` WHERE active=1 ``` -Default Value: 0 - -Enable Type-Ahead: Yes - -Force Selection to List: Yes +- Default Value: `0` +- Enable Type-Ahead: Yes +- Force Selection to List: Yes -5\. Привяжите TV к шаблонам нужных ресурсов и выберите категорию. Сохраните. +4. Привяжите TV к шаблонам нужных ресурсов. Сохраните. -6\. Откройте целевой ресурс в менеджере, перейдите в Template Variables и найдите ваш TV. Выберите нужный альбом галереи и нажмите Save. +5. Откройте ресурс, вкладка Template Variables, выберите альбом, Save. -7\. В шаблоне страницы разместите следующий код там, где должна выводиться галерея: +6. В шаблоне страницы выведите галерею: ```php [[!Gallery? &album=`[[*assignedGallery]]`]] diff --git a/ru/extras/gridclasskey/index.md b/ru/extras/gridclasskey/index.md index 66f57b65d..cfde586ac 100644 --- a/ru/extras/gridclasskey/index.md +++ b/ru/extras/gridclasskey/index.md @@ -94,7 +94,13 @@ On this example, let's named it "author". ![](authortv.png) -We need a snippet that will list the users from this particular user group, we use [@EVAL binding](making-sites-with-modx/customizing-content/template-variables/bindings/eval-binding) feature for this. +Create a snippet that lists users from that usergroup (next step), then set the TV Input Option Values to: + +```php +@SNIPPET authorListTV +``` + +`@EVAL` bindings are removed in MODX 3. Use [`@SNIPPET`](building-sites/elements/template-variables/bindings/snippet-binding) instead. ##### 3. Create snippet to list the authors on Template Variable's values diff --git a/ru/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md b/ru/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md index 0cd3c877f..f561fba7b 100644 --- a/ru/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md +++ b/ru/extras/migxdb/migxdb.tutorials/create-a-basic-gallery-management-from-scratch-with-migxdb/add-image-tagging.md @@ -45,10 +45,10 @@ Package Name: mygallery На вкладку добавьте поле с fieldname «tags» и inputTVtype «listbox-multiple» -В Input Option Values этого поля укажите: +В Input Option Values этого поля укажите (привязка `@SNIPPET`; `@EVAL` в MODX 3 недоступен): ``` php -@EVAL return $modx->runSnippet('migxLoopCollection',array('classname'=>'mygalTag','sortConfig'=>'[{"sortby":""tag}]','tpl'=>'@CODE:[[+tag]]==[[+id]]','outputSeparator'=>'||')); +@SNIPPET migxLoopCollection {"classname":"mygalTag","sortConfig":"[{\"sortby\":\"tag\"}]","tpl":"@CODE:[[+tag]]==[[+id]]","outputSeparator":"||"} ``` Создайте ещё одно поле с fieldname «newtag» diff --git a/ru/getting-started/maintenance/upgrading/troubleshooting.md b/ru/getting-started/maintenance/upgrading/troubleshooting.md index 355733933..310d2991b 100644 --- a/ru/getting-started/maintenance/upgrading/troubleshooting.md +++ b/ru/getting-started/maintenance/upgrading/troubleshooting.md @@ -24,9 +24,7 @@ translation: "getting-started/maintenance/upgrading/troubleshooting" Очистите кэш браузера. Браузер кэширует JS и CSS Менеджера, и после обновления часто продолжает тянуть старые файлы. (После 2.0.2 это реже: JS-файлы получают префикс версии и после обновления не кэшируются.) -### Пустые страницы Менеджера из-за 400 Bad Request от manager/min/ - -Если раньше min не ломался и вы ставили ACE Extra, проверьте, что файлы из `manager/components/ace/` на месте. +В MODX 3.x менеджер отдаёт готовые asset-бандлы. Пути `manager/min/` больше нет (каталог убрали в 3.0). Если страница пустая после апгрейда, очистите кеш браузера для хоста менеджера и проверьте, что Extra по-прежнему грузит свои файлы из `manager/components/`. ## Проблемы остались? From 3478a774cfd7c85f1291fb645f7ba071fff95d8a Mon Sep 17 00:00:00 2001 From: Ivan Bochkarev Date: Mon, 17 Aug 2026 18:40:23 +0600 Subject: [PATCH 2/4] docs(settings): finish 3.0 default and removed setting pages Sync the remaining changed-default pages (including resource_tree_node_name_fallback) with Revolution 3.x lexicon and defaults, and mark leftover removed-setting pages that still read as live. --- en/building-sites/settings/allow_tv_eval.md | 12 +++++++---- .../settings/automatic_template_assignment.md | 2 ++ .../settings/cache_action_map.md | 16 +++++++-------- .../settings/compress_js_max_files.md | 12 +++++++---- en/building-sites/settings/editor_css_path.md | 15 +++++++++----- .../settings/editor_css_selectors.md | 15 ++++++++++---- en/building-sites/settings/enable_gravatar.md | 4 +++- .../settings/manager_favicon_url.md | 2 +- .../manager_js_zlib_output_compression.md | 12 +++++++---- .../settings/manager_language.md | 13 +++++++++++- .../settings/preserve_menuindex.md | 4 +++- .../resource_tree_node_name_fallback.md | 11 ++++++---- ru/building-sites/settings/allow_tv_eval.md | 16 +++++++++------ .../settings/automatic_template_assignment.md | 8 +++++--- .../settings/cache_action_map.md | 14 ++++++------- .../settings/compress_js_max_files.md | 16 +++++++++------ ru/building-sites/settings/editor_css_path.md | 13 ++++++++---- .../settings/editor_css_selectors.md | 13 ++++++++---- ru/building-sites/settings/enable_gravatar.md | 12 ++++++----- .../settings/manager_favicon_url.md | 10 +++++----- .../manager_js_zlib_output_compression.md | 20 +++++++++++-------- .../settings/manager_language.md | 13 ++++++++---- .../settings/manager_time_format.md | 8 ++++---- .../settings/preserve_menuindex.md | 12 ++++++----- .../resource_tree_node_name_fallback.md | 14 ++++++++----- 25 files changed, 184 insertions(+), 103 deletions(-) diff --git a/en/building-sites/settings/allow_tv_eval.md b/en/building-sites/settings/allow_tv_eval.md index e41d9d8ed..f3fa521e0 100644 --- a/en/building-sites/settings/allow_tv_eval.md +++ b/en/building-sites/settings/allow_tv_eval.md @@ -1,11 +1,15 @@ --- title: "allow_tv_eval" -description: "Select this option to enable or disable eval in TV binding. If this option is set to no, the code/value will just be handled as regular text." +description: "Removed in MODX 3.0. Formerly enabled eval in TV bindings." --- -**Name**: Disable eval in TV binding +**Removed in MODX 3.0.** `@EVAL` TV bindings are gone. Use `@SELECT`, `@SNIPPET`, or other supported bindings instead. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + +--- + +**Name**: Enable eval in TV bindings **Type**: Yes/No **Default**: Yes -**Available In**: Revolution 2.5.0+ +**Available In**: Revolution 2.5.0–2.x only -Select this option to enable or disable eval in TV binding. If this option is set to no, the code/value will just be handled as regular text. \ No newline at end of file +On 2.x: enable or disable eval in TV bindings. When No, the value was treated as plain text. diff --git a/en/building-sites/settings/automatic_template_assignment.md b/en/building-sites/settings/automatic_template_assignment.md index 5c4e5722f..5571b39ba 100644 --- a/en/building-sites/settings/automatic_template_assignment.md +++ b/en/building-sites/settings/automatic_template_assignment.md @@ -3,6 +3,8 @@ title: "automatic_template_assignment" description: "Choose how templates are assigned to new Resources on creation" --- +## automatic_template_assignment + **Name**: Automatic Template Assignment **Type**: String **Default**: `sibling` (MODX 3.0+; was `parent` in earlier 2.x defaults) diff --git a/en/building-sites/settings/cache_action_map.md b/en/building-sites/settings/cache_action_map.md index 2ea9f16e0..d6f58d8ea 100644 --- a/en/building-sites/settings/cache_action_map.md +++ b/en/building-sites/settings/cache_action_map.md @@ -4,15 +4,15 @@ _old_id: "35" _old_uri: "2.x/administering-your-site/settings/system-settings/cache_action_map" --- -## cache\_action\_map +## cache_action_map - **Name**: Enable Action Map Cache -**Type**: Yes/No -**Default**: Yes +**Removed in MODX 3.0.** The action map is gone with `modAction`. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). - When enabled, actions (or controller maps) will be cached to greatly reduce manager page load times. +--- -## See Also +**Name**: Enable Action Map Cache +**Type**: Yes/No +**Default**: Yes +**Available In**: Revolution 2.x only -- **modmanagerrequest.class.php** `modManagerRequest::loadActionMap()` function -- `$modx->actionMap array` \ No newline at end of file +On 2.x: when enabled, controller action maps were cached to speed up Manager page loads. diff --git a/en/building-sites/settings/compress_js_max_files.md b/en/building-sites/settings/compress_js_max_files.md index 1640e3ee2..8fe8ec7b6 100644 --- a/en/building-sites/settings/compress_js_max_files.md +++ b/en/building-sites/settings/compress_js_max_files.md @@ -1,11 +1,15 @@ --- title: "compress_js_max_files" -description: "The maximum number of JavaScript files MODX will attempt to compress at once" +description: "Removed in MODX 3.0. Formerly the JS compression file threshold for the Manager." +--- + +**Removed in MODX 3.0.** Dynamic Manager JS/CSS minification and related settings are gone. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + --- **Name**: Maximum JavaScript Files Compression Threshold **Type**: String -**Default**: 10 -**Available In**: Revolution 2.2.0+ +**Default**: 10 +**Available In**: Revolution 2.2.0–2.x only -The maximum number of JavaScript files MODX will attempt to compress at once when [compress_js](building-sites/settings/compress_js) is on. Set to a lower number if you are experiencing issues with Google Minify in the manager. \ No newline at end of file +On 2.x: maximum number of JavaScript files MODX would compress at once when [compress_js](building-sites/settings/compress_js) was on. diff --git a/en/building-sites/settings/editor_css_path.md b/en/building-sites/settings/editor_css_path.md index 12179b8bb..9173962be 100644 --- a/en/building-sites/settings/editor_css_path.md +++ b/en/building-sites/settings/editor_css_path.md @@ -4,10 +4,15 @@ _old_id: "101" _old_uri: "2.x/administering-your-site/settings/system-settings/editor_css_path" --- -## editor\_css\_path +## editor_css_path -**Name**: Path to CSS file -**Type**: String -**Default**: +**Removed in MODX 3.0.** Core no longer ships this setting. TinyMCE or other editor Extras may still need their own CSS path configuration. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). -The path to your CSS file that you wish to use within the editor. The best way to enter the path is to enter the path from the root of your server, for example: /assets/site/style.css. If you do not wish to load a style sheet into the editor, leave this field blank. +--- + +**Name**: Path to CSS file +**Type**: String +**Default**: (empty) +**Available In**: Revolution 2.x only + +On 2.x: path to a CSS file for the rich-text editor, usually from the server root (for example `/assets/site/style.css`). diff --git a/en/building-sites/settings/editor_css_selectors.md b/en/building-sites/settings/editor_css_selectors.md index a00b9611c..4d3406b3d 100644 --- a/en/building-sites/settings/editor_css_selectors.md +++ b/en/building-sites/settings/editor_css_selectors.md @@ -4,8 +4,15 @@ _old_id: "102" _old_uri: "2.x/administering-your-site/settings/system-settings/editor_css_selectors" --- -## editor\_css\_selectors +## editor_css_selectors -**Name**: CSS Selectors for Editor -**Type**: String -**Default**: +**Removed in MODX 3.0.** Core no longer ships this setting. Configure CSS selectors in the editor Extra if it still needs them. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + +--- + +**Name**: CSS Selectors for Editor +**Type**: String +**Default**: (empty) +**Available In**: Revolution 2.x only + +On 2.x: comma-separated CSS selectors for the rich-text editor. diff --git a/en/building-sites/settings/enable_gravatar.md b/en/building-sites/settings/enable_gravatar.md index 0d8e933be..a2a078623 100644 --- a/en/building-sites/settings/enable_gravatar.md +++ b/en/building-sites/settings/enable_gravatar.md @@ -3,11 +3,13 @@ title: "enable_gravatar" description: "Enable Gravatar usage" --- +## enable_gravatar + **Name**: Enable Gravatar **Type**: Yes/No **Default**: No (MODX 3.0+ for new installs; was Yes in 2.x) **Available In**: Revolution 2.3.1+ -When Yes, Gravatar supplies the profile image if the user has no uploaded photo. +If enabled, Gravatar is used as the profile image when the user has no uploaded photo. See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/manager_favicon_url.md b/en/building-sites/settings/manager_favicon_url.md index 6038b3ccb..f39ee673b 100644 --- a/en/building-sites/settings/manager_favicon_url.md +++ b/en/building-sites/settings/manager_favicon_url.md @@ -11,6 +11,6 @@ _old_uri: "2.x/administering-your-site/settings/system-settings/manager_favicon_ **Default**: `favicon.ico` (MODX 3.0+; earlier defaults were often empty) **Available In**: 2.1+ -URL of the favicon for the MODX Manager. Relative to the `manager/` directory, or an absolute URL. +If set, MODX loads this URL as the Manager favicon. Use a path relative to the `manager/` directory, or an absolute URL. See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/manager_js_zlib_output_compression.md b/en/building-sites/settings/manager_js_zlib_output_compression.md index 5ebb45438..cac01a884 100644 --- a/en/building-sites/settings/manager_js_zlib_output_compression.md +++ b/en/building-sites/settings/manager_js_zlib_output_compression.md @@ -1,11 +1,15 @@ --- title: "manager_js_zlib_output_compression" -description: "Whether or not to enable zlib output compression for compressed CSS/JS in the manager" +description: "Removed in MODX 3.0. Formerly enabled zlib output compression for Manager CSS/JS." +--- + +**Removed in MODX 3.0.** Dynamic Manager JS/CSS minification and related settings are gone. See [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + --- **Name**: Enable zlib Output Compression for Manager JS/CSS **Type**: Yes/No -**Default**: No -**Available In**: Revolution 2.2.0+ +**Default**: No +**Available In**: Revolution 2.2.0–2.x only -Whether or not to enable zlib output compression for compressed CSS/JS in the manager. Do not turn this on unless you are sure the PHP config variable `zlib.output_compression` can be set to 1. MODX recommends leaving it off. \ No newline at end of file +On 2.x: zlib output compression for compressed Manager CSS/JS. Leave off unless you know `zlib.output_compression` can be set to 1. diff --git a/en/building-sites/settings/manager_language.md b/en/building-sites/settings/manager_language.md index e7fd349b6..c8c91bc43 100644 --- a/en/building-sites/settings/manager_language.md +++ b/en/building-sites/settings/manager_language.md @@ -4,4 +4,15 @@ _old_id: "192" _old_uri: "2.x/administering-your-site/settings/system-settings/manager_language" --- -The `manager_language` setting was removed in MODX 3.0. [Learn more.](getting-started/maintenance/upgrading/3.0/manager-language) +## manager_language + +**Removed in MODX 3.0.** Language detection and on-the-fly switching replaced this setting. [Learn more about the Manager language in 3.0](getting-started/maintenance/upgrading/3.0/manager-language). Also listed under [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). + +--- + +**Name**: Manager Language +**Type**: String +**Default**: `en` +**Available In**: Revolution 2.x only + +On 2.x: Manager UI language. Could override `cultureKey` for the `mgr` context. diff --git a/en/building-sites/settings/preserve_menuindex.md b/en/building-sites/settings/preserve_menuindex.md index 3ed6de390..648502557 100644 --- a/en/building-sites/settings/preserve_menuindex.md +++ b/en/building-sites/settings/preserve_menuindex.md @@ -3,11 +3,13 @@ title: "preserve_menuindex" description: "When duplicating Resources, keep the menu index order" --- +## preserve_menuindex + **Name**: Preserve Menu Index When Duplicating Resources **Type**: Yes/No **Default**: No (MODX 3.0+; was Yes in 2.x) **Available In**: Revolution 2.5.0+ -When Yes, duplicating Resources also keeps their menu index order. +When duplicating Resources, the menu index order is preserved. See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/en/building-sites/settings/resource_tree_node_name_fallback.md b/en/building-sites/settings/resource_tree_node_name_fallback.md index 636f8cf1c..989e8085b 100644 --- a/en/building-sites/settings/resource_tree_node_name_fallback.md +++ b/en/building-sites/settings/resource_tree_node_name_fallback.md @@ -1,11 +1,14 @@ --- title: "resource_tree_node_name_fallback" -description: "Specify the Resource field to use as fallback when rendering the nodes in the Resource Tree" +description: "Resource field used as fallback when rendering nodes in the Resource Tree" --- +## resource_tree_node_name_fallback -**Name**: Resource Tree Node Fallback Field +**Name**: Resource Tree Node Fallback Field **Type**: String -**Default**: pagetitle +**Default**: `alias` (MODX 3.0+; was `pagetitle` in earlier 2.x defaults) -Specify the Resource field to use as fallback when rendering the nodes in the Resource Tree. This will be used if the resource has an empty value for the configured Resource Tree Node Field. \ No newline at end of file +Resource field used as fallback when rendering nodes in the Resource Tree, if the configured Resource Tree Node Field is empty. + +See also [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/allow_tv_eval.md b/ru/building-sites/settings/allow_tv_eval.md index 2cb7be512..1d1ac0ce6 100644 --- a/ru/building-sites/settings/allow_tv_eval.md +++ b/ru/building-sites/settings/allow_tv_eval.md @@ -1,12 +1,16 @@ --- title: "allow_tv_eval" translation: "building-sites/settings/allow_tv_eval" -description: "Выберите этот параметр, чтобы разрешить исполнение кода в TV" +description: "Удалено в MODX 3.0. Раньше разрешало исполнение кода в TV." --- -- **Имя**: Разрешить исполнение кода в TV -- **Тип**: Да/Нет -- **По умолчанию**: Да -- **Доступен в**: Revolution 2.5.0+ +**Удалено в MODX 3.0.** Привязки `@EVAL` у TV больше нет. Используйте `@SELECT`, `@SNIPPET` или другие поддерживаемые привязки. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Выберите этот параметр, чтобы разрешить исполнение кода в TV. Если выбрано «Нет», код или значение обработается как обычный текст. \ No newline at end of file +--- + +**Имя**: Разрешить исполнение кода в TV +**Тип**: Да/Нет +**По умолчанию**: Да +**Доступен в**: только Revolution 2.5.0–2.x + +В 2.x: включать или отключать eval в привязках TV. При «Нет» значение обрабатывалось как обычный текст. diff --git a/ru/building-sites/settings/automatic_template_assignment.md b/ru/building-sites/settings/automatic_template_assignment.md index beb3fb3bf..5935b54cd 100644 --- a/ru/building-sites/settings/automatic_template_assignment.md +++ b/ru/building-sites/settings/automatic_template_assignment.md @@ -4,9 +4,11 @@ description: "Как назначается шаблон новым ресурс translation: "building-sites/settings/automatic_template_assignment" --- -**Name**: Automatic Template Assignment -**Type**: String -**Default**: `sibling` (MODX 3.0+; в ранних 2.x по умолчанию было `parent`) +## automatic_template_assignment + +**Имя**: Автоматическое присвоение шаблона +**Тип**: String +**По умолчанию**: `sibling` (MODX 3.0+; в ранних 2.x было `parent`) Как назначается шаблон новым ресурсам при создании: diff --git a/ru/building-sites/settings/cache_action_map.md b/ru/building-sites/settings/cache_action_map.md index 7c2c142cc..f1e6ea64d 100644 --- a/ru/building-sites/settings/cache_action_map.md +++ b/ru/building-sites/settings/cache_action_map.md @@ -5,13 +5,13 @@ translation: "building-sites/settings/cache_action_map" ## cache_action_map -- **Имя**: Включить кэширование карты действий -- **Тип**: Да/Нет -- **По умолчанию**: Да +**Удалено в MODX 3.0.** Карта действий исчезла вместе с `modAction`. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Когда включено, действия (или карты контроллера) будут кэшироваться, чтобы значительно сократить время загрузки страницы менеджера. +--- -## Посмотрите также +**Имя**: Включить кэширование карты действий +**Тип**: Да/Нет +**По умолчанию**: Да +**Доступен в**: только Revolution 2.x -- **modmanagerrequest.class.php** `modManagerRequest::loadActionMap()` функция -- `$modx->actionMap array` +В 2.x: при включении карты контроллеров кэшировались, чтобы быстрее грузить страницы менеджера. diff --git a/ru/building-sites/settings/compress_js_max_files.md b/ru/building-sites/settings/compress_js_max_files.md index ed4d37b75..6ddc6de5b 100644 --- a/ru/building-sites/settings/compress_js_max_files.md +++ b/ru/building-sites/settings/compress_js_max_files.md @@ -1,12 +1,16 @@ --- title: "compress_js_max_files" translation: "building-sites/settings/compress_js_max_files" -description: "Максимальное количество файлов JavaScript, которые MODX будет пытаться сжать за один раз, когда включен compress_js" +description: "Удалено в MODX 3.0. Раньше задавало порог сжатия JS-файлов менеджера." --- -- **Имя**: Максимальный порог сжатия файлов JavaScript -- **Тип**: String -- **По умолчанию**: 10 -- **Доступен в**: Revolution 2.2.0+ +**Удалено в MODX 3.0.** Динамическая минификация JS/CSS менеджера и связанные настройки больше не существуют. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Максимальное количество файлов JavaScript, которые MODX будет пытаться сжать за один раз, когда включен [compress_js](building-sites/settings/compress_js). Установите меньшее значение, если у вас возникли проблемы с Google Minify в Менеджере. \ No newline at end of file +--- + +**Имя**: Максимальный порог сжатия файлов JavaScript +**Тип**: String +**По умолчанию**: 10 +**Доступен в**: только Revolution 2.2.0–2.x + +В 2.x: сколько JS-файлов MODX пытался сжать за раз при включённом [compress_js](building-sites/settings/compress_js). diff --git a/ru/building-sites/settings/editor_css_path.md b/ru/building-sites/settings/editor_css_path.md index 2990f9790..54f7de4e2 100644 --- a/ru/building-sites/settings/editor_css_path.md +++ b/ru/building-sites/settings/editor_css_path.md @@ -5,8 +5,13 @@ translation: "building-sites/settings/editor_css_path" ## editor_css_path -- **Имя**: Путь к CSS-файлу -- **Тип**: String -- **По умолчанию**: +**Удалено в MODX 3.0.** В ядре этой настройки больше нет. TinyMCE и другие редакторы могут задавать путь к CSS сами. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Путь к вашему файлу CSS, который вы хотите использовать в редакторе. Лучший способ ввести путь - это ввести путь от корня вашего сервера, например: /assets/site/style.css. Если вы не хотите загружать таблицу стилей в редактор, оставьте это поле пустым. +--- + +**Имя**: Путь к CSS-файлу +**Тип**: String +**По умолчанию**: (пусто) +**Доступен в**: только Revolution 2.x + +В 2.x: путь к CSS для rich-text редактора, обычно от корня сервера (например `/assets/site/style.css`). diff --git a/ru/building-sites/settings/editor_css_selectors.md b/ru/building-sites/settings/editor_css_selectors.md index e8ff7de24..a3d4360b1 100644 --- a/ru/building-sites/settings/editor_css_selectors.md +++ b/ru/building-sites/settings/editor_css_selectors.md @@ -5,8 +5,13 @@ translation: "building-sites/settings/editor_css_selectors" ## editor_css_selectors -- **Имя**: CSS-селекторы для текстового редактора -- **Тип**: String -- **По умолчанию**: +**Удалено в MODX 3.0.** В ядре этой настройки больше нет. Селекторы задавайте в Extra редактора, если они ещё нужны. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Разделенный запятыми список CSS-селекторов для текстового редактора +--- + +**Имя**: CSS-селекторы для текстового редактора +**Тип**: String +**По умолчанию**: (пусто) +**Доступен в**: только Revolution 2.x + +В 2.x: список CSS-селекторов для редактора через запятую. diff --git a/ru/building-sites/settings/enable_gravatar.md b/ru/building-sites/settings/enable_gravatar.md index 6a2090bdd..b37403436 100644 --- a/ru/building-sites/settings/enable_gravatar.md +++ b/ru/building-sites/settings/enable_gravatar.md @@ -4,11 +4,13 @@ description: "Включение Gravatar" translation: "building-sites/settings/enable_gravatar" --- -**Name**: Enable Gravatar -**Type**: Yes/No -**Default**: No (MODX 3.0+ на новых установках; в 2.x было Yes) -**Available In**: Revolution 2.3.1+ +## enable_gravatar -Если Yes, Gravatar подставляет фото профиля, когда у пользователя нет загруженного аватара. +**Имя**: Использовать Gravatar +**Тип**: Да/Нет +**По умолчанию**: Нет (MODX 3.0+ на новых установках; в 2.x было Да) +**Доступен в**: Revolution 2.3.1+ + +Если включено, фото из Gravatar подставляется как иконка профиля, когда у пользователя нет своего аватара. См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/manager_favicon_url.md b/ru/building-sites/settings/manager_favicon_url.md index 13bc65961..40a456f86 100644 --- a/ru/building-sites/settings/manager_favicon_url.md +++ b/ru/building-sites/settings/manager_favicon_url.md @@ -5,11 +5,11 @@ translation: "building-sites/settings/manager_favicon_url" ## manager_favicon_url -**Name**: Manager Favicon URL -**Type**: Textfield -**Default**: `favicon.ico` (MODX 3.0+; раньше часто оставляли пустым) -**Available In**: 2.1+ +**Имя**: URL фавиконки системы управления +**Тип**: Textfield +**По умолчанию**: `favicon.ico` (MODX 3.0+; раньше часто оставляли пустым) +**Доступен в**: 2.1+ -URL favicon для менеджера MODX. Относительный путь от каталога `manager/` или абсолютный URL. +Если задано, MODX подставляет этот URL как favicon менеджера. Путь относительно каталога `manager/` или абсолютный URL. См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/manager_js_zlib_output_compression.md b/ru/building-sites/settings/manager_js_zlib_output_compression.md index fa0b2e03f..a20249bae 100644 --- a/ru/building-sites/settings/manager_js_zlib_output_compression.md +++ b/ru/building-sites/settings/manager_js_zlib_output_compression.md @@ -1,12 +1,16 @@ --- -title: "manager_js_cache_max_age" -translation: "building-sites/settings/manager_js_cache_max_age" -description: "Следует ли включать zlib сжатие для вывода сжатых CSS/JS файлов в Менеджере" +title: "manager_js_zlib_output_compression" +translation: "building-sites/settings/manager_js_zlib_output_compression" +description: "Удалено в MODX 3.0. Раньше включало zlib-сжатие вывода CSS/JS менеджера." --- -- **Имя**: Включить zlib сжатие вывода файлов JS/CSS для Менеджера -- **Тип**: Да/Нет -- **По умолчанию**: Нет -- **Доступен в**: Revolution 2.2.0+ +**Удалено в MODX 3.0.** Динамическая минификация JS/CSS менеджера и связанные настройки больше не существуют. См. [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Следует ли включать zlib сжатие для вывода сжатых CSS/JS файлов в Менеджере. Не включайте это, если вы не уверены, что конфигурационная переменная PHP `zlib.output_compression` может быть установлена в 1. MODX рекомендует оставить ее выключенной. \ No newline at end of file +--- + +**Имя**: Включить zlib сжатие вывода файлов JS/CSS для Менеджера +**Тип**: Да/Нет +**По умолчанию**: Нет +**Доступен в**: только Revolution 2.2.0–2.x + +В 2.x: zlib-сжатие вывода сжатых CSS/JS менеджера. Не включайте, если не уверены, что `zlib.output_compression` можно поставить в 1. diff --git a/ru/building-sites/settings/manager_language.md b/ru/building-sites/settings/manager_language.md index 5c7a39952..84dd78a20 100644 --- a/ru/building-sites/settings/manager_language.md +++ b/ru/building-sites/settings/manager_language.md @@ -5,8 +5,13 @@ translation: "building-sites/settings/manager_language" ## manager_language -- **Имя**:Язык панели управления -- **Тип**: String -- **По умолчанию**: en +**Удалено в MODX 3.0.** Вместо этой настройки работают автоопределение языка и переключение на лету. [Язык менеджера в 3.0](getting-started/upgrading-to-3.0/manager-language). Также в списке [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). -Язык интерфейса диспетчера MODX. Это переопределит любую настройку cultureKey для контекста mgr. +--- + +**Имя**: Язык панели управления +**Тип**: String +**По умолчанию**: `en` +**Доступен в**: только Revolution 2.x + +В 2.x: язык интерфейса менеджера. Мог переопределять `cultureKey` для контекста `mgr`. diff --git a/ru/building-sites/settings/manager_time_format.md b/ru/building-sites/settings/manager_time_format.md index 65d21833a..f7481bb05 100644 --- a/ru/building-sites/settings/manager_time_format.md +++ b/ru/building-sites/settings/manager_time_format.md @@ -5,10 +5,10 @@ translation: "building-sites/settings/manager_time_format" ## manager_time_format -**Name**: Manager Time Format -**Type**: String -**Default**: `H:i` (MODX 3.0+; в ранних 2.x по умолчанию было `g:i a`) +**Имя**: Формат времени в системе управления +**Тип**: String +**По умолчанию**: `H:i` (MODX 3.0+; в ранних 2.x было `g:i a`) -Строка формата PHP `date()` для времени в менеджере. +Строка в формате PHP `date()` для времени в менеджере. См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/preserve_menuindex.md b/ru/building-sites/settings/preserve_menuindex.md index 3a6285887..52d09ebf7 100644 --- a/ru/building-sites/settings/preserve_menuindex.md +++ b/ru/building-sites/settings/preserve_menuindex.md @@ -4,11 +4,13 @@ description: "При дублировании ресурсов сохранят translation: "building-sites/settings/preserve_menuindex" --- -**Name**: Preserve Menu Index When Duplicating Resources -**Type**: Yes/No -**Default**: No (MODX 3.0+; в 2.x было Yes) -**Available In**: Revolution 2.5.0+ +## preserve_menuindex -Если Yes, при дублировании ресурсов сохраняется и порядок menuindex. +**Имя**: Сохранять индекс меню при дублировании ресурсов +**Тип**: Да/Нет +**По умолчанию**: Нет (MODX 3.0+; в 2.x было Да) +**Доступен в**: Revolution 2.5.0+ + +При дублировании ресурсов сохраняется и порядок menuindex. См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). diff --git a/ru/building-sites/settings/resource_tree_node_name_fallback.md b/ru/building-sites/settings/resource_tree_node_name_fallback.md index 4cb2efd50..2f5fe3d19 100644 --- a/ru/building-sites/settings/resource_tree_node_name_fallback.md +++ b/ru/building-sites/settings/resource_tree_node_name_fallback.md @@ -1,11 +1,15 @@ --- title: "resource_tree_node_name_fallback" translation: "building-sites/settings/resource_tree_node_name_fallback" -description: "Укажите поле Ресурса для использования в качестве запасного названия узла в Дереве ресурсов" +description: "Поле ресурса для запасного названия узла в дереве ресурсов" --- -- **Имя**: Запасное поле для узла в дереве ресурсов -- **Тип**: String -- **По умолчанию**: pagetitle +## resource_tree_node_name_fallback -Укажите поле Ресурса для использования в качестве запасного названия узла в Дереве ресурсов. Это значение будет использоваться, если Ресурс имеет пустое значение для заданного поля Ресурса в Дереве. \ No newline at end of file +**Имя**: Запасное поле для узла в дереве ресурсов +**Тип**: String +**По умолчанию**: `alias` (MODX 3.0+; в ранних 2.x было `pagetitle`) + +Поле ресурса для запасного названия узла в дереве, если у ресурса пустое значение в основном поле узла. + +См. также [Изменения системных настроек в 3.0](getting-started/upgrading-to-3.0/system-settings). From 899affa877aa41f30507967470a2b1bdac77202a Mon Sep 17 00:00:00 2001 From: Ivan Bochkarev Date: Mon, 17 Aug 2026 18:40:40 +0600 Subject: [PATCH 3/4] docs(settings): fix manager_language upgrade link path --- en/building-sites/settings/manager_language.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/building-sites/settings/manager_language.md b/en/building-sites/settings/manager_language.md index c8c91bc43..cd2537fb3 100644 --- a/en/building-sites/settings/manager_language.md +++ b/en/building-sites/settings/manager_language.md @@ -6,7 +6,7 @@ _old_uri: "2.x/administering-your-site/settings/system-settings/manager_language ## manager_language -**Removed in MODX 3.0.** Language detection and on-the-fly switching replaced this setting. [Learn more about the Manager language in 3.0](getting-started/maintenance/upgrading/3.0/manager-language). Also listed under [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). +**Removed in MODX 3.0.** Language detection and on-the-fly switching replaced this setting. [Learn more about the Manager language in 3.0](getting-started/upgrading-to-3.0/manager-language). Also listed under [System Settings changes in 3.0](getting-started/upgrading-to-3.0/system-settings). --- From 2d7024bb671f480db98d192b0b4c40e5d5f03517 Mon Sep 17 00:00:00 2001 From: Ivan Bochkarev Date: Mon, 17 Aug 2026 18:41:30 +0600 Subject: [PATCH 4/4] docs(gallery): fix MD029 ordered list numbering after code block --- .../assinging-a-gallery-album-to-a-specifc-resource.md | 6 +++--- .../assinging-a-gallery-album-to-a-specifc-resource.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md b/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md index 7e28b7b98..2a5092aa0 100644 --- a/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md +++ b/en/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md @@ -24,11 +24,11 @@ Gallery does not assign albums to Resources out of the box. Use a Listbox TV who - Enable Type-Ahead: Yes - Force Selection to List: Yes -4. Assign the TV to the templates that should pick an album. Save. +1. Assign the TV to the templates that should pick an album. Save. -5. Edit a Resource, open Template Variables, choose the album, Save. +2. Edit a Resource, open Template Variables, choose the album, Save. -6. In the page Template, render the album: +3. In the page Template, render the album: ```php [[!Gallery? &album=`[[*assignedGallery]]`]] diff --git a/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md b/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md index c01b00727..bfa9112d3 100644 --- a/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md +++ b/ru/extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-resource.md @@ -24,11 +24,11 @@ translation: "extras/gallery/gallery/assinging-a-gallery-album-to-a-specifc-reso - Enable Type-Ahead: Yes - Force Selection to List: Yes -4. Привяжите TV к шаблонам нужных ресурсов. Сохраните. +1. Привяжите TV к шаблонам нужных ресурсов. Сохраните. -5. Откройте ресурс, вкладка Template Variables, выберите альбом, Save. +2. Откройте ресурс, вкладка Template Variables, выберите альбом, Save. -6. В шаблоне страницы выведите галерею: +3. В шаблоне страницы выведите галерею: ```php [[!Gallery? &album=`[[*assignedGallery]]`]]