Personalización de las páginas de escaparate

Personalice los archivos JavaServer Page (archivos JSP) y las vistas MVC Spring que los invocan para modificar cómo se generan las páginas de tienda y cómo se devuelven a los usuarios de la tienda. Realice adiciones o modificaciones a los archivos JSP existentes o añada nuevos archivos JSP para ampliar la funcionalidad del escaparate.

Por qué y cuándo se efectúa esta tarea

Añada o amplíe los archivos JSP de widget y páginas de tienda en el archivador web de tienda personalizado (crs-web.war). Además de personalizar los archivos JSP existentes o añadir unos nuevos, también debe modificar el controlador de vista y las vistas Spring de tienda para devolver y visualizar páginas nuevas o ampliadas a los usuarios del escaparate.

Este proceso también ofrece la posibilidad de personalizar widgets y páginas de tienda proporcionados por IBM. Cuando estos archivos se mueven al archivador web de tienda personalizado, ya no se podrán actualizar más automáticamente durante el proceso de migración. Por lo tanto, estos archivos JSP personalizados siguen estando totalmente bajo su control. Previsiblemente, estos archivos JSP funcionarán de la misma manera hasta que se realicen más personalizaciones o las actualizaciones en los originales dentro del archivador de tienda proporcionado por IBM se fusionen manualmente.

El procedimiento de ejemplo que se proporciona detalla el flujo de tareas que es necesario para personalizar las páginas de tienda existentes y añadir nuevas páginas a su escaparate. Los nombres de archivo, carpeta y tienda individuales deben reflejar su propio entorno y la personalización que tiene previsto implementar.

Procedimiento

Cree o amplíe el archivo de configuración crs-web.war/WEB-INF/spring/MyStore/member-views-ext.xml de la vista personalizada con la definición de la vista modificada. En este ejemplo se muestra la misma definición de vista exacta que member-views.xml. La única diferencia reside en el archivo JSP que se utiliza.

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="GlobalLoginSignInView/MyStore" class="com.ibm.commerce.store.mvc.view.spring.StoreInternalResourceView">
<property name="url" value="/MyWidgets/com.ibm.commerce.store.widgets.GlobalLogin/GlobalLoginSignInRegistration.jsp"/>
<property name="https" value="1"/>
<property name="credentialsAccepted" value="P"/>
<property name="storeDir" value="no"/>
<property name="generic" value="1"/>
</bean>
</beans>

Para obtener más información sobre la personalización del controlador de vista, consulte Personalización de MVC Spring y del controlador de tienda.

Añada la vista personalizada al archivo de definición del controlador de vista ampliado.
1. Abra el archivo de definición de controlador de vista crs-web.war/WEB-INF/spring/MyStore/views-ext.xml con un editor de texto.
2. Modifique las vistas existentes o bien añada la nueva vista personalizada dentro del elemento <beans>.
  Por ejemplo:
```
<import resource="classpath:/WEB-INF/spring/MyStore/member-views-ext.xml"/>
```
Cree o amplíe el nuevo archivo o archivos JSP. Si personaliza los archivos JSP existentes en el archivador web de tienda proporcionado por IBM, muévalos y mueva todas las dependencias al archivador web de tienda personalizado.
En este ejemplo, estos archivos JSP incluyen:
- El archivo JSP ampliado personalizado, crs-web.war/WebContent/MyWidgets/com.ibm.commerce.store.widgets.GlobalLogin/GlobalLoginSignInRegistration.jsp. Se ha localizado originalmente en el directorio crs-web.war/WebContent/Widgets_701/com.ibm.commerce.store.widgets.GlobalLogin/.
- Los archivos de fragmento JSP referenciados, ubicados ahora en el directorio crs-web.war/WebContent/MyWidgets/. Ubicado originalmente en el directorio crs-web.war/WebContent/Widgets_701/:
  - /Common/EnvironmentSetup.jspf
  - /Common/JSTLEnvironmentSetup.jspf
  - /Common/ErrorMessageSetup.jspf
  - /Common/nocache.jspf
  - /com.ibm.commerce.store.widgets.GlobalLogin/GlobalLoginSignInRegistration_Data.jspf
Nota: Puede copiar todos los archivos JSP referenciados en el archivador web de tiendas. Si hace referencia a los archivos JSP en otros archivadores (como por ejemplo, los archivos JSP predeterminados en el archivador de tienda que proporciona IBM), puede utilizar la propiedad targetServletName para hacer referencia a ellos. Por ejemplo, <property name="targetServletName" value="IBMStores"/> significa que el JSP referenciado está en el archivador de tienda que proporciona IBM.
Personalice los archivos JSP creados o ampliados dentro del archivador de tienda web personalizado.
Reinicie el servidor de tienda.

Resultados

Ahora, el escaparte devuelve una página que se compila con el archivo JSP personalizado cuando se utiliza la vista Spring personalizada.