diff --git a/en/building-sites/client-proofing/security/policies/permissions/administrator-policy.md b/en/building-sites/client-proofing/security/policies/permissions/administrator-policy.md index f767682e1..df8969fe7 100644 --- a/en/building-sites/client-proofing/security/policies/permissions/administrator-policy.md +++ b/en/building-sites/client-proofing/security/policies/permissions/administrator-policy.md @@ -70,6 +70,7 @@ This policy is packaged into MODX and is given to users on the 'mgr' context who | new\_chunk | To create a new [Chunk](building-sites/elements/chunks "Chunks"). | | new\_context | To create a new [Context](building-sites/contexts "Contexts"). | | new\_document | To create a new [Resources](building-sites/resources "Resources"). | +| new\_document\_in\_root | To create a [Resource](building-sites/resources "Resources") at the site root. Replaces the removed `udperms_allowroot` setting. | | new\_plugin | To create a new [Plugin](extending-modx/plugins "Plugins"). | | new\_role | To create a new [Role](building-sites/client-proofing/security/roles "Roles"). | | new\_snippet | To create a new [Snippet](extending-modx/snippets "Snippets"). | diff --git a/en/building-sites/resources/custom-resources.md b/en/building-sites/resources/custom-resources.md index bb2683aee..defe6a0c6 100644 --- a/en/building-sites/resources/custom-resources.md +++ b/en/building-sites/resources/custom-resources.md @@ -31,6 +31,8 @@ CRCs look like normal Resources in the tree. The CRC class can also hook into th CRCs can have their Controllers, Processors and main rendering functionality extended and overridden. You can, for example, automatically append text to the output of any CRC's content by overriding the process() or getContent() method of the CRC in the PHP class. Any method in the modResource class is available to be overridden when using CRCs. +On MODX 3, a CRC create or update processor must extend `\MODX\Revolution\Processors\Resource\Create` or `Update`. The old `modResourceCreateProcessor` and `modResourceUpdateProcessor` names are aliases until 3.3. The 2.x processor files under `core/model/modx/processors/resource/` are gone. See [Step 4: Customizing the Processors](extending-modx/custom-resources/step-4-processors) and [Processors in the 3.0 upgrade notes](getting-started/upgrading-to-3.0/processors). + ## Creating a CRC Please follow the tutorial on [Creating a Resource Class](extending-modx/custom-resources "Creating a Resource Class"). diff --git a/en/building-sites/settings/index.md b/en/building-sites/settings/index.md index f1f736ea8..4f9e5f8c8 100644 --- a/en/building-sites/settings/index.md +++ b/en/building-sites/settings/index.md @@ -354,116 +354,119 @@ A description of each setting follows: 140. [manager_login_url_alternate](building-sites/settings/manager_login_url_alternate) 141. [manager_theme](building-sites/settings/manager_theme) 142. [manager_time_format](building-sites/settings/manager_time_format) -143. [manager_use_fullname](building-sites/settings/manager_use_fullname) -144. [manager_week_start](building-sites/settings/manager_week_start) -145. [mgr_source_icon](building-sites/settings/mgr_source_icon) -146. [mgr_tree_icon_context](building-sites/settings/mgr_tree_icon_context) -147. [modx_browser_default_sort](building-sites/settings/modx_browser_default_sort) -148. [modx_browser_default_viewmode](building-sites/settings/modx_browser_default_viewmode) -149. [modx_browser_tree_hide_files](building-sites/settings/modx_browser_tree_hide_files) -150. [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips) -151. [modx_charset](building-sites/settings/modx_charset) -152. [new_file_permissions](building-sites/settings/new_file_permissions) -153. [new_folder_permissions](building-sites/settings/new_folder_permissions) -154. [parser_recurse_uncacheable](building-sites/settings/parser_recurse_uncacheable) -155. [password_generated_length](building-sites/settings/password_generated_length) -156. [password_min_length](building-sites/settings/password_min_length) -157. [phpthumb_allow_src_above_docroot](building-sites/settings/phpthumb_allow_src_above_docroot) -158. [phpthumb_cache_maxage](building-sites/settings/phpthumb_cache_maxage) -159. [phpthumb_cache_maxfiles](building-sites/settings/phpthumb_cache_maxfiles) -160. [phpthumb_cache_maxsize](building-sites/settings/phpthumb_cache_maxsize) -161. [phpthumb_cache_source_enabled](building-sites/settings/phpthumb_cache_source_enabled) -162. [phpthumb_document_root](building-sites/settings/phpthumb_document_root) -163. [phpthumb_error_bgcolor](building-sites/settings/phpthumb_error_bgcolor) -164. [phpthumb_error_fontsize](building-sites/settings/phpthumb_error_fontsize) -165. [phpthumb_error_textcolor](building-sites/settings/phpthumb_error_textcolor) -166. [phpthumb_far](building-sites/settings/phpthumb_far) -167. [phpthumb_imagemagick_path](building-sites/settings/phpthumb_imagemagick_path) -168. [phpthumb_nohotlink_enabled](building-sites/settings/phpthumb_nohotlink_enabled) -169. [phpthumb_nohotlink_erase_image](building-sites/settings/phpthumb_nohotlink_erase_image) -170. [phpthumb_nohotlink_text_message](building-sites/settings/phpthumb_nohotlink_text_message) -171. [phpthumb_nohotlink_valid_domains](building-sites/settings/phpthumb_nohotlink_valid_domains) -172. [phpthumb_nooffsitelink_enabled](building-sites/settings/phpthumb_nooffsitelink_enabled) -173. [phpthumb_nooffsitelink_erase_image](building-sites/settings/phpthumb_nooffsitelink_erase_image) -174. [phpthumb_nooffsitelink_require_refer](building-sites/settings/phpthumb_nooffsitelink_require_refer) -175. [phpthumb_nooffsitelink_text_message](building-sites/settings/phpthumb_nooffsitelink_text_message) -176. [phpthumb_nooffsitelink_valid_domains](building-sites/settings/phpthumb_nooffsitelink_valid_domains) -177. [phpthumb_nooffsitelink_watermark_src](building-sites/settings/phpthumb_nooffsitelink_watermark_src) -178. [phpthumb_zoomcrop](building-sites/settings/phpthumb_zoomcrop) -179. [preserve_menuindex](building-sites/settings/preserve_menuindex) -180. [principal_targets](building-sites/settings/principal_targets) -181. [proxy_auth_type](building-sites/settings/proxy_auth_type) -182. [proxy_host](building-sites/settings/proxy_host) -183. [proxy_password](building-sites/settings/proxy_password) -184. [proxy_port](building-sites/settings/proxy_port) -185. [proxy_username](building-sites/settings/proxy_username) -186. [publish_default](building-sites/settings/publish_default) -187. [rb_base_dir](building-sites/settings/rb_base_dir) -188. [rb_base_url](building-sites/settings/rb_base_url) -189. [request_controller](building-sites/settings/request_controller) -190. [request_method_strict](building-sites/settings/request_method_strict) -191. [request_param_alias](building-sites/settings/request_param_alias) -192. [request_param_id](building-sites/settings/request_param_id) -193. [resource_tree_node_name](building-sites/settings/resource_tree_node_name) -194. [resource_tree_node_name_fallback](building-sites/settings/resource_tree_node_name_fallback) -195. [resource_tree_node_tooltip](building-sites/settings/resource_tree_node_tooltip) -196. [richtext_default](building-sites/settings/richtext_default) -197. [search_default](building-sites/settings/search_default) -198. [send_poweredby_header](building-sites/settings/send_poweredby_header) -199. [server_offset_time](building-sites/settings/server_offset_time) -200. [server_protocol](building-sites/settings/server_protocol) -201. [session_cookie_domain](building-sites/settings/session_cookie_domain) -202. [session_cookie_httponly](building-sites/settings/session_cookie_httponly) -203. [session_cookie_lifetime](building-sites/settings/session_cookie_lifetime) -204. [session_cookie_path](building-sites/settings/session_cookie_path) -205. [session_cookie_secure](building-sites/settings/session_cookie_secure) -206. [session_enabled](building-sites/settings/session_enabled) -207. [session_gc_maxlifetime](building-sites/settings/session_gc_maxlifetime) -208. [session_handler_class](building-sites/settings/session_handler_class) -209. [session_name](building-sites/settings/session_name) -210. [settings_version](building-sites/settings/settings_version) -211. [setting_static_elements_basepath](building-sites/settings/setting_static_elements_basepath) -212. [show_tv_categories_header](building-sites/settings/show_tv_categories_header) -213. [signupemail_message](building-sites/settings/signupemail_message) -214. [site_name](building-sites/settings/site_name) -215. [site_start](building-sites/settings/site_start) -216. [site_status](building-sites/settings/site_status) -217. [site_unavailable_message](building-sites/settings/site_unavailable_message) -218. [site_unavailable_page](building-sites/settings/site_unavailable_page) -219. [static_elements_automate_chunks](building-sites/settings/static_elements_automate_chunks) -220. [static_elements_automate_plugins](building-sites/settings/static_elements_automate_plugins) -221. [static_elements_automate_snippets](building-sites/settings/static_elements_automate_snippets) -222. [static_elements_automate_templates](building-sites/settings/static_elements_automate_templates) -223. [static_elements_automate_tvs](building-sites/settings/static_elements_automate_tvs) -224. [static_elements_basepath](building-sites/settings/static_elements_basepath) -225. [static_elements_default_category](building-sites/settings/static_elements_default_category) -226. [static_elements_default_mediasource](building-sites/settings/static_elements_default_mediasource) -227. [strip_image_paths](building-sites/settings/strip_image_paths) -228. [symlink_merge_fields](building-sites/settings/symlink_merge_fields) -229. [syncsite_default](building-sites/settings/syncsite_default) -230. [tree_default_sort](building-sites/settings/tree_default_sort) -231. [tree_root_id](building-sites/settings/tree_root_id) -232. [tvs_below_content](building-sites/settings/tvs_below_content) -233. [udperms_allowroot](building-sites/settings/udperms_allowroot) -234. [ui_debug_mode](building-sites/settings/ui_debug_mode) -235. [unauthorized_page](building-sites/settings/unauthorized_page) -236. [upload_files](building-sites/settings/upload_files) -237. [upload_file_exists](building-sites/settings/upload_file_exists) -238. [upload_maxsize](building-sites/settings/upload_maxsize) -239. [upload_translit](building-sites/settings/upload_translit) -240. [upload_translit_restrict_chars_pattern](building-sites/settings/upload_translit_restrict_chars_pattern) -241. [user_nav_parent](building-sites/settings/user_nav_parent) -242. [use_alias_path](building-sites/settings/use_alias_path) -243. [use_browser](building-sites/settings/use_browser) -244. [use_context_resource_table](building-sites/settings/use_context_resource_table) -245. [use_editor](building-sites/settings/use_editor) -246. [use_frozen_parent_uris](building-sites/settings/use_frozen_parent_uris) -247. [use_multibyte](building-sites/settings/use_multibyte) -248. [use_weblink_target](building-sites/settings/use_weblink_target) -249. [welcome_action](building-sites/settings/welcome_action) -250. [welcome_namespace](building-sites/settings/welcome_namespace) -251. [welcome_screen](building-sites/settings/welcome_screen) -252. [welcome_screen_url](building-sites/settings/welcome_screen_url) -253. [which_editor](building-sites/settings/which_editor) -254. [which_element_editor](building-sites/settings/which_element_editor) -255. [xhtml_urls](building-sites/settings/xhtml_urls) +143. [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay) +144. [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) +145. [manager_use_fullname](building-sites/settings/manager_use_fullname) +146. [manager_week_start](building-sites/settings/manager_week_start) +147. [mgr_source_icon](building-sites/settings/mgr_source_icon) +148. [mgr_tree_icon_context](building-sites/settings/mgr_tree_icon_context) +149. [modx_browser_default_sort](building-sites/settings/modx_browser_default_sort) +150. [modx_browser_default_viewmode](building-sites/settings/modx_browser_default_viewmode) +151. [modx_browser_tree_hide_files](building-sites/settings/modx_browser_tree_hide_files) +152. [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips) +153. [modx_charset](building-sites/settings/modx_charset) +154. [new_file_permissions](building-sites/settings/new_file_permissions) +155. [new_folder_permissions](building-sites/settings/new_folder_permissions) +156. [parser_recurse_uncacheable](building-sites/settings/parser_recurse_uncacheable) +157. [password_generated_length](building-sites/settings/password_generated_length) +158. [password_min_length](building-sites/settings/password_min_length) +159. [phpthumb_allow_src_above_docroot](building-sites/settings/phpthumb_allow_src_above_docroot) +160. [phpthumb_cache_maxage](building-sites/settings/phpthumb_cache_maxage) +161. [phpthumb_cache_maxfiles](building-sites/settings/phpthumb_cache_maxfiles) +162. [phpthumb_cache_maxsize](building-sites/settings/phpthumb_cache_maxsize) +163. [phpthumb_cache_source_enabled](building-sites/settings/phpthumb_cache_source_enabled) +164. [phpthumb_document_root](building-sites/settings/phpthumb_document_root) +165. [phpthumb_error_bgcolor](building-sites/settings/phpthumb_error_bgcolor) +166. [phpthumb_error_fontsize](building-sites/settings/phpthumb_error_fontsize) +167. [phpthumb_error_textcolor](building-sites/settings/phpthumb_error_textcolor) +168. [phpthumb_far](building-sites/settings/phpthumb_far) +169. [phpthumb_imagemagick_path](building-sites/settings/phpthumb_imagemagick_path) +170. [phpthumb_nohotlink_enabled](building-sites/settings/phpthumb_nohotlink_enabled) +171. [phpthumb_nohotlink_erase_image](building-sites/settings/phpthumb_nohotlink_erase_image) +172. [phpthumb_nohotlink_text_message](building-sites/settings/phpthumb_nohotlink_text_message) +173. [phpthumb_nohotlink_valid_domains](building-sites/settings/phpthumb_nohotlink_valid_domains) +174. [phpthumb_nooffsitelink_enabled](building-sites/settings/phpthumb_nooffsitelink_enabled) +175. [phpthumb_nooffsitelink_erase_image](building-sites/settings/phpthumb_nooffsitelink_erase_image) +176. [phpthumb_nooffsitelink_require_refer](building-sites/settings/phpthumb_nooffsitelink_require_refer) +177. [phpthumb_nooffsitelink_text_message](building-sites/settings/phpthumb_nooffsitelink_text_message) +178. [phpthumb_nooffsitelink_valid_domains](building-sites/settings/phpthumb_nooffsitelink_valid_domains) +179. [phpthumb_nooffsitelink_watermark_src](building-sites/settings/phpthumb_nooffsitelink_watermark_src) +180. [phpthumb_zoomcrop](building-sites/settings/phpthumb_zoomcrop) +181. [preserve_menuindex](building-sites/settings/preserve_menuindex) +182. [principal_targets](building-sites/settings/principal_targets) +183. [proxy_auth_type](building-sites/settings/proxy_auth_type) +184. [proxy_host](building-sites/settings/proxy_host) +185. [proxy_password](building-sites/settings/proxy_password) +186. [proxy_port](building-sites/settings/proxy_port) +187. [proxy_username](building-sites/settings/proxy_username) +188. [publish_default](building-sites/settings/publish_default) +189. [rb_base_dir](building-sites/settings/rb_base_dir) +190. [rb_base_url](building-sites/settings/rb_base_url) +191. [request_controller](building-sites/settings/request_controller) +192. [request_method_strict](building-sites/settings/request_method_strict) +193. [request_param_alias](building-sites/settings/request_param_alias) +194. [request_param_id](building-sites/settings/request_param_id) +195. [resource_tree_node_name](building-sites/settings/resource_tree_node_name) +196. [resource_tree_node_name_fallback](building-sites/settings/resource_tree_node_name_fallback) +197. [resource_tree_node_tooltip](building-sites/settings/resource_tree_node_tooltip) +198. [richtext_default](building-sites/settings/richtext_default) +199. [search_default](building-sites/settings/search_default) +200. [send_poweredby_header](building-sites/settings/send_poweredby_header) +201. [server_offset_time](building-sites/settings/server_offset_time) +202. [server_protocol](building-sites/settings/server_protocol) +203. [session_cookie_domain](building-sites/settings/session_cookie_domain) +204. [session_cookie_httponly](building-sites/settings/session_cookie_httponly) +205. [session_cookie_lifetime](building-sites/settings/session_cookie_lifetime) +206. [session_cookie_path](building-sites/settings/session_cookie_path) +207. [session_cookie_secure](building-sites/settings/session_cookie_secure) +208. [session_enabled](building-sites/settings/session_enabled) +209. [session_gc_maxlifetime](building-sites/settings/session_gc_maxlifetime) +210. [session_handler_class](building-sites/settings/session_handler_class) +211. [session_name](building-sites/settings/session_name) +212. [settings_version](building-sites/settings/settings_version) +213. [setting_static_elements_basepath](building-sites/settings/setting_static_elements_basepath) +214. [show_tv_categories_header](building-sites/settings/show_tv_categories_header) +215. [signupemail_message](building-sites/settings/signupemail_message) +216. [site_name](building-sites/settings/site_name) +217. [site_start](building-sites/settings/site_start) +218. [site_status](building-sites/settings/site_status) +219. [site_unavailable_message](building-sites/settings/site_unavailable_message) +220. [site_unavailable_page](building-sites/settings/site_unavailable_page) +221. [static_elements_automate_chunks](building-sites/settings/static_elements_automate_chunks) +222. [static_elements_automate_plugins](building-sites/settings/static_elements_automate_plugins) +223. [static_elements_automate_snippets](building-sites/settings/static_elements_automate_snippets) +224. [static_elements_automate_templates](building-sites/settings/static_elements_automate_templates) +225. [static_elements_automate_tvs](building-sites/settings/static_elements_automate_tvs) +226. [static_elements_basepath](building-sites/settings/static_elements_basepath) +227. [static_elements_default_category](building-sites/settings/static_elements_default_category) +228. [static_elements_default_mediasource](building-sites/settings/static_elements_default_mediasource) +229. [strip_image_paths](building-sites/settings/strip_image_paths) +230. [symlink_merge_fields](building-sites/settings/symlink_merge_fields) +231. [syncsite_default](building-sites/settings/syncsite_default) +232. [tree_default_sort](building-sites/settings/tree_default_sort) +233. [tree_root_id](building-sites/settings/tree_root_id) +234. [tvs_below_content](building-sites/settings/tvs_below_content) +235. [udperms_allowroot](building-sites/settings/udperms_allowroot) +236. [ui_debug_mode](building-sites/settings/ui_debug_mode) +237. [unauthorized_page](building-sites/settings/unauthorized_page) +238. [upload_files](building-sites/settings/upload_files) +239. [upload_file_exists](building-sites/settings/upload_file_exists) +240. [upload_maxsize](building-sites/settings/upload_maxsize) +241. [upload_translit](building-sites/settings/upload_translit) +242. [upload_translit_restrict_chars_pattern](building-sites/settings/upload_translit_restrict_chars_pattern) +243. [user_nav_parent](building-sites/settings/user_nav_parent) +244. [use_alias_path](building-sites/settings/use_alias_path) +245. [use_browser](building-sites/settings/use_browser) +246. [use_context_resource_table](building-sites/settings/use_context_resource_table) +247. [use_editor](building-sites/settings/use_editor) +248. [use_frozen_parent_uris](building-sites/settings/use_frozen_parent_uris) +249. [use_multibyte](building-sites/settings/use_multibyte) +250. [use_weblink_target](building-sites/settings/use_weblink_target) +251. [webpwdreminder_message](building-sites/settings/webpwdreminder_message) +252. [welcome_action](building-sites/settings/welcome_action) +253. [welcome_namespace](building-sites/settings/welcome_namespace) +254. [welcome_screen](building-sites/settings/welcome_screen) +255. [welcome_screen_url](building-sites/settings/welcome_screen_url) +256. [which_editor](building-sites/settings/which_editor) +257. [which_element_editor](building-sites/settings/which_element_editor) +258. [xhtml_urls](building-sites/settings/xhtml_urls) diff --git a/en/building-sites/settings/manager_tooltip_delay.md b/en/building-sites/settings/manager_tooltip_delay.md new file mode 100644 index 000000000..8cf53a44a --- /dev/null +++ b/en/building-sites/settings/manager_tooltip_delay.md @@ -0,0 +1,13 @@ +--- +title: "manager_tooltip_delay" +description: "Milliseconds before a manager field tooltip hides" +--- + +**Name**: Delay Time for Manager Tooltips +**Type**: Number +**Default**: 2300 +**Available In**: Revolution 3.0+ + +Milliseconds before an enabled field tooltip hides. The manager passes this value to ExtJS QuickTips as `dismissDelay`. + +Has no effect when [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) is No. diff --git a/en/building-sites/settings/manager_tooltip_enable.md b/en/building-sites/settings/manager_tooltip_enable.md new file mode 100644 index 000000000..d629b01ed --- /dev/null +++ b/en/building-sites/settings/manager_tooltip_enable.md @@ -0,0 +1,15 @@ +--- +title: "manager_tooltip_enable" +description: "Show field description tooltips in the manager" +--- + +**Name**: Enable Manager Tooltips +**Type**: Yes/No +**Default**: Yes +**Available In**: Revolution 3.0+ + +When Yes, the manager shows ExtJS QuickTips on form fields that have a description. The same text appears on the field and on its label. + +Set this to No to hide those tooltips. This setting does not control Media Browser image preview tooltips. Those use [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips). + +See [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay) for how long an enabled tooltip stays on screen. These settings are listed with other 3.0 manager UI notes on [Manager UI in 3.0](getting-started/upgrading-to-3.0/manager-ui). diff --git a/en/building-sites/settings/udperms_allowroot.md b/en/building-sites/settings/udperms_allowroot.md index 443b9ed9d..6afd1395a 100644 --- a/en/building-sites/settings/udperms_allowroot.md +++ b/en/building-sites/settings/udperms_allowroot.md @@ -4,12 +4,6 @@ _old_id: "317" _old_uri: "2.x/administering-your-site/settings/system-settings/udperms_allowroot" --- -## udperms\_allowroot +The `udperms_allowroot` setting was removed in MODX 3.0. Revolution already ignored it. Root resource creation is controlled by the `new_document_in_root` [permission](building-sites/client-proofing/security/policies/permissions/administrator-policy) on the Administrator Policy (granted by default). -**Name**: Allow Root Resource Creation -**Type**: Yes/No -**Default**: No - -If true, allows users to create new resources in the root of the site. - -This setting is **deprecated** in MODX Revolution. It has been replaced by the 'new\_document\_in\_root' [Permission](building-sites/client-proofing/security/policies/permissions "Permissions") in the Administrator Policy (the permission is granted by default). +Grant `new_document_in_root` to let users create resources at the site root. Deny it to block create, duplicate, and move into the root. diff --git a/en/building-sites/settings/webpwdreminder_message.md b/en/building-sites/settings/webpwdreminder_message.md new file mode 100644 index 000000000..6f1b312e2 --- /dev/null +++ b/en/building-sites/settings/webpwdreminder_message.md @@ -0,0 +1,8 @@ +--- +title: "webpwdreminder_message" +description: "Removed in MODX 3.0. Unused web-user password reminder email template" +--- + +The `webpwdreminder_message` setting was removed in MODX 3.0. In 2.x it stored the HTML email sent when a web user requested a password reset. The core no longer used that template. + +Manager password reset uses [forgot_login_email](building-sites/settings/forgot_login_email). Front-end reset is handled by extras such as Login. diff --git a/en/extending-modx/custom-resources/step-4-processors.md b/en/extending-modx/custom-resources/step-4-processors.md index 3c4ad563d..cf214ed18 100644 --- a/en/extending-modx/custom-resources/step-4-processors.md +++ b/en/extending-modx/custom-resources/step-4-processors.md @@ -4,18 +4,46 @@ _old_id: "73" _old_uri: "2.x/developing-in-modx/advanced-development/custom-resource-classes/creating-a-resource-class/creating-a-resource-class-step-4" --- - This tutorial is part of a Series: +This tutorial is part of a Series: - [Part I: Creating a Custom Resource Class](extending-modx/custom-resources "Creating a Resource Class") - [Part II: Handling our CRC Behavior](extending-modx/custom-resources/step-2-overriding-methods "Creating a Resource Class - Step 2") - [Part III: Customizing the Controllers](extending-modx/custom-resources/step-3-controllers "Creating a Resource Class - Step 3") - Part IV: Customizing the Processors - This is a bit of bonus material to help identify some of the things you can do by extending the default processors. +This is a bit of bonus material to help identify some of the things you can do by extending the default processors. + +## MODX 3.x class names + +When you create or update a CRC, `MODX\Revolution\Processors\Resource\Create::getInstance()` looks for `{class_key}CreateProcessor`. The update processor looks for `{class_key}UpdateProcessor`. Those classes must extend the core resource processors. + +The 2.x files `core/model/modx/processors/resource/create.class.php` and `update.class.php` are gone. Do not `require_once` those paths. + +| Old class | New class | +| --- | --- | +| `modResourceCreateProcessor` | `\MODX\Revolution\Processors\Resource\Create` | +| `modResourceUpdateProcessor` | `\MODX\Revolution\Processors\Resource\Update` | + +`core/include/deprecated.php` aliases the old names until 3.3. For 3.0+ only, extend the namespaced classes: + +``` php +use MODX\Revolution\Processors\Resource\Create; +use MODX\Revolution\Processors\Resource\Update; + +class CopyrightedResourceCreateProcessor extends Create +{ +} + +class CopyrightedResourceUpdateProcessor extends Update +{ +} +``` + +See [Processors in the 3.0 upgrade notes](getting-started/upgrading-to-3.0/processors). ## Extending the Processors for our CRC - Extending the Processors for our CopyrightedResource is fairly simple. Load up your **copyrightedresource.class.php** file that contains your main class, and at the top, put this: + Extending the Processors for our CopyrightedResource is fairly simple. On MODX 2.x, load up your **copyrightedresource.class.php** file that contains your main class, and at the top, put this: ``` php require_once MODX_CORE_PATH.'model/modx/modprocessor.class.php'; @@ -23,7 +51,7 @@ require_once MODX_CORE_PATH.'model/modx/processors/resource/create.class.php'; require_once MODX_CORE_PATH.'model/modx/processors/resource/update.class.php'; ``` - This tells MODX to load some base classes that we'll need – yes, we're sort of double-dipping here. Because our main class file is on MODX's radar and will be included when MODX loads, we just can require more files from there. At the bottom of the same file, after your CopyrightedResource class, put this: + This tells MODX to load some base classes that we'll need. Because our main class file is on MODX's radar and will be included when MODX loads, we just can require more files from there. At the bottom of the same file, after your CopyrightedResource class, put this: ``` php class CopyrightedResourceCreateProcessor extends modResourceCreateProcessor { @@ -32,7 +60,9 @@ class CopyrightedResourceUpdateProcessor extends modResourceUpdateProcessor { } ``` - Now we've overridden the processors for our class; MODX will automatically use these classes as the processor class when creating or updating our CRC. We can then override methods to provide custom functionality for our CopyrightedResource class. For example, here is a stub for our CopyrightedResource class and the Update processor that shows some methods that you could override: +On 3.x skip those `require_once` lines and extend `\MODX\Revolution\Processors\Resource\Create` and `Update` instead, as shown above. + +Now we've overridden the processors for our class; MODX will automatically use these classes as the processor class when creating or updating our CRC. We can then override methods to provide custom functionality for our CopyrightedResource class. For example, here is a stub for our CopyrightedResource class and the Update processor that shows some methods that you could override: ``` php class CopyrightedResourceUpdateProcessor extends modResourceUpdateProcessor { @@ -71,13 +101,13 @@ class CopyrightedResourceUpdateProcessor extends modResourceUpdateProcessor { } ``` - These are just trivial examples, but hopefully you get the idea. If you've been paying close attention to our examples on these pages, you may have noticed that we set some properties in the **CopyrightedResource** class (class\_key), and we set others in **CopyrightedResourceUpdateProcessor** (cacheable, isfolder). This may leave you confused as to where you should modify a behavior – in the resource child class? In the controller class? or in the processor? +These are just trivial examples, but hopefully you get the idea. If you've been paying close attention to our examples on these pages, you may have noticed that we set some properties in the **CopyrightedResource** class (class\_key), and we set others in **CopyrightedResourceUpdateProcessor** (cacheable, isfolder). This may leave you confused as to where you should modify a behavior – in the resource child class? In the controller class? or in the processor? - If the attribute is something that can be controlled by the GUI, then you'll have to do some customizations in the processors. +If the attribute is something that can be controlled by the GUI, then you'll have to do some customizations in the processors. ## Extra Attributes - There are some attributes that are not in the **`modx_site_content`** table. See the comments in the **modresource.class.php** file for a list of attributes. You can set them in your resource class via the set method, e.g.: +There are some attributes that are not in the **`modx_site_content`** table. See the comments in the **modresource.class.php** file for a list of attributes. You can set them in your resource class via the set method, e.g.: ``` php $this->set('show_in_tree',false); @@ -88,4 +118,4 @@ You can customize the icon used in the MODX resource by creating a System Settin ## Conclusion - And that's about it! There's obviously tons of possibilities with CRCs, and you can really go nuts on the customization that you can apply to them and their processing and rendering logic. Have fun! +And that's about it! There's obviously tons of possibilities with CRCs, and you can really go nuts on the customization that you can apply to them and their processing and rendering logic. Have fun! diff --git a/en/getting-started/upgrading-to-3.0/manager-ui.md b/en/getting-started/upgrading-to-3.0/manager-ui.md new file mode 100644 index 000000000..16cc4af38 --- /dev/null +++ b/en/getting-started/upgrading-to-3.0/manager-ui.md @@ -0,0 +1,29 @@ +--- +title: Manager UI in 3.0 +--- + +The manager in 3.0 is the same ExtJS app with a new skin and a set of layout tweaks. This page lists the leftover interface changes from the 3.0 cycle that do not have their own how-to. + +Installer and login redesigns are covered on [Upgrading to 3.0](getting-started/upgrading-to-3.0) and [Manager login](building-sites/client-proofing/manager-login). Language switching is on [Manager language](getting-started/upgrading-to-3.0/manager-language). + +## Tooltips + +Field description tooltips can be turned off, and you can change how long they stay on screen: + +- [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) (default Yes) +- [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay) (default 2300 ms, ExtJS `dismissDelay`) + +Media Browser image previews use [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips), not these settings. + +## Profile and resource forms + +- User profile screens share one layout. [#14731](https://github.com/modxcms/revolution/pull/14731), [#14420](https://github.com/modxcms/revolution/pull/14420) +- Resource settings and the Quick Update Resource window use the same field layout. [#14726](https://github.com/modxcms/revolution/pull/14726) +- Template and TV forms put the TV tab before Settings. Resource editing does the same for TVs. [#14251](https://github.com/modxcms/revolution/pull/14251), [#14250](https://github.com/modxcms/revolution/pull/14250) +- Grid "New" buttons follow one pattern. [#14312](https://github.com/modxcms/revolution/pull/14312) + +## Other manager behaviour + +- System Info → Database tables shows a success notice after a table operation. [#14525](https://github.com/modxcms/revolution/pull/14525) +- The top search bar (uberbar) trims leading and trailing spaces before it searches. [#14523](https://github.com/modxcms/revolution/pull/14523) +- The manager CSS starts from normalize.css. [#14369](https://github.com/modxcms/revolution/pull/14369) diff --git a/en/getting-started/upgrading-to-3.0/processors.md b/en/getting-started/upgrading-to-3.0/processors.md index cd630ce26..83533b751 100644 --- a/en/getting-started/upgrading-to-3.0/processors.md +++ b/en/getting-started/upgrading-to-3.0/processors.md @@ -37,6 +37,21 @@ To help ease with the transition to 3.0, the old class names are automatically m Any call to a core processor will need to be reviewed. The old action names in [modX::runProcessor](extending-modx/modx-class/reference/modx.runprocessor) (e.g. `resource/create`) are still supported, but it is possible that the internal logic of some processors has changed. +## Custom resource types (CRC) + +If a custom resource class defines `{ClassKey}CreateProcessor` or `{ClassKey}UpdateProcessor`, the core resource processors instantiate that class instead of themselves. Custom resource types that extend those processors must follow the 3.x class names. + +In 2.x the core classes lived at `core/model/modx/processors/resource/create.class.php` (`modResourceCreateProcessor`) and `update.class.php` (`modResourceUpdateProcessor`). Those files are gone. + +| Old class | New class | +| ------------------------------- | ----------------------------------------------- | +| `\modResourceCreateProcessor` | `\MODX\Revolution\Processors\Resource\Create` | +| `\modResourceUpdateProcessor` | `\MODX\Revolution\Processors\Resource\Update` | + +`core/include/deprecated.php` aliases the old names until 3.3. A `require_once` of the 2.x paths fails. + +See [Step 4: Customizing the Processors](extending-modx/custom-resources/step-4-processors). + ## Flat-file processors no longer supported Support for so-called flat-file processors (which end in `.php` rather than `.class.php` and don't use a processor class) has been removed. diff --git a/en/getting-started/upgrading-to-3.0/system-settings.md b/en/getting-started/upgrading-to-3.0/system-settings.md index 542213b41..35a696a0b 100644 --- a/en/getting-started/upgrading-to-3.0/system-settings.md +++ b/en/getting-started/upgrading-to-3.0/system-settings.md @@ -12,6 +12,7 @@ MODX 3.0 cleaned up a significant number of old system settings and changed the - `manager_language` [#13786](https://github.com/modxcms/revolution/pull/13786), replaced by automatic language detection and on-the-fly switching in the manager [#14046](https://github.com/modxcms/revolution/pull/14046). [Learn more about the manager language in 3.0](getting-started/maintenance/upgrading/3.0/manager-language) - `resolve_hostnames` and `server_protocol` have been removed [#14877](https://github.com/modxcms/revolution/pull/14877). Deprecated settings from MODX Evolution. - `upload_flash`, set `upload_files` or `upload_images` or the `allowedFileTypes` on the media source instead. [#14252](https://github.com/modxcms/revolution/pull/14252) +- `udperms_allowroot` and `webpwdreminder_message` [#14841](https://github.com/modxcms/revolution/pull/14841). Root resource creation uses the `new_document_in_root` permission. `webpwdreminder_message` was an unused web-user password email template. See [udperms_allowroot](building-sites/settings/udperms_allowroot) and [webpwdreminder_message](building-sites/settings/webpwdreminder_message). - `cache_action_map` as the action map has been removed completely now that modAction is officially gone [#14927](https://github.com/modxcms/revolution/pull/14927) ## Changed default values diff --git a/ru/building-sites/client-proofing/security/policies/permissions/administrator-policy.md b/ru/building-sites/client-proofing/security/policies/permissions/administrator-policy.md index b41c7704e..6c2ef84d3 100644 --- a/ru/building-sites/client-proofing/security/policies/permissions/administrator-policy.md +++ b/ru/building-sites/client-proofing/security/policies/permissions/administrator-policy.md @@ -69,6 +69,7 @@ translation: "building-sites/client-proofing/security/policies/permissions/admin | new_chunk | Создать новый [чанк](building-sites/elements/chunks "Куски") . | | new_context | Создать новый [контекст](building-sites/contexts "Контексты") . | | new_document | Для создания новых [ресурсов](building-sites/resources "Ресурсы") . | +| new_document_in_root | Создавать [ресурс](building-sites/resources "Ресурсы") в корне сайта. Заменяет удалённую настройку `udperms_allowroot`. | | new_plugin | Создать новый [плагин](extending-modx/plugins "Плагины") . | | new_role | Создать новую [роль](building-sites/client-proofing/security/roles "Роли") . | | new_snippet | Создать новый [сниппет](extending-modx/snippets "обрывки") . | diff --git a/ru/building-sites/resources/custom-resources.md b/ru/building-sites/resources/custom-resources.md index 0c908f9b8..1914cd19f 100644 --- a/ru/building-sites/resources/custom-resources.md +++ b/ru/building-sites/resources/custom-resources.md @@ -30,6 +30,8 @@ translation: "building-sites/resources/custom-resources" Контроллеры, процессоры и основные функции рендеринга могут быть расширены и переопределены. Например, вы можете автоматически добавлять текст к выводу любого содержимого пользовательских классов ресурсов, переопределяя метод `process()` или `getContent()` CRC в классе PHP. Любой метод в классе `modResource` доступен для переопределения при использовании пользовательских классов ресурсов. +В MODX 3 процессор создания или обновления CRC должен расширять `\MODX\Revolution\Processors\Resource\Create` или `Update`. Старые имена `modResourceCreateProcessor` и `modResourceUpdateProcessor` работают как псевдонимы до 3.3. Файлы процессоров 2.x в `core/model/modx/processors/resource/` удалены. См. [Шаг 4: Настройка процессоров](extending-modx/custom-resources/step-4-processors) и [процессоры в заметках об обновлении до 3.0](getting-started/upgrading-to-3.0/processors). + ## Создание Пользовательских классов ресурсов Пожалуйста, следуйте инструкциям на [Создание класса ресурса](extending-modx/custom-resources "Создание класса ресурса"). diff --git a/ru/building-sites/settings/index.md b/ru/building-sites/settings/index.md index 5f96a228a..79af11b67 100644 --- a/ru/building-sites/settings/index.md +++ b/ru/building-sites/settings/index.md @@ -353,115 +353,118 @@ MODX заполняет значения для имени и описания 140. [manager_login_url_alternate](building-sites/settings/manager_login_url_alternate) 141. [manager_theme](building-sites/settings/manager_theme) 142. [manager_time_format](building-sites/settings/manager_time_format) -143. [manager_use_fullname](building-sites/settings/manager_use_fullname) -144. [manager_week_start](building-sites/settings/manager_week_start) -145. [mgr_source_icon](building-sites/settings/mgr_source_icon) -146. [mgr_tree_icon_context](building-sites/settings/mgr_tree_icon_context) -147. [modx_browser_default_sort](building-sites/settings/modx_browser_default_sort) -148. [modx_browser_default_viewmode](building-sites/settings/modx_browser_default_viewmode) -149. [modx_browser_tree_hide_files](building-sites/settings/modx_browser_tree_hide_files) -150. [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips) -151. [modx_charset](building-sites/settings/modx_charset) -152. [new_file_permissions](building-sites/settings/new_file_permissions) -153. [new_folder_permissions](building-sites/settings/new_folder_permissions) -154. [parser_recurse_uncacheable](building-sites/settings/parser_recurse_uncacheable) -155. [password_generated_length](building-sites/settings/password_generated_length) -156. [password_min_length](building-sites/settings/password_min_length) -157. [phpthumb_allow_src_above_docroot](building-sites/settings/phpthumb_allow_src_above_docroot) -158. [phpthumb_cache_maxage](building-sites/settings/phpthumb_cache_maxage) -159. [phpthumb_cache_maxfiles](building-sites/settings/phpthumb_cache_maxfiles) -160. [phpthumb_cache_maxsize](building-sites/settings/phpthumb_cache_maxsize) -161. [phpthumb_cache_source_enabled](building-sites/settings/phpthumb_cache_source_enabled) -162. [phpthumb_document_root](building-sites/settings/phpthumb_document_root) -163. [phpthumb_error_bgcolor](building-sites/settings/phpthumb_error_bgcolor) -164. [phpthumb_error_fontsize](building-sites/settings/phpthumb_error_fontsize) -165. [phpthumb_error_textcolor](building-sites/settings/phpthumb_error_textcolor) -166. [phpthumb_far](building-sites/settings/phpthumb_far) -167. [phpthumb_imagemagick_path](building-sites/settings/phpthumb_imagemagick_path) -168. [phpthumb_nohotlink_enabled](building-sites/settings/phpthumb_nohotlink_enabled) -169. [phpthumb_nohotlink_erase_image](building-sites/settings/phpthumb_nohotlink_erase_image) -170. [phpthumb_nohotlink_text_message](building-sites/settings/phpthumb_nohotlink_text_message) -171. [phpthumb_nohotlink_valid_domains](building-sites/settings/phpthumb_nohotlink_valid_domains) -172. [phpthumb_nooffsitelink_enabled](building-sites/settings/phpthumb_nooffsitelink_enabled) -173. [phpthumb_nooffsitelink_erase_image](building-sites/settings/phpthumb_nooffsitelink_erase_image) -174. [phpthumb_nooffsitelink_require_refer](building-sites/settings/phpthumb_nooffsitelink_require_refer) -175. [phpthumb_nooffsitelink_text_message](building-sites/settings/phpthumb_nooffsitelink_text_message) -176. [phpthumb_nooffsitelink_valid_domains](building-sites/settings/phpthumb_nooffsitelink_valid_domains) -177. [phpthumb_nooffsitelink_watermark_src](building-sites/settings/phpthumb_nooffsitelink_watermark_src) -178. [phpthumb_zoomcrop](building-sites/settings/phpthumb_zoomcrop) -179. [preserve_menuindex](building-sites/settings/preserve_menuindex) -180. [principal_targets](building-sites/settings/principal_targets) -181. [proxy_auth_type](building-sites/settings/proxy_auth_type) -182. [proxy_host](building-sites/settings/proxy_host) -183. [proxy_password](building-sites/settings/proxy_password) -184. [proxy_port](building-sites/settings/proxy_port) -185. [proxy_username](building-sites/settings/proxy_username) -186. [publish_default](building-sites/settings/publish_default) -187. [rb_base_dir](building-sites/settings/rb_base_dir) -188. [rb_base_url](building-sites/settings/rb_base_url) -189. [request_controller](building-sites/settings/request_controller) -190. [request_method_strict](building-sites/settings/request_method_strict) -191. [request_param_alias](building-sites/settings/request_param_alias) -192. [request_param_id](building-sites/settings/request_param_id) -193. [resource_tree_node_name](building-sites/settings/resource_tree_node_name) -194. [resource_tree_node_name_fallback](building-sites/settings/resource_tree_node_name_fallback) -195. [resource_tree_node_tooltip](building-sites/settings/resource_tree_node_tooltip) -196. [richtext_default](building-sites/settings/richtext_default) -197. [search_default](building-sites/settings/search_default) -198. [send_poweredby_header](building-sites/settings/send_poweredby_header) -199. [server_offset_time](building-sites/settings/server_offset_time) -200. [server_protocol](building-sites/settings/server_protocol) -201. [session_cookie_domain](building-sites/settings/session_cookie_domain) -202. [session_cookie_httponly](building-sites/settings/session_cookie_httponly) -203. [session_cookie_lifetime](building-sites/settings/session_cookie_lifetime) -204. [session_cookie_path](building-sites/settings/session_cookie_path) -205. [session_cookie_secure](building-sites/settings/session_cookie_secure) -206. [session_enabled](building-sites/settings/session_enabled) -207. [session_gc_maxlifetime](building-sites/settings/session_gc_maxlifetime) -208. [session_handler_class](building-sites/settings/session_handler_class) -209. [session_name](building-sites/settings/session_name) -210. [settings_version](building-sites/settings/settings_version) -211. [setting_static_elements_basepath](building-sites/settings/setting_static_elements_basepath) -212. [show_tv_categories_header](building-sites/settings/show_tv_categories_header) -213. [signupemail_message](building-sites/settings/signupemail_message) -214. [site_name](building-sites/settings/site_name) -215. [site_start](building-sites/settings/site_start) -216. [site_status](building-sites/settings/site_status) -217. [site_unavailable_message](building-sites/settings/site_unavailable_message) -218. [site_unavailable_page](building-sites/settings/site_unavailable_page) -219. [static_elements_automate_chunks](building-sites/settings/static_elements_automate_chunks) -220. [static_elements_automate_plugins](building-sites/settings/static_elements_automate_plugins) -221. [static_elements_automate_snippets](building-sites/settings/static_elements_automate_snippets) -222. [static_elements_automate_templates](building-sites/settings/static_elements_automate_templates) -223. [static_elements_automate_tvs](building-sites/settings/static_elements_automate_tvs) -224. [static_elements_basepath](building-sites/settings/static_elements_basepath) -225. [static_elements_default_category](building-sites/settings/static_elements_default_category) -226. [static_elements_default_mediasource](building-sites/settings/static_elements_default_mediasource) -227. [strip_image_paths](building-sites/settings/strip_image_paths) -228. [symlink_merge_fields](building-sites/settings/symlink_merge_fields) -229. [syncsite_default](building-sites/settings/syncsite_default) -230. [tree_default_sort](building-sites/settings/tree_default_sort) -231. [tree_root_id](building-sites/settings/tree_root_id) -232. [tvs_below_content](building-sites/settings/tvs_below_content) -233. [udperms_allowroot](building-sites/settings/udperms_allowroot) -234. [ui_debug_mode](building-sites/settings/ui_debug_mode) -235. [unauthorized_page](building-sites/settings/unauthorized_page) -236. [upload_files](building-sites/settings/upload_files) -237. [upload_maxsize](building-sites/settings/upload_maxsize) -238. [upload_translit](building-sites/settings/upload_translit) -239. [upload_translit_restrict_chars_pattern](building-sites/settings/upload_translit_restrict_chars_pattern) -240. [user_nav_parent](building-sites/settings/user_nav_parent) -241. [use_alias_path](building-sites/settings/use_alias_path) -242. [use_browser](building-sites/settings/use_browser) -243. [use_context_resource_table](building-sites/settings/use_context_resource_table) -244. [use_editor](building-sites/settings/use_editor) -245. [use_frozen_parent_uris](building-sites/settings/use_frozen_parent_uris) -246. [use_multibyte](building-sites/settings/use_multibyte) -247. [use_weblink_target](building-sites/settings/use_weblink_target) -248. [welcome_action](building-sites/settings/welcome_action) -249. [welcome_namespace](building-sites/settings/welcome_namespace) -250. [welcome_screen](building-sites/settings/welcome_screen) -251. [welcome_screen_url](building-sites/settings/welcome_screen_url) -252. [which_editor](building-sites/settings/which_editor) -253. [which_element_editor](building-sites/settings/which_element_editor) -254. [xhtml_urls](building-sites/settings/xhtml_urls) +143. [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay) +144. [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) +145. [manager_use_fullname](building-sites/settings/manager_use_fullname) +146. [manager_week_start](building-sites/settings/manager_week_start) +147. [mgr_source_icon](building-sites/settings/mgr_source_icon) +148. [mgr_tree_icon_context](building-sites/settings/mgr_tree_icon_context) +149. [modx_browser_default_sort](building-sites/settings/modx_browser_default_sort) +150. [modx_browser_default_viewmode](building-sites/settings/modx_browser_default_viewmode) +151. [modx_browser_tree_hide_files](building-sites/settings/modx_browser_tree_hide_files) +152. [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips) +153. [modx_charset](building-sites/settings/modx_charset) +154. [new_file_permissions](building-sites/settings/new_file_permissions) +155. [new_folder_permissions](building-sites/settings/new_folder_permissions) +156. [parser_recurse_uncacheable](building-sites/settings/parser_recurse_uncacheable) +157. [password_generated_length](building-sites/settings/password_generated_length) +158. [password_min_length](building-sites/settings/password_min_length) +159. [phpthumb_allow_src_above_docroot](building-sites/settings/phpthumb_allow_src_above_docroot) +160. [phpthumb_cache_maxage](building-sites/settings/phpthumb_cache_maxage) +161. [phpthumb_cache_maxfiles](building-sites/settings/phpthumb_cache_maxfiles) +162. [phpthumb_cache_maxsize](building-sites/settings/phpthumb_cache_maxsize) +163. [phpthumb_cache_source_enabled](building-sites/settings/phpthumb_cache_source_enabled) +164. [phpthumb_document_root](building-sites/settings/phpthumb_document_root) +165. [phpthumb_error_bgcolor](building-sites/settings/phpthumb_error_bgcolor) +166. [phpthumb_error_fontsize](building-sites/settings/phpthumb_error_fontsize) +167. [phpthumb_error_textcolor](building-sites/settings/phpthumb_error_textcolor) +168. [phpthumb_far](building-sites/settings/phpthumb_far) +169. [phpthumb_imagemagick_path](building-sites/settings/phpthumb_imagemagick_path) +170. [phpthumb_nohotlink_enabled](building-sites/settings/phpthumb_nohotlink_enabled) +171. [phpthumb_nohotlink_erase_image](building-sites/settings/phpthumb_nohotlink_erase_image) +172. [phpthumb_nohotlink_text_message](building-sites/settings/phpthumb_nohotlink_text_message) +173. [phpthumb_nohotlink_valid_domains](building-sites/settings/phpthumb_nohotlink_valid_domains) +174. [phpthumb_nooffsitelink_enabled](building-sites/settings/phpthumb_nooffsitelink_enabled) +175. [phpthumb_nooffsitelink_erase_image](building-sites/settings/phpthumb_nooffsitelink_erase_image) +176. [phpthumb_nooffsitelink_require_refer](building-sites/settings/phpthumb_nooffsitelink_require_refer) +177. [phpthumb_nooffsitelink_text_message](building-sites/settings/phpthumb_nooffsitelink_text_message) +178. [phpthumb_nooffsitelink_valid_domains](building-sites/settings/phpthumb_nooffsitelink_valid_domains) +179. [phpthumb_nooffsitelink_watermark_src](building-sites/settings/phpthumb_nooffsitelink_watermark_src) +180. [phpthumb_zoomcrop](building-sites/settings/phpthumb_zoomcrop) +181. [preserve_menuindex](building-sites/settings/preserve_menuindex) +182. [principal_targets](building-sites/settings/principal_targets) +183. [proxy_auth_type](building-sites/settings/proxy_auth_type) +184. [proxy_host](building-sites/settings/proxy_host) +185. [proxy_password](building-sites/settings/proxy_password) +186. [proxy_port](building-sites/settings/proxy_port) +187. [proxy_username](building-sites/settings/proxy_username) +188. [publish_default](building-sites/settings/publish_default) +189. [rb_base_dir](building-sites/settings/rb_base_dir) +190. [rb_base_url](building-sites/settings/rb_base_url) +191. [request_controller](building-sites/settings/request_controller) +192. [request_method_strict](building-sites/settings/request_method_strict) +193. [request_param_alias](building-sites/settings/request_param_alias) +194. [request_param_id](building-sites/settings/request_param_id) +195. [resource_tree_node_name](building-sites/settings/resource_tree_node_name) +196. [resource_tree_node_name_fallback](building-sites/settings/resource_tree_node_name_fallback) +197. [resource_tree_node_tooltip](building-sites/settings/resource_tree_node_tooltip) +198. [richtext_default](building-sites/settings/richtext_default) +199. [search_default](building-sites/settings/search_default) +200. [send_poweredby_header](building-sites/settings/send_poweredby_header) +201. [server_offset_time](building-sites/settings/server_offset_time) +202. [server_protocol](building-sites/settings/server_protocol) +203. [session_cookie_domain](building-sites/settings/session_cookie_domain) +204. [session_cookie_httponly](building-sites/settings/session_cookie_httponly) +205. [session_cookie_lifetime](building-sites/settings/session_cookie_lifetime) +206. [session_cookie_path](building-sites/settings/session_cookie_path) +207. [session_cookie_secure](building-sites/settings/session_cookie_secure) +208. [session_enabled](building-sites/settings/session_enabled) +209. [session_gc_maxlifetime](building-sites/settings/session_gc_maxlifetime) +210. [session_handler_class](building-sites/settings/session_handler_class) +211. [session_name](building-sites/settings/session_name) +212. [settings_version](building-sites/settings/settings_version) +213. [setting_static_elements_basepath](building-sites/settings/setting_static_elements_basepath) +214. [show_tv_categories_header](building-sites/settings/show_tv_categories_header) +215. [signupemail_message](building-sites/settings/signupemail_message) +216. [site_name](building-sites/settings/site_name) +217. [site_start](building-sites/settings/site_start) +218. [site_status](building-sites/settings/site_status) +219. [site_unavailable_message](building-sites/settings/site_unavailable_message) +220. [site_unavailable_page](building-sites/settings/site_unavailable_page) +221. [static_elements_automate_chunks](building-sites/settings/static_elements_automate_chunks) +222. [static_elements_automate_plugins](building-sites/settings/static_elements_automate_plugins) +223. [static_elements_automate_snippets](building-sites/settings/static_elements_automate_snippets) +224. [static_elements_automate_templates](building-sites/settings/static_elements_automate_templates) +225. [static_elements_automate_tvs](building-sites/settings/static_elements_automate_tvs) +226. [static_elements_basepath](building-sites/settings/static_elements_basepath) +227. [static_elements_default_category](building-sites/settings/static_elements_default_category) +228. [static_elements_default_mediasource](building-sites/settings/static_elements_default_mediasource) +229. [strip_image_paths](building-sites/settings/strip_image_paths) +230. [symlink_merge_fields](building-sites/settings/symlink_merge_fields) +231. [syncsite_default](building-sites/settings/syncsite_default) +232. [tree_default_sort](building-sites/settings/tree_default_sort) +233. [tree_root_id](building-sites/settings/tree_root_id) +234. [tvs_below_content](building-sites/settings/tvs_below_content) +235. [udperms_allowroot](building-sites/settings/udperms_allowroot) +236. [ui_debug_mode](building-sites/settings/ui_debug_mode) +237. [unauthorized_page](building-sites/settings/unauthorized_page) +238. [upload_files](building-sites/settings/upload_files) +239. [upload_maxsize](building-sites/settings/upload_maxsize) +240. [upload_translit](building-sites/settings/upload_translit) +241. [upload_translit_restrict_chars_pattern](building-sites/settings/upload_translit_restrict_chars_pattern) +242. [user_nav_parent](building-sites/settings/user_nav_parent) +243. [use_alias_path](building-sites/settings/use_alias_path) +244. [use_browser](building-sites/settings/use_browser) +245. [use_context_resource_table](building-sites/settings/use_context_resource_table) +246. [use_editor](building-sites/settings/use_editor) +247. [use_frozen_parent_uris](building-sites/settings/use_frozen_parent_uris) +248. [use_multibyte](building-sites/settings/use_multibyte) +249. [use_weblink_target](building-sites/settings/use_weblink_target) +250. [webpwdreminder_message](building-sites/settings/webpwdreminder_message) +251. [welcome_action](building-sites/settings/welcome_action) +252. [welcome_namespace](building-sites/settings/welcome_namespace) +253. [welcome_screen](building-sites/settings/welcome_screen) +254. [welcome_screen_url](building-sites/settings/welcome_screen_url) +255. [which_editor](building-sites/settings/which_editor) +256. [which_element_editor](building-sites/settings/which_element_editor) +257. [xhtml_urls](building-sites/settings/xhtml_urls) diff --git a/ru/building-sites/settings/manager_tooltip_delay.md b/ru/building-sites/settings/manager_tooltip_delay.md new file mode 100644 index 000000000..2ae48a610 --- /dev/null +++ b/ru/building-sites/settings/manager_tooltip_delay.md @@ -0,0 +1,14 @@ +--- +title: "manager_tooltip_delay" +translation: "building-sites/settings/manager_tooltip_delay" +description: "Миллисекунды до скрытия подсказки поля в системе управления" +--- + +- **Имя**: Время задержки для подсказок в системе управления +- **Тип**: Число +- **По умолчанию**: 2300 +- **Доступен в**: Revolution 3.0+ + +Через столько миллисекунд скрывается включённая подсказка поля. Система управления передаёт это значение в ExtJS QuickTips как `dismissDelay`. + +Не действует, если [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) равен Нет. diff --git a/ru/building-sites/settings/manager_tooltip_enable.md b/ru/building-sites/settings/manager_tooltip_enable.md new file mode 100644 index 000000000..8f7cd094b --- /dev/null +++ b/ru/building-sites/settings/manager_tooltip_enable.md @@ -0,0 +1,16 @@ +--- +title: "manager_tooltip_enable" +translation: "building-sites/settings/manager_tooltip_enable" +description: "Показывать подсказки с описанием полей в системе управления" +--- + +- **Имя**: Включить подсказки в системе управления +- **Тип**: Да/Нет +- **По умолчанию**: Да +- **Доступен в**: Revolution 3.0+ + +Если значение Да, система управления показывает ExtJS QuickTips на полях формы, у которых есть описание. Тот же текст появляется на поле и на его подписи. + +Поставьте Нет, чтобы скрыть эти подсказки. Настройка не управляет превью изображений в Медиабраузере. Для них есть [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips). + +Сколько времени подсказка остаётся на экране, задаёт [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay). Вместе с другими заметками об интерфейсе 3.0 эти настройки есть на странице [Интерфейс системы управления в 3.0](getting-started/upgrading-to-3.0/manager-ui). diff --git a/ru/building-sites/settings/udperms_allowroot.md b/ru/building-sites/settings/udperms_allowroot.md index 87817e604..7eb9de9a2 100644 --- a/ru/building-sites/settings/udperms_allowroot.md +++ b/ru/building-sites/settings/udperms_allowroot.md @@ -3,12 +3,6 @@ title: "udperms_allowroot" translation: "building-sites/settings/udperms_allowroot" --- -## udperms_allowroot +Настройка `udperms_allowroot` удалена в MODX 3.0. Revolution её уже не читал. Создание ресурсов в корне сайта задаёт разрешение `new_document_in_root` в [политике администратора](building-sites/client-proofing/security/policies/permissions/administrator-policy) (по умолчанию выдано). -- **Имя**: Разрешить доступ к корневой папке -- **Тип**: Да/Нет -- **По умолчанию**: Нет - -Если это да, позволяет пользователям создавать новые ресурсы в корне сайта. - -Эта настройка **устарела** в MODX Revolution. Он был заменен 'new_document_in_root' [Permission](building-sites/client-proofing/security/policies/permissions "Permissions") в Политиках администратора (разрешение предоставляется по умолчанию). +Выдайте `new_document_in_root`, чтобы пользователь мог создавать ресурсы в корне. Заберите его, чтобы запретить создание, дублирование и перенос в корень. diff --git a/ru/building-sites/settings/webpwdreminder_message.md b/ru/building-sites/settings/webpwdreminder_message.md new file mode 100644 index 000000000..0c81afe7f --- /dev/null +++ b/ru/building-sites/settings/webpwdreminder_message.md @@ -0,0 +1,9 @@ +--- +title: "webpwdreminder_message" +translation: "building-sites/settings/webpwdreminder_message" +description: "Удалена в MODX 3.0. Неиспользуемый шаблон письма сброса пароля веб-пользователя" +--- + +Настройка `webpwdreminder_message` удалена в MODX 3.0. В 2.x в ней хранился HTML письма, которое уходило веб-пользователю при запросе нового пароля. Ядро этот шаблон уже не использовало. + +Сброс пароля менеджера идёт через [forgot_login_email](building-sites/settings/forgot_login_email). Сброс на сайте делают дополнения вроде Login. diff --git a/ru/extending-modx/custom-resources/step-4-processors.md b/ru/extending-modx/custom-resources/step-4-processors.md index e32ca656b..3775c83b8 100644 --- a/ru/extending-modx/custom-resources/step-4-processors.md +++ b/ru/extending-modx/custom-resources/step-4-processors.md @@ -12,9 +12,37 @@ translation: "extending-modx/custom-resources/step-4-processors" Это небольшой бонусный материал, помогающий определить некоторые вещи, что можно сделать, расширяя стандартные процессоры. +## Имена классов в MODX 3.x + +При создании или обновлении CRC метод `MODX\Revolution\Processors\Resource\Create::getInstance()` ищет класс `{class_key}CreateProcessor`. Процессор обновления ищет `{class_key}UpdateProcessor`. Эти классы должны расширять основные процессоры ресурсов. + +Файлы 2.x `core/model/modx/processors/resource/create.class.php` и `update.class.php` удалены. Не подключайте их через `require_once`. + +| Старый класс | Новый класс | +| --- | --- | +| `modResourceCreateProcessor` | `\MODX\Revolution\Processors\Resource\Create` | +| `modResourceUpdateProcessor` | `\MODX\Revolution\Processors\Resource\Update` | + +`core/include/deprecated.php` даёт псевдонимы старых имён до 3.3. Для кода только под 3.0+ расширяйте классы с пространствами имён: + +```php +use MODX\Revolution\Processors\Resource\Create; +use MODX\Revolution\Processors\Resource\Update; + +class CopyrightedResourceCreateProcessor extends Create +{ +} + +class CopyrightedResourceUpdateProcessor extends Update +{ +} +``` + +См. [процессоры в заметках об обновлении до 3.0](getting-started/upgrading-to-3.0/processors). + ## Расширение процессоров для нашего CRC -Расширить процессоры для нашего CopyrightedResource довольно просто. Загрузите ваш файл **copyrightedresource.class.php**, содержащий ваш основной класс, и в верхней части поместите следующий код: +Расширить процессоры для нашего CopyrightedResource довольно просто. В MODX 2.x загрузите ваш файл **copyrightedresource.class.php**, содержащий ваш основной класс, и в верхней части поместите следующий код: ```php require_once MODX_CORE_PATH.'model/modx/modprocessor.class.php'; @@ -22,7 +50,7 @@ require_once MODX_CORE_PATH.'model/modx/processors/resource/create.class.php'; require_once MODX_CORE_PATH.'model/modx/processors/resource/update.class.php'; ``` -Это говорит MODX загружать некоторые базовые классы, которые нам понадобятся - да, мы здесь как бы удваиваемся. Поскольку MODX видит наш файл основного класса, и этот класс будет включен при загрузке MODX, нам просто может потребоваться больше файлов оттуда. Внизу того же файла, после вашего класса CopyrightedResource, поместите следующий код: +Это говорит MODX загружать некоторые базовые классы, которые нам понадобятся. Поскольку MODX видит наш файл основного класса, и этот класс будет включен при загрузке MODX, нам просто может потребоваться больше файлов оттуда. Внизу того же файла, после вашего класса CopyrightedResource, поместите следующий код: ```php class CopyrightedResourceCreateProcessor extends modResourceCreateProcessor { @@ -31,6 +59,8 @@ class CopyrightedResourceUpdateProcessor extends modResourceUpdateProcessor { } ``` +В 3.x эти строки `require_once` не нужны. Расширяйте `\MODX\Revolution\Processors\Resource\Create` и `Update`, как показано выше. + Теперь мы переопределили процессоры для нашего класса; MODX будет автоматически использовать эти классы в качестве класса процессора при создании или обновлении нашего CRC. Затем мы можем переопределить методы, чтобы обеспечить пользовательскую функциональность для нашего класса CopyrightedResource. Например, вот заглушка для нашего класса CopyrightedResource и процессора обновлений. Она показывает некоторые методы, которые вы можете переопределить: ```php diff --git a/ru/getting-started/upgrading-to-3.0/manager-ui.md b/ru/getting-started/upgrading-to-3.0/manager-ui.md new file mode 100644 index 000000000..09e045c48 --- /dev/null +++ b/ru/getting-started/upgrading-to-3.0/manager-ui.md @@ -0,0 +1,30 @@ +--- +title: Интерфейс системы управления в 3.0 +translation: "getting-started/upgrading-to-3.0/manager-ui" +--- + +Система управления в 3.0 остаётся приложением ExtJS с новой темой и правками вёрстки. Здесь собраны оставшиеся изменения интерфейса цикла 3.0, у которых нет отдельной инструкции. + +Редизайн установщика и входа описаны в [Обновлении до 3.0](getting-started/upgrading-to-3.0) и на странице [входа в систему управления](building-sites/client-proofing/manager-login). Смена языка описана в [языке системы управления](getting-started/upgrading-to-3.0/manager-language). + +## Подсказки + +Подсказки с описанием полей можно выключить. Можно задать, сколько они висят на экране: + +- [manager_tooltip_enable](building-sites/settings/manager_tooltip_enable) (по умолчанию Да) +- [manager_tooltip_delay](building-sites/settings/manager_tooltip_delay) (по умолчанию 2300 мс, ExtJS `dismissDelay`) + +Превью картинок в Медиабраузере задаёт [modx_browser_tree_hide_tooltips](building-sites/settings/modx_browser_tree_hide_tooltips), не эти настройки. + +## Профиль и формы ресурсов + +- Экраны профиля пользователя используют одну вёрстку. [#14731](https://github.com/modxcms/revolution/pull/14731), [#14420](https://github.com/modxcms/revolution/pull/14420) +- Настройки ресурса и окно быстрого обновления ресурса используют одну раскладку полей. [#14726](https://github.com/modxcms/revolution/pull/14726) +- В формах шаблона и TV вкладка TV стоит перед Настройками. В редактировании ресурса TV тоже стоят раньше. [#14251](https://github.com/modxcms/revolution/pull/14251), [#14250](https://github.com/modxcms/revolution/pull/14250) +- Кнопки «Создать» в таблицах приведены к одному шаблону. [#14312](https://github.com/modxcms/revolution/pull/14312) + +## Прочее поведение + +- На странице Сведения о системе → Таблицы базы данных после операции с таблицей появляется уведомление об успехе. [#14525](https://github.com/modxcms/revolution/pull/14525) +- Верхняя строка поиска (uberbar) обрезает пробелы по краям запроса. [#14523](https://github.com/modxcms/revolution/pull/14523) +- CSS системы управления начинается с normalize.css. [#14369](https://github.com/modxcms/revolution/pull/14369) diff --git a/ru/getting-started/upgrading-to-3.0/processors.md b/ru/getting-started/upgrading-to-3.0/processors.md index 4e1b070fe..aff612a18 100644 --- a/ru/getting-started/upgrading-to-3.0/processors.md +++ b/ru/getting-started/upgrading-to-3.0/processors.md @@ -38,6 +38,21 @@ translation: "getting-started/upgrading-to-3.0/processors" Любой вызов к ядру процессора должен быть рассмотрен. Старые имена действий в [modX::runProcessor](extending-modx/modx-class/reference/modx.runprocessor) (например `resource/create`) все еще поддерживаются, но возможно, что внутренняя логика некоторых процессоров изменилась. +## Пользовательские типы ресурсов (CRC) + +Если класс пользовательского ресурса определяет `{ClassKey}CreateProcessor` или `{ClassKey}UpdateProcessor`, основные процессоры ресурсов создают этот класс вместо себя. Типы ресурсов, которые расширяют эти процессоры, должны использовать имена классов 3.x. + +В 2.x основные классы лежали в `core/model/modx/processors/resource/create.class.php` (`modResourceCreateProcessor`) и `update.class.php` (`modResourceUpdateProcessor`). Этих файлов больше нет. + +| Старый класс | Новый класс | +| ------------------------------- | ----------------------------------------------- | +| `\modResourceCreateProcessor` | `\MODX\Revolution\Processors\Resource\Create` | +| `\modResourceUpdateProcessor` | `\MODX\Revolution\Processors\Resource\Update` | + +`core/include/deprecated.php` даёт псевдонимы старых имён до 3.3. `require_once` путей 2.x падает. + +См. [Шаг 4: Настройка процессоров](extending-modx/custom-resources/step-4-processors). + ## Процессоры с плоскими файлами больше не поддерживаются Поддержка так называемых процессоров с плоскими файлами (которые заканчиваются на `.php` вместо `.class.php` и не используют класс процессора) была удалена. diff --git a/ru/getting-started/upgrading-to-3.0/system-settings.md b/ru/getting-started/upgrading-to-3.0/system-settings.md index f005d2433..033a5f458 100644 --- a/ru/getting-started/upgrading-to-3.0/system-settings.md +++ b/ru/getting-started/upgrading-to-3.0/system-settings.md @@ -13,6 +13,7 @@ MODX 3.0 очистил значительное количество стары - `manager_language` [#13786](https://github.com/modxcms/revolution/pull/13786), заменено автоматическое определение языка и переключение на лету в менеджере [#14046](https://github.com/modxcms/revolution/pull/14046). [Узнайте больше о языке менеджера в 3.0](getting-started/upgrading-to-3.0/manager-language) - `resolve_hostnames` и `server_protocol` были удалены [#14877](https://github.com/modxcms/revolution/pull/14877). Устаревшие настройки из MODX Evolution. - `upload_flash`, установите `upload_files` или `upload_images` или `allowedFileTypes` вместо медиа источника. [#14252](https://github.com/modxcms/revolution/pull/14252) +- `udperms_allowroot` и `webpwdreminder_message` [#14841](https://github.com/modxcms/revolution/pull/14841). Создание ресурсов в корне задаёт разрешение `new_document_in_root`. `webpwdreminder_message` был неиспользуемым шаблоном письма веб-пользователю. См. [udperms_allowroot](building-sites/settings/udperms_allowroot) и [webpwdreminder_message](building-sites/settings/webpwdreminder_message). - `cache_action_map` поскольку карта действий была полностью удалена, теперь официально исчезло modAction [#14927](https://github.com/modxcms/revolution/pull/14927) ## Измененные значения по умолчанию