Skip to content
ca es en

← Mòduls i desenvolupament

Crear el teu primer mòdul

De carpeta buida a mòdul instal·lable que enganxa a un hook i mostra alguna cosa al front.

5 slides 5 min de lectura

  1. PrestaShop · Mòduls

    El teu primer mòdul

    De carpeta buida a alguna cosa visible al front.

    PrestaShop · Mòduls i desenvolupament arlaf.dev

  2. El mòdul mínim que fa 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òduls i desenvolupament arlaf.dev

  3. Instal·lar-lo

    Puja la carpeta a modules/, ves al back-office, busca'l a la llista i prem Instal·lar. PrestaShop crida install() i el registra al hook displayHome.

    PrestaShop · Mòduls i desenvolupament arlaf.dev

  4. La plantilla

    El hookDisplayHome retorna una plantilla .tpl de Smarty. És HTML amb variables; aquí poses el que vols mostrar a la home.

    PrestaShop · Mòduls i desenvolupament arlaf.dev

  5. Donar-li configuració

    Implementant getContent() i un formulari, el mòdul guanya una pantalla de configuració al back-office. Així el client pot canviar textos sense tocar codi.

    PrestaShop · Mòduls i desenvolupament arlaf.dev
Llegir 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.