Hooks de la página de confirmación del pedido en Prestashop 1.7

En este TIP de Prestashop, comentaremos los hooks/posiciones disponibles en la página de confirmación del pedido en Prestashop 1.7

Si accedemos al fichero: “/themes/classic/templates/checkout/order-confirmation.tpl” vemos disponibles los siguientes hooks (en la página de confirmación del pedido)

  • displayOrderConfirmation

    Hook -> displayOrderConfirmation

  • displayPaymentReturn

    displayPaymentReturn

  • displayOrderConfirmation1

    displayOrderConfirmation1

  • displayOrderConfirmation2 (vemos que tenemos añadido el módulo de productos destacados)

    displayConfirmation2

  • Todos los hooks

    Hooks página de confirmación del pedido

Sigue leyendo

Banner de la página principal en la cabecera en Prestashop 1.7

En este pequeño documento, vamos a cambiar de localización del módulo de banner que se muestra en la página principal para colocarlo en la cabecera de la tienda.

Banner principal en Prestashop 1.7

La idea es dejar ese banner en la cabecera de la tienda.

Banner cabecera

Vemos que en el fichero: /themes/classic/templates/_partials/header.tpl (Versión 1.7.2.4 de Prestashop) disponemos de la siguiente línea de código:

{block name='header_banner'}
<div class="header-banner">
{hook h='displayBanner'}
</div>
{/block}

header.tpl

Y la vamos a dejar del siguiente modo (hemos encerrado la impresión del hook -> displayBanner dentro de un div con clase container):

{block name='header_banner'}
<div class="header-banner">
<div class="container">
{hook h='displayBanner'}
</div>
</div>
{/block}

header.tpl

El siguiente paso es ir a la pestaña Diseño -> posiciones de los módulos, pulsamos en “Insertar un módulo

Insertar módulo hook

Y vemos que no encontramos el hook -> displayBanner

No aparece hook -> displayBanner

Vamos a crear nosotros el hook, mediante el módulo gratuito de Vekia: Crear Hook mediante el módulo de Vekia

Una vez hayamos creado el hook:

Creando hook

Volvemos a la pestaña Diseño -> Posiciones de los módulos y ahora si podremos anclar el módulo del banner en el hook -> displayBanner

Anclando módulo en el displayBanner

Finalmente, lo veremos del siguiente modo:

Logo cabecera

Vemos que queda demasiado ajustado, podemos meterle un relleno, añadiendo, por ejemplo, en el fichero:

/themes/classic/assets/css/custom.css

La siguiente instrucción:

#header .header-banner {
padding: 1em;
}

Sigue leyendo

Creación de un módulo de pago en Prestashop 1.7

Hace tiempo que no me paso por el blog francés de h-hennes, y a que resaltar que últimamente tiene unos artículos interesantes, donde traduciré parte de unos de los artículos que podéis ver de forma completa en su mismo blog y que me ha parecido que os puede interesar.

En este pequeño TIP rápido que es solo recomendado para aquellas personas que hayan tocado el desarrollo de módulos orientados a métodos de pago en versiones anteriores de Prestashop, comentare algunos aspectos básicos que se introducen como novedad en Prestashop 1.7 respecto a Prestashop 1.6.

A los módulos que gestionan los sistemas de pago, a que indicarles que usan la clase: PaymentOption (antiguamente esto no se hacía)

Es decir, la primera línea de código de la clase de un módulo que gestiona un sistema de pago es:

use PrestaShop\PrestaShop\Core\Payment\PaymentOption;
Indicar que usamos la clase PaymentOption

Indicar que usamos la clase PaymentOption

Por otro lado, la clase del módulo sigue heredando de PaymentModule (esto no ha cambiado)

 Clase del módulo hereda de PaymentModule

Clase del módulo hereda de PaymentModule

¿En que hooks queda instalado y registrado un módulo que gestiona un método de pago (transferencia bancaria, cheque, etc..) ?

Registrando módulo en hooks

Habitualmente queda registrado en los siguientes hooks:

  • paymentOptions -> Este hook si podemos decir que es nuevo, y es el que vemos cuando estamos viendo los métodos de pago en el proceso de pedido (a la hora de seleccionarlos)

    Listado de los métodos de pago en Prestashop 1.7

  • paymentReturn -> Este hook no tiene sorpresa porque es el mismo que se usaba en versiones anteriores para devolver la confirmación del pedido.

Vayamos a ver el interior de la función del hook -> paymentOptions que tiene por ejemplo la clase principal del módulo de Cheque (modules/ps_checkpayment/ps_checkpayment.php) que lleva Prestashop.

hookPaymentOptions

Dentro de la función de este hook, comento la parte más importante (obviando el resto que ya conocéis)

Aquí estamos creando un objeto de la Clase PaymentOption.

$newOption = new PaymentOption();

A través de ese objeto vamos a poder definir dentro del listado de métodos de pago, respecto al método actual los siguientes datos:

  • setCallToActionText : Define el texto/título público del método de pago / Obligatorio

    Texto del método de pago

    Mostrando el texto del método de pago

  • setAdditionalInformation : Define información adicional del método de pago  / Opcional

    Código información adicional del método de pago

    En el ejemplo del método de pago, lo que hacemos con “setAdditionalInformation” es integrar el fichero TPL payment_infos.tpl. (Fijaros al ampliar el pantallazo)

    Información adicional del método de pago en el listado de métodos de pago de Prestashop 1.7

  • setLogo : Definir un logo para el método de pago / Opcional

    Código logo método de pago en el listado de métodos

    Logo método de pago

  • setAction : Definimos el controlador que se encarga de la validación de la confirmación del pago (No visible ) / Es obligatorio si hemos usado el método setForm

    Controlador validación

    Estamos haciendo referencia en esta ocasión al controlador Validation.php del módulo que lo podemos encontrar en: ps_checkpayment/controllers/front/validation.php

  • setInputs : Permite añadir campos de formulario. Se usa más para campos de tipo oculto (hidden) que para que el cliente introduzca datos / OpcionalPor ejemplo, almacenamos en una variable “2 campos”
    $inputs = [
    [
    'name' => 'campo1',
    'type' => 'hidden',
    'value' => '100'
    ],
    [
    'name' => 'campo2',
    'type' => 'hidden',
    'value' => $this->context->customer->id,
    ],
    ];
    

    En el campo 1 guardamos el valor 100 y en el campo2 guardamos el ID del cliente.

    Ahora pasamos esos campos dentro de “setInputs

    Campos

  • setModuleName : Nombre del módulo (interno) / Obligatorio

    Nombre interno del módulo

  • setForm : Permite generar un formulario especifico para el módulo, si se utiliza, las funciones setInputs y setAction no tienen efecto / Opcional

    Formulario

    Dentro del método/función setForm hemos integrado el contenido del TPL: modules/ps_checkpayment/views/templates/hook/formularioprueba.tpl donde hemos preparado el formulario.

    Formulario dentro de método de pago

  • setBinary :  Solo es necesario si se utiliza una ejecución binaria. Es necesario también que el módulo este también anclado en el hook -> displayPaymentByBinaries

Sigue leyendo

Cambiar pestaña por defecto de la zona de módulos en Prestashop 1.7

En su momento estuvimos comentado a grosso modo las novedades y opciones básicas de la gestión de módulos desde el panel en Prestashop 1.7

Recordamos que cuando accedemos a la gestión de módulos en Prestashop 1.7 desde la pestaña Módulos -> Módulos y servicios.

Inicialmente accedemos por defecto a la pestaña “Selección“.

Pestaña “Selección” por defecto al acceder a la gestión de módulos en Prestashop 1.7

La idea es acceder por defecto a la opción/pestaña  “Módulos Instalados” cuando vayamos acceder a  la gestión de módulos desde Módulos -> Módulos y servicios.

Pestaña módulos instalados por defecto

Tenemos una solución proporcionada por el usuario Zax37 de la Comunidad de Prestashop en forma de módulo.

La instalación del módulo no tiene complicaciones, se hace desde la pestaña módulos -> módulos y servicios

El módulo no permite ninguna configuración adicional.

Módulo instalado

Una vez que hemos instalado el módulo, siempre que accedamos a la pestaña “Módulos -> Módulos y servicios” veremos seleccionada por defecto la opción “Módulos Instalados“.

Pestaña módulos instalados

Al meternos un poquito en el módulo, por ejemplo, en el fichero: adminmoduleslinkfix.php (clase principal del módulo en cuestión) veremos (entre otras cuestiones) dentro de la función install del módulo la siguiente instrucción:

$this->replaceString(__DIR__."\..\..\classes\Link.php", "admin_module_catalog", "admin_module_manage");

Esta instrucción hace que en clase “Link.php” (/classes/Link.php) donde aparece “admin_module_manage” se cambie por “admin_module_catalog

Si nos metemos dentro de /classes/Link.php, dentro de  “case ‘AdminModulesSf’“: y observamos la siguiente línea:

Código clase Link

Fijémonos en el siguiente código:

case 'AdminModulesSf':
$sfRoute = array_key_exists('route', $sfRouteParams) ? $sfRouteParams['route'] : 'admin_module_catalog';

El módulo simplemente cambia “admin_module_catalog” por “admin_module_manage” para acceder por defecto a la opción de “Módulos instalados” cuando pinchemos en el panel de administración de tu tienda en la pestaña módulos -> módulos y servicios.

Observando fríamente el funcionamiento del módulo, sería conveniente hacer un override de la clase depende hacer un buscar y reemplazar de un dato en la clase original.

Sigue leyendo

Eliminar el título de la categoría en Prestashop 1.7

Es una chorrada, pero me lo pregunto un compañero por telegram y como es sencillo, además de que existen diferencias en las rutas de ficheros y en las líneas de código en esta versión de Prestashop respecto a versiones anteriores, lo explicare de forma simple.

Muestro una pequeña captura, para que nos situemos.

Eliminar título de la categoría en Prestashop 1.7

Para eliminar el título de la categoría cuando estamos viendo la categoría en Prestashop 1.7  y suponiendo que estemos trabajando con la plantilla por defecto, una de las posibles opciones es editar el fichero:

/themes/classic/templates/catalog/listing/category.tpl

Tener en cuenta, que si vuestra plantilla no es la que lleva Prestashop por defecto, no estaremos hablando de la carpeta “classic“, sino de la carpeta de vuestra plantilla.

Fichero category.tpl

Dentro de: Sigue leyendo