1.1. Переменные конфигурации

Здесь описаны все доступные переменные конфигурации K4. Каждая переменная представляет из себя запись в 2-х таблицах:

ConfigurationAdmin - визуальное представление переменной в административной консоли;
ConfigurationValues - значение переменной в административной консоли.

1.1.1. Core

название	описание	по умолчанию
UseCronForRegularEvent (int)	Указывает на способ выполнения регулярных событий. Если включить данную переменную, то все регулярные события будут выполняться только из cron.	0
UseChangeLog (int)	Добавлено в версии 4.3.0. Указывает на то, что изменения в базе должны писаться в журнал изменений.	0
KeepSessionOnBrowserClose (int)	Добавлено в версии 4.2.2: Ранее сессия пользователя была доступна и при повторном открытии браузера. Указывает на то, что при закрытии браузера НЕ должна теряться (expire) его сессия. По умолчанию выключена, т.е. при закрытии браузера сессия ТЕРЯЕТСЯ.	0
AutoRefreshIntervals (string)	Добавлено в версии 4.3.0. Возможные интервалы автоматического обновления списков. Указывается через запятую, задаётся в минутах. Доступно из «View Menu» у списков.	1,5,15,30,60,120,240
RememberLastAdminTemplate (int)	Добавлено в версии 4.3.1: Ранее последний шаблон в административной консоли всегда восстанавливался после прохождения идентификации. Указывает на то, что после прохождения идентификации пользователь не должен быть перенаправлен на последний посещённый им шаблон. Только для административной консоли.	0
SSL_URL (string)	Добавлено в версии 1.1.2. Здесь указывается адрес сайта, по которому он доступен при использовании в SSL режиме. Адрес всегда должен начинаться с `https://` и не заканчиваться на `/`.
AdminSSL_URL (string)	Добавлено в версии 4.3.1. Здесь указывается адрес сайта, по которому будет доступна его административная консоль при использовании в SSL режиме (`/admin` указывать не нужно). Адрес всегда должен начинаться с `https://` и не заканчиваться на `/`. Если значение данной конфигурационной переменной не указано, то будет использовано значение переменной SSL_URL.
Require_AdminSSL (int)	Добавлено в версии 4.1.0. Эта переменная конфигурации говорит о том, что в административную консоль можно заходить только используя защищённое соединение, т.е. SSL.	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-режиме). Осторожно Перед включением данной конфигурационной переменной нужно убедиться, что для сайта, указанного в конфигурационной переменной SSL_URL включена поддержка mod-rewrite (в настройках сервера).	0
AllowSelectGroupOnFront (int)	Добавлено в версии 4.3.1. Эта переменная разрешает пользователю на Front-End выбрать себе группу прав, которую он пожелает (виртуальное поле `UserGroup`). Можно выбирать только те группы, у которых это разрешено (см. поле FrontRegistration).	0
ForceImageMagickResize (int)	Добавлено в версии 4.3.1. Эта переменная которая говорит, что изображения масштабировать нужно при помощи программы ImageMagicк, даже если библиотека `GD` доступна в `PHP`.	0
Email_As_Login (int)	Добавлено в версии 1.1.0. Эта переменная конфигурации задаёт поле, используемое при авторизации на пользовательской части сайта. 1 - Email. 0 - Login.	0
RegistrationCaptcha (int)	Добавлено в версии 4.0.1. Эта переменная конфигурации определяет, требуется ли при регистрации новых пользователей с пользовательской части сайта ввод буквенно-числового кода, подтверждающего что системой намерен пользоваться человек а не робот. Значения: 1 - требуется. 0 - не требуется.	0
User_Allow_New (int)	Эта переменная определяет возможность регистрации новых пользователей с пользовательской части сайта. Значения: 1 - регистрация возможна, статус новых пользователей - активный 2 - регистрация не возможна 3 - регистрация возможна, статус новых пользователей - ожидают подтверждения со стороны администратора
User_NewGroup (int)	Эта переменная определяет группу пользователей, к которой новый пользователь приписывается если не была задана явно другая группа. $this->Application->GetVar('user_group') По соображениям безопасности переменная `user_group` таким образом работает только в административной консоли - чтобы посетители сайта не могли при регистрации назначить себе группу.
User_MembershipExpirationReminder (int)	В K4 пользователи могут состоять в группах пользователей (Member, Subscribers и.т.п.). Членство в группе может быть постоянным или временным. В случае временного членства, эта переменная определяет за сколько дней до окончания членства в группе пользователю, чьё членство должно скоро прекратиться, и администратору сайта, будет высылаться почтовое извещение (событие `USER.MEMBERSHIP.EXPIRATION.NOTICE`).
User_Password_Auto (int)	Эта переменная определяет должна ли система при создании нового пользователя автоматически сгенерировать пароль для этого пользователя. Значения: 1 - должна, 0 - не должна. Если эта опция включена, то в форме регистрации пользователя не надо показывать поля для ввода пароля.
FirstDayOfWeek (int)	Добавлено в версии 1.1.2. Эта переменная конфигурации определяет день недели, с которого начинается неделя и влияет на отображение календаря. Типичные значения: 1 - понедельник, 0 - воскресенье.	1
NoPermissionTemplate (string)	Добавлено в версии 1.2.0. Эта переменная конфигурации задаёт шаблон, на который происходит перенаправление в случае несоответствия прав доступа пользователя требованиям, предъявляемым для отображения исходной страницы пользовательской части сайта.	no_permission
SessionCookieName (string)	Добавлено в версии 1.1.4. Эта переменная конфигурации задаёт имя cookie, хранящей идентификатор сессии пользователя.	sid
SessionReferrerCheck (int)	Добавлено в версии 1.1.4. Эта переменная конфигурации определяет, должна ли происходить проверка переменной `$_SERVER['HTTP_REFERER']`, когда идентификатор сессии пользователя может передаваться в обход `cookies`. Проверка даёт дополнительные гарантии что система не обработает ложные `POST`-запросы, сгенерированные вне системы.	1
SessionTimeout (int)	Эта переменная конфигурации определяет как долго будет продолжаться сессия пользователя в случае отсутствия какой-либо активности с его стороны. Время задаётся в секундах. Время сохранения сессии ограничивается в целях безопасности.
Site_Name (string)	Эта переменная конфигурации задаёт название сайта, отображаемое в заголовках страниц, в электронных сообщениях, посылаемых с сайта.
Site_Path (string)	Эта переменная конфигурации задаёт путь к сайту относительно корневого каталога, соответствующего домену, используемому для доступа к сайту (`$_SERVER['DOCUMENT_ROOT']`). Например, если сайт находится в подкаталоге `dev`, значение этой переменной должно быть `/dev/`.
Smtp_AdminMailFrom (string)	Эта переменная конфигурации задаёт обратный адрес электронной почты, используемый по умолчанию в сообщениях электронной почты, отправляемых с сайта.	`portal@domain`, где `domain` - домен, указанный при инсталляции сайта
Smtp_Authenticate (int)	Эта переменная конфигурации определяет нужна ли авторизация при обращению к серверу электронной почты. Значения: 1 - нужна, 0 - не нужна.	0
Smtp_User (int)	Эта переменная конфигурации определяет имя пользователя для доступа к почтовому серверу, в случае когда требуется авторизация.
Smtp_Pass (int)	Эта переменная конфигурации определяет пароль для доступа к почтовому серверу, в случае когда требуется авторизация.
Smtp_Server (int)	Эта переменная конфигурации позволяет задать домен или `IP` почтового сервера в случае, если не годится почтовый сервер по умолчанию, задаваемый конфигурацией `PHP`.
UseModRewrite (int)	Добавлено в версии 1.1.4. Эта переменная конфигурации определяет способ адресации страниц на пользовательской части сайта. Значения: `0 - mod-rewrite` выключен, `1 - mod-rewrite` включен. Если `mod-rewrite` выключен, то при адресации страницы её положение в структуре сайта задаётся в переменной env. `http://www.somedomain.com/index.php?env=-in-commerce/product/details:m304-1-1-3-s-:p-41----` Если же `mod-rewrite` включен, то положение страницы в структуре сайта отображается в виде каталогов-подкаталогов, именованных в соответствии с названиями категорий сайта и названием текущего объекта когда таковой представлен на странице, `http://www.somedomain.com/products/bikes/incredi_bike.html` что бывает предпочтительно в смысле индексации сайта поисковыми роботами.	0
UseToolbarLabels (int)	Добавлено в версии 4.2.0. Эта переменная конфигурации определяет будут ли в административной консоли, в Toolbar-ах показываться текстовые надписи под кнопками. Значения: 1 - будут, 0 - не будут. Это значение используется в JavaScript-функциях, генерирующих кнопки.	1
YahooApplicationId (string)	Добавлено в версии 4.3.2. Эта переменная конфигурации позволяет задать Yahoo Application ID, которая в последствии будет использована для интеграции с возможностями, которые предоставляет сервис `Yahoo`. На данный момент она используется для осуществления орфографических подсказок на форме поиска.
FilenameSpecialCharReplacement (string)	Добавлено в версии 4.3.2. Эта переменная конфигурации позволяет символ, использующийся для замены запрещённых символов в названиях элементов, использующихся при построении ссылок в `mod-rewrite` режиме. До появления этой конфигурационной переменной использовался только символ `_`, но теперь его можно заменить на `-`.	`_`
QuickCategoryPermissionRebuild (string)	Добавлено в версии 5.0.0. Эта переменная конфигурации позволяет перестраивать кеш прав категорий (после сохранения категории) по быстрому, т.е. не используя `progress bar`.	`1`

1.1.2. In-Portal

название	описание	по умолчанию
RecycleBinFolder (int)	Добавлено в версии 4.2.2. Если указать, то все записи из каталога после удаления будут попадать в категорию с ID, указанным здесь.
UsePageHitCounter (int)	Добавлено в версии 4.3.0. Указывать на то, что нужно считать общее количество посещений сайта (т.е. захода на каждую страницу на Front-End).	0
PageHitCounter (int)	Добавлено в версии 4.3.0. Хранит в себе общее количество посещений сайта. Используется совместно с UsePageHitCounter.	0
RootPass (string)	Добавлено в версии 1.0.0. Эта переменная конфигурации хранит hash пароля главного администратора сайта и используется для проверки пароля при входе главного администратора в администраторскую часть сайта.	Задаётся администратором при инсталляции системы
Root_Name (string)	Добавлено в версии 1.0.0. Эта переменная содержит фразу, переводимую как название корневой категории системы (категории с номером 0). Используется для отображения элементов навигации.	lu_rootcategory_name

1.1.3. Proj-Base

название

описание

по умолчанию

UseSmallHeader (int)

Добавлено в версии 4.2.0.

Позволяет убрать заголовок на grid.

до	после

Будет работать только при использовании блока combined_header.

0

UsePopups (int)

Начинать создание/редактирование записей из grid в новом окне (popup).

1

TrimRequiredFields (int)

Добавлено в версии 4.2.2.

Указывает на то, что перед проверкой на наличие данных в обязательных полях к ним применяется функция trim().

0

MenuFrameWidth (int)

Добавлено в версии 4.2.2.

Позволяет задать ширину фрэйма c деревом (в пикселях), по умолчанию 200. Доступна только в Platform с версии

200

DefaultSettingsUserId (int)

Добавлено в версии 4.2.2.

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

ColumnPicker’а;
PerPage;
Filters.

Таким образом если красиво настроить все списки (включая ширины колонок, т.к. они теперь тоже хранятся в PersistentSession) для root’а или другого пользователя (указав его Id), то эти настройки будут работать для новых пользователей по умолчанию. Также в раздел Users Management -> Admins добавлена кнопка Reset (только в Platform), которая стирает персональные настройки выбранным пользователям (только те, что берутся от пользователя по умолчанию) и таким образом пользователю можно принудительно выставить настройки списков (правда сразу всех) по умолчанию. Переменная по умолчанию имеет значение -1, т.е. «root».

Примечание

Если не ввести значение, то всё равно будет интерпретировано, как -1 :(. Чтобы выключить данную функциональность нужно написать любое ID несуществующего пользователя, напр. 999999999999.

-1

AdvancedUserManagement (int)

Добавлено в версии 4.2.2.

Включает дополнительные возможности управления правами пользователей (администраторов) через группы. По умолчанию выключена. После включения необходимо очистить Sections Cache и перезагрузить фрейм с деревом. Параметр включает секцию Groups, в которой можно создавать группы по смыслу, а также просматривать и добавлять/удалять пользователей в этих группах. В редактировании администраторов добавляется закладка со списком групп в которых состоит пользователь. Для управления правами пользователей используется следующая схема: стандартной группе admin запрещается все, кроме права ADMIN.LOGIN, далее создаются группы по смыслу, которым разрешается доступ в нужные секции. Все администраторы автоматически добавляются в основную группу admin (при создании через соответствующую секцию). Далее их надо добавлять в нужные смысловые группы, НЕ УБИРАЯ из группы admin и НЕ МЕНЯЯ основную (primary) группу, т.к. в секции Administrators показываются пользователи, у которых основная группа - admin.

0

UseDoubleSorting (int)

Эта переменная конфигурации определяет как меняется сортировка в списках. Сортировка меняется при выполнении события OnSetSorting - например, когда мышкой нажимают на заголовок столбца с данными. При UseDoubleSorting = 0 (значение по умолчанию) в итоге получается фильтр только по одному столбцу, на заголовок которого нажали. Если же UseDoubleSorting = 1, и мышкой поочерёдно нажимали на заголовки разных столбцов, то фильтр будет по двум столбцам - вначале по столбцу, нажатому последним, а затем - по столбцу, нажатому предпоследним.

0

1.1.4. Proj-CMS

название	описание	по умолчанию
ProjCMSAllowManualFilenames (int)	Добавлено в версии 4.0.1. Эта переменная конфигурации разрешает пользователю редактировать название файла для mod-rewrite (галочка «Auto-filename» и само название файла).	0

1.1.5. In-Commerce

Переменные вида Comm_Shipping*** задают адрес с которого происходит доставка заказов и могут использоваться для расчёта стоимости доставки заказа.

название	описание	по умолчанию
Comm_RequireLoginBeforeCheckout (string)	Эта переменная конфигурации определяет должен ли покупатель авторизоваться на пользовательской части сайта для окончательного оформления заказа. 1 - должен авторизоваться. 0 - не должен.	0
Comm_Shipping_AddressLine1 (string)	Эта переменная конфигурации задаёт первую строку адреса с которого происходит доставка заказов.
Comm_Shipping_AddressLine2 (string)	Эта переменная конфигурации задаёт вторую строку адреса с которого происходит доставка заказов.
Comm_Shipping_City (string)	Эта переменная конфигурации задаёт город из которого происходит доставка заказов.
Comm_Shipping_Country (string)	Эта переменная конфигурации задаёт страну из которой происходит доставка заказов. Выбирается одно из значений `DestAbbr` таблицы `StdDestinations`.
Comm_Shipping_State (string)	Эта переменная конфигурации задаёт штат или провинцию откуда происходит доставка заказов.
Comm_Shipping_ZIP (string)	Эта переменная конфигурации задаёт почтовый индекс с которого происходит доставка заказов.

См. также

Предупреждение

Этот шаблон содержит поломанные ссылки.