Usted está aquí:
Contenedor de imagen de producto DIS de la comunidad opcional
El proyecto opcional de código abierto dis-product-image-wrapper ayuda a algunos proyectos de Salesforce Reference Architecture (SFRA) y SiteGenesis a centralizar los parámetros de la imagen del producto y a utilizar ayudantes de JavaScript. No es un reemplazo obligatorio para URLUtils y MediaFile de la API de B2C Commerce.
Para conocer la ruta de acceso recomendada de B2C Commerce, consulte Temas relacionados con Dynamic Imaging Service y Dynamic Imaging Service . Para obtener información sobre URLUtils y MediaFile, consulte Script API . En las secciones siguientes solo se describe el cartridge de la comunidad.
Lo que aporta el proyecto comunitario
El proyecto de GitHub documenta un cartucho plugin_dis, una configuración JSON de tipos de vista (por ejemplo, dimensiones grandes, medianas y pequeñas ) y un ayudante como ProductImageDIS para obtener objetos de imagen en Internet Store Markup Language (ISML). El comportamiento y los nombres de los archivos en el repositorio pueden cambiar entre versiones; use el archivo README y el wiki actuales en el repositorio, no un número de línea impreso o una ruta de un documento anterior.
Repositorio y acceso
- Repositorio: SalesforceCommerceCloud / dis-product-image-wrapper en GitHub
- Wiki (cuando se publica): wiki dis-product-image-wrapper para listas de plantillas y cambios específicos del proyecto
- El acceso puede requerir una cuenta de GitHub, autenticación de dos factores y procesos de la comunidad de Commerce descritos en el repositorio. Siga las instrucciones allí cuando cambien; no copie los pasos de las credenciales de un PDF o una guía obsoletos como autorizados.
Habilitación de SFRA (resumen)
La documentación actual del repositorio reemplaza este esquema. Los pasos que usan plugin_dis, ProductImageDIS.js o image_config_DIS.json describen el diseño típico de la comunidad en el momento de escribir este artículo; Los nombres y las ubicaciones de los archivos pueden cambiar.
- Clone el repositorio actual de GitHub.
- En , agregue
plugin_disa la ruta del cartucho antes deapp_storefront_base. Por ejemplo:app_mystorefront:plugin_dis:app_storefront_base. - Configure los tipos de vista y las dimensiones en un archivo JSON, como
image_config_DIS.jsonen un cartucho de su propiedad. Un archivo típico define los tipos de vista (por ejemplo,grande,mediana,pequeña,muestra),viewTypeMappingopcional para que los tipos de vista más pequeños se deriven de un origen más grande ylas reservas de missingImages. - Cargue imágenes de origen de alta resolución (por ejemplo, 2400 x 2400 píxeles para las imágenes principales del producto) en . Asocie cada imagen con el tipo de vista de origen (por ejemplo,
alta resoluciónogrande). - En ISML, llame al ayudante del proyecto, por ejemplo,
ProductImageDIS.getImage(product, viewType, index),y use las propiedadesgetURL(),altytitledel objeto devuelto al escribir la etiquetaimg. - Verifique que las URL generadas usen el dominio personalizado de su storefront, incluyan
/dw/image/v2/donde se aplique una transformación y coincidan con los tamaños configurados. Consulte Solución de problemas y migración si una solicitud devuelve 4xx, un tiempo de espera o una imagen rota.
Habilitación de SiteGenesis (resumen)
Los proyectos de SiteGenesis siguen la misma instalación del cartucho, pero las actualizaciones de la plantilla son manuales. Ejemplo de ruta del cartucho: app_mystorefront:plugin_dis:sitegenesis_controllers:sitegenesis_core. Actualizar las llamadas a imágenes de productos en las plantillas del storefront que la wiki enumera; Las plantillas de alto tráfico suelen incluir la página de detalles del producto, el mosaico del producto, el carrito y el minicarrito, el resumen de la finalización de la compra y el correo electrónico del producto. Prefiera el reemplazo basado en patrones (busque la búsqueda de imágenes existente y reemplácela con una llamada que pase por el asistente) en lugar de instrucciones específicas de números de línea de una guía de implementación anterior, porque las plantillas básicas de SiteGenesis han cambiado.
