Svinkovod.ru

Бытовая техника
3 просмотров
Рейтинг статьи
1 звезда2 звезды3 звезды4 звезды5 звезд
Загрузка...

1С Битрикс

# 1С Битрикс

Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе 1С Битрикс.

Обратите внимание, что модуль быстрого подключения может не содержать весь актуальный функционал. Для полного подключения рекомендуется использовать JS SDK.

# Краткий план установки

  • Зарегистрировать магазин в системе REES46.
  • Установить модуль на сайт.
  • Установить сбор данных.
  • Настроить блоки рекомендаций.
  • Проверить работоспособность.

# Пошаговая инструкция по установке

# Регистрация магазина

  1. Перейдите на сайт rees46.com

# Установка модуля на сайт

  1. Убедитесь, что установлены все последние обновления платформы Bitrix и модуля "Современный интернет-магазин (bitrix.eshop)".
  2. Перейдите в административный интерфейс вашего сайта.
  3. Зайдите в раздел "Marketplace", затем в "Каталог решений".
  4. В поле поиска введите REES46 и найдите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  5. Выполните установку.
  6. Не забудьте включить модуль.

# Первичная настройка

# Коды доступа
  1. Перейдите в раздел "Настройки".
  2. Перейдите в подраздел "Настройки модулей" и выберите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  3. Вставьте в текстовые поля код магазина и секретный ключ, полученные в разделе 4.1.
  4. Сохраните изменения.

Коды доступа

# Обмен информацией о товарах

Там же в настройках перейдите во вкладку "Расширенный YML", скопируйте предоставленный URL:

YML фид

И вставьте его в соответствующее поле в настройках вашего магазина на сайте REES46:

YML фид

Функция YML доступна для Битрикс версии 15.0.2 и выше.

# Установка отслеживания событий

Режим правки

Обратите внимание, что большинство операций по вставке блоков рекомендаций и кода отслеживания производится в режиме правки со стороны сайта, а не интерфейса администратора.

Включается режим в верхней панели переключателем, который находится в правом углу.

# Отредактируйте текущий шаблон

Откройте на редактирование шаблон вашего сайта и вставьте перед закрывающим тегом </head> код:

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

# Отредактируйте шаблон компонента "Элемент каталога детально (bitrix:catalog.element)"

1 Перейдите на страницу просмотра любого товара. 1 Убедитесь, что режим "Правки" включен. 1 Наведите мышь на карточку товара и подождите, пока не появится серый плавающий блок, у которого слева будет ссылка "Изменить товар", а справа шестеренка. Рядом с шестеренкой будет выпадающий список. Кликните в него и найдите в списке элемент "Элемент каталога детально ( bitrix:catalog.element )". Кликните в него и выберите "Редактировать шаблон компонента". Если такого пункта нет, то выполните следующие действия: 1 выберите элемент списка "Каталог ( bitrix:catalog )" и кликните "Копировать шаблон компонента".

  • в форме укажите любое имя шаблона, сохраните и, когда появится редактор кода, сохраните еще раз.
  • в итоге вы должны вернуться на просмотр страницы товара. 1 Повторите пункт №3, пока не сможете попасть в редактирование ( bitrix:catalog.element ) 1 Вставьте в шаблон bitrix:catalog.element следующий код. Обратите внимание, что код необходимо вставить в конце шаблона таким образом, чтобы он был размещён вне любого другого кода, заключённого в <? . ?> или <?php . ?> .

В некоторых версиях 1С Битрикс переменная $arResult["ID"] может отсутствовать и вместо нее может быть переменная $ElementID либо другая. Важно в этом коде передавать именно идентификатор товара. Убедитесь в правильности имени переменной и ее существовании.

Читайте так же:
Восстановление файлов с микро сд

Если вы испытываете затруднения с установкой этого кода, свяжитесь с нами по адресу desk@rees46.com.

