Crear nuevos campos en el formulario de registro

Hola amigos, hoy vamos a ver cómo crear nuevos campos en el formulario de registro con la plataforma Prestashop versión 1.7.2.x

Para empezar diremos que hay algunos campos definidos en la plataforma los cuales podemos hacer obligatorios o no. Para ello debemos entrar en nuestro panel de administración e ir a Clientes -> Direciones.

Pero como esta entrada trata acerca de creación de nuevos campos, vamos a obviar el paso anterior y vamos a ir directamente a lo que toca 🙂

Primeros pasos creando un nuevo campo en el formulario de registro.

Lo primero que tenemos que hacer es ir abrir el siguiente script con nuestro editor de código favorito classes/form/CustomerFormatter.php

Si vamos a la función public function getFormat() podemos apreciar en este script que se están declarando todos los campos que podemos ver en el formulario de registro.

Ya que no es recomendable editar los scripts por defecto de Prestashop, vamos a crear un Override.

Recordemos que si no creamos Overrides y por ejemplo estamos trabajando sobre un módulo, al recibir una actualización de este, lo más probable es que perdamos los cambios realizados.

Trabajando sobre el Override classes/form/CustomerFormatter.php

Vamos al directorio override/classes/ y creamos un nuevo directorio form/ y también un nuevo script llamado como el original CustomerFormater.php. Desde este momento este script prevalecerá sobre el original.

Copiamos todo el código del CustomerFormater.php original y ahora sí, vamos a crear nuestro campo DNI.
Este es el trozo de código que debemos insertar justo en el método getFormat().

Tengamos en cuenta que dependiendo de dónde coloquemos este trozo de código el nuevo campo aparecerá más arriba o abajo en nuestro formulario.

$format['dni'] = (new FormField)
    ->setName('dni')
    ->setLabel(
        $this->translator->trans(
            'Dni', [], 'Shop.Forms.Labels'
        )
    )
    ->setRequired(true)
    ->addAvailableValue(
        'placeholder',
        '00000000A'
    )
    ->setMaxLength(9)
    ->addAvailableValue(
        'comment',
        '(Ejemplo: 00000000A)'
    )
;

Nosotros vamos a colocarlo justo debajo del campo Apellido quedando en nuestro código fuente así.

$format['lastname'] = (new FormField)
    ->setName('lastname')
    ->setLabel(
        $this->translator->trans(
            'Last name', [], 'Shop.Forms.Labels'
        )
    )
    ->setRequired(true)
;

$format['dni'] = (new FormField)
    ->setName('dni')
    ->setLabel(
        $this->translator->trans(
            'Dni', [], 'Shop.Forms.Labels'
        )
    )
    ->setRequired(true)
    ->addAvailableValue(
        'placeholder',
        '00000000A'
    )
    ->addAvailableValue(
        'comment',
        '(Ejemplo: 0000000A)'
    )
;

Recordemos que cada vez que creamos un nuevo Override debemos borrar la caché desde nuestro back-office para poder apreciar los cambios.

Explicando los valores del nuevo campo añadido en nuestro formulario de registro.

setName(‘dni’) :: valor name en nuestro input.
setLabel() :: Etiqueta.
setRequired(true) :: Campo obligatorio.
addAvailableValue() :: Añade otros valores como placeholder, comentario sobre un campo, etc.

Y esto es todo en nuestra entrada de hoy.
Puedes continuar con la entrada de validación de campos pulsando en este enlace: https://luisjordan.net/prestashop/manual-de-prestashop-1-7-comprobar-el-valor-de-los-campos-del-formulario-de-registro/

Versiones utilizadas, tiempo y dificultad de desarrollo:

Plataforma: Prestashop 1.7.2