aem core cif components Скачать - aem core cif components Скачать исходный код

aem core cif components

Сторонние компоненты

CI

Скачать

AEM CIF CORE COMPONETS

Проект AEM CIF Core Components служит акселератором, чтобы начать работу с проектами с использованием AEM, CIF и Adobe Commerce. Проект содержит повторно используемые компоненты Commerce Core, которые сочетают в себе компоненты AEM на стороне сервера с компонентами Client Side React Commerce (MPA) для динамического опыта / данных.

Этот проект предназначен для использования в сочетании с основными компонентами AEM -сайтов. Компоненты AEM CIF CORE используют компоненты AEM -сайтов в качестве основы, где это возможно и расширяет их.

Для начала нового проекта, пожалуйста, посмотрите на наш проект архетипа. Также взгляните на наш проект «Выборочный образ», который использует компоненты WCM и CIF Core для обеспечения потрясающего опыта в магазине.

Документация

См. Документацию AEM Content & Commerce для использования и инструкций по конфигурации компонентов AEM CIF Core и введения в разработку компонентов AEM.

Доступные компоненты

Продукт v1
Продукт V2 - Adobe Commerce EE только с версией> = 2.4.2
Список продуктов v1
Список продуктов v2 - Adobe Commerce EE только с версией> = 2.4.2
Коллекция продукта v1
Сбор продуктов v2 - Adobe Commerce EE только с версией> = 2.4.2
Продукт тизер
Продукт карусель
Связанные продукты
Навигация
Хлебная рубашка
Результаты поиска v1
Результаты поиска v2
Searchbar
Корзина
Показанный список категорий
Коммерческий тизер
Кнопка коммерции
Список торговли
Войти
Зарегистрироваться
Мини -аккаунт
Детали счета
Адресная книга
Сбросить пароль
Категория Карусель
Коммерческий опыт фрагмент
Фрагмент содержания торговли
Фрагмент содержания торговли
Детали тележки
Страница оформления заказа

Удлинительные компоненты

Рекомендации по продукту - Требуются рекомендации по продукту Adobe Commerce

Технический предварительный просмотр

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

Продукт V3 - Adobe Commerce EE только с версией> = 2.4.4

Системные требования

Последняя версия компонентов AEM CIF CORE, требует ниже минимальных системных требований:

CIF Core Components	AEM как облачный сервис	AEM 6.5	AEM Commerce Add-On	Adobe Commerce	Ява
2.15.0	Непрерывный	6.5.18	V2022.08.02.00	2.4.2 EE	11

Список требований для предыдущих версий см. Исторические системы.

AEM CIF дополнение

Для AEM как развертывания облачных сервисов этот проект требует дополнения CIF для каждого AEM в качестве среды облачных сервисов. Дополнение CIF устанавливается автоматически, никакого дополнительного развертывания не требуется. Дополнение CIF также доступно для локальной разработки с AEM SDK от портала распределения программного обеспечения.

Для установок AEM этот проект требует, чтобы AEM Commerce Add-On для AEM 6.5 для улучшения опыта авторизации путем использования сборщиков продуктов, просмотра активов продуктов и консолей продукта, предоставленных пакетом Connector. Дополнение AEM Commerce для AEM 6.5 также доступно на портале распределения программного обеспечения. Он должен быть установлен отдельно.

AEM -сайты основные компоненты

Этот проект опирается на основные компоненты AEM -сайтов. Они обычно устанавливаются как часть AEM. Если вы установите AEM без выборки содержимого, вы должны развернуть их вручную перед использованием компонентов AEM CIF Core.

График кэширование с Adobe Commerce 2.3.2

Начиная с 2.3.2, Adobe Commerce поддерживает запросы GraphQL с кэшем и, начиная с версии 0.2.1, компоненты CIF Core будут использовать его по умолчанию. Чтобы компоненты работали с Adobe Commerce 2.3.1, вы можете вручную отключить эту функцию в следующих местах:

Для компонентов на стороне клиента: CommerceGraphqlapi.js

Установка

Клонировать это хранилище.
Запустите mvn clean install в корневой папке, чтобы установить артефакты в местный репозиторий Maven.
Переключитесь на all Project и запустите mvn clean install content-package:install .

Вот полное видео прохождение процесса настройки.

Легкая установка с пакетом "All"

Если вы хотите самостоятельно построить все модули и получить все последние (пока) не выпущенные изменения, просто создайте и установите все модули со следующей командой в корне репозитория:

 mvn clean install -PautoInstallAll

Это устанавливает все по умолчанию на localhost:4502 без какого -либо контекстного пути. Вы также можете настроить расположение установки со следующими свойствами Maven:

aem.host : имя экземпляра AEM
aem.port : номер порта экземпляра AEM
aem.contextPath : путь контекста вашего экземпляра AEM (если нет / )

Уберджар

Этот проект полагается на AEM 6.5.7 cq-quickstart Uberjar. Это публично доступно на https://repo.adobe.com

Для получения более подробной информации о Uberjar, пожалуйста, перейдите к тому, как создать проекты AEM, используя страницу документации Apache Maven.

Включите основные компоненты в качестве подпакукции в свой собственный проект Maven Build

Выпущенная версия компонентов AEM CIF Core доступна в центральном репозитории Maven. Чтобы включить пакет компонентов CIF CIF CORE в свой собственный проект Maven Build Вы можете добавить зависимость

 <dependency>
    <groupId>com.adobe.commerce.cif</groupId>
    <artifactId>core-cif-components-all</artifactId>
    <type>zip</type>
    <version>x.y.z</version>
</dependency>

и раздел Sub Package

 <subPackage>
     <groupId>com.adobe.commerce.cif</groupId>
     <artifactId>core-cif-components-all</artifactId>
     <filter>true</filter>
 </subPackage>

к content-package-maven-plugin .

Конфигурация

Чтобы подключить компоненты AEM CIF Core с вашей средой Adobe Commerce или 3 -й коммерческой коммерции, следуйте этапам конфигурации. Для подключения сайта AEM необходимы дополнительные шаги, чтобы связать сайт AEM с конфигурацией просмотра магазина Adobe Commerce.

Настройка

Для настройки компонентов CIF Core мы предоставляем варианты использования и примеры в нашей документации при настройке компонентов CIF Core.

Тестирование

Карма модульные тесты

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

 cd ui.apps
npm install
npm test

Карма будет тестировать с Chrome и Firefox. Убедитесь, что у вас установлены оба браузера.

Форматирование кода

Ява

Вы можете найти правила форматирования кода в файле eclipse-formatter.xml . Форматирование кода автоматически проверяется для каждой сборки. Чтобы автоматически форматировать код, запустите:

mvn clean install -Pformat-code

JavaScript & CSS

Для форматирования JavaScript и CSS мы используем красивые. Форматирование автоматически проверяется при запуске npm test в проекте ui.apps . Чтобы автоматически форматировать код, запустите следующую команду в ui.apps :

npm run prettier:fix

Релизы в Maven Central

Выпуски этого проекта запускаются вручную запустить mvn release:prepare release:clean на master ветви в корневой папке этого репозитория. После того, как вы выберете выпуск и следующие версии снимков, он совершает изменение вместе с тегом GIT, например, core-cif-components-reactor-xyz . Обратите внимание, что коммиты не выдвигаются автоматически в репозиторий GIT, поэтому у вас есть время, чтобы проверить ваши изменения, а затем вручную подтолкнуть их. Затем толчок запускает выделенную сборку CircleCI , которая выполняет развертывание помеченного артефакта в Maven Central.

ВАЖНО : Этот проект выполняет выпуска Maven Reactor, не запускает выпуски из подмодулей!

Примечание. В случае, если необходимо обновить версию пакета Java из -за изменений API и семантического управления версией, можно легко обновить родительскую версию POM и все POM, ссылающиеся на родительскую версию POM, запустив следующую команду в папке родительского проекта: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Это гарантирует, что все проекты имеют одинаковую версию.