Jump to main content Jump to doc navigation

MODX поставляется с гибким набором системных настроек. Они находятся в Система -> Системные настройки и могут быть легко отредактированы и изменены. Все системные настройки доступны в ваших шаблонах с помощью обозначения [[++placeholder]]. Посмотрите Теги шаблона для дополнительной информации.

Переопределение настроек (Наследование)

В то время как в этом документе в основном говорится о Системных настройках, MODX поставляется с очень мощной системой наследования, которая позволяет переопределять настройки в контексте, пользовательской группе или пользовательской настройке.

По сути, когда параметр запрашивается в сеансе определенного пользователя, параметры проверяются в следующем порядке:

  1. Настройка пользователя
  2. Настройка группы пользователей
  3. Настройка контекста (обратите внимание, что в менеджере контекст обычно называется mgr)
  4. Настройка системы

Создание новых системных настроек (через графический интерфейс)

Чтобы создать новый параметр системы, нажмите ссылку «Создать новые параметры» в разделе «Система» -> «Параметры системы».

Параметры

  • Ключ: в конечном итоге это уникальное имя вашего [[++placeholder]]
  • Имя: эта метка отображается в столбце «Имя» при просмотре всех настроек системы. Это значение может быть локализовано (см. Ниже).
  • Тип поля: в настоящее время поддерживаются 3 типа ввода: TextField, TextArea, Yes/No
  • Пространство имен: как с Пользовательские страницы менеджера, пространство имен определяет папку внутри core/components/.
  • Area Lexicon Entry: это значение влияет на группировку системных настроек; создайте несколько системных настроек, которые совместно используют «Область ввода лексики», и они будут сгруппированы вместе.
  • Значение: значение по умолчанию.
  • Описание: это значение может быть локализовано (см. Ниже).

Локализация

Значения, используемые для описания настроек системы, могут быть необязательно локализованы (т.е. переведены) путем ссылки на конкретный файл локализации. Ключи лексики следуют определенному формату:

  • Имя: setting_ + Key
  • Описание: setting_ + Key + _desc

Например, если мы посмотрим на Quip's [[++quip.emailsFrom]] настройки, мы видим, что он использует пространство имен quip. Ожидаемая структура папок состоит в том, чтобы искать файлы локализации в папке пространства имен, затем в папке «лексикона», затем в папках, разделенных по языковым кодам, и затем в default.inc.php файле, для примера core/components/quip/lexicon/en/default.inc.php

В нашем примере Quip мы видим имя setting_quip.emailsFrom и описание setting_quip.emailsFrom_desc. Эти два значения соответствуют ключам в $_lang массив внутри default.inc.php:

$_lang['setting_quip.emailsFrom'] = 'From Email';
$_lang['setting_quip.emailsFrom_desc'] = 'The email address to send system emails from.';

Мы рекомендуем вам щелкнуть правой кнопкой мыши существующий системный параметр и выбрать «Обновить системный параметр», чтобы получить представление о том, как это работает.

Получение настроек системы (программно)

Чтобы получить значение настройки из сниппета, плагина или другого PHP-кода, вы используете getOption функции и передачи ей уникальный ключ для опции, например:

$siteStartId = $modx->getOption('site_start');

В WordPress сопоставимая функция API get_option().

Эта функция извлекает значение из кэша настроек.

Сохранение настроек системы (программно)

Здесь все становится немного сложнее: когда мы получаем значение, используя getOption, мы получаем объект из кэша настроек. Это имеет явное преимущество в скорости, но это означает, что у нас по существу есть копия значения настройки, доступная только для чтения.

Пока есть метод setOption; это только обновляет кэш настроек в памяти.

Это по архитектурным причинам: системные настройки должны быть определены как configurations, NOT runtime dynamic values. Они обычно устанавливаются во время установки, а затем не часто обновляются. Однако могут быть законные времена, когда вам нужно обновить системные настройки программно, например, возможно, вы написали Пользовательская страница менеджера которая предлагает настраиваемую форму для ваших пользователей для своих системных настроек.

Если мы хотим обновить настройки системы, мы используем мощный xPDO getObject функция. Итак, давайте вернемся к нашему поиску простой настройки сайта и сравним ее рядом с более подробным (и более гибким) аналогом xPDO:

echo $modx->getOption('site_name');
// prints the same thing as this:
$setting = $modx->getObject('modSystemSetting', 'site_name');
if ($setting) {
    echo $setting->get('value');
}

