aem core cif components Download - aem core cif components Sumber Download

aem core cif components

Komponen pihak ketiga

CI

Unduh

Komponen inti AEM CIF

Proyek Komponen Inti AEM CIF berfungsi sebagai akselerator untuk memulai dengan proyek menggunakan AEM, CIF dan Adobe Commerce. Proyek ini berisi komponen inti perdagangan yang dapat digunakan kembali yang menggabungkan komponen AEM sisi-server dengan komponen perdagangan reaksi sisi klien (MPA) untuk pengalaman / data dinamis.

Proyek ini dimaksudkan untuk digunakan bersama dengan komponen inti situs AEM. Komponen inti AEM CIF menggunakan komponen inti situs AEM sebagai fondasi di mana memungkinkan dan memperluasnya.

Untuk memulai proyek baru, silakan lihat proyek arketipe kami. Juga lihat proyek sampel Venia kami yang menggunakan komponen inti WCM dan CIF untuk memberikan pengalaman toko di depan yang menakjubkan.

Dokumentasi

Lihat Dokumentasi Konten & Perdagangan AEM untuk instruksi penggunaan dan konfigurasi dari komponen inti AEM CIF dan pengantar pengembangan komponen AEM.

Komponen yang tersedia

Produk V1
Produk V2 - Adobe Commerce hanya dengan versi> = 2.4.2
Daftar Produk V1
Daftar Produk V2 - Adobe Commerce EE hanya dengan versi> = 2.4.2
Koleksi Produk V1
Koleksi Produk V2 - Adobe Commerce EE hanya dengan versi> = 2.4.2
Penggoda produk
Korsel Produk
Produk terkait
Navigasi
Remah roti
Hasil pencarian v1
Hasil pencarian v2
Searchbar
Keranjang belanja
Daftar kategori unggulan
Penggoda Perdagangan
Tombol Perdagangan
Daftar Perdagangan
Masuk
Buat akun
Akun mini
Detail Akun
Buku alamat
Setel ulang kata sandi
Kategori korsel
Fragmen Pengalaman Perdagangan
Fragmen Konten Perdagangan
Fragmen Konten Perdagangan
Detail gerobak
Halaman checkout

Komponen ekstensi

Rekomendasi Produk - Membutuhkan Rekomendasi Produk Adobe Commerce

Pratinjau Teknis

Komponen yang dalam pratinjau teknis dapat berubah dengan cara yang tidak kompatibel dengan tidak ada di belakang kapan saja. Ini termasuk semua asepect dan khususnya struktur konten, API, markup dan gaya jika berlaku. Jangan gunakan komponen ini dalam produksi.

Produk V3 - Adobe Commerce hanya dengan versi> = 2.4.4

Persyaratan sistem

Versi terbaru dari komponen inti AEM CIF, memerlukan persyaratan sistem minimum di bawah ini:

Komponen inti CIF	AEM sebagai layanan cloud	AEM 6.5	AEM Commerce Add-on	Adobe Commerce	Jawa
2.15.0	Terus -menerus	6.5.18	V2022.08.02.00	2.4.2 EE	11

Untuk daftar persyaratan untuk versi sebelumnya, lihat persyaratan sistem historis.

AEM CIF Add-on

Untuk AEM sebagai penyebaran layanan cloud, proyek ini membutuhkan tambahan CIF yang disediakan pada setiap AEM sebagai lingkungan layanan cloud. Add-on CIF diinstal secara otomatis, tidak diperlukan penyebaran tambahan. Add-on CIF juga tersedia untuk pengembangan lokal dengan AEM SDK dari portal distribusi perangkat lunak.

Untuk instalasi AEM on-prem, proyek ini mensyaratkan add-on perdagangan AEM untuk AEM 6.5 untuk meningkatkan pengalaman penulisan dengan memanfaatkan pemetik produk, tampilan aset produk, dan konsol produk yang disediakan oleh paket konektor. Add-on AEM Commerce untuk AEM 6.5 juga tersedia di portal distribusi perangkat lunak. Itu harus dipasang secara terpisah.

Komponen Inti Situs AEM

Proyek ini bergantung pada komponen inti situs AEM. Mereka biasanya dipasang sebagai bagian dari AEM. Jika Anda menginstal AEM tanpa opsi konten sampel, Anda harus menggunakannya secara manual sebelum menggunakan komponen inti AEM CIF.

Caching graphql dengan Adobe Commerce 2.3.2

Dimulai dengan 2.3.2, Adobe Commerce mendukung permintaan graphQL yang dapat cache dan dimulai dengan versi 0.2.1 Komponen inti CIF akan menggunakannya secara default. Untuk membuat komponen berfungsi dengan Adobe Commerce 2.3.1 Anda dapat secara manual menonaktifkan fitur ini di lokasi berikut:

Untuk komponen sisi klien: commercegraphqlapi.js

Instalasi

Kloning repositori ini.
Jalankan mvn clean install di folder root untuk menginstal artefak ke repositori Maven lokal Anda.
Beralih ke all proyek dan jalankan mvn clean install content-package:install .

Berikut adalah video lengkap walk-through dari proses pengaturan.

Instal Mudah Dengan Paket "Semua"

Jika Anda ingin membangun semua modul sendiri dan mendapatkan semua perubahan terbaru (belum) yang belum dirilis , cukup buat dan instal semua modul dengan perintah berikut di root repositori:

 mvn clean install -PautoInstallAll

Ini menginstal semuanya secara default ke localhost:4502 tanpa jalur konteks apa pun. Anda juga dapat mengonfigurasi lokasi instal dengan properti Maven berikut:

aem.host : Nama instance AEM
aem.port : Jumlah port dari instance AEM
aem.contextPath : jalur konteks instance AEM Anda (jika tidak / )

Uberjar

Proyek ini bergantung pada AEM 6.5.7 cq-quickstart Uberjar. Ini tersedia untuk umum di https://repo.adobe.com

Untuk detail lebih lanjut tentang uberjar, silakan kunjungi halaman How to Build AEM menggunakan halaman dokumentasi Apache Maven.

Sertakan komponen inti sebagai subpackage ke dalam proyek Anda sendiri Maven build

Versi yang dirilis dari komponen inti AEM CIF tersedia di repositori pusat Maven. Untuk memasukkan paket komponen inti AEM CIF ke dalam proyek Anda sendiri, Anda dapat menambahkan ketergantungan

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

dan bagian sub paket

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

ke content-package-maven-plugin .

Konfigurasi

Untuk menghubungkan komponen inti AEM CIF dengan lingkungan Adobe Commerce Anda atau penyebaran perdagangan pihak ke -3, ikuti langkah -langkah konfigurasi. Untuk pengaturan multi -toko / situs, langkah -langkah tambahan diperlukan untuk menautkan situs AEM ke konfigurasi tampilan Adobe Commerce Store.

Kustomisasi

Untuk menyesuaikan komponen inti CIF, kami memberikan kasus dan contoh penggunaan dalam dokumentasi kami dalam menyesuaikan komponen inti CIF.

Pengujian

Tes Unit Karma

Kode JavaScript sisi klien dari komponen dicakup menggunakan uji unit mocha yang dieksekusi dengan karma. Pastikan bahwa untuk setiap kontribusi kode sisi klien baru dicakup oleh tes dan semua tes lulus.

 cd ui.apps
npm install
npm test

Karma akan menguji dengan Chrome dan Firefox. Pastikan Anda menginstal kedua browser.

Pemformatan kode

Jawa

Anda dapat menemukan aturan pemformatan kode dalam file eclipse-formatter.xml . Pemformatan kode secara otomatis diperiksa untuk setiap bangunan. Untuk memformat kode Anda secara otomatis, silakan jalankan:

mvn clean install -Pformat-code

JavaScript & CSS

Untuk memformat JavaScript dan CSS kami menggunakan lebih cantik. Pemformatan secara otomatis diperiksa saat menjalankan npm test di proyek ui.apps . Untuk secara otomatis memformat kode Anda, silakan jalankan perintah berikut di ui.apps :

npm run prettier:fix

Rilis ke Maven Central

Rilis proyek ini dipicu dengan menjalankan mvn release:prepare release:clean di cabang master pada folder root repositori ini. Setelah Anda memilih rilis dan versi snapshot berikutnya, ini melakukan perubahan bersama dengan rilis tag git seperti misalnya core-cif-components-reactor-xyz . Perhatikan bahwa komit tidak secara otomatis didorong ke repositori git, jadi Anda punya waktu untuk memeriksa perubahan Anda dan kemudian secara manual mendorongnya. Dorongan kemudian memicu bangunan CircleCI khusus yang melakukan penyebaran artefak yang ditandai ke Maven Central.

Penting : Proyek ini melakukan pelepasan reaktor Maven, jangan memicu rilis dari sub modul!

Catatan: Jika diperlukan untuk memperbarui versi bundel Java karena perubahan API dan versi semantik, orang dapat dengan mudah memperbarui versi POM induk dan semua POM merujuk versi POM induk dengan menjalankan perintah berikut di folder proyek induk: mvn versions:set -DnewVersion=xyz-SNAPSHOT . Ini akan memastikan semua proyek memiliki versi yang sama.