# Отредактируйте шаблон компонента "Элементы раздела (bitrix:catalog.section)"
  1. Перейдите на страницу просмотра любой категории.
  2. Убедитесь, что режим "Правки" включен.
  3. Наведите мышь на область страницы под заголовком категории и подождите пока не появится серый плавающий блок с шестеренкой справа. Рядом с шестеренкой будет выпадающий список. Кликните в него и найдите в списке элемент "Элементы раздела ( bitrix:catalog.section )". Кликните в него и выберите "Редактировать шаблон компонента".
  4. Вставьте в шаблон следующий код. Обратите внимание, что код необходимо вставить в конце шаблона таким образом, чтобы он был размещён вне любого другого кода, заключённого в <? . ?> или <?php . ?> .

В некоторых версиях 1С Битрикс переменная $arResult["ID"] может отсутствовать и вместо нее может быть переменная $ElementID либо другая. Важно в этом коде передавать именно идентификатор товара. Убедитесь в правильности имени переменной и ее существовании.

Если вы испытываете затруднения с установкой этого кода, свяжитесь с нами по адресу desk@rees46.com.

# Установка блоков рекомендаций

Вы можете использовать предустановленные блоки рекомендаций или создать собственные. Настройка блоков осуществляется в личном кабинете REES46.

# Проверка работоспособности

Проверка выполняется так:

  1. Включаете консоль разработчика в вашем браузере.
  2. Находите вкладку Network (или "Сеть"), в которой при обновлении страницы отображаются происходящие запросы.
  3. Включаете режим фильтрации только XHR-запросов.
  4. Проверяете, есть ли запросы, которые уходят на api.rees46.com.

# Проверка отправки событий

  1. Перейдите на страницу просмотра товара.
  2. Убедитесь, что уходит запрос на адрес api.rees46.com/push

Проверка отправки событий

# Проверка запроса рекомендаций

  1. Перейдите на главную страницу и убедитесь, что уходит один запрос на api.rees46.com/recommend.
  2. Перейдите на страницу категории и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  3. Перейдите на страницу товара и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  4. Перейдите на страницу корзины и убедитесь, что уходит один запрос на api.rees46.com/recommend.

Проверка запросов рекомендаций

# Если рекомендации еще не появились

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

# Если вы используете систему контроля версий

Раздел для разработчиков

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

Сотбит: Оригами – интернет-магазин

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

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

Папка с блоком содержит в себе 4 файла и папку локализации.

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

Содержание файлов

class.php

Файл содержит класс, отвечающий за очистку кеша компонента при добавлении и сохранении контента.

Читайте так же:
Использование музыки в видео авторские права

В файле требуется изменить имя класса на уникальное:

settings.php

