K4:Configuration
From In-Portal Developers Guide
Current revision (11:31, 15 March 2015) (view source) |
|||
(One intermediate revision not shown.) | |||
Line 1: | Line 1: | ||
+ | {{Transferred|url = http://community.in-portal.org/pages/viewpage.action?pageId=14155801}} | ||
+ | |||
{{toc | category = Настройка системы | sortkey = 001.001}} | {{toc | category = Настройка системы | sortkey = 001.001}} | ||
- | + | Здесь описаны все доступные переменные конфигурации K4. Каждая переменная представляет из себя запись в 2-х таблицах: | |
- | * [[K4:ConfigurationAdmin|ConfigurationAdmin]] - | + | * [[K4:ConfigurationAdmin|ConfigurationAdmin]] - визуальное представление переменной в административной консоли; |
- | * [[K4:ConfigurationValues|ConfigurationValues]] - | + | * [[K4:ConfigurationValues|ConfigurationValues]] - значение переменной в административной консоли. |
- | == | + | == Переменные конфигурации == |
=== Core === | === Core === | ||
{| class="prettytable" | {| class="prettytable" | ||
- | ! | + | ! название || описание || по умолчанию |
|- | |- | ||
- | | {{ConfigProperty|UseCronForRegularEvent|int}} || | + | | {{ConfigProperty|UseCronForRegularEvent|int}} || Указывает на способ выполнения [[K4:Regular Events|регулярных событий]]. Если включить данную переменную, то все регулярные события будут выполняться только из cron. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|UseChangeLog|int}} || | + | | {{ConfigProperty|UseChangeLog|int}} || Указывает на то, что изменения в базе должны писаться в журнал изменений. Доступна с [[K4:Core v 4.3.0|Core v 4.3.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|KeepSessionOnBrowserClose|int}} || | + | | {{ConfigProperty|KeepSessionOnBrowserClose|int}} || Указывает на то, что при закрытии браузера НЕ должна теряться (expire) его сессия. По умолчанию выключена, т.е. при закрытии браузера сессия ТЕРЯЕТСЯ. Доступна с версии [[K4:Core v 4.2.2|Core v 4.2.2]]. {{TipBox|Ранее сессия пользователя была доступна и при повторном открытии браузера.}} |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|AutoRefreshIntervals|string}} || | + | | {{ConfigProperty|AutoRefreshIntervals|string}} || Возможные интервалы автоматического обновления списков. Указывается через запятую, задаётся в минутах. Доступно из "View Menu" у списков. Доступна с версии [[K4:Core v 4.3.0|Core v 4.3.0]]. |
| 1,5,15,30,60,120,240 | | 1,5,15,30,60,120,240 | ||
|- | |- | ||
- | | {{ConfigProperty|RememberLastAdminTemplate|int}} || | + | | {{ConfigProperty|RememberLastAdminTemplate|int}} || Указывает на то, что после прохождения идентификации пользователь не должен быть перенаправлен на последний посещённый им шаблон. Только для административной консоли. Доступна с версии [[K4:Core v 4.3.1|Core v 4.3.1]]. {{TipBox|Ранее последний шаблон в административной консоли всегда восстанавливался после прохождения идентификации.}} |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|SSL_URL|string}} || | + | | {{ConfigProperty|SSL_URL|string}} || Здесь указывается адрес сайта, по которому он доступен при использовании в SSL режиме. Адрес всегда должен начинаться с "'''<code>https://</code>'''" и не заканчиваться на "'''<code>/</code>'''". Доступна с версии [[K4:Core v 1.1.2|Core v 1.1.2]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|AdminSSL_URL|string}} || | + | | {{ConfigProperty|AdminSSL_URL|string}} || Здесь указывается адрес сайта, по которому будет доступна его административная консоль при использовании в SSL режиме ("<code>/admin</code>" указывать не нужно). Адрес всегда должен начинаться с "'''<code>https://</code>'''" и не заканчиваться на "'''<code>/</code>'''". Если значение данной конфигурационной переменной не указано, то будет использовано значение переменной [[#SSL_URL|SSL_URL]]. Доступна с версии [[K4:Core v 4.3.1|Core v 4.3.1]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Require_AdminSSL|int}} || | + | | {{ConfigProperty|Require_AdminSSL|int}} || Эта переменная конфигурации говорит о том, что в административную консоль можно заходить только используя защищённое соединение, т.е. SSL. Доступна с версии [[K4:Core v 4.1.0|Core v 4.1.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|Require_SSL|int}} || | + | | {{ConfigProperty|Require_SSL|int}} || Эта переменная конфигурации говорит о том, что при посещении шаблонов, на которых установлен тэг <code>m_CheckSSL</code> с параметром <code>condition="Require_SSL"</code> должен автоматически осуществляться переход в SSL-режим (конечно если сайт в таком уже не находиться). <source lang="xml"><inp2:m_CheckSSL mode="required" condition="Require_SSL"/></source> |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|Force_HTTP_When_SSL_Not_Required|int}} || | + | | {{ConfigProperty|Force_HTTP_When_SSL_Not_Required|int}} || Если эта конфигурационная переменная включена, то если пользователь находясь в SSL-режиме заходит на шаблон, который не требует наличия SSL-режима, то он будет автоматически перенаправлен на '''эквивалентный''' <code>http://</code> шаблон (напр. адрес "<code>'''https://'''<nowiki>www.test.com/no_ssl.html</nowiki></code>" станет "<code>'''http://'''<nowiki>www.test.com/no_ssl.html</nowiki></code>"). |
| 1 | | 1 | ||
|- | |- | ||
- | | {{ConfigProperty|UseModRewriteWithSSL|int}} || | + | | {{ConfigProperty|UseModRewriteWithSSL|int}} || Если данная переменная конфигурации включена и для пользовательской части сайта включён режим mod-rewrite, то ссылки в SSL-режиме тоже будут строиться используя mod-rewrite технологию (как и не в SSL-режиме). {{InfoBox|Перед включением данной конфигурационной переменной нужно убедиться, что для сайта, указанного в конфигурационной переменной [[#SSL_URL|SSL_URL]] включена поддержка mod-rewrite (в настройках сервера).}} |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|AllowSelectGroupOnFront|int}} || | + | | {{ConfigProperty|AllowSelectGroupOnFront|int}} || Эта переменная разрешает пользователю на Front-End выбрать себе [[K4:PortalGroup|группу]] прав, которую он пожелает (виртуальное поле <code>UserGroup</code>). Можно выбирать только те [[K4:PortalGroup|группы]], у которых это разрешено (см. поле [[K4:PortalGroup#FrontRegistration|FrontRegistration]]). Доступна с версии [[K4:Core v 4.3.1|Core v 4.3.1]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|ForceImageMagickResize|int}} || | + | | {{ConfigProperty|ForceImageMagickResize|int}} || Эта переменная которая говорит, что изображения масштабировать нужно при помощи программы [http://www.imagemagick.org/script/index.php ImageMagicк], даже если библиотека <code>GD</code> доступна <code>в PHP</code>. Доступна с версии [[K4:Core v 4.3.1|Core v 4.3.1]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|Email_As_Login|int}} || | + | | {{ConfigProperty|Email_As_Login|int}} || Эта переменная конфигурации задаёт поле, используемое при авторизации на пользовательской части сайта. 1 - Email. 0 - Login. Доступна с версии [[K4:Core v 1.1.0|Core v 1.1.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|RegistrationCaptcha|int}} || | + | | {{ConfigProperty|RegistrationCaptcha|int}} || Эта переменная конфигурации определяет, требуется ли при регистрации новых пользователей с пользовательской части сайта ввод буквенно-числового кода, подтверждающего что системой намерен пользоваться человек а не робот. Значения: 1 - требуется. 0 - не требуется. Доступна с версии [[K4:Core v 4.0.1|Core v 4.0.1]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|User_Allow_New|int}} || | + | | {{ConfigProperty|User_Allow_New|int}} || Эта переменная определяет возможность регистрации новых пользователей с пользовательской части сайта. Значения: |
- | *1 - | + | *1 - регистрация возможна, статус новых пользователей - активный |
- | *2 - | + | *2 - регистрация не возможна |
- | *3 - | + | *3 - регистрация возможна, статус новых пользователей - ожидают подтверждения со стороны администратора |
- | + | Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. | |
| 3 | | 3 | ||
|- | |- | ||
- | | {{ConfigProperty|User_NewGroup|int}} || | + | | {{ConfigProperty|User_NewGroup|int}} || Эта переменная определяет группу пользователей, к которой новый пользователь приписывается если не была задана явно другая группа. |
<source lang="php"> | <source lang="php"> | ||
$this->Application->GetVar('user_group') | $this->Application->GetVar('user_group') | ||
</source> | </source> | ||
- | + | По соображениям безопасности переменная <code>user_group</code> таким образом работает только в административной консоли - чтобы посетители сайта не могли при регистрации назначить себе группу. | |
+ | Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. | ||
| 13 (Member) | | 13 (Member) | ||
|- | |- | ||
- | | {{ConfigProperty|User_MembershipExpirationReminder|int}} || | + | | {{ConfigProperty|User_MembershipExpirationReminder|int}} || В K4 пользователи могут состоять в группах пользователей (Member, Subscribers и.т.п.). Членство в группе может быть постоянным или временным. В случае временного членства, эта переменная определяет за сколько дней до окончания членства в группе пользователю, чьё членство должно скоро прекратиться, и администратору сайта, будет высылаться [[K4:Отсылка почтового извещения|почтовое извещение]] (событие <code>USER.MEMBERSHIP.EXPIRATION.NOTICE</code>). |
+ | Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. | ||
| 10 | | 10 | ||
|- | |- | ||
- | | {{ConfigProperty|User_Password_Auto|int}} || | + | | {{ConfigProperty|User_Password_Auto|int}} || Эта переменная определяет должна ли система при создании нового пользователя автоматически сгенерировать пароль для этого пользователя. Значения: 1 - должна, 0 - не должна. Если эта опция включена, то в форме регистрации пользователя не надо показывать поля для ввода пароля. |
+ | Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. | ||
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|FirstDayOfWeek|int}} || | + | | {{ConfigProperty|FirstDayOfWeek|int}} || Эта переменная конфигурации определяет день недели, с которого начинается неделя и влияет на отображение календаря. Типичные значения: 1 - понедельник, 0 - воскресенье. Доступна с версии [[K4:Core v 1.1.2|Core v 1.1.2]]. |
| 1 | | 1 | ||
|- | |- | ||
- | | {{ConfigProperty|NoPermissionTemplate|string}} || | + | | {{ConfigProperty|NoPermissionTemplate|string}} || Эта переменная конфигурации задаёт шаблон, на который происходит перенаправление в случае несоответствия прав доступа пользователя требованиям, предъявляемым для отображения исходной страницы пользовательской части сайта. Доступна с версии [[K4:Core v 1.2.0|Core v 1.2.0]]. |
| no_permission | | no_permission | ||
|- | |- | ||
- | | {{ConfigProperty|SessionCookieName|string}} || | + | | {{ConfigProperty|SessionCookieName|string}} || Эта переменная конфигурации задаёт имя cookie, хранящей идентификатор сессии пользователя. Доступна с версии [[K4:Core v 1.1.4|Core v 1.1.4]]. |
| sid | | sid | ||
|- | |- | ||
- | | {{ConfigProperty|SessionReferrerCheck|int}} || | + | | {{ConfigProperty|SessionReferrerCheck|int}} || Эта переменная конфигурации определяет, должна ли происходить проверка переменной <code>$_SERVER['HTTP_REFERER']</code>, когда идентификатор сессии пользователя может передаваться в обход <code>cookies</code>. Проверка даёт дополнительные гарантии что система не обработает ложные <code>POST</code>-запросы, сгенерированные вне системы. Доступна с версии [[K4:Core v 1.1.4|Core v 1.1.4]]. |
| 1 | | 1 | ||
|- | |- | ||
- | | {{ConfigProperty|SessionTimeout|int}} || | + | | {{ConfigProperty|SessionTimeout|int}} || Эта переменная конфигурации определяет как долго будет продолжаться сессия пользователя в случае отсутствия какой-либо активности с его стороны. Время задаётся в секундах. Время сохранения сессии ограничивается в целях безопасности. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| 3600 | | 3600 | ||
|- | |- | ||
- | | {{ConfigProperty|Site_Name|string}} || | + | | {{ConfigProperty|Site_Name|string}} || Эта переменная конфигурации задаёт название сайта, отображаемое в заголовках страниц, в электронных сообщениях, посылаемых с сайта. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| KernelX | | KernelX | ||
|- | |- | ||
- | | {{ConfigProperty|Site_Path|string}} || | + | | {{ConfigProperty|Site_Path|string}} || Эта переменная конфигурации задаёт путь к сайту относительно корневого каталога, соответствующего домену, используемому для доступа к сайту (<code>$_SERVER['DOCUMENT_ROOT']</code>). Например, если сайт находится в подкаталоге <code>dev</code>, значение этой переменной должно быть <code>/dev/</code>. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| / | | / | ||
|- | |- | ||
- | | {{ConfigProperty|Smtp_AdminMailFrom|string}} || | + | | {{ConfigProperty|Smtp_AdminMailFrom|string}} || Эта переменная конфигурации задаёт обратный адрес электронной почты, используемый по умолчанию в сообщениях электронной почты, отправляемых с сайта. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
- | | <code>portal@'''domain'''</code>, | + | | <code>portal@'''domain'''</code>, где <code>'''domain'''</code> - домен, указанный при инсталляции сайта |
|- | |- | ||
- | | {{ConfigProperty|Smtp_Authenticate|int}} || | + | | {{ConfigProperty|Smtp_Authenticate|int}} || Эта переменная конфигурации определяет нужна ли авторизация при обращению к серверу электронной почты. Значения: 1 - нужна, 0 - не нужна. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|Smtp_User|int}} || | + | | {{ConfigProperty|Smtp_User|int}} || Эта переменная конфигурации определяет имя пользователя для доступа к почтовому серверу, в случае когда требуется авторизация. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Smtp_Pass|int}} || | + | | {{ConfigProperty|Smtp_Pass|int}} || Эта переменная конфигурации определяет пароль для доступа к почтовому серверу, в случае когда требуется авторизация. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Smtp_Server|int}} || | + | | {{ConfigProperty|Smtp_Server|int}} || Эта переменная конфигурации позволяет задать домен или <code>IP</code> почтового сервера в случае, если не годится почтовый сервер по умолчанию, задаваемый конфигурацией <code>PHP</code>. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|UseModRewrite|int}} || | + | | {{ConfigProperty|UseModRewrite|int}} || Эта переменная конфигурации определяет способ адресации страниц на пользовательской части сайта. Значения: <code>0 - mod-rewrite</code> выключен, <code>1 - mod-rewrite</code> включен. Если <code>mod-rewrite</code> выключен, то при адресации страницы её положение в структуре сайта задаётся в переменной env. |
<code>http://www.somedomain.com/index.php?env=-in-commerce/product/details:m304-1-1-3-s-:p-41----</code> | <code>http://www.somedomain.com/index.php?env=-in-commerce/product/details:m304-1-1-3-s-:p-41----</code> | ||
- | + | Если же <code>mod-rewrite</code> включен, то положение страницы в структуре сайта отображается в виде каталогов-подкаталогов, именованных в соответствии с названиями категорий сайта и названием текущего объекта когда таковой представлен на странице, | |
<code>http://www.somedomain.com/products/bikes/incredi_bike.html</code> | <code>http://www.somedomain.com/products/bikes/incredi_bike.html</code> | ||
- | + | что бывает предпочтительно в смысле индексации сайта поисковыми роботами. Доступна с версии [[K4:Core v 1.1.4|Core v 1.1.4]]. | |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|UseToolbarLabels|int}} || | + | | {{ConfigProperty|UseToolbarLabels|int}} || Эта переменная конфигурации определяет будут ли в административной консоли, в Toolbar-ах показываться текстовые надписи под кнопками. Значения: 1 - будут, 0 - не будут. Это значение используется в JavaScript-функциях, генерирующих кнопки. Доступна с версии [[K4:Core v 4.2.0|Core v 4.2.0]]. |
| 1 | | 1 | ||
|- | |- | ||
- | | {{ConfigProperty|YahooApplicationId|string}} || | + | | {{ConfigProperty|YahooApplicationId|string}} || Эта переменная конфигурации позволяет задать [http://developer.yahoo.com/wsregapp/ Yahoo Application ID], которая в последствии будет использована для интеграции с возможностями, которые предоставляет сервис <code>Yahoo</code>. На данный момент она используется для осуществления [[K4:SpellingDictionary|орфографических подсказок]] на форме поиска. Доступна с версии [[K4:Core v 4.3.2|Core v 4.3.2]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|FilenameSpecialCharReplacement|string}} || | + | | {{ConfigProperty|FilenameSpecialCharReplacement|string}} || Эта переменная конфигурации позволяет символ, использующийся для замены запрещённых символов в названиях элементов, использующихся при построении ссылок в <code>mod-rewrite</code> режиме. До появления этой конфигурационной переменной использовался только символ "<code>_</code>", но теперь его можно заменить на "<code>-</code>". Доступна с версии [[K4:Core v 4.3.2|Core v 4.3.2]]. |
| <code>_</code> | | <code>_</code> | ||
+ | |- | ||
+ | | {{ConfigProperty|QuickCategoryPermissionRebuild|string}} || Эта переменная конфигурации позволяет перестраивать кеш прав категорий (после сохранения категории) по быстрому, т.е. не используя <code>progress bar</code>. Доступна с версии [[K4:Core v 5.0.0|Core v 5.0.0]]. | ||
+ | | <code>1</code> | ||
|} | |} | ||
=== In-Portal === | === In-Portal === | ||
{| class="prettytable" | {| class="prettytable" | ||
- | ! | + | ! название || описание || по умолчанию |
|- | |- | ||
- | | {{ConfigProperty|RecycleBinFolder|int}} || | + | | {{ConfigProperty|RecycleBinFolder|int}} || Если указать, то все записи из каталога после удаления будут попадать в категорию с ID, указанным здесь. Доступна с [[K4:Core v 4.2.2|Core v 4.2.2]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|UsePageHitCounter|int}} || | + | | {{ConfigProperty|UsePageHitCounter|int}} || Указывать на то, что нужно считать общее количество посещений сайта (т.е. захода на каждую страницу на Front-End). Доступна с [[K4:Core v 4.3.0|Core v 4.3.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|PageHitCounter|int}} || | + | | {{ConfigProperty|PageHitCounter|int}} || Хранит в себе общее количество посещений сайта. Используется совместно с [[#UsePageHitCounter|UsePageHitCounter]]. Доступна с [[K4:Core v 4.3.0|Core v 4.3.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|RootPass|string}} || | + | | {{ConfigProperty|RootPass|string}} || Эта переменная конфигурации хранит hash пароля главного администратора сайта и используется для проверки пароля при входе главного администратора в администраторскую часть сайта. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
- | | | + | | Задаётся администратором при инсталляции системы |
|- | |- | ||
- | | {{ConfigProperty|Root_Name|string}} || | + | | {{ConfigProperty|Root_Name|string}} || Эта переменная содержит фразу, переводимую как название корневой категории системы (категории с номером 0). Используется для отображения элементов навигации. Доступна с версии [[K4:Core v 1.0.0|Core v 1.0.0]]. |
| lu_rootcategory_name | | lu_rootcategory_name | ||
|} | |} | ||
Line 154: | Line 162: | ||
=== Proj-Base === | === Proj-Base === | ||
{| class="prettytable" | {| class="prettytable" | ||
- | ! | + | ! название || описание || по умолчанию |
|- | |- | ||
- | | {{ConfigProperty|UseSmallHeader|int}} || | + | | {{ConfigProperty|UseSmallHeader|int}} || Позволяет убрать заголовок на grid. |
{| class="prettytable vertical-table" | {| class="prettytable vertical-table" | ||
- | ! | + | ! до || после |
|- | |- | ||
| [[Image:Normal grid header.gif|thumb]] || [[Image:Small grid header.gif|thumb]] | | [[Image:Normal grid header.gif|thumb]] || [[Image:Small grid header.gif|thumb]] | ||
|} | |} | ||
- | + | Будет работать только при использовании блока '''<code>combined_header</code>'''. Доступна с [[K4:Core v 4.2.0|Core v 4.2.0]]. | |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|UsePopups|int}} || | + | | {{ConfigProperty|UsePopups|int}} || Начинать создание/редактирование записей из grid в новом окне (popup). |
| 1 | | 1 | ||
|- | |- | ||
- | | {{ConfigProperty|TrimRequiredFields|int}} || | + | | {{ConfigProperty|TrimRequiredFields|int}} || Указывает на то, что перед проверкой на наличие данных в обязательных полях к ним применяется функция <code>trim()</code>. Доступна с версии [[K4:Core v 4.2.2|Core v 4.2.2]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|MenuFrameWidth|int}} || | + | | {{ConfigProperty|MenuFrameWidth|int}} || Позволяет задать ширину фрэйма c деревом (в пикселях), по умолчанию 200. Доступна только в Platform с версии [[K4:Core v 4.2.2|Core v 4.2.2]]. |
| 200 | | 200 | ||
|- | |- | ||
- | | {{ConfigProperty|DefaultSettingsUserId|int}} || | + | | {{ConfigProperty|DefaultSettingsUserId|int}} || Пользователь, который используется когда новый администратор (у которого еще нет данных [[K4:PersistantSessionData|PersistentSession]]) первый раз заходит на любой список. Такому администратору проставляются значения [[K4:PersistantSessionData|PersistentSession]] от пользователя с указанным в этой переменной ID, а именно данные: |
- | * ColumnPicker; | + | * ColumnPicker'а; |
* PerPage; | * PerPage; | ||
* Filters. | * Filters. | ||
- | + | Таким образом если красиво настроить все списки (включая ширины колонок, т.к. они теперь тоже хранятся в [[K4:PersistantSessionData|PersistentSession]]) для root'а или другого пользователя (указав его Id), то эти настройки будут работать для новых пользователей по умолчанию. Также в раздел "<code>Users Management -> Admins</code>" добавлена кнопка <code>Reset</code> (только в Platform), которая стирает персональные настройки выбранным пользователям (только те, что берутся от пользователя по умолчанию) и таким образом пользователю можно принудительно выставить настройки списков (правда сразу всех) по умолчанию. Переменная по умолчанию имеет значение <code>-1</code>, т.е. "root". Доступна с версии [[K4:Core v 4.2.2|Core v 4.2.2]]. | |
- | {{TipBox| | + | {{TipBox|Если не ввести значение, то всё равно будет интерпретировано, как "<code>-1</code>" :(. Чтобы выключить данную функциональность нужно написать любое <code>ID</code> несуществующего пользователя, напр. <code>999999999999</code>.}} |
| -1 | | -1 | ||
|- | |- | ||
- | | {{ConfigProperty|AdvancedUserManagement|int}} || | + | | {{ConfigProperty|AdvancedUserManagement|int}} || Включает дополнительные возможности управления правами пользователей (администраторов) через группы. По умолчанию выключена. После включения необходимо очистить Sections Cache и перезагрузить фрейм с деревом. Параметр включает секцию <code>Groups</code>, в которой можно создавать группы по смыслу, а также просматривать и добавлять/удалять пользователей в этих группах. В редактировании администраторов добавляется закладка со списком групп в которых состоит пользователь. Для управления правами пользователей используется следующая схема: стандартной группе <code>admin</code> запрещается все, кроме права <code>ADMIN.LOGIN</code>, далее создаются группы по смыслу, которым разрешается доступ в нужные секции. Все администраторы автоматически добавляются в основную группу <code>admin</code> (при создании через соответствующую секцию). Далее их надо добавлять в нужные смысловые группы, НЕ УБИРАЯ из группы <code>admin</code> и НЕ МЕНЯЯ основную (primary) группу, т.к. в секции <code>Administrators</code> показываются пользователи, у которых основная группа - <code>admin</code>. Доступна только в Platform с версии [[K4:Core v 4.2.2|Core v 4.2.2]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|UseDoubleSorting|int}} || | + | | {{ConfigProperty|UseDoubleSorting|int}} || Эта переменная конфигурации определяет как меняется сортировка в списках. Сортировка меняется при выполнении события <code>OnSetSorting</code> - например, когда мышкой нажимают на заголовок столбца с данными. При <code>UseDoubleSorting = 0</code> (значение по умолчанию) в итоге получается фильтр только по одному столбцу, на заголовок которого нажали. Если же <code>UseDoubleSorting = 1</code>, и мышкой поочерёдно нажимали на заголовки разных столбцов, то фильтр будет по двум столбцам - вначале по столбцу, нажатому последним, а затем - по столбцу, нажатому предпоследним. |
| 0 | | 0 | ||
|} | |} | ||
Line 191: | Line 199: | ||
=== Proj-CMS === | === Proj-CMS === | ||
{| class="prettytable" | {| class="prettytable" | ||
- | ! | + | ! название || описание || по умолчанию |
|- | |- | ||
- | | {{ConfigProperty|ProjCMSAllowManualFilenames|int}} || | + | | {{ConfigProperty|ProjCMSAllowManualFilenames|int}} || Эта переменная конфигурации разрешает пользователю редактировать название файла для mod-rewrite (галочка "Auto-filename" и само название файла). Доступна с версии [[K4:Core v 4.0.1|Core v 4.0.1]]. |
| 0 | | 0 | ||
|} | |} | ||
=== In-Commerce === | === In-Commerce === | ||
- | + | Переменные вида <code>Comm_Shipping***</code> задают адрес с которого происходит доставка заказов и могут использоваться для расчёта стоимости доставки заказа. | |
{| class="prettytable" | {| class="prettytable" | ||
- | ! | + | ! название || описание || по умолчанию |
|- | |- | ||
- | | {{ConfigProperty|Comm_RequireLoginBeforeCheckout|int}} || | + | | {{ConfigProperty|Comm_RequireLoginBeforeCheckout|int}} || Эта переменная конфигурации определяет должен ли покупатель авторизоваться на пользовательской части сайта для окончательного оформления заказа. 1 - должен авторизоваться. 0 - не должен. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| 0 | | 0 | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_AddressLine1|string}} || | + | | {{ConfigProperty|Comm_Shipping_AddressLine1|string}} || Эта переменная конфигурации задаёт первую строку адреса с которого происходит доставка заказов. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_AddressLine2|string}} || | + | | {{ConfigProperty|Comm_Shipping_AddressLine2|string}} || Эта переменная конфигурации задаёт вторую строку адреса с которого происходит доставка заказов. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_City|string}} || | + | | {{ConfigProperty|Comm_Shipping_City|string}} || Эта переменная конфигурации задаёт город из которого происходит доставка заказов. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_Country|string}} || | + | | {{ConfigProperty|Comm_Shipping_Country|string}} || Эта переменная конфигурации задаёт страну из которой происходит доставка заказов. Выбирается одно из значений <code>DestAbbr</code> таблицы <code>StdDestinations</code>. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_State|string}} || | + | | {{ConfigProperty|Comm_Shipping_State|string}} || Эта переменная конфигурации задаёт штат или провинцию откуда происходит доставка заказов. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|- | |- | ||
- | | {{ConfigProperty|Comm_Shipping_ZIP|string}} || | + | | {{ConfigProperty|Comm_Shipping_ZIP|string}} || Эта переменная конфигурации задаёт почтовый индекс с которого происходит доставка заказов. Доступна с версии [[K4:In-Commerce v 1.0.0|In-Commerce v 1.0.0]]. |
| | | | ||
|} | |} | ||
- | == | + | == См. также == |
* [[K4:ConfigurationAdmin|ConfigurationAdmin]] | * [[K4:ConfigurationAdmin|ConfigurationAdmin]] | ||
* [[K4:ConfigurationValues|ConfigurationValues]] | * [[K4:ConfigurationValues|ConfigurationValues]] |
Current revision
This article was transferred! You see this message because current Article was transferred to http://community.in-portal.org/pages/viewpage.action?pageId=14155801. |
| ||
---|---|---|
Статьи в этой категории | ||
|
Здесь описаны все доступные переменные конфигурации K4. Каждая переменная представляет из себя запись в 2-х таблицах:
- ConfigurationAdmin - визуальное представление переменной в административной консоли;
- ConfigurationValues - значение переменной в административной консоли.
Contents |
Переменные конфигурации
Core
название | описание | по умолчанию | ||
---|---|---|---|---|
UseCronForRegularEvent (int) | Указывает на способ выполнения регулярных событий. Если включить данную переменную, то все регулярные события будут выполняться только из cron. | 0 | ||
UseChangeLog (int) | Указывает на то, что изменения в базе должны писаться в журнал изменений. Доступна с Core v 4.3.0. | 0 | ||
KeepSessionOnBrowserClose (int) | Указывает на то, что при закрытии браузера НЕ должна теряться (expire) его сессия. По умолчанию выключена, т.е. при закрытии браузера сессия ТЕРЯЕТСЯ. Доступна с версии Core v 4.2.2. | 0 | ||
AutoRefreshIntervals (string) | Возможные интервалы автоматического обновления списков. Указывается через запятую, задаётся в минутах. Доступно из "View Menu" у списков. Доступна с версии Core v 4.3.0. | 1,5,15,30,60,120,240 | ||
RememberLastAdminTemplate (int) | Указывает на то, что после прохождения идентификации пользователь не должен быть перенаправлен на последний посещённый им шаблон. Только для административной консоли. Доступна с версии Core v 4.3.1. | 0 | ||
SSL_URL (string) | Здесь указывается адрес сайта, по которому он доступен при использовании в SSL режиме. Адрес всегда должен начинаться с "https:// " и не заканчиваться на "/ ". Доступна с версии Core v 1.1.2.
| |||
AdminSSL_URL (string) | Здесь указывается адрес сайта, по которому будет доступна его административная консоль при использовании в SSL режиме ("/admin " указывать не нужно). Адрес всегда должен начинаться с "https:// " и не заканчиваться на "/ ". Если значение данной конфигурационной переменной не указано, то будет использовано значение переменной SSL_URL. Доступна с версии Core v 4.3.1.
| |||
Require_AdminSSL (int) | Эта переменная конфигурации говорит о том, что в административную консоль можно заходить только используя защищённое соединение, т.е. SSL. Доступна с версии Core v 4.1.0. | 0 | ||
Require_SSL (int) | Эта переменная конфигурации говорит о том, что при посещении шаблонов, на которых установлен тэг m_CheckSSL с параметром condition="Require_SSL" должен автоматически осуществляться переход в SSL-режим (конечно если сайт в таком уже не находиться). <inp2:m_CheckSSL mode="required" condition="Require_SSL"/> | 0 | ||
Force_HTTP_When_SSL_Not_Required (int) | Если эта конфигурационная переменная включена, то если пользователь находясь в SSL-режиме заходит на шаблон, который не требует наличия SSL-режима, то он будет автоматически перенаправлен на эквивалентный http:// шаблон (напр. адрес "https://www.test.com/no_ssl.html " станет "http://www.test.com/no_ssl.html ").
| 1 | ||
UseModRewriteWithSSL (int) | Если данная переменная конфигурации включена и для пользовательской части сайта включён режим mod-rewrite, то ссылки в SSL-режиме тоже будут строиться используя mod-rewrite технологию (как и не в SSL-режиме).
| 0 | ||
AllowSelectGroupOnFront (int) | Эта переменная разрешает пользователю на Front-End выбрать себе группу прав, которую он пожелает (виртуальное поле UserGroup ). Можно выбирать только те группы, у которых это разрешено (см. поле FrontRegistration). Доступна с версии Core v 4.3.1.
| 0 | ||
ForceImageMagickResize (int) | Эта переменная которая говорит, что изображения масштабировать нужно при помощи программы ImageMagicк, даже если библиотека GD доступна в PHP . Доступна с версии Core v 4.3.1.
| 0 | ||
Email_As_Login (int) | Эта переменная конфигурации задаёт поле, используемое при авторизации на пользовательской части сайта. 1 - Email. 0 - Login. Доступна с версии Core v 1.1.0. | 0 | ||
RegistrationCaptcha (int) | Эта переменная конфигурации определяет, требуется ли при регистрации новых пользователей с пользовательской части сайта ввод буквенно-числового кода, подтверждающего что системой намерен пользоваться человек а не робот. Значения: 1 - требуется. 0 - не требуется. Доступна с версии Core v 4.0.1. | 0 | ||
User_Allow_New (int) | Эта переменная определяет возможность регистрации новых пользователей с пользовательской части сайта. Значения:
Доступна с версии Core v 1.0.0. | 3 | ||
User_NewGroup (int) | Эта переменная определяет группу пользователей, к которой новый пользователь приписывается если не была задана явно другая группа.
$this->Application->GetVar('user_group') По соображениям безопасности переменная | 13 (Member) | ||
User_MembershipExpirationReminder (int) | В K4 пользователи могут состоять в группах пользователей (Member, Subscribers и.т.п.). Членство в группе может быть постоянным или временным. В случае временного членства, эта переменная определяет за сколько дней до окончания членства в группе пользователю, чьё членство должно скоро прекратиться, и администратору сайта, будет высылаться почтовое извещение (событие USER.MEMBERSHIP.EXPIRATION.NOTICE ).
Доступна с версии Core v 1.0.0. | 10 | ||
User_Password_Auto (int) | Эта переменная определяет должна ли система при создании нового пользователя автоматически сгенерировать пароль для этого пользователя. Значения: 1 - должна, 0 - не должна. Если эта опция включена, то в форме регистрации пользователя не надо показывать поля для ввода пароля.
Доступна с версии Core v 1.0.0. | 0 | ||
FirstDayOfWeek (int) | Эта переменная конфигурации определяет день недели, с которого начинается неделя и влияет на отображение календаря. Типичные значения: 1 - понедельник, 0 - воскресенье. Доступна с версии Core v 1.1.2. | 1 | ||
NoPermissionTemplate (string) | Эта переменная конфигурации задаёт шаблон, на который происходит перенаправление в случае несоответствия прав доступа пользователя требованиям, предъявляемым для отображения исходной страницы пользовательской части сайта. Доступна с версии Core v 1.2.0. | no_permission | ||
SessionCookieName (string) | Эта переменная конфигурации задаёт имя cookie, хранящей идентификатор сессии пользователя. Доступна с версии Core v 1.1.4. | sid | ||
SessionReferrerCheck (int) | Эта переменная конфигурации определяет, должна ли происходить проверка переменной $_SERVER['HTTP_REFERER'] , когда идентификатор сессии пользователя может передаваться в обход cookies . Проверка даёт дополнительные гарантии что система не обработает ложные POST -запросы, сгенерированные вне системы. Доступна с версии Core v 1.1.4.
| 1 | ||
SessionTimeout (int) | Эта переменная конфигурации определяет как долго будет продолжаться сессия пользователя в случае отсутствия какой-либо активности с его стороны. Время задаётся в секундах. Время сохранения сессии ограничивается в целях безопасности. Доступна с версии Core v 1.0.0. | 3600 | ||
Site_Name (string) | Эта переменная конфигурации задаёт название сайта, отображаемое в заголовках страниц, в электронных сообщениях, посылаемых с сайта. Доступна с версии Core v 1.0.0. | KernelX | ||
Site_Path (string) | Эта переменная конфигурации задаёт путь к сайту относительно корневого каталога, соответствующего домену, используемому для доступа к сайту ($_SERVER['DOCUMENT_ROOT'] ). Например, если сайт находится в подкаталоге dev , значение этой переменной должно быть /dev/ . Доступна с версии Core v 1.0.0.
| / | ||
Smtp_AdminMailFrom (string) | Эта переменная конфигурации задаёт обратный адрес электронной почты, используемый по умолчанию в сообщениях электронной почты, отправляемых с сайта. Доступна с версии Core v 1.0.0. | portal@domain , где domain - домен, указанный при инсталляции сайта
| ||
Smtp_Authenticate (int) | Эта переменная конфигурации определяет нужна ли авторизация при обращению к серверу электронной почты. Значения: 1 - нужна, 0 - не нужна. Доступна с версии Core v 1.0.0. | 0 | ||
Smtp_User (int) | Эта переменная конфигурации определяет имя пользователя для доступа к почтовому серверу, в случае когда требуется авторизация. Доступна с версии Core v 1.0.0. | |||
Smtp_Pass (int) | Эта переменная конфигурации определяет пароль для доступа к почтовому серверу, в случае когда требуется авторизация. Доступна с версии Core v 1.0.0. | |||
Smtp_Server (int) | Эта переменная конфигурации позволяет задать домен или IP почтового сервера в случае, если не годится почтовый сервер по умолчанию, задаваемый конфигурацией PHP . Доступна с версии Core v 1.0.0.
| |||
UseModRewrite (int) | Эта переменная конфигурации определяет способ адресации страниц на пользовательской части сайта. Значения: 0 - mod-rewrite выключен, 1 - mod-rewrite включен. Если mod-rewrite выключен, то при адресации страницы её положение в структуре сайта задаётся в переменной env.
Если же
что бывает предпочтительно в смысле индексации сайта поисковыми роботами. Доступна с версии Core v 1.1.4. | 0 | ||
UseToolbarLabels (int) | Эта переменная конфигурации определяет будут ли в административной консоли, в Toolbar-ах показываться текстовые надписи под кнопками. Значения: 1 - будут, 0 - не будут. Это значение используется в JavaScript-функциях, генерирующих кнопки. Доступна с версии Core v 4.2.0. | 1 | ||
YahooApplicationId (string) | Эта переменная конфигурации позволяет задать Yahoo Application ID, которая в последствии будет использована для интеграции с возможностями, которые предоставляет сервис Yahoo . На данный момент она используется для осуществления орфографических подсказок на форме поиска. Доступна с версии Core v 4.3.2.
| |||
FilenameSpecialCharReplacement (string) | Эта переменная конфигурации позволяет символ, использующийся для замены запрещённых символов в названиях элементов, использующихся при построении ссылок в mod-rewrite режиме. До появления этой конфигурационной переменной использовался только символ "_ ", но теперь его можно заменить на "- ". Доступна с версии Core v 4.3.2.
| _
| ||
QuickCategoryPermissionRebuild (string) | Эта переменная конфигурации позволяет перестраивать кеш прав категорий (после сохранения категории) по быстрому, т.е. не используя progress bar . Доступна с версии Core v 5.0.0.
| 1
|
In-Portal
название | описание | по умолчанию |
---|---|---|
RecycleBinFolder (int) | Если указать, то все записи из каталога после удаления будут попадать в категорию с ID, указанным здесь. Доступна с Core v 4.2.2. | |
UsePageHitCounter (int) | Указывать на то, что нужно считать общее количество посещений сайта (т.е. захода на каждую страницу на Front-End). Доступна с Core v 4.3.0. | 0 |
PageHitCounter (int) | Хранит в себе общее количество посещений сайта. Используется совместно с UsePageHitCounter. Доступна с Core v 4.3.0. | 0 |
RootPass (string) | Эта переменная конфигурации хранит hash пароля главного администратора сайта и используется для проверки пароля при входе главного администратора в администраторскую часть сайта. Доступна с версии Core v 1.0.0. | Задаётся администратором при инсталляции системы |
Root_Name (string) | Эта переменная содержит фразу, переводимую как название корневой категории системы (категории с номером 0). Используется для отображения элементов навигации. Доступна с версии Core v 1.0.0. | lu_rootcategory_name |
Proj-Base
название | описание | по умолчанию | ||||
---|---|---|---|---|---|---|
UseSmallHeader (int) | Позволяет убрать заголовок на grid.
Будет работать только при использовании блока | 0 | ||||
UsePopups (int) | Начинать создание/редактирование записей из grid в новом окне (popup). | 1 | ||||
TrimRequiredFields (int) | Указывает на то, что перед проверкой на наличие данных в обязательных полях к ним применяется функция trim() . Доступна с версии Core v 4.2.2.
| 0 | ||||
MenuFrameWidth (int) | Позволяет задать ширину фрэйма c деревом (в пикселях), по умолчанию 200. Доступна только в Platform с версии Core v 4.2.2. | 200 | ||||
DefaultSettingsUserId (int) | Пользователь, который используется когда новый администратор (у которого еще нет данных PersistentSession) первый раз заходит на любой список. Такому администратору проставляются значения PersistentSession от пользователя с указанным в этой переменной ID, а именно данные:
Таким образом если красиво настроить все списки (включая ширины колонок, т.к. они теперь тоже хранятся в PersistentSession) для root'а или другого пользователя (указав его Id), то эти настройки будут работать для новых пользователей по умолчанию. Также в раздел " | -1 | ||||
AdvancedUserManagement (int) | Включает дополнительные возможности управления правами пользователей (администраторов) через группы. По умолчанию выключена. После включения необходимо очистить Sections Cache и перезагрузить фрейм с деревом. Параметр включает секцию Groups , в которой можно создавать группы по смыслу, а также просматривать и добавлять/удалять пользователей в этих группах. В редактировании администраторов добавляется закладка со списком групп в которых состоит пользователь. Для управления правами пользователей используется следующая схема: стандартной группе admin запрещается все, кроме права ADMIN.LOGIN , далее создаются группы по смыслу, которым разрешается доступ в нужные секции. Все администраторы автоматически добавляются в основную группу admin (при создании через соответствующую секцию). Далее их надо добавлять в нужные смысловые группы, НЕ УБИРАЯ из группы admin и НЕ МЕНЯЯ основную (primary) группу, т.к. в секции Administrators показываются пользователи, у которых основная группа - admin . Доступна только в Platform с версии Core v 4.2.2.
| 0 | ||||
UseDoubleSorting (int) | Эта переменная конфигурации определяет как меняется сортировка в списках. Сортировка меняется при выполнении события OnSetSorting - например, когда мышкой нажимают на заголовок столбца с данными. При UseDoubleSorting = 0 (значение по умолчанию) в итоге получается фильтр только по одному столбцу, на заголовок которого нажали. Если же UseDoubleSorting = 1 , и мышкой поочерёдно нажимали на заголовки разных столбцов, то фильтр будет по двум столбцам - вначале по столбцу, нажатому последним, а затем - по столбцу, нажатому предпоследним.
| 0 |
Proj-CMS
название | описание | по умолчанию |
---|---|---|
ProjCMSAllowManualFilenames (int) | Эта переменная конфигурации разрешает пользователю редактировать название файла для mod-rewrite (галочка "Auto-filename" и само название файла). Доступна с версии Core v 4.0.1. | 0 |
In-Commerce
Переменные вида Comm_Shipping***
задают адрес с которого происходит доставка заказов и могут использоваться для расчёта стоимости доставки заказа.
название | описание | по умолчанию |
---|---|---|
Comm_RequireLoginBeforeCheckout (int) | Эта переменная конфигурации определяет должен ли покупатель авторизоваться на пользовательской части сайта для окончательного оформления заказа. 1 - должен авторизоваться. 0 - не должен. Доступна с версии In-Commerce v 1.0.0. | 0 |
Comm_Shipping_AddressLine1 (string) | Эта переменная конфигурации задаёт первую строку адреса с которого происходит доставка заказов. Доступна с версии In-Commerce v 1.0.0. | |
Comm_Shipping_AddressLine2 (string) | Эта переменная конфигурации задаёт вторую строку адреса с которого происходит доставка заказов. Доступна с версии In-Commerce v 1.0.0. | |
Comm_Shipping_City (string) | Эта переменная конфигурации задаёт город из которого происходит доставка заказов. Доступна с версии In-Commerce v 1.0.0. | |
Comm_Shipping_Country (string) | Эта переменная конфигурации задаёт страну из которой происходит доставка заказов. Выбирается одно из значений DestAbbr таблицы StdDestinations . Доступна с версии In-Commerce v 1.0.0.
| |
Comm_Shipping_State (string) | Эта переменная конфигурации задаёт штат или провинцию откуда происходит доставка заказов. Доступна с версии In-Commerce v 1.0.0. | |
Comm_Shipping_ZIP (string) | Эта переменная конфигурации задаёт почтовый индекс с которого происходит доставка заказов. Доступна с версии In-Commerce v 1.0.0. |