Разница в том, что использование getObject извлекает объект из базы данных без кэширования, и мы можем делать с объектом гораздо больше вещей, включая сохранение этого объекта. Итак, вот как мы должны получить и сохранить настройки системы:

$setting = $modx->getObject('modSystemSetting', 'site_name');
$setting->set('value', 'My New Site Name');
$setting->save();

Однако обратите внимание, что это не очищает кэш настроек, поэтому любые последующие вызовы getOption по-прежнему будут возвращать более старую кешированную версию настройки.

Чтобы исправить это в MODX, вы должны очистить кеш. По крайней мере, кэш system_settings, но если вы используете значение параметра во сниппете или другой код, влияющий на интерфейс, кеш ресурсов тоже:

$cacheRefreshOptions =  [
    'system_settings' => [],
    'resource' => [],
];
$modx->cacheManager->refresh($cacheRefreshOptions);

В WordPress сопоставимая функция API update_option().

Получение метаданных настроек

Как только мы начнем извлекать Objects, которые представляют системные настройки, а не только их значение, мы можем увидеть все метаданные для любого заданного параметра (то есть все атрибуты). Посмотрите на этот код в качестве примера:

$Setting = $modx->getObject('modSystemSetting', 'site_name');
print_r( $Setting->toArray() );
/*
prints out something like this:
Array (
    [key] => site_name
    [value] => My Skiphop Site
    [xtype] => textfield
    [namespace] => core
    [area] => site
    [editedon] => 2010-10-24 21:53:55
)
*/

Как только вы поймете, как манипулировать объектами с помощью MODX и xPDO, вы сможете извлекать и изменять практически все внутри MODX, потому что практически все является объектом.

Получение списка связанных настроек

Если вы заметили в графическом интерфейсе выше, MODX позволяет несколько логично сгруппировать настройки системы. Самые полезные группировки - это area и префикс key. Использование xPDO getCollection Метод, мы можем легко предоставить некоторые критерии поиска, чтобы получить настройки, которые мы хотим.

Вот как мы можем получить все настройки из области «Почта»:

$relatedSettings = $modx->getCollection('modSystemSetting', array('area'=>'Mail'));
foreach ( $relatedSettings as $Setting ) {
        print $Setting->get('value');
}

Это естественным образом приводит нас к одной из других особенностей xPDO: xPDOQuery объект. Мы можем использовать его для передачи более сложных критериев нашему вызову getCollection. Вот как мы можем получить все настройки, которые используют префикс «quip»:

$query = $modx->newQuery('modSystemSetting');
$query->where(array('key:LIKE' => 'quip.%') );
$relatedSettings = $modx->getCollection('modSystemSetting', $query);
foreach ( $relatedSettings as $Setting ) {
    print $Setting->get('value');
}

Возможно, вы не ожидали введения в xPDO, пока вы просто пытались получить и установить системные настройки, но он там.

Создание системной настройки программно

Возможно, вы захотите создать Системные настройки программно, чтобы предоставить вашим пользователям более чистый UX / UI. В своем коде вы можете поместить что-то вроде следующего:

$MySetting = $modx->newObject('modSystemSetting');
$MySetting->set('key', 'mykey');
$MySetting->set('value', 'my_value');
$MySetting->set('xtype', 'textfield');
$MySetting->set('namespace', 'my_namespace');
$MySetting->set('area', 'MyArea');
$MySetting->save();
// Clear the cache:
$cacheRefreshOptions =  array( 'system_settings' => array() );
$modx->cacheManager->refresh($cacheRefreshOptions);

Обратите внимание, что вы должны создать записи лексики, которые соответствуют вашему имени ключа (см. Раздел «Локализация» выше):

  • Имя: setting_ + Key
  • Описание: setting_ + Key + _desc

Таким образом, в этом примере вам необходимо добавить следующие записи лексикона в загруженный вами лексикон:

$_lang['setting_mykey'] = 'Имя моей настройки';
$_lang['setting_mykey_desc'] = 'Описание моего ключа';

MODX заполняет значения для имени и описания на основе этих записей лексики.

Может оказаться полезным ссылаться на ваши локализованные языковые строки внутри ваших шаблонов или CMP. Это можно сделать с помощью тега лексикона, но вы должны указать тему «setting», например,

[[!%setting_emailsender? &topic=`setting` &namespace=`core` &language=`en`]]

Типы системных настроек