Файл содержит в себе массив с настройками, структура которого представлена ниже:

  • block – параметры блока.
    • name – задается значение имени блока.
    • section – задается принадлежность к категории блоков. Перечень доступных категорий можно увидеть в файле /include/blocks/.sections.php .
    • title – заголовок блока.
      • name – подпись поля.
      • type – тип поля. Доступные значения: input (текстовое поле), select (раскрывающийся список).
      • group – группа, к которой относится поле. Доступные значения указываются из названия групп настроек ниже.
      • value – значение поля.
      • titles – название группы настроек.
        • name – подпись группы.
        • js – указывается массив с указанием файлов скриптов.
        • css – указывается массив с указанием файлов стилей.

        В массив можно добавить пользовательские поля. Для этого в массив fields добавьте массив c уникальным ключом, хранящий значения ключей name, type, group и value.

        Пример дополнительного поля:

        Поле предназначено для хранения ссылки на изображения со сторонних источников.

        Также в массив можно добавить пользовательские группы полей. Для этого в массив groups добавьте массив c уникальным ключом, хранящий значения ключа name.

        Пример дополнительной группы:

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

        Не забудьте добавить новые переменные в файл локализации.

        В результате настройки блока примут вид:

        Пример подключения файлов стилей и скриптов

        preview.jpg

        Файл содержит изображение, отображаемое при выборе блока.

        content.php

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

        Пример пустого блока

        Массив $settings содержит в себе данные из файла settings.php . Таким образом в блоке можно использовать значения настроек, указанных в публичной части сайта.

        Массив настроек с ключами: $settings[‘fields’][‘title’][‘value’] хранит в себе значение текстового поля, указанного в меню редактирования в публичной части сайта.

        Для того, чтобы созданные шаблоны компонентов не удалялись в процессе обновления решения, поместите их в папку, поиск в которой осуществляется в первую очередь, в нашем случае:
        /local/templates/sotbit_origami/components .

        Урок 2: создаем шаблон сайта в Битриксе

        Наша задача в этом уроке – создать простейший шаблон Битрикса на основе готовой верстки. Архив с версткой можете скачать по ссылке: https://alfavitka.ru/downloads/gruzovichok.zip. Демо-страничка верстки: https://alfavitka.ru/demo/gruzovichok/.

        Создаем шаблон сайта в настройках

        На вкладке «Администрирование» идем в Настройки=>Настройки продукта => Сайты => Шаблоны сайтов и нажимаем кнопку «Добавить шаблон»:

        Нажимаем кнопку Добавить шаблон

        В открывшейся форме заполняем поля на вкладке «Шаблон»:

        ID – идентификатор шаблона (а также название папки шаблона), используем латинские буквы/цифры. Пусть будет alfavitka

        Название – как хотим, так и называем, например, Учебный шаблон

        Описание – необязательное поле, заполняем по желанию. Я введу Создаем шаблон с нуля

        Порядок – порядок отображения шаблона в списке шаблонов (можно не заполнять)

        Тип – выбираем «Шаблон сайта»

        Внешний вид шаблона сайта – сюда мы можем вставить HTML код шапки и подвала сайта, разделив их плейсхолдером #WORK_AREA#. Однако, чтобы получше разобраться с системой шаблонов Битрикса, мы сделаем немного по-другому: давайте пока не будем вставлять сюда верстку, а просто вставим плейсхолдер #WORK_AREA# (чуть позже будет понятно, зачем он нужен).

        Вкладки «Стили сайта» и «Стили шаблона» предназначены для добавления стилей, но их мы тоже пока что оставим пустыми.

        Обязательные поля мы заполнили, сохраняем шаблон:

        Сохраняем шаблон

        Отлично, он появился в списке шаблонов:

        Шаблон создан

        Теперь зайдем в настройки сайта и установим наш (пока еще пустой) шаблон. Настройки => Настройки продукта => Сайты => Список сайтов => Кликаем на ID сайта, чтобы перейти к его настройкам:

        Идем в настройки сайта

        Проматываем страницу к блоку «Шаблон сайта», в первом поле выбираем наш шаблон и сохраняем изменения:

        Выбираем шаблон в настройках

        Теперь, если мы перейдем в публичный раздел сайта, то больше не увидим сообщение «Шаблон не найден». То есть всё ок, Битрикс принял наш шаблон. Сейчас наша главная страница выглядит следующим образом:

        Главная страница обновилась

        Знакомимся со структурой шаблона

        Давайте посмотрим, из чего состоит созданный нами шаблон. Для этого по FTP перейдем в папку шаблона. В Битриксе шаблоны сайта лежат в папке /bitrix/templates/ , если мы зайдем туда – увидим следующий набор папок:

        Папка с шаблонами

        Это три шаблона, которые сейчас есть у нас на сайте.

        .default – папка шаблона сайта по-умолчанию: он подключается, если нет никаких других шаблонов (именно он использовался Битриксом до тех пор, пока мы не создали и не выбрали в настройках наш собственный шаблон).

        landing24 – папка стандартного шаблона, который используется для создания лэндингов в рамках Битрикса (этот функционал в рамках данного курса мы рассматривать не будем).

        alfavitka – это папка нашего шаблона (совпадает с ID шаблона, который мы указали при его создании).

        Зайдем в папку нашего шаблона и видим следующий набор файлов:

        Наш новый шаблон

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

        .styles.php – файл для описания стилей, которые используются в визуальном редакторе Битрикса (с ним мы разберемся в следующих уроках).

        description.php – здесь хранится текстовое название шаблона, описание и другая информация:

        Описание шаблона

        footer.php – содержит код подвала сайта.

        header.php – содержит код шапки сайта.

        Сейчас эти файлы пустые, потому что на этапе создания шаблона мы не внесли в них никакой код.

        styles.css – содержит стили сайта (с этим файлом мы разберемся в следующих уроках).

        template_styles.css – содержит стили шаблона сайта.

        Эти файлы также пустые, т.к. при создании шаблона их мы не заполняли.

        Вставляем HTML в шаблон и на главную страницу

        Для начала нужно мысленно разбить нашу верстку на 2 части: на шапку и подвал. Открываем файл с версткой index.html и ищем контент (ту часть верстки, которая будет уникальная для каждой страницы сайта). В нашем случае контент выглядит следующим образом:

        Контент главной страницы

        Всё, что выше контента – вставляем в файл шаблона header.php, весь код под контентом – в файл footer.php

        Главная страница нашего сайта немного изменилась:

        Главная страница без стилей

        Т.к. в нашей верстке есть контент для главной страницы – давайте вставим его на главную страницу нашего сайта. Через FTP-менеджер идем в корень сайта и открываем файл index.php, видим следующее содержимое:

        Содержимое главной страницы

        Очень грубо говоря: в первых четырех строчках подключается шапка сайта (и ядро битрикса) и устанавливается заголовок страницы. Последняя строчка подключает подвал сайта (и кое-какие служебные скрипты).

        Между этими строчками и содержится контент страницы. Давайте заменим его на контент из верстки, получим следующее:

        Вставляем новый контент на главную

        Главная страница сайта стала еще чуть более информативной:

        Главная страница с новым контентом

        Подключаем стили и скрипты

        Верстку мы добавили, теперь подключим стили и скрипты. В нашем HTML шаблоне есть папка css-js, которая содержит файлы CSS-стилей и JS-скриптов. Давайте загрузим ее в папку Битрикс шаблона /bitrix/templates/alfavitka :

        Папка шаблона

        В header.php у нас есть 2 файла со стилями:

        Файл bootstrap.min.css – это файл-библиотека, который в будущем мы точно не будем редактировать. Поэтому подключаем его как дополнительный файл стилей. Для подключения дополнительных файлов со стилями в Битриксе используется следующий код:

        В нашем случае код будет иметь следующий вид:

        Секция head в нашем шаблоне теперь выглядит следующим образом:

        Вывод стилей через SetAdditionalCSS

        Теперь разберемся со вторым подключаемым файлом стилей styles.css – он содержит стили шаблона, которые мы в перспективе точно будем редактировать. Поэтому стили из этого файла мы вставляем в файл шаблона template_styles.css. Сам файл styles.css из папки css-js можем удалить. Также удаляем подключение этого файла из секции head, в итоге она выглядит следующим образом:

        Удалили подключение файла styles.css

        Отлично, мы передали Битриксу информацию о всех наших стилях, осталось вывести их в шаблоне. Для этого воспользуемся следующим кодом:

        Этот код выводит не только все подключенные CSS-стили, но и JS-скрипты, а также мета-теги Content-Type, robots, keywords, description. Вставляем этот код в самый конец секции head, в итоге она выглядит следующим образом:

        Функция ShowHead

        С подключением стилей мы разобрались, наш шаблон приобретает более-менее приемлемый вид:

        Теперь давайте подключим JS-скрипты. В файле footer.php у нас есть две строчки со скриптами:

        Подключение скриптов

        Как и в случае со стилями, для подключения JS-скриптов в Битриксе есть своя функция:

        В нашем случае подключение скриптов будет выглядеть следующим образом:

        Также давайте перенесем подключение скриптов из подвала в шапку.

        В итоге секция head будет выглядеть следующим образом:

        Функция AddHeadScript в Битриксе

        Теперь на мобильных размерах экрана меню будет разворачиваться/сворачиваться при клике на иконку «гамбургера»:

        Меню заработало

        Прописываем актуальные пути к картинкам

        Сейчас у нас на сайте есть две картинки, которые не отображаются. Во-первых, нам нужно загрузить их на хостинг: из локального HTML шаблона загружаем папку images в папку шаблона на нашем хостинге:

        Загрузили папку картинок

        Теперь, чтобы картинки отобразились у нас на сайте, в атрибуте src каждому тегу img нужно указать актуальный путь к файлу изображения. Обе картинки теперь лежат в папке images внутри папки шаблона. Как вы уже догадались, здесь нам опять поможет константа SITE_TEMPLATE_PATH. Код подключения логотипа теперь выглядит так:

        Аналогично используем SITE_TEMPLATE_PATH для получения пути картинки в контенте на главной странице (файл index.php в корне сайта):

        В итоге наша главная страница выглядит следующим образом:

        Итоговый вид главной страницы

        Выводим панель администратора

        Напоследок давайте выведем панель администратора в самое начало страницы. Для вывода панели администратора в Битриксе используется следующий код:

        Разместим этот код в header.php сразу после открывающего тега body:

        Битрикс ShowPanel

        Панель администратора отобразилась:

        Вывели панель администратора

        На этом закончим данный урок. В следующем уроке познакомимся с компонентами битрикса на примере компонента «Меню» и научимся создавать новые страницы сайта.

        Битрикс шаблон главной страницы

        Пусть у нас на сайте есть страница (или раздел), которая сильно отличается от всех остальных. Чтобы разговор был более предметным, это будет страница блога. Мы уже создали шаблон voguis_index , применили его ко всем страницам, а теперь надо придумать, как для страницы блога что-то скрыть или наоборот — показать.

        Самый простой способ — использовать метод getCurPage(false) объекта $APPTICATION . Для главной страницы он вернет / (слэш), а для блога — /blog/ . Проверяя возвращаемое значение, можно выводить разный контент:

        Но, если отличий много, таких вставок тоже будет немало. А если и верстка блога имеет большие отличия от дефолтного шаблона — будет вообще трудно что-то понять: множество проверок (выводить или нет), какие css-стили применять и т.п. Гораздо проще для блога создать отдельный шаблон. Для этого копируем уже имеющийся шаблон из папки voguis_index в папку voguis_blog , и вносим исправления в копию.

        А потом для страницы блога подключаем отдельный шаблон по условию:

        Список всех шаблонов расположен по пути «Настройки • Настройки продукта • Сайты • Шаблоны сайтов», а условия для применения того или иного шаблона — по пути «Настройки • Настройки продукта • Сайты • Список сайтов». Условия применения шаблона могут быть самыми разными:

        Часто сайты имеют разный вид и структуру для главной и внутренних страниц, поэтому приходится делать разные шаблоны под них. Что бы сделать в 1с-битрикс два разных шаблона (учитывая что файлы шаблонов уже лежат на своих местах), нужно открыть админку и перейти в Настройки ->Настройки продукта->Сайты->Список сайтов и выбрать нужный. Когда откроете сайт для редактирования прокрутите экран до раздела «Шаблон».

        Теперь нужно указать 1 шаблон для внутренних страниц, без условия. И один шаблон для главной (условие «/index.php» тип условия для «Для папки или файла»)

        Создан: 06.05.2013 07:58 | Отредактирован: 12.03.2015 06:39

        Mожно ли в битриксе сделать разные шаблоны для главной и для внутренней страниц? — Оказывается, что можно и даже не сложно вовсе.

        Сделайте 2 разных шаблона, удобно путём копирования одного и последующего изменения.

        Дальше в настройках сайта (путь смотри в комментарии #152) задайте сначала шаблон для внутренних страниц (без условия), а ниже сделайте условие, что если страница главная, то она будет с другим шаблоном (/index.php). Вот рисунок

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

        almix
        Разработчик Loco, автор статей по веб-разработке на Yii, CodeIgniter, MODx и прочих инструментах. Создатель Team Sense.

        голоса
        Рейтинг статьи
Ссылка на основную публикацию
Adblock
detector