Перейти к содержанию

Глоссарий

Что есть что?

Каждая платформа имеет свои термины, используемые в работе. Чтобы без проблем ориентироваться в документации, учебных курсах, при общении с разработчиками желательно объяснять ваши трудности не «на пальцах», а на языке понятном специалистам. Ниже в помощь вам приведен глоссарий терминов системы и несколько общих терминов, активно используемых в системе.

- Accept-Language - API - cron (крон) - DocumentRoot - HTML-безопасный вид - IP адрес - Абсолютный путь - Административная часть - Буферизация - Включаемые области - Время в Unix-формате - Группа пользователей - Дамп - Доменное имя (домен) - Индексная страница (файл) - Кастомизация - Компоненты - Локализация - Мета-тэг - Многоязычный интерфейс - Навигационная цепочка - Полный путь - Пользователь - Портал - Постоянное соединение (persistent) - Права в Unix системах - Пролог - Публичная часть - Путь к компоненту - Путь относительно корня - Почтовое событие - Почтовый шаблон - Раздел сайта - Режим Правка - Сабмит - Сайт - Связывание переменных - Сессия - Система обновлений - Тело страницы - Тип почтового события - Хост - Шаблон сайта - Шаблон страницы - Экземпляр программы - Эпилог - Язык - Языковой файл
--- --- Термин Описание Административная часть Раздел системы, содержащий интерфейс для управления модулями системы, структурой, содержанием, посетителями и другими составляющими сайта. Страницы, в которых подключен административный пролог и эпилог. Эти страницы: - не принадлежат ни одному сайту; - принадлежат какому-либо модулю; - имеют строго определённый административный интерфейс; - отображаются в выбранном языке интерфейса; - дополнительно проверяются по правам, задаваемым в настройках соответствующего модуля. Публичная часть Раздел системы, доступный для отображения посетителям сайта.На страницах раздела подключается пролог и эпилог одного из шаблонов сайта. Эти страницы: - принадлежат какому либо сайту; - имеют интерфейс текущего шаблона сайта; - отображаются на языке текущего сайта. Режим Правка Режим, при котором текущая страница публичного раздела отображается в особом виде: выделены используемые компоненты, включаемые области, редактируемые области и т.д. Каждая такая область имеет набор кнопок для быстрого перехода к редактированию данного элемента страницы. Сайт Совокупность параметров: - учетная запись в базе данных - создаётся в административном меню Сайты, включает в себя: - идентификатор - набор символов, идентифицирующий сайт; - доменное имя - одно или более доменное имя сайта; - папка сайта - путь к каталогу в котором будет храниться публичная часть сайта; - язык сайта; - формат даты и времени; - URL - протокол и доменное имя по умолчанию (например, http://www.site.ru); - DocumentRoot - если многосайтовость организована на разных доменах, то в данном параметре должен храниться путь в файловой системе сервера к корню сайта; - условия подключения шаблонов - каждый сайт может иметь один или более шаблонов для отображения скриптов своей публичной части, каждый такой шаблон может быть подключен по тому или иному условию; - публичная часть - совокупность страниц, лежащих в папке сайта и принадлежащих этому сайту; - настройки - каждый модуль может иметь ряд настроек, связанных с сайтом, например у модуля Информационные блоки эти настройки представляют из себя привязку информационного блока к тому или иному сайту, у модуля Техподдержка - привязку статуса, категории и т.п. к сайту. Шаблон сайта Синонимы: дизайн сайта, скин сайта. Для показа одного сайта можно использовать несколько различных шаблонов. Шаблон сайта - это набор файлов в каталоге /bitrix/templates/ID_шаблона/, где ID_шаблона - поле ID в форме редактирования Управление шаблонами дизайна осуществляется в административном разделе на странице Шаблоны сайта (Настройки > Настройки продукта > Сайты > Шаблоны сайтов), где можно... Подробнее ... шаблона сайта. Структура каталога: - /components/ - каталог с компонентами, принадлежащими тому или иному модулю; - /lang/ - языковые файлы, принадлежащие как шаблону в целом, так и отдельным компонентам; - /images/ - каталог с изображениями шаблона; - /page_templates/ - каталог с шаблонами страниц и их описанием, хранящимся в файле .content.php; - /include_areas/ - каталог с файлами - содержимым включаемых областей; - header.php - пролог шаблона; - footer.php - эпилог шаблона; - styles.css - CSS стили, используемые на страницах сайта, когда используется шаблон; - template_styles.css - CSS стили, используемые в самом шаблоне; - .тип_меню.menu_template.php - шаблон вывода меню соответствующего типа; - chain_template.php - шаблон по умолчанию для вывода навигационной цепочки; - а также ряд других вспомогательных произвольных файлов и папок, входящих в данный шаблон. Раздел сайта Каталог в файловой системе сервера. В Bitrix Framework структура сайта - это файловая структура сервера, поэтому страницы сайта - это файлы, а разделы сайта - соответственно каталоги. Компонент Часть какого-либо модуля, логически завершенный код, хранящийся в одном файле. Принимает ряд параметров, выполняет ряд действий и выводит результат этих действий (например, в виде HTML кода). Использование компонента - предпочтительный способ вывода информации как в публичной, так и в административной частях. Компонент подключается методом IncludeComponent Рабочая версия компонентов - 2.0. Использование компонентов 1.0 не рекомендуется, но их ещё можно встретить на сайтах, построенных на ранних версиях системы. Путь к компоненту Устаревшее. Используется в функции CMain::IncludeFile в качестве первого параметра и представляет из себя путь к основному файлу компонента 1.0. Включаемые области Это специально выделенная область на странице сайта, которую можно редактировать отдельно от основного содержания страницы. Реализуется с помощью специального компонента. Навигационная цепочка Это элемент дизайна, предназначенный для навигации по сайту. Выводится в визуальной части пролога и состоит из заголовков разделов сайта с соответствующими ссылками на них. Помимо заголовков разделов, добавляемых автоматически, вы также можете добавлять произвольные пункты в навигационную цепочку. Индексная страница (файл) Это имя файла, который будет использован веб-сервером в случае, если запрашиваемый URL заканчивается на слэш и не содержит в себе имени файла. Порядок, в котором будут искаться индексные страницы для различных веб-серверов, задается по разному, например: - Apache - в файле httpd.conf, параметр DirectoryIndex; - IIS - в свойствах сайта, закладка Documents > Enable default content page; К сожалению, в PHP значение данного параметра недоступно, поэтому для определения индексной страницы в коде необходимо пользоваться функцией GetDirIndex. Пользователь Запись в базе данных с параметрами зарегистрированного пользователя, обязательные поля: - логин; - пароль; - E-Mail. А также ряд дополнительных полей, содержащих личную информацию о пользователе, информацию по его работе, административные заметки. Регистрационные данные (логин и пароль) в дальнейшем используются для авторизации в системе. Пользователь привязывается к определенной группе и получает право на доступ к ресурсам портала в соответствии с правами данной группы. Группа пользователей Совокупность пользователей, обладающих определенными правами на доступ и управление ресурсами (например, пользователи группы Модераторы обладают правом на чтение и редактирование сообщений форума). Управление группами пользователей осуществляется на странице Группы пользователей в административном разделе (Настройки > Пользователи > Группы пользователей). Почтовое событие Это почтовое сообщение, имеющее свой тип и отправляемое по соответствующему почтовому шаблону. Почтовое событие инициализирует поля типа почтового события конкретными значениями. Порядок расположения этих полей в письме, а также текст письма, определяется почтовым шаблоном. Для создания почтового события предназначен класс CEvent. Почтовый шаблон Определяет текст почтового сообщения, а также порядок расположения полей (placeholder'ов), заданных в типе почтового события. Почтовые шаблоны доступны в административном разделе на странице Почтовые шаблоны (Настройки > Настройки продукта > Почтовые события > Почтовые шаблоны). Для манипуляции почтовыми шаблонами предназначен класс CEventMessage. Тип почтового события Определяет набор специальных полей (placeholder'ов), которые могут быть использованы в почтовом шаблоне. В момент создания почтового события эти поля будут инициализированы конкретными значениями. Типы почтовых событий доступны в административном разделе на странице Типы почтовых событий (Настройки > Настройки продукта > Почтовые события > Типы почтовых событий). Для манипуляции типами почтовых событий предназначен класс CEventType. Путь относительно корня Путь к файлу, начинающийся от каталога, указанного в параметре DocumentRoot в настройках веб-сервера, заданный по правилам формирования URL-адресов. Пример:/ru/about/index.php Полный путь Включает в себя протокол, домен и путь относительно корня к странице (каталогу). Пример: http://www.bitrixsoft.ru/ru/about/index.php Абсолютный путь Абсолютный путь к файлу включает в себя DocumentRoot и путь относительно корня. DocumentRoot Путь к корню сайта в файловой системе сервера. Задается в настройках веб-сервера, например: - для Apache - в файле httpd.conf, параметр DocumentRoot; - для IIS - в свойствах сайта, закладка Home Directory > Local Path. Система обновлений Технология SiteUpdate позволяет: - скачивать обновления продукта; - загружать новые модули и обновления для имеющихся модулей, расширяющие их функциональные возможности; - загружать языковые файлы и устанавливать новые языки; - выполнять регистрацию лицензий на дополнительные сайты. В процессе обновления выполняется модификация только ядра продукта (файлы папок /bitrix/modules/, /bitrix/tools/, /bitrix/admin/ и /bitrix/components/bitrix/). Обновление не затрагивает публичную часть портала, полностью исключая возможность потери данных. Обновление системы осуществляется в несколько шагов: - система обновлений автоматически запрашивает лицензионный ключ продукта; - затем выполняется проверка наличия доступных обновлений; - далее пользователю предлагается выбрать обновления для загрузки; - после этого происходит загрузка выбранных обновлений. Язык Это учетная запись в базе данных, доступная для редактирования в административном меню на странице Языки интерфейса, со следующими полями: - Идентификатор; - Название; - Формат даты; - Формат времени; - Кодировка; - и т. д.. Как в публичной, так и административной частях, язык в первую очередь используется в работе с языковыми файлами. В административной части язык определяет формат времени, даты, кодировку страниц (в публичной - данные параметры определяются настройками сайта). Языковой файл Файл, хранящий переводы языковых фраз на тот или иной язык. Данный скрипт состоит из массива $MESS, ключи которого - идентификаторы языковых фраз, а значения - переводы на соответствующий язык. Для каждого языка существует свой набор языковых файлов, хранящихся как правило в каталогах /lang/. Языковые файлы, как правило, используются в административных скриптах модулей и в компонентах. Для работы с языковыми файлами предназначен модуль Перевод. Многоязычный интерфейс Возможность реализуется за счет использования языковых файлов, хранящих перевод фраз на соответствующие языки для: - административного раздела; - сообщений об ошибках; - визуальных компонентов; - соответствующих областей в шаблоне портала; - и т.д. В соответствии с текущим языком интерфейса выполняется подключение необходимых языковых файлов. В результате сообщения отображаются пользователю на выбранном им языке. Переключение между языками административного интерфейса осуществляется на административной панели. Локализация Подразумевает представление информации в переводе на соответствующих языке, кодировке и форматов представления данных (дата, время, денежные единицы, числа и т.д.). Мета-тэг Мета-тэг это - элемент HTML, задающий информацию о странице: кодировку страницы, ключевые слова, автора, краткое описание. Как правило, содержимое мета-тэгов используется в служебных целях, например, роботами поисковых систем, индексирующих сайт. Мета-тэг задается внутри тэга <head>. Доменное имя (домен) Одно из полей DNS таблицы (domain name service), содержащее в себе строго структурированное имя интернет сайта, заданное по определённым правилам. Основная задача DNS таблицы - это ассоциация доменных имен с IP адресами сайтов. Пример доменного имени: 1c-bitrix.ru IP адрес Это "имя" компьютера в сети, заданное по правилам протоколов TCP/IP. IP адрес состоит из четырех октетов, часть из которых идентифицирует подсеть, в которой находится компьютер, а часть - непосредственно этот компьютер в рамках соответствующей подсети. Пример IP адреса: 198.63.210.79. Хост В применении к функциям главного модуля, хост - это доменное имя или IP адрес для обращения к тому или иному сайту. Сессия Под термином понимается сессия PHP. Сессия может открываться в момент захода на сайт и закрывается при закрытии окна браузера. Также новая сессия открывается при авторизации пользователя, если закончить сеанс авторизации (разлогиниться) - сессия закрывается. Синонимом термина сессия можно считать один "заход на сайт". Время в Unix-формате Количество секунд, прошедшее с 1 января 1970 года, с точностью до микросекунды. На сегодняшний день, время в Unix-формате может фиксироваться только до 2038 года. Права в Unix системах В Unix-подобных операционных системах поддерживаются три вида прав - чтение, запись и выполнение, которые присваиваются каждому файлу или директории. Права эти повторяются три раза: для владельца файла, для группы пользователей, и для всех остальных пользователей. Как правило, права указываются в числовом формате: - 4 - чтение; - 2 - запись; - 1 - выполнение. Сумма этих чисел дает окончательный набор прав, например, 6 - это чтение и запись, но без выполнения, 7 - все права, 5 - чтение и выполнение. Таким образом, например, право 764 будет означать: 7 - все права для владельца файла, 6 - чтение и запись для группы пользователей, к которой принадлежит владелец файла и 4 - чтение для всех остальных пользователей. В PHP все права задаются в виде восьмеричных чисел, поэтому их надо задавать с обязательным указанием префикса - 0. Пример: 0755. Пролог В общем случае, под данным термином понимается верхняя левая часть страницы. Для публичной части, пролог соответствующего шаблона сайта хранится в файле /bitrix/templates/ID шаблона сайта/header.php. Для административной части - пролог хранится в файле /bitrix/modules/main/interface/prolog_main_admin.php. В свою очередь пролог может быть разделен на служебную и визуальную части. В служебной части подключаются все необходимые классы, создаётся соединения с базой, создаются ряд служебных экземпляров объектов, таких как $USER, $APPLICATION и т.д. В визуальной части выводится верхняя левая часть страницы. Если в публичной части необходимо подключить неразделенный пролог, то используем следующий код: php require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php"); Если по тем или иным причинам необходимо разделить пролог на служебную (prolog_before.php) и визуальную (prolog_after.php) части, то используем следующий код: php require($_SERVER["DOCUMENT_ROOT"]. "/bitrix/modules/main/include/prolog_before.php"); ... require($_SERVER["DOCUMENT_ROOT"]. "/bitrix/modules/main/include/prolog_after.php");