Содержание
Engine Site Configuration — документация по CrafterCMS 3.1.28
Crafter Engine обеспечивает гибкую систему конфигурации, которая позволяет администраторам сайта изменять
поведение сайта без необходимости модификации какого-либо кода. Некоторые свойства используются Crafter
Engine, но разработчики также могут добавлять любые пользовательские свойства, необходимые для их кода. Все
свойства будут доступны разработчикам в шаблонах Freemarker и сценариях Groovy с помощью
siteConfig
переменная.
- Файлы конфигурации XML
-
-
/config/engine/site-config.xml
Основная конфигурация XML для сайта, этот файл всегда будет загружаться Crafter Engine. Этот файл может
легко получить доступ с любого сайта, созданного с помощью готовых чертежей, путем навигации из
Панель инструментов Studio дляSite Config
>Configuration
и, наконец, выборEngine Site
из выпадающего списка.
Конфигурация -
/config/engine/{crafterEnv}-site-config.xml
Конфигурация XML для конкретной среды, эти файлы будут загружены только тогда, когда значение
Свойствоcrafter.engine.environment
соответствует заполнителю crafterEnv в имени файла. -
$TOMCAT/shared/classes/crafter/engine/extension/sites/{siteName}/site-config.xml
Внешняя конфигурация XML, этот файл всегда будет загружаться Crafter Engine, если он присутствует и
позволит изменять конфигурации без необходимости модификации файлов в репозитории сайта.
-
Примечание
Свойства будут переопределены в соответствии с порядком загрузки файлов, который совпадает с
список выше: основной сайт-config.xml, среда site-config.xml, внешний сайт-config.xml
Если одно и то же свойство присутствует во всех файлах, будет использовано значение из внешнего файла.
Примечание
Используется конфигурация Apache Commons (https://commons. apache.org/proper/commons-configuration/).
для чтения всех файлов конфигурации. Переменная siteConfig
является экземпляром
XMLконфигурация
класс.
Свойства конфигурации
Этот пример файла содержит свойства, используемые Crafter Engine:
site-config.xml
1 2 3 139140<сайт> 141 142index.xml 143en 144 145 146 151 152 153 <совместимость> 154false 155 совместимость> 156 157 158 159<фильтры> 160 <фильтр> 161 162 <отображение> 163 <включить>/**включить> 164 165 фильтр> 166 <фильтр> 167 168 <отображение> 169 <включить>/**включить> 170 отображение> 171 фильтр> 172 <фильтр> 173 174 <отображение> 175 <включить>/**включить> 176/static-assets/** 177 178 фильтр> 179фильтры> 180 181 182 <кор> 183true 1843600 185* 186GET\, POST\, PUT 187Content-Type 188true 189 190 191 192 <нацеливание> 193 <включено>правдавключено> 194/сайт/веб-сайт 195/сайт/веб-сайт/index\.xml 196en,ja,ja_JP,ja_JP_JP 197ru 198true 199false 200 таргетинг> 201 202 203 <профиль> 204205 207 профиль> 208 209 210 <безопасность> 211 <самл> 212 <токен>SOME_RANDOM_TOKENтокен> 213 <группы> 214 <группа> 215 <имя>ЧЛЕН 216${enc:q3l5YNoKh48RldAkg6EAGjxlI7+K7Cl4iEmMJNlemNOjcuhaaQNPLwAB824QcJKCbEeLfsg+QSfHCYNcNP/yMw==} 206memberUser 217 групп> 218 групп> 219 <атрибуты> 220 <атрибут> 221 <имя>данноеИмяимя> 222имя 223 атрибут> 224 атрибуты> 225 самл> 226 <логин> 227/signin 228/home 229true 230/signin?error=loginFailure 231 логин> 232 <выход> 233/дом 234 выход> 235 <доступ запрещен> 236/signin?error=accessDenied 237 238 <ограничения URL> 239 <ограничение> 240/* 241 <выражение>hasRole('ПОЛЬЗОВАТЕЛЬ')выражение> 242 ограничение> 243 244 безопасность> 245 246 247 <социальные подключения> 248249 252 социальные подключения> 253 254 255 <работы> 256 <папка_работы> 257 <путь>/scripts/jobs/morejobs 258${enc:ENCRYPTED_APP_ID} 250${enc:ENCRYPTED_APP_SECRET} 2510 0/15 * * * ? 259 папка_работы> 260 <должность> 261 <путь>/scripts/jobs/testJob. groovyпуть> 2620 0/15 * * * ? 263 работа> 264 работы> 265 266 267 <кэш> 268 <разминка> 269/site:3 270/скрипты/шаблоны 271 разогрев> 272 кэш> 273сайт>
- Свойства движка Crafter
-
-
indexFileName: Имя индексного файла страницы (по умолчанию
index.xml
). -
defaultLocale: Язык по умолчанию для сайта. Используется с таргетингом контента посредством локализации.
-
navigation.additionalFields: Список дополнительных полей для включения в элементы динамической навигации (пример:
myTitle_s,myAuthor_s,… ) -
spa: Используется для свойств одностраничного приложения (SPA) (React JS, Angular, Vue.js и т. д.). Содержит элемент
/
) или имя шаблона (например,/template/web/app.ftl
). По умолчанию/
) -
compatibility.disableFullModelTypeConversion: Отключает полное преобразование типа модели содержимого для режима обратной совместимости (по умолчанию false)
До версии 2 включительно:
Crafter Engine, только в хосте FreeMarker, преобразует элементы модели на основе подсказки типа суффикса, но только для первого уровня в
модели, а не для _dt. Например, для contentModel.myvalue_i возвращается целое число, а для contentModel.repeater.myvalue_i
и contentModel.date_dt возвращается строка. В узле Groovy никаких преобразований не выполнялось.В версии 3 и выше:
Crafter Engine преобразует элементы с любыми подсказками типа суффикса (включая _dt) на любом уровне содержимого.
модели и для хостов Freemarker и Groovy. -
фильтры: Используется для определения сопоставления фильтров. Каждый элемент
-