Атрибут xtype определяет, какой тип поля GUI будет использовать при рендеринге интерфейса для этого поля:

  • combo-boolean : сохраненные значения 1 и 0. Будет отображать «Да» и «Нет»
  • textfield : стандартное текстовое поле
  • textarea : стандартная текстовая область
  • text-password : стандартное поле пароля (ввод маскируется)
  • numberfield : используется для ввода цифр
  • modx-combo-language : позволяет пользователю выбрать язык
  • modx-combo-source :
  • modx-combo-template : позволяет пользователю выбрать шаблон
  • modx-combo-content-type : позволяет пользователю выбрать тип контента
  • modx-combo-charset : позволяет пользователю выбрать набор символов
  • modx-combo-rte : как текстовая область, но с элементами управления форматированием
  • modx-combo-context : позволяет пользователю выбрать контекст
  • modx-combo-manager-theme : позволяет пользователю выбрать тему оформления интерфейса менеджера MODX

Список настроек

Описание каждого параметра следующее:

  1. access_category_enabled
  2. access_context_enabled
  3. access_resource_group_enabled
  4. allow_duplicate_alias
  5. allow_forward_across_contexts
  6. allow_manager_login_forgot_password
  7. allow_multiple_emails
  8. allow_tags_in_post
  9. allow_tv_eval
  10. anonymous_sessions
  11. archive_with
  12. automatic_alias
  13. automatic_template_assignment
  14. auto_check_pkg_updates
  15. auto_check_pkg_updates_cache_expire
  16. auto_isfolder
  17. auto_menuindex
  18. base_help_url
  19. blocked_minutes
  20. cache_action_map
  21. cache_alias_map
  22. cache_context_settings
  23. cache_db
  24. cache_db_expires
  25. cache_db_session
  26. cache_db_session_lifetime
  27. cache_default
  28. cache_disabled
  29. cache_format
  30. cache_handler
  31. cache_json
  32. cache_json_expires
  33. cache_lang_js
  34. cache_lexicon_topics
  35. cache_noncore_lexicon_topics
  36. cache_resource
  37. cache_resource_clear_partial
  38. cache_resource_expires
  39. cache_scripts
  40. cache_system_settings
  41. clear_cache_refresh_trees
  42. compress_css
  43. compress_js
  44. compress_js_groups
  45. compress_js_max_files
  46. concat_js
  47. confirm_navigation
  48. container_suffix
  49. context_tree_sortby
  50. context_tree_sortdir
  51. context_tree_sort
  52. context_tree_sort
  53. cultureKey
  54. custom_resource_classes
  55. date_timezone
  56. debug
  57. default_content_type
  58. default_context
  59. default_duplicate_publish_option
  60. default_media_source
  61. default_media_source_type
  62. default_per_page
  63. default_template
  64. default_username
  65. editor_css_path
  66. editor_css_selectors
  67. emailsender
  68. emailsubject
  69. enable_dragdrop
  70. enable_gravatar
  71. error_log_filename
  72. error_log_filepath
  73. error_page
  74. extension_packages
  75. failed_login_attempts
  76. feed_modx_news
  77. feed_modx_news_enabled
  78. feed_modx_security
  79. feed_modx_security_enabled
  80. fe_editor_lang
  81. filemanager_path
  82. filemanager_path_relative
  83. filemanager_url
  84. filemanager_url_relative
  85. forgot_login_email
  86. form_customization_use_all_groups
  87. forward_merge_excludes
  88. friendly_alias_lowercase_only
  89. friendly_alias_max_length
  90. friendly_alias_realtime
  91. friendly_alias_restrict_chars
  92. friendly_alias_restrict_chars_pattern
  93. friendly_alias_strip_element_tags
  94. friendly_alias_translit
  95. friendly_alias_translit_class
  96. friendly_alias_translit_class_path
  97. friendly_alias_trim_chars
  98. friendly_alias_urls
  99. friendly_alias_word_delimiters
  100. friendly_alias_word_delimiter
  101. friendly_urls
  102. friendly_urls_strict
  103. friendly_url_prefix
  104. friendly_url_suffix
  105. global_duplicate_uri_check
  106. hidemenu_default
  107. inherit_parent_template
  108. link_tag_scheme
  109. locale
  110. lock_ttl
  111. log_deprecated
  112. log_level
  113. log_snippet_not_found
  114. log_target
  115. mail_charset
  116. mail_encoding
  117. mail_smtp_auth
  118. mail_smtp_autotls
  119. mail_smtp_helo
  120. mail_smtp_hosts
  121. mail_smtp_keepalive
  122. mail_smtp_pass
  123. mail_smtp_port
  124. mail_smtp_prefix
  125. mail_smtp_single_to
  126. mail_smtp_timeout
  127. mail_smtp_user
  128. mail_use_smtp
  129. main_nav_parent
  130. manager_date_format
  131. manager_direction
  132. manager_favicon_url
  133. manager_html5_cache
  134. manager_js_cache_file_locking
  135. manager_js_cache_max_age
  136. manager_js_document_root
  137. manager_js_zlib_output_compression
  138. manager_language
  139. manager_lang_attribute
  140. manager_login_url_alternate
  141. manager_theme
  142. manager_time_format
  143. manager_use_fullname
  144. manager_week_start
  145. mgr_source_icon
  146. mgr_tree_icon_context
  147. modx_browser_default_sort
  148. modx_browser_default_viewmode
  149. modx_browser_tree_hide_files
  150. modx_browser_tree_hide_tooltips
  151. modx_charset
  152. new_file_permissions
  153. new_folder_permissions
  154. parser_recurse_uncacheable
  155. password_generated_length
  156. password_min_length
  157. phpthumb_allow_src_above_docroot
  158. phpthumb_cache_maxage
  159. phpthumb_cache_maxfiles
  160. phpthumb_cache_maxsize
  161. phpthumb_cache_source_enabled
  162. phpthumb_document_root
  163. phpthumb_error_bgcolor
  164. phpthumb_error_fontsize
  165. phpthumb_error_textcolor
  166. phpthumb_far
  167. phpthumb_imagemagick_path
  168. phpthumb_nohotlink_enabled
  169. phpthumb_nohotlink_erase_image
  170. phpthumb_nohotlink_text_message
  171. phpthumb_nohotlink_valid_domains
  172. phpthumb_nooffsitelink_enabled
  173. phpthumb_nooffsitelink_erase_image
  174. phpthumb_nooffsitelink_require_refer
  175. phpthumb_nooffsitelink_text_message
  176. phpthumb_nooffsitelink_valid_domains
  177. phpthumb_nooffsitelink_watermark_src
  178. phpthumb_zoomcrop
  179. preserve_menuindex
  180. principal_targets
  181. proxy_auth_type
  182. proxy_host
  183. proxy_password
  184. proxy_port
  185. proxy_username
  186. publish_default
  187. rb_base_dir
  188. rb_base_url
  189. request_controller
  190. request_method_strict
  191. request_param_alias
  192. request_param_id
  193. resource_tree_node_name
  194. resource_tree_node_name_fallback
  195. resource_tree_node_tooltip
  196. richtext_default
  197. search_default
  198. send_poweredby_header
  199. server_offset_time
  200. server_protocol
  201. session_cookie_domain
  202. session_cookie_httponly
  203. session_cookie_lifetime
  204. session_cookie_path
  205. session_cookie_secure
  206. session_enabled
  207. session_gc_maxlifetime
  208. session_handler_class
  209. session_name
  210. settings_version
  211. setting_static_elements_basepath
  212. show_tv_categories_header
  213. signupemail_message
  214. site_name
  215. site_start
  216. site_status
  217. site_unavailable_message
  218. site_unavailable_page
  219. static_elements_automate_chunks
  220. static_elements_automate_plugins
  221. static_elements_automate_snippets
  222. static_elements_automate_templates
  223. static_elements_automate_tvs
  224. static_elements_basepath
  225. static_elements_default_category
  226. static_elements_default_mediasource
  227. strip_image_paths
  228. symlink_merge_fields
  229. syncsite_default
  230. tree_default_sort
  231. tree_root_id
  232. tvs_below_content
  233. udperms_allowroot
  234. ui_debug_mode
  235. unauthorized_page
  236. upload_files
  237. upload_maxsize
  238. user_nav_parent
  239. use_alias_path
  240. use_browser
  241. use_context_resource_table
  242. use_editor
  243. use_frozen_parent_uris
  244. use_multibyte
  245. use_weblink_target
  246. welcome_action
  247. welcome_namespace
  248. welcome_screen
  249. welcome_screen_url
  250. which_editor
  251. which_element_editor
  252. xhtml_urls

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

  • modmore
  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Raffy
  • eydolan
  • Digital Penguin
  • Fabian Christen
  • Dannevang Digital
  • deJaya
  • Sepia River Studios
  • Following Sea
  • Anton Tarasov
  • Lefthandmedia
  • Nick Clark
  • Chris Fickling
  • Murray Wood
  • YJ
  • CrewMark
  • Richard

Budget

$305 per month—let's make that $500!

Learn more