Skip to content
ca es en

← Módulos y desarrollo

Crear tu primer módulo

De carpeta vacía a módulo instalable que engancha a un hook y muestra algo en el front.

5 slides 5 min de lectura

  1. PrestaShop · Mòduls

    Tu primer módulo

    De carpeta vacía a algo visible en el front.

    PrestaShop · Módulos y desarrollo arlaf.dev

  2. El módulo mínimo que hace algo

    class HelloBlock extends Module
{
    public function __construct()
    {
        $this->name = 'helloblock';
        $this->version = '1.0.0';
        parent::__construct();
        $this->displayName = $this->l('Hello block');
    }

    public function install()
    {
        return parent::install()
            && $this->registerHook('displayHome');
    }

    public function hookDisplayHome()
    {
        return $this->display(__FILE__, 'views/templates/hook/home.tpl');
    }
}
    PrestaShop · Módulos y desarrollo arlaf.dev

  3. Instalarlo

    Sube la carpeta a modules/, ve al back-office, búscalo en la lista y pulsa Instalar. PrestaShop llama a install() y lo registra en el hook displayHome.

    PrestaShop · Módulos y desarrollo arlaf.dev

  4. La plantilla

    El hookDisplayHome devuelve una plantilla .tpl de Smarty. Es HTML con variables; aquí pones lo que quieres mostrar en la home.

    PrestaShop · Módulos y desarrollo arlaf.dev

  5. Darle configuración

    Implementando getContent() y un formulario, el módulo gana una pantalla de configuración en el back-office. Así el cliente puede cambiar textos sin tocar código.

    PrestaShop · Módulos y desarrollo arlaf.dev
Leer la nota completa

La millor manera d’entendre els mòduls és fer-ne un que faci una cosa visible. La fita: un bloc que aparegui a la home.

El mòdul mínim que fa alguna cosa

Amb la classe principal, un install() que registri el hook displayHome i un mètode hookDisplayHome() que retorni una plantilla, ja tens un mòdul que pinta HTML a la portada. És literalment això: registrar-se a un hook i respondre quan PrestaShop el crida.

Instal·lar-lo

Puja la carpeta a modules/, entra al back-office, busca el mòdul a la llista i prem Instal·lar. En aquell moment PrestaShop executa el teu install(), que crida parent::install() i registra el hook. Si tot va bé, recarrega la home i hi veuràs el bloc.

La plantilla

hookDisplayHome() retorna un .tpl de Smarty: HTML amb variables. Aquí decideixes què mostres. Mantén la lògica a PHP i deixa el .tpl només per pintar.

El següent pas: configuració

Implementant getContent() i un formulari (amb HelperForm), el mòdul guanya una pantalla de configuració al back-office. És el que converteix un mòdul rígid en una eina que el client pot ajustar sol —canviar un títol, una imatge, un enllaç— sense trucar-te. Aquest petit esforç és el que fa que un mòdul sigui realment útil en un encàrrec real.