Как написать компонент для bitrix

Евгений Смолин: Сам кувыркался с непонятками (пока курсы учебные не прочитал и руками не попробовал то, что там написано). Битрикс из тех систем, где изучение «методом тыка» не очень эффективно без предварительного изучения учебных курсов. Уважаемые новички, потратьте немного своего драгоценного времени, пройдите пару-тройку учебных курсов и масса вопросов просто испарится — там есть ответы на множество вопросов.

Для кого этот курс?

Курс для разработчиков — продолжение линейки учебных курсов по Bitrix Framework. Его цель: научить программистов работать с платформой Bitrix Framework, создавать на ней сайты, дорабатывать функцинал фреймворка под потребности клиента, создавать новый функционал за счёт создания своих модулей.

Начальные требования

Для успешного изучения курса и овладения мастерством разработки сайтов на Bitrix Framework необходимо владеть (хотя бы на начальном уровне):

основами PHP, баз данных;
основами HTML, CSS.

Чтобы научиться программировать в Bitrix Framework, нет необходимости предварительно изучать всю линейку учебных курсов по «1С-Битрикс: Управление сайтом». Но есть моменты, которые необходимо знать разработчикам о системе, они раскрыты в начальных курсах:

Интерфейс программы — в главе Элементы управления курса Контент-менеджер.
Компоненты 2.0 (начальные сведения) в главе Компоненты 2.0 (начальные сведения) курса Контент-менеджер.
Информационные блоки — в главе Информационные блоки (начальные сведения) курса Контент-менеджер.
Управление доступом к файлам, элементам контента, модулям и другие права доступа в главе Управление доступом курса Администратор. Базовый.
Работа с инструментами системы — в главе Работа с инструментами курса Администратор. Базовый.
Модуль Поиск — в главе Поиск курса Администратор. Базовый.
Вся информация по администрированию модулей размещена в курсах:
- Администрирование. Модули — модули «1С-Битрикс: Управление сайтом»
- Администратор. Бизнес — модули «1С-Битрикс: Управление сайтом», связанные с коммерческой деятельностью в Интернете.
- Администратор «1С-Битрикс: Корпоративный портал» — модули «1С-Битрикс: Корпоративный портал»
По завершению изучения этого курса можно продолжить изучение работы в продуктах Bitrix Framework по следующим курсам:
Бизнес-процессы — настройка и создание бизнес-процессов.
Технология Композитный сайт — ускорение работы сайта.
Разработка и эксплуатация высоконагруженных проектов — для тех кто делает «тяжёлые» проекты.
Бот платформа Битрикс24 — приложения, основанных на чатах в веб-мессенджере.
Маркетплейс Битрикс24 — приложения для коробочной и облачной версий Битрикс24.
Маркетплейс Bitrix Framework — расширение функционала проектов на основе Bitrix Framework с помощью сторонних модулей и решений.
Многосайтовость — система многосайтовости и принципы работы с многосайтовой конфигурацией.

Комментарии к урокам

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

ЧТо бы не было скучно

В тексте курса вы встретите цитаты, высказанные в разное время разработчиками системы и разработчиками проектов на базе Bitrix Framework. Надеемся, что такие неформальные замечания внесут некоторое разнообразие в процесс изучения. Заодно опытные специалисты поделятся и своим опытом.

Имена авторов цитат даются в том написании, в каком авторы зарегистрировали себя на сайте «1С-Битрикс».

Тесты и сертификат

После изучения курса вам будет предложено пройти тесты на сертификацию. При успешной сдаче последовательности тестов на странице Моё обучение можно просмотреть результат обучения и загрузить сертификат в формате PDF.

Для преподавания оффлайн

Если данный курс берётся в качестве основы для оффлайного преподавания, то рекомендуемая продолжительность: 5 дней (40 академических часов).

Если нет интернета

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

Чтобы отключить подобное отношение к файлу необходимо:

Общие

Отсутствие кнопки Разблокировать возможно в двух случаях:

Файл лежит не локально, а на сетевом ресурсе.
Если файл лежит на локальном диске, но путь к нему содержит спецсимволы (# и прочие).

Источник статьи: http://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2305&LESSON_PATH=3913.4565.4790.4777.2305

Как написать компонент для bitrix

Для кого этот курс?

Начальные требования

основами PHP, баз данных;
основами HTML, CSS.

Интерфейс программы — в главе Элементы управления курса Контент-менеджер.
Компоненты 2.0 (начальные сведения) в главе Компоненты 2.0 (начальные сведения) курса Контент-менеджер.
Информационные блоки — в главе Информационные блоки (начальные сведения) курса Контент-менеджер.
Управление доступом к файлам, элементам контента, модулям и другие права доступа в главе Управление доступом курса Администратор. Базовый.
Работа с инструментами системы — в главе Работа с инструментами курса Администратор. Базовый.
Модуль Поиск — в главе Поиск курса Администратор. Базовый.
Вся информация по администрированию модулей размещена в курсах:
- Администрирование. Модули — модули «1С-Битрикс: Управление сайтом»
- Администратор. Бизнес — модули «1С-Битрикс: Управление сайтом», связанные с коммерческой деятельностью в Интернете.
- Администратор «1С-Битрикс: Корпоративный портал» — модули «1С-Битрикс: Корпоративный портал»
По завершению изучения этого курса можно продолжить изучение работы в продуктах Bitrix Framework по следующим курсам:
Бизнес-процессы — настройка и создание бизнес-процессов.
Технология Композитный сайт — ускорение работы сайта.
Разработка и эксплуатация высоконагруженных проектов — для тех кто делает «тяжёлые» проекты.
Бот платформа Битрикс24 — приложения, основанных на чатах в веб-мессенджере.
Маркетплейс Битрикс24 — приложения для коробочной и облачной версий Битрикс24.
Маркетплейс Bitrix Framework — расширение функционала проектов на основе Bitrix Framework с помощью сторонних модулей и решений.
Многосайтовость — система многосайтовости и принципы работы с многосайтовой конфигурацией.

Комментарии к урокам

ЧТо бы не было скучно

Имена авторов цитат даются в том написании, в каком авторы зарегистрировали себя на сайте «1С-Битрикс».

Тесты и сертификат

Для преподавания оффлайн

Если нет интернета

Чтобы отключить подобное отношение к файлу необходимо:

Общие

Отсутствие кнопки Разблокировать возможно в двух случаях:

Файл лежит не локально, а на сетевом ресурсе.
Если файл лежит на локальном диске, но путь к нему содержит спецсимволы (# и прочие).

Источник статьи: http://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=2305

Статьи 1С Битрикс | Пример создания компонента

В этой статье предпринята попытка пошагово описать процесс создания простого компонента для 1С Битрикс с минимальным использованием функционала старого ядра и максимально близко к принципам написания кода на D7.

Репозиторий примера можно посмотреть тут

Размещение компонента в файловой структуре сайта

Компоненты в битрикс размещаются по пути от корня вашего сайта /bitrix/components В этой папке всегда есть каталог bitrix нем расположены компоненты, которые достались вам при установки Битрикса и количество этих компонентов варьируется в зависимости от используемой вами редакцией продукта.

В папке /bitrix/components можно создавать свои папки, в терминах битрикса это называется “пространством имен”, так например при установке модулей из Маркетплейс модули партнеров скопируют свои компоненты именно в эту папку, предварительно создав в ней свое “пространство имен”.

Не путайте термин “пространства имен” в рамках Битрикса и пространства имен PHP этот термин остался в Битриксе исторически и нам придется с этим мириться.

Так же компоненты можно разместить в каталоге /local/components в этой папке нужно так же создать свое “пространство имен” в виде отдельного каталога в котором и разместить свой компонент.

Для размежения локальных компонентов, которые пишутся под конкретный проект, а так же для кастомизации стандартных компонентов Битрикса нужно использовать именно папку /local/components

Для нашего примера будем использовать папку ‘example’ в качестве “пространства имен”, а назовем компонент compsimple таким образом итоговый путь к файлам разрабатываемого компонента будет таким: /local/components/example/compsimple .

Структура файлов и папок компонента

Основной файл компонента к которому происходит обращение при подключении компонента на странице и в котором находится точка входа в логику работы компонента class.php .

Следующий по важности файл .description.php он содержит описание компонента и путь для его отображения в интерфейсе системы.

Принято выносить языкозависимые тексты в языковые файлы поэтому нам нужна папка lang в которой будут находиться папки с кодами языков, в нашем случае только ru в ней должен быть еще один файл .description.php , а он уже содержит массив с переводами текстов.

Почти каждый компонент в итоге своей работы выводит информацию на сайт, для этого нужно создать файлы шаблонов компонента. Папка templates создается для хранения шаблонов отображения, шаблон по умолчанию должен располагаться в папке .default в файле template.php .

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

Большей части компонентов для обеспечения корректной работы требуется передать какие-либо начальные значения, обеспечить отображение полей для ввода параметров позволит файл .parameters.php

Итоговая структура файлов и папок используемых в примере выглядит так:

class.php

В файле class.php должен располагаться класс компонента унаследованный от CBitrixComponent .

Принцыпы именования класса компонента нигде не регламинтированы, но рекомендуется давать имя классу максимально похожее на путь к компоненту. Наш класс будет называться ExampleCompSimple .

Пример содержимого нашего файла:

.description.php

В принципах описания компонента ничего не меняется почи с времен появления БУС. Тут относительно подробное описание структуры файла.

Рассмотрим пару примеров размещения компонента в визуальном редакторе:

Разместить компонент в ветке на ровне с остальными основными ветками

Разместить компонент в дочернюю ветку

Пример файла языковых констант lang/ru/.description.php :

.parameters.php

Для отображения полей для передачи параметров в форме настроек компонента предназначен файл .parameters.php. Он содержит в себе массив с определением типа и значений входных параметров компонента.

Языковой файл lang/ru/.parameters.php

Шаблон компонента

Компонент может содержать множество шаблонов. Шаблон по умолчанию находится в папке .default и именно он отрабатывает, если приподключении компонента оставить имя шаблона пустым.

В нашем примере просто выведем дамп массива входных параметров и массива результатов работы компонента.

Источник статьи: http://gdecider.github.io/articles_bx-component-creation.html