Ti trovi qui:
Wrapper opzionale per l'immagine del prodotto DIS della community
Il progetto open source facoltativo dis-product-image-wrapper consente ad alcuni progetti Salesforce Reference Architecture (SFRA) e SiteGenesis di centralizzare i parametri delle immagini dei prodotti e di utilizzare gli helper JavaScript. Non è un sostituto obbligatorio per URLUtils e MediaFile di B2C Commerce API.
Per il percorso B2C Commerce consigliato, vedere Argomenti correlati a Dynamic Imaging Service e Dynamic Imaging Service . Per informazioni di riferimento su URLUtils e MediaFile, consultate Script API . Le sezioni seguenti descrivono solo il cartridge della community.
Cosa prevede il progetto comunitario
Il progetto GitHub documenta un cartridge plugin_dis, la configurazione JSON dei tipi di visualizzazione (ad esempio, dimensioni grandi / medie / piccole ) e un helper come ProductImageDIS per ottenere oggetti immagine in Internet Store Markup Language (ISML). Il comportamento e i nomi dei file nel repository possono cambiare da una versione all'altra; utilizzare il file README e il wiki correnti nel repository, non un numero di riga stampato o il percorso di un documento precedente.
Repository e accesso
- Repository: SalesforceCommerceCloud / dis-product-image-wrapper su GitHub
- Wiki (quando pubblicato): wiki dis-product-image-wrapper per elenchi di template e modifiche specifiche del progetto
- L'accesso può richiedere un account GitHub, l'autenticazione a due fattori e i processi della community di Commerce descritti nell'archivio. Segui le istruzioni lì quando cambiano; non copiare i passaggi delle credenziali da un PDF obsoleto o da una guida come autorevole.
Abilitazione SFRA (riepilogo)
L'attuale documentazione del repository sostituisce questo schema. I passaggi che utilizzano plugin_dis, ProductImageDIS.js o image_config_DIS.json descrivono il layout tipico della community al momento della stesura; I nomi e le posizioni dei file possono cambiare.
- Clonare il repository corrente da GitHub.
- In , aggiungere
plugin_disal percorso del cartridge primadi app_storefront_base. Ad esempio:app_mystorefront:plugin_dis:app_storefront_base. - Configurare i tipi di visualizzazione e le dimensioni in un file JSON, ad esempio
image_config_DIS.jsonin un cartridge di cui si è proprietari. Un file tipico definisce i tipi di visualizzazione (ad esempiolarge,medium,small,swatch),l'opzione viewTypeMappingin modo che i tipi di visualizzazione più piccoli derivino da un'origine più grande e i fallbackmissingImages. - Caricare immagini sorgente ad alta risoluzione (ad esempio, 2400 x 2400 pixel per le immagini principali del prodotto) in Strumenti per il . Associare ogni immagine al tipo di visualizzazione sorgente (ad esempio
alta risoluzioneogrande). - In ISML, chiamare l'helper del progetto, ad esempio
ProductImageDIS.getImage(product, viewType, index),e utilizzare le proprietàgetURL(),altetitledell'oggetto restituito quando si scrive il tagimg. - Verificare che gli URL generati utilizzino il dominio personalizzato dello storefront, includano
/dw/image/v2/dove si applica una trasformazione e corrispondano alle dimensioni configurate. Vedere Risoluzione dei problemi e migrazione se una richiesta restituisce 4xx, un timeout o un'immagine interrotta.
Abilitazione di SiteGenesis (riepilogo)
I progetti SiteGenesis seguono la stessa installazione del cartridge, ma gli aggiornamenti dei modelli sono manuali. Esempio di percorso cartridge: app_mystorefront:plugin_dis:sitegenesis_controllers:sitegenesis_core. Aggiornare le chiamate alle immagini dei prodotti nei modelli dello storefront elencati dal wiki; I modelli a traffico elevato in genere includono la pagina dei dettagli del prodotto, il riquadro del prodotto, il carrello e il mini carrello, il riepilogo del checkout e l'e-mail del prodotto. Preferire la sostituzione basata su pattern, ovvero cercare la ricerca di immagini esistente e sostituirla con una chiamata che passa attraverso l'helper, rispetto alle istruzioni specifiche per il numero di riga di una guida all'implementazione precedente, perché i modelli SiteGenesis di base sono cambiati.

