K4:Configuration

From In-Portal Developers Guide

Path to article:

Сообщество > Документация > Настройка системы

(Difference between revisions)

Jump to: navigation, search

You need to have JavaScript enabled to use this page.

Current revision

Настройка системы

Статьи в этой категории

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

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

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

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-режиме).

Перед включением данной конфигурационной переменной нужно убедиться, что для сайта, указанного в конфигурационной переменной SSL_URL включена поддержка mod-rewrite (в настройках сервера).

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)

Эта переменная определяет возможность регистрации новых пользователей с пользовательской части сайта. Значения:

1 - регистрация возможна, статус новых пользователей - активный
2 - регистрация не возможна
3 - регистрация возможна, статус новых пользователей - ожидают подтверждения со стороны администратора

Доступна с версии Core v 1.0.0.

3

User_NewGroup (int)

Эта переменная определяет группу пользователей, к которой новый пользователь приписывается если не была задана явно другая группа.

$this->Application->GetVar('user_group')

По соображениям безопасности переменная user_group таким образом работает только в административной консоли - чтобы посетители сайта не могли при регистрации назначить себе группу. Доступна с версии Core v 1.0.0.

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.

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

что бывает предпочтительно в смысле индексации сайта поисковыми роботами. Доступна с версии 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.

до	после

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

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, а именно данные:

ColumnPicker'а;
PerPage;
Filters.

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

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

-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.

См. также

@@ Line 1: / Line 1: @@
+{{Transferred|url = http://community.in-portal.org/pages/viewpage.action?pageId=14155801}}
 {{toc | category = Настройка системы | sortkey = 001.001}}
 Здесь описаны все доступные переменные конфигурации K4. Каждая переменная представляет из себя запись в 2-х таблицах:
@@ Line 133: / Line 135: @@
 | {{ConfigProperty|FilenameSpecialCharReplacement|string}} || Эта переменная конфигурации позволяет символ, использующийся для замены запрещённых символов в названиях элементов, использующихся при построении ссылок в <code>mod-rewrite</code> режиме. До появления этой конфигурационной переменной использовался только символ "<code>_</code>", но теперь его можно заменить на "<code>-</code>". Доступна с версии [[K4:Core v 4.3.2|Core v 4.3.2]].
 | <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 Developers Guide

K4:Configuration

From In-Portal Developers Guide

Current revision

Contents

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

Core

In-Portal

Proj-Base

Proj-CMS

In-Commerce

См. также

Search

Navigation

Toolbox

Personal tools