Документация для разработчиков

Настройки главного модуля

Меню страницы

  • Форма настройки модуля
  • Закладка "Настройки"
  • Закладка "Почта и СМС"
  • Закладка "Авторизация"
  • Закладка "Журнал событий"
  • Закладка "Система обновлений"
  • Закладка "Доступ"
  • Служебные процедуры
  • Закладка "Публичная часть"
  • Закладка "Контроллер"
  • Форма Настройки модуля служит для управления глобальными настройками как сайта в целом, так и каждого модуля в отдельности. Для удобства работы форма разделена на закладки. Каждая закладка содержит логически сгруппированный набор полей, позволяющих выполнять определённые действия по настройке выбранного модуля.

    Перейти к форме настройки модулей можно, нажав кнопку Настройки на административной панели, либо из административного меню: Настройки > Настройки продукта > Настройки модулей.

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

    Следующие модули не имеют форм настроек:

    • Внешние источники данных;
    • Веб-сервисы;
    • Дизайнер бизнес-процессов;
    • Менеджер идей;
    • Компрессия;
    • Конструктор отчётов;
    • Планёрки и собрания.

    Ниже приводится описание настроек Главного модуля.

    Форма настройки модуля

    Закладка "Настройки"

    На данной вкладке выполняется настройка общих параметров Главного модуля.

    ПолеОписание
    Системные настройки
    Язык по умолчанию для административной частиОпределяет, какой язык используется для административной части по умолчанию.
    Название сайтаНазвание, используемое для всех сайтов по умолчанию.
    URL сайта (без http://)Web-адрес, используемый по умолчанию в качестве адресов сайтов, работающих под управлением системы (вводится без http://). Например: www.mysite.com
    Имя префикса для названия cookies (без точек и пробелов)Строка, добавляемая к имени cookie.
    Использовать общие файлы cookies для всех доменов. Используется для модулей Статистика, Реклама, Опросы, Форумы и некоторых других модулей.

    Установка флага в это поле также дает возможность организовать "сквозную" авторизацию на сайтах, работающих под управлением системы.
    Посылать в заголовке статус 200 на 404 ошибкуЕсли опция включена, то при отправке ответа Страница не найдена в случае ошибочного запроса будет отправлен статус операции ОК.
    Режим вывода ошибок (error_reporting)Определяет, какие сообщения об ошибках в работе системы будут выводиться на экран (обычно используется для отладки).
    • Только ошибки - выводить сообщения только об ошибках;
    • Ошибки и предупреждения- выводить сообщения об ошибках, а также предупреждения о возможности возникновения ошибки;
    • Не выводить- не показывать сообщения об ошибках.
    Использовать горячие клавишиРазрешение/запрет на использование горячих клавиш в продукте.
    Галерея смайлов для парсераВыбор набора смайлов, который будет использован парсером системы. Выбирается из загруженных наборов на странице Наборы смайлов.
    Файлы
    Ограничение дискового пространства (Мб) При необходимости вы можете задать ограничение (в Мб) на дисковое пространство.
    Папка по умолчанию для загрузки файловПапка, в которую будут попадать файлы (например, картинки) при загрузке на сайт. Путь к папке указывается относительно корня сайта.
    Сохранять исходные имена загружаемых файловЕсли опция отключена, то при загрузке файлов на сайт (например, изображений) оригинальные имена этих файлов сохранены не будут. Файлам будут автоматически присваиваться имена, состоящие из случайных символов.

    Если же опция включена, то вместо переименования файлов создаётся подпапка с именем, состоящим из случайных символов; само же имя файла сохраняется. Это позволяет сохранять оригинальное осмысленное имя файла, что полезно, например, при скачивании файла посетителями.
    Производить транслитерацию имени файлаЕсли же опция включена, то при загрузке файла произойдёт автоматическая транслитерация имени файла, если исходный файл имеет название на кириллице.

    Функция работает, если включена опция Сохранять исходные имена загружаемых файлов

    Автоматически заменять невалидные символы в именах загружаемых файловЕсли флаг Сохранять исходные имена загружаемых файлов включен, то при включении данной опции все небезопасные символы в именах файлов (нелатинские, цифры и некоторые другие) будут заменяться на произвольные латинские.
    Если опция выключена, система не позволит сохранять файлы с небезопасными именами.
    Данная возможность введена для обеспечения кроссплатформенной совместимости.
    Максимальный размер документа, из которого будут сгенерированы pdf и jpgПоля для ограничения размеров файлов (в Мб), используемых при работе модуля Трансформер.

    Только для "Битрикс24 в коробке".

    Максимальный размер видео, из которого будут сгенерированы mp4 и jpg
    Качество JPG при масштабировании изображений (в процентах)Задается уровень сжатия в процентах для *.JPG файлов при масштабировании.
    Быстрая отдача файлов через NginxЗадаёт способ отдачи файлов: через Nginx или Apache.

    Файл на скачивание с проверкой прав отдаётся с помощью метода CFile::ViewByUser. Если читать файл на php, то это занимает время на бекенде и существенно зависит от размера файла. При включенной опции метод после проверки прав выставляет заголовок X-Accel-Redirect и прекращает работу. Этот заголовок обрабатывается ngnix, который сам считывает указанный файл с диска, освобождая бекенд. При этом дополнительная настройка ngnix не требуется.

    Изображения в профиле пользователя
    Максимальная ширина в пикселяхУказание максимально возможной ширины изображения.
    Максимальная высота в пикселяхУказание максимально возможной высоты изображения.
    Максимальный размер файла в байтахУказание максимально возможного размера файла.
    Эти поля - не ресайз изображения, а проверка на заданные ограничения на загружаемый файл. В случае превышения ограничений файл не будет загружен, выведется соответсвующее уведомление.
    Оптимизация CSS
    Объединять CSS файлыВсе файлы стилей будет сведены в один файл для выдачи клиенту.
    Объединять JS файлыВсе JS файлы в один файл для выдачи клиенту.
    Подключать минифицированные версии CSS и JS файловМинифицированная версия файлов имеет суффикс .min в названии: style.min.css и script.min.js. Это касается любых файлов, подключаемых через SetAdditionalCSS и AddHeadScript. Если время изменения исходного файла больше минифицированного, то подключится исходный.
    Переместить весь Javascript в конец страницыJS скрипты будут загружаться после загрузки кода всей страницы. Опция ускоряет загрузку страницы, но выполнение активных сценариев будет производиться после загрузки страницы.
    Создавать сжатую копию объединенных CSS и JS файловСистема создаст сжатый файл .gz и отдаст его клиенту. При установке флажка создается сжатый файл, для того чтобы nginx не сжимал файл js и css "на лету", а брал уже готовый файл.
    Внешние сервисы перевода
    Ключ сервиса Яндекс.ПереводДля автоматической генерации символьных кодов используется Яндекс.Перевод. Требуется зарегистрироваться на сайте API Яндекса, получить ключ и указать его в настройках модуля. Используемая версия API Яндекс.Перевода - 1.5.
    Если ключ не указан, осуществляется транслитерация.
    Часовые пояса
    Локальное время сервераИнформация о текущем времени сервера, на котором установлен сайт. Показывает, в каком поясе фактически работает сервер. Для корректной работы системы часовых поясов должна быть правильная комбинация времени и смещения от UTC (18:26:10 +0300). Из продукта время и пояс не настраиваются, они просто должны быть правильными. Если что-то не так, нужно настраивать ОС и/или PHP и БД.

    Доступно для PHP 5.2.0 и выше

    Разрешить использование часовых поясовРазрешение на использование часовых поясов,отличных от Локального времени сервера. При отключенной галочке запросы к БД будут немного короче.
    При включённой опции станут активными дополнительные поля. Список полей, активных при выборе опции Разрешить использование часовых поясов:
    Поле Описание
    Часовой пояс сервера по умолчаниюВыбор часового пояса, который должен использоваться на сайте вместо Локального времени сервера. Поле указывает, в какой/из какого часового пояса будут конвертированы даты по умолчанию. Например, сайт стоит на разделяемом хостинге в США, фактически работает по чикагскому времени. Управлять системным временем на хостинге возможности нет. На сайте - форумы с преимущественно калининградскими посетителями. Необходимо выбрать зону Europe/Kaliningrad - и сообщения форума показываются по калининградскому времени для всех, даже для анонимов. Эта настройка может быть переопределена конкретным пользователем под себя.
    По умолчанию автоматически определять часовой пояс по браузеруУстановить эту опцию, если не используются другие способы определения времени клиента. В этом случае время определяется по времени браузера клиента. Опция особенно полезна в корпоративном портале, где часовые пояса имеют большое значение.
    .
    Сервис рекомендаций
    Использовать сервис рекомендаций товаровВключает использование сервиса BigData.
    Карта сайта
    Тип меню для нулевого уровня карты сайтаНазвание типа меню, пункты которого будут использоваться в качестве вершин карты сайта. Можно указать несколько типов меню через запятую, если предполагается использовать больше 2-х уровней вложенности.
    Тип меню для остальных уровней карты сайтаНазвание типа меню, пункты которого будут использоваться в качестве ветвей карты сайта. Можно указать несколько типов меню через запятую, если предполагается использовать больше 2-х уровней вложенности.
    Богатые ссылки
    Включить богатые ссылкиПри установке флажка ссылки в публичной части будут отображаться с выводом части информации с указанной страницы. (В Битрикс24 в коробке опция включена по умолчанию.)
    Сохранять изображения локальноПри включённой опции первом просмотре богатой ссылки загружается картинка и потом она достаётся из кеша. То есть повторные просмотры - производятся быстрее. Кроме того, некоторые сайты не любят, когда их контент напрямую вставляют в чужие страницы, и отдают access denied вместо изображения.
    Редактор изображений
    Разрешить редактирование изображений с внешних сайтовПараметр определяет можно ли открывать в редакторе изображения которые находятся на внешних ресурсах.
    Изначально картинка редактируется на удаленном сервере, просто проксируется поток. Но это все потенциально небезопасно (см. политику CORS). Поэтому пользователь может указать список доверенных ресурсов, с которых можно редактировать. По умолчанию редактировать можно только картинки с текущего хоста.
    Список разрешенных сайтовС помощью ссылки Добавить сайт указываются сайты (как правило это - CDN) с которых разрешено редактировать изображения.
    Панель инструментов публичного раздела
    Всегда показывать панель для пользователейС помощью ссылки Добавить пользователей можно указать для каких групп пользователей, пользователей или структурных подразделений необходимо всегда отображать панель управления (независимо от имеющихся прав доступа).
    Никогда не показывать панель для пользователей:С помощью ссылки Добавить пользователей можно указать для каких групп пользователей, пользователей или структурных подразделений не нужно отображать панель управления (независимо от имеющихся прав доступа).

    Закладка "Почта и СМС"

    Секция появляется при установленном и настроенном модуле Служба сообщений (messageservice)
    ПолеОписание
    Почта
    E-Mail адрес или список адресов через запятую, на который будут дублироваться все исходящие сообщенияВсе почтовые сообщения из системы почтовых событий сайта будут дублироваться на указанный e-mail адрес (адреса). В почтовых шаблонах адреса из этого поля выводятся по макросу #BCC#.

    Внимание! Не дублируются почтовые сообщения: из модуля Форум, уведомления Магазина.
    Отправлять в письме идентификаторы почтового события и шаблонаПри отмеченной опции в каждом письме будут присутствовать данные, уникально идентифицирующие это письмо.
    Дублировать E-Mail адрес в заголовокАдрес по умолчанию получателя сообщений с сайта. Значение данного поля используется, например, при формировании сообщений автоматической рассылки.

    Отметьте этот флаг, если письма с сайта приходят без поля TO.
    E-Mail администратора сайта (отправитель по умолчанию)По умолчанию в качестве e-mail адреса отправителя письма с сайта будет подставляться этот адрес.
    Конвертировать символы новой строки Unix формата в Windows формат при отправке emailЕсли опция включена, то переводы строк конвертируются из односимвольного формата UNIX в двухсимвольный Windows (CR+LF).
    Конвертировать 8-битные символы в заголовке письмаЕсли символы с кодом выше 127 (т.е. 8-битные) в заголовках отправляемых с сайта писем отображаются некорректно, то включите эту опцию. В этом случае все подобные символы в заголовке будут переданы в кодировке Base64.
    Отправлять картинки в виде вложений в письмоФлажок, установленный в этом поле разрешит отправлять вложения в виде файла. Рекомендуется при использовании модуля Email-маркетинг.
    Генерировать текстовую версию для html-писемПо умолчанию включено. При включённой опции автоматически создаётся текстовая версия отправляемых писем.
    Максимальный размер файлов вложения в байтахУстанавливается ограничение на размер вложений в письмо. Значение 0 - вложения без ограничений.
    Сколько дней хранить почтовые событияКоличество дней, в течение которого будут сохраняться почтовые события.
    Сколько писем отправлять за один хитКоличество писем, отправляемых за один хит.
    Дополнительный параметр для передачи функции mailУказывается дополнительный параметр для передачи функции mail.
    Протокол в ссылках письмаУказывается протокол, который будет проставляться в относительные ссылки сообщения. Если протокол не указан, по умолчанию используется HTTP.
    Отправка СМС
    Служба отправки СМС по умолчанию:Одна из подключённых служб выбирается как служба по умолчанию.
    Номер отправителя по умолчанию:После выбора службы по умолчанию в этом поле автоматически появится список номеров из личного кабинета выбранной службы. Укажите один из них как номер отправителя.
    Форматирование телефонных номеров
    Страна по умолчаниюВыбор страны по правилам которой телефонный номер будет преобразован из местного формата в международный.

    Закладка "Авторизация"

    ПолеОписание
    Настройки локальной системы авторизации
    Разрешить запоминание авторизацииОпределяет, выводить ли флажок "Запомнить меня на этом компьютере" в форме авторизации.
    Использовать защищенное хранение авторизации в cookiesОпределяет, будет ли использоваться шифрация при сохранении идентификационной информация в файлах cookies.
    Установка флага в это поле позволяет организовать "сквозную" авторизацию на всех сайтах, работающих под управлением системы. Т.е. авторизация пользователя в одном домене автоматически будет распространяться на все домены всех сайтов. Предварительно необходимо разрешить распространение файлов cookies на все домены.
    Разрешить авторизацию через внешние сервисыПри отмеченной опции для авторизации можно будет использовать внешние сервисы типа LiveID.
    Разрешить авторизацию HTTP DigestВ Windows 7/Office 2010 отказались от поддержки авторизации HTTP Basic без SSL, т.к. пароль передается в открытом виде. При этом поддерживается авторизация HTTP Digest, при которой пароль не передается в открытом виде, т.е. SSL не обязателен. С версии 10 такой тип авторизации поддерживается в библиотеке документов. Может применяться только для встроенной авторизации.
    Страница регистрации (для системного компонента авторизации)Указывается путь к странице авторизации.
    Шаблон системных компонентов авторизации (system.auth.*)Указание шаблона, который будет применяться в компонентах авторизации. (Пользователю недоступны настройки компонентов, они подключаются ядром.)
    Использовать CAPTCHA при восстановлении пароляПри установке флажка при восстановлении пароля будет появляться поле для ввода CAPTCHA.

    Внимание! Может потребоваться доработка кастомизированных шаблонов компонентов system.auth.changepasswd и system.auth.forgotpasswd для показа CAPTCHA.

    Безопасная авторизация
    Передавать пароль в зашифрованном видеВключение функции Безопасная авторизация.
    Ключ шифрованияУказывает на то сгенерен ли открытый ключ для использования функции. Если ключ не использыется, то создать его можно по кнопке Сгенерировать ключ.
    Регистрация новых пользователей
    Позволять ли пользователям регистрироваться самостоятельно?Определяет, могут ли посетители самостоятельно регистрироваться на сайте.
    Использовать CAPTCHA при регистрацииПри отмеченной опции будет использована технология CAPTCHA в процессе регистрации.
    При регистрации добавлять в группуГруппа, в которую пользователь будет автоматически попадать при регистрации.
    Регистрировать пользователей по номеру телефона:Разрешение на регистрацию пользователя по номеру телефона. Номер телефона потребуется подтвердить через СМС. Настроить службы отправки СМС вы можете в настройках модуля Служба сообщений.
    Номер телефона является обязательным:Поле становится активным после включения опции, разрешающей регистрацию по телефону. Если опция не включена, поле "Номер телефона" при регистрации будет необязательным.
    Регистрировать пользователей по email:Разрешение на регистрацию пользователя по e-mail. После включения поля становятся активными три поля ниже.
    E-mail является обязательным полемЕсли флажок снят, В этом случае поле Запрашивать подтверждение регистрации по E-mail будет неактивно то поле e-mail будет не обязательным при регистрации.
    Запрашивать подтверждение регистрации по E-mailПри отмеченной опции пользователю будет отправлено письмо с подтверждением регистрации по E-mail, сформирванное на основе почтового шаблона. Отредактировать почтовый шаблон можно с помощью ссылки Почтовые шаблоны.
    Проверять E-mail на уникальность при регистрацииЕсли опция отмечена, то при регистрации пользователя будет выполняться проверка адреса электронной почты на совпадение с уже имеющимися адресами в системе. Также уникальность E-mail будет проверяется и при обновлении пользователя. Уникальность Email проверяется только для внутренней регистрации. Внешние источники авторизации могут вовсе не отдавать e-mail, например odnoklassniki, twitter, vkontakte.
    Сколько дней хранить пользователей с неподтвержденной регистрациейУказывается количество дней, в течении которых будут храниться записи о пользователях с неподтвержденной регистрацией.
    Настройка соглашений. Переход к созданию нового соглашения о согласии пользователя по ссылке Создать новое соглашение. Далее следуют поля для выбора сайта и соглашения для него. Выбранное соглашение используется при регистрации пользователя.
    Безопасность
    Деактивировать давно не заходивших пользователей Указывается число дней. Если в указанное значение пользователь не авторизовался на сайте, его аккаунт автоматически становится неактивным.
    Контроль сессии
    Продлевать сессию при активности посетителя в окне браузераПод активностью понимается движение мышью, клик мышью, нажатие кнопки клавиатуры. Система отслеживает эти действия в окне браузера и автоматически продлевает сессию при их наличии.
    Продлевать сессию только для авторизованных посетителейПункт позволяет продлевать сессию при активности посетителя в окне браузера только для авторизованных пользователей.
    Показывать пользователям сообщение об окончании сессииПри отмеченной опции по истечении сессии пользователю будет выведено сообщение:



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

    Закладка "Журнал событий"

    На данной вкладке выполняется настройка параметров журнала событий.

    ПолеОписание
    Сколько дней хранить событияУказывается период времени (количество дней), в течении которого события будут храниться в журнале.
    События для записи в журнал
    Записывать [тип события]Отметьте флажками события, которые должны фиксироваться в журнале.
    Профиль пользователя
    Сохранять историю изменения полей профиля пользователяВключает логирование изменений профилей пользователей и делает активной страницу Настройки > Пользователи > История профилей.
    Настройки системы авторизации на контроллере*
    Префикс для авторизации на контроллереУказывается префикс, который будет использоваться для авторизации пользователей контроллера на этом подчиненном сайте.
    Авторизовывать на этом сайте пользователей других сайтов контроллераПри отмеченной опции пользователи других сайтов контроллера смогут авторизовываться на этом сайте, причем обязательно должна быть разрешена авторизация между подчиненными сайтами на контроллере и настроено соответствие групп.

    * - данная секция доступна, если сайт подключен к контроллеру.

    Закладка "Система обновлений"

    ПолеОписание
    Лицензионный ключЛицензионный ключ данной копии продукта.
    Установка для разработкиПометка того, что данный экземпляр используется для разработки и тестирования, закрытый от публичного доступа. Установки для разработки при обновлении учитываются отдельно от публичных установок.
    Имя сервера, содержащего обновленияИмя сервера, с которого выполняется обновление продукта (должно быть равно bitrix.ru).
    Адрес прокси для системы обновленийАдрес прокси-сервера, через который выполняется доступ к серверу обновлений (используется, например, для корпоративных сетей).
    Порт прокси для системы обновленийАдрес порта, по которому выполняется доступ к системе обновлений через прокси-сервер.
    Имя пользователя проксиИмя пользователя для доступа к прокси-серверу.
    Пароль проксиПароль для доступа к прокси-серверу.
    Флаг в этом поле позволяет выполнять проверку корректности установки обновлений. При копировании файлов из промежуточной папки /updates/ в папки модулей будет выполняться проверка контрольной суммы. Если полученная контрольная сумма не соответствует исходной, то выводится сообщение о некорректной установке обновлений.
    Загружать только стабильные обновленияПри отмеченной опции в системе обновлений будут загружаться только стабильные версии. При снятой опции - бета-версии.
    Автоматически проверять наличие обновленийУказывается периодичность проверки наличия обновлений на сервере:
    • Не проверять;
    • Каждый день;
    • Раз в неделю;
    • Раз в месяц.
    Если выбрать Каждый день, Раз в неделю или Раз в месяц, то система будет выводить в Центре уведомлений Панели управления соответствующее сообщение:

    Остановить автоматическую проверку при возникновении ошибокПри отмеченной опции при возникновении ошибок автоматическая проверка обновлений будет остановлена.
    Не использовать архиваторПри отмеченной опции файлы с обновлениями архивироваться не будут. Опция влияет как на обновления самой системы, так и на обновления Marketplace.
    Продолжительность шага пошаговой загрузки обновления (сек)Система обновлений поддерживает пошаговую загрузку файлов обновления. Установите продолжительность шага загрузки в секундах.

    Закладка "Доступ"

    На закладке выполняется настройка прав доступа групп пользователей к управлению ресурсами Главного модуля.

    Поле Описание
    По умолчанию Уровень доступа групп пользователей, для которых установлено право "по умолчанию".
    [группа_пользователей] Изменение настроек доступа для конкретной группы. Возможно назначение следующих прав доступа к Главному модулю:
    • [D] Доступ закрыт - запрет на доступ;
    • [P] Изменение своего профайла - право на просмотр и изменение собственного профайла;
    • [R] Просмотр всех данных модуля - доступ к просмотру файлов модуля без права на изменение;
    • [T] Просмотр всех данных модуля и изменение своего профайла - доступ к просмотру файлов модуля с правом на изменение собственного профайла;
    • [V] Просмотр данных модуля и изменение заданных профайлов - доступ к просмотру файлов модуля с правом на изменение указанных профайлов;

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


    • [W] Полный доступ - полный доступ к управлению модулем.

    Служебные процедуры

    Закладка "Публичная часть"

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

    ПолеОписание
    Доступ к публичной части открыт/закрытСообщение о текущем состоянии доступа к публичной части сайта.

    С помощью кнопки Закрыть доступ пользователей/Открыть доступ для всех посетителям может быть разрешен или запрещён доступ к публичной части сайта.

    Контроллер

    ПолеОписание
    URL контроллера Адрес сайта, который является базовым для модуля Контроллер.
    Дополнительные параметры
    Логин администратора контроллераЛогин администратора контроллера.
    Пароль Пароль администратора контроллера.
    Название текущего сайта Название сайта.
    URL сайта URL подключаемого сайта.
    Добавить этот сайт к контроллеруНажатие на кнопку добавляет сайт к контроллеру. Если не верно или не полностью заполнены данные, будет выведено соответствующее уведомление.
    Настройки прокси (если требуется)
    Поля для настройки доступа к серверу: Адрес, Порт, Логин и Пароль пользователяДанные для доступа к прокси серверу.
    Сохранить настройку проксиКнопка сохранения настроек.
    Доступ к публичной части открыт/закрытСообщение о текущем состоянии доступа к публичной части сайта.

    Смотрите также:



    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх