Child pages
  • Posiciones de los módulos en el Front-Office

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Un módulo puede tener dos aspectos: uno en el back-office (sus opciones, o incluso su pantalla de configuración), y el otro en el front-office. La parte front-office corresponde a cómo y dónde se mostrará el módulo en su el tema utilizado por tu tienda.

La posición de un módulo en su el tema de tu tienda tema puede ser cambiada, porque debido a que es posible que desee desees que el bloque de un módulo esté posicionado más arriba (o más abajo) en la página que otros. En la jerga PrestaShop, a esta acción se la denomina "trasplante", y se realiza mediante la herramienta disponible en la página "Posiciones de los módulos", bajo el menú "Módulos y Servicios". En realidad, ésta le te permite conectar un módulo a uno de los muchos hooks (también denominados ganchos)) disponibles en el tema actual, sin necesidad de escribir ningún código.

La página "Posiciones de los módulos" le te muestra todos los hooks o ganchos disponibles, así como los módulos correspondientes que están conectados enganchados a ellos. Muchos están vacíos por defecto, pero la mayoría utilizan  fácilmente una docena de módulos (el hook displayHeader, perteneciente a la cabecera de la tienda, tiene 33 módulos de forma predeterminada).

...

En la parte superior de la página, un menú desplegable le te permite mostrar sólo el hook en el que esté estés interesado.
De forma predeterminada, la lista sólo muestra los hooks en los cuales puede puedes posicionar módulos. Al marcar la casilla "Mostrar hooks invisibles" se mostrarán todos los hooks, incluso aquellos en donde no puede puedes colocar nada.

La cabecera de la tabla para cada hook muestra el nombre del hook, su nombre técnico (para algunos de ellos, una rápida descripción), y su número de módulos conectados. La tabla muestra los módulos que están conectados a ese hook.

...

  • Haciendo clic en las flechas arriba o abajo. La página se actualizará y mostrará el nuevo orden.
  • Arrastrando y soltando el módulo a la posición deseada:
    1. Coloque Coloca el cursor del ratón entre las flechas de movimiento y el nombre del módulo para que este cambie a un cursor de "movimiento de elementos". Lo reconocerá reconocerás porque el cursor se convierte en una cruz.
    2. Haga Haz clic con el botón derecho del ratón y manténgalo mantenlo presionado, mientras mueve mueves el cursor del ratón a la fila / posición deseada: el módulo pasará a ocupar la fila / posición correspondiente.
    3. Suelte Suelta el botón derecho del ratón: para guardar la nueva posición del módulo.

...

En PrestaShop, "trasplantar" es la acción de insertar un módulo en un hook. Puede Puedes añadir un módulo a más de un hook.

Hay dos cosas que debe debes conocer antes de trasplantar un módulo:

  • Algunos módulos están escritos para sólo poder conectarlos a un conjunto de hooks específicos.
  • Algunos hooks han sido desarrollados para no aceptar ciertos tipos de módulos.

Por lo tanto, sea debes ser consciente de que no siempre puede puedes trasplantar cualquier módulo a cualquier hook.

Info

Asegúrese Asegúrate de desactivar la caché cuando añada añadas un nuevo módulo a un hook, o lo cambie cambies de posición , ya que no podrá podrás ver el cambio producido en el front-office. Puede Puedes hacer esto en la página "Rendimiento", bajo el menú "Parámetros avanzados".

El proceso de trasplante tiene su propia interfaz:

  1. Diríjase Dirígete a la página "Posiciones de los módulos", disponible en el menú "Módulos".
  2. Haga Haz clic en el botón "Insertar un hook" situado en la parte superior derecha. La interfaz de trasplante de módulos, aparecerá en pantalla.
  3. En la lista desplegable "Módulo", seleccione selecciona el módulo que desea deseas trasplantar.
  4. En la lista desplegable "Insertar hook en", seleccione selecciona el lugar donde quiere quieres trasplantar el módulo. Hay muchos hooks disponibles. Puede Puedes cambiar su tu decisión más tarde si es necesario.
  5. En el campo "Excepciones", escriba escribe el nombre del archivo(s) correspondiente(s) a las páginas en las que no desea deseas que el módulo aparezca.
    Puede Puedes realizar una selección múltiple, haciendo clic en los nombres de archivo mientras mantiene mantienes pulsada la tecla Ctrl. Puede Puedes anular la selección de los archivos de la misma manera: Ctrl + clic.
  6. No olvide olvides guardar sus los cambios realizados.

El menú desplegable "Insertar hook en" le te ofrece información sobre dónde puede puedes colocar el módulo.

A pesar de que en la lista desplegable "Insertar hook en" le te ofrece una vista global de los hooks disponibles, no siempre puede puedes ser del todo esclarecedora, sobre cuando se trata de encontrar un punto en particular donde insertar su el módulo. No dude dudes en probar con otro hook, si el resultado de su tu elección no es el que esperabaesperabas.
La lista le te da algunos detalles más: algunos hooks tienen tras su nombre una breve descripción de lo que hacen, por ejemplo " Add fields to the form 'attribute value'" para displayAttributeForm. Examínelos Examínalos a todos con detenimiento con el fin de elegir el hook correcto.

...

Para editar la configuración de un módulo se utiliza la misma interfaz que para el trasplante de módulos. La principal diferencia es que no puede puedes cambiar la configuración de "Módulo" e "Insertar hook en", ya que están deshabilitados, y por tanto aparecerán en color gris. Tan solamente puede puedes cambiar la configuración de las excepciones, que funciona como se ha descrito en la sección anterior "Insertar un módulo a un hook: Trasplantar".
Aunque no pueda puedas editar la configuración de "Módulo" y de "Insertar hook en", estos pueden servirle servirte para que recuerde recuerdes la posición actual del módulo, en caso de que más tarde desee desees volver a posicionarlo en su sitio originario.

Si quiere quieres mover un módulo a otro hook, debe debes utilizar la interfaz de trasplante:

  1. Haga Haz clic en el botón "Insertar un hook" situado en la parte superior derecha. La interfaz de trasplante de módulos, aparecerá en pantalla.
  2. En la lista desplegable "Módulo", seleccione selecciona el módulo que desea deseas mover a otro hook.
  3. En la lista desplegable "Insertar hook en", seleccione selecciona el lugar donde quiere quieres trasplantar el módulo.
  4. En el campo "Excepciones", escriba escribe el nombre del archivo(s) correspondiente(s) a las páginas en las que no desea deseas que el módulo aparezca.
  5. Guarde sus Guarda tus cambios. El hook aparece en la lista.
  6. Diríjase Dirígete al hook en el que ha has trasplantado el módulo: este éste debe aparecer aquí. Cambie Cambia su posición si es necesario.
  7. Diríjase Dirígete al hook donde estaba el módulo originariamente, y haga haz clic en el icono de la papelera para eliminarlo de este hook. Esto evita que el mismo módulo aparezca dos veces.

Siempre debe debes comprobar el front-office de su tu tienda, para asegurarse asegurarte de que el módulo aparece en donde deseadeseas.

Eliminar un módulo de un hook

Hay dos maneras de eliminar un módulo(s) de un hook:

  • Eliminar un sólo módulo: haga haz clic en el icono del bote de basura situada situado a la derecha de la fila del módulo.
  • Eliminar un lote de módulos: seleccione selecciona los módulos marcando las casillas situadas a la derecha de la fila, y luego haga a continuación, haz clic en el botón "Eliminar hooks seleccionados", que encontrará encontrarás tanto en la parte superior como en  en la parte inferior del listado de hooks.

...

Otra forma de posicionar los módulos en la página principal de la tienda es mediante el modo LiveEdit, que incrusta en dicha página de inicio una herramienta que le te permite decidir visualmente dónde colocar los módulos. Puede Puedes acceder a esta este modo desde la página "Posiciones de los módulos", haciendo clic en el botón "Inicie LiveEdit".

...

Al hacer clic en este botón, PrestaShop abre la página inicial principal de la tienda en una nueva ventana / pestaña de su tu navegador, con mostrando el Live Edit script en la parte superior de la pantalla:

  • Todos los bloques de módulos tienen un borde de puntos rojos, que le te permite observar los bloques que puede puedes mover.
  • En la parte superior izquierda de cada bloque, aparece unos iconos específicos, junto con el nombre del bloque, que le te permite encontrar fácilmente los diferentes bloques.
  • La parte superior derecha de cada bloque, muestra dos iconos:
    1. Un icono "mover": haga haz clic sobre éste para empezar a mover el módulo por la página.
    2. Un icono "papelera": haga haz clic sobre éste para eliminar el bloque de la página inicialprincipal.

En la parte superior del modo Live Edit, una barra de herramientas le te presenta dos botones: "Cerrar Live Edit" y "Guardar".

El primer botón guarda los cambios realizados; el segundo botón cancela todos los cambios que haya hayas realizado en las posiciones de sus tus módulos durante esta sesión.

Warning

Una vez que haya hayas eliminado un módulo, si quiere quieres recuperarlo y que este regrese a su vuelva a estar disponible en tu tienda, debe dirigirse debes dirigirte a la página "Posiciones de los módulos" y utilizar el formulario "Trasplantar un módulo".

...

Los módulos no se pueden mover a cualquier lugar: esto depende tanto de los hooks disponibles en el tema, como del código fuente del módulo que puede permitir o no conectarlo a ciertos hooks (como se explicó en la sección anterior). Por lo tanto, sólo puede puedes mover los módulos dentro del contexto para el que fueron diseñados y programados: los módulos diseñados para trabajar en columnas pueden ser posicionados dentro de una columna, así como trasplantarlos de una columna a otra (por ejemplo, de izquierda a derecha), mientras que los módulos comunes (los que está en el centro) sólo pueden ser posicionados dentro de su columna específica.

Para que tenga tengas una ayuda visual sobre donde puede puedes mover un módulo, PrestaShop le te mostrará un bloque vacío con un borde punteado de color verde: si la ubicación es permitida, y un bloque vacío con un borde punteado de color rojo: si no puede puedes moverlo a esa ubicación.

Trasplantar un módulo modificando su código

Info

Esta opción es indicada tan sólo para usuarios expertos: debe debes tener un amplio conocimiento de PHP y HTML antes de realizar cualquier modificación a un módulo.

...

Por ejemplo, el bloque "Búsqueda rápida" (/blocksearch) contiene archivos de plantilla para mostrarse tanto en las columnas como en la cabecera, mientras que el bloque "Monedas" (/blockcurrencies) sólo tiene un archivo de plantilla para hacerlo funcionar en la sección cabecera de la página. Del mismo modo, el bloque "Productos destacados" (/homefeatured) sólo puede ser posicionado en la sección central de la página principal.

Si quiere quieres mostrar los módulos, como el bloque "Monedas" a una posición para la cual no fue programado, debe debes editar los archivos de su plantilla.
  Los módulos más complejos, como el bloque "Productos Destacados", también se pueden modificar ser modificados para aparecer en otras secciones de la página, pero puede ser que tengan que ser reprogramados parcialmente para que su diseño sea funcional en la nueva ubicación.

Para personalizar la posibilidad de trasplantar un módulo, debe dar debes otorgar a este éste la función PHP exacta para el hook de destino. Por ejemplo, el bloque "Moneda" tiene esta función:

...

Para trasplantar el bloque "Monedas" en la columna derecha, por ejemplo, necesita necesitas añadir la función hookRightColumn():

Code Block
function hookRightColumn($params)
  {
  ...
  }

Una vez hecho esto, debe debes escribir el código que mostrará el contenido de la página principal. En el mejor de los casos, esto significa copiar/pegar el contenido de la función hookTop(); en el peor de los casos, necesita necesitas reescribir el contenido de la función hookTop() para que funcione en la nueva ubicación.