Skip to content
ca es en

← Módulos y desarrollo

Anatomía de un módulo

Los archivos mínimos de un módulo, la clase principal y el ciclo de vida (install/uninstall).

5 slides 5 min de lectura

  1. PrestaShop · Mòduls

    Anatomía de un módulo

    La unidad con la que se extiende PrestaShop.

    PrestaShop · Módulos y desarrollo arlaf.dev

  2. Los archivos mínimos

    Un módulo es una carpeta dentro de modules/ con poco obligatorio.

    • nombredelmodulo/ — la carpeta, con el mismo nombre que la clase.
    • nombredelmodulo.php — la clase principal que extiende Module.
    • logo.png — el icono del back-office.
    PrestaShop · Módulos y desarrollo arlaf.dev

  3. La clase principal

    class MyModule extends Module
{
    public function __construct()
    {
        $this->name = 'mymodule';
        $this->version = '1.0.0';
        $this->author = 'Arnau';
        parent::__construct();
        $this->displayName = $this->l('El meu mòdul');
    }
}
    PrestaShop · Módulos y desarrollo arlaf.dev

  4. El ciclo de vida

    install() corre al instalar (crear tablas, registrar hooks, fijar config) y uninstall() lo deshace. Dejarlo limpio es parte de hacer bien un módulo.

    PrestaShop · Módulos y desarrollo arlaf.dev

  5. Carpetas habituales

    A medida que crece, el módulo gana estructura.

    • controllers/ — controladores de front y admin.
    • views/ — plantillas y assets del módulo.
    • classes/ — tus ObjectModel.
    • translations/ — las traducciones.
    PrestaShop · Módulos y desarrollo arlaf.dev
Leer la nota completa

Un mòdul és la unitat amb què s’estén PrestaShop sense tocar el nucli. Abans d’escriure’n cap, val la pena saber de què es compon.

El mínim imprescindible

Un mòdul viu en una carpeta dins de modules/ amb el mateix nom que la seva classe. Estrictament només necessita dues coses: el fitxer nomdelmodul.php amb la classe principal i un logo.png. La resta s’afegeix quan cal.

La classe principal

Tot mòdul defineix una classe que estén Module. Al constructor s’hi fixen les metadades (nom, versió, autor, nom visible) i es crida parent::__construct(). Aquesta classe és el punt d’entrada de tot el que el mòdul fa.

install() i uninstall(): el cicle de vida

Quan instal·les el mòdul des del back-office, PrestaShop crida install(): aquí crees les taules que necessitis, registres els hooks i fixes la configuració per defecte. uninstall() ha de desfer-ho tot. Un mòdul que s’instal·la net però deixa brossa en desinstal·lar-se és un mòdul mal acabat.

Quan creix

A mesura que el mòdul fa més coses, guanya carpetes previsibles: controllers/ (front i admin), views/ (plantilles i assets), classes/ (els teus ObjectModel) i translations/. Conèixer aquest esquelet fa que llegir mòduls d’altres —i el teu d’aquí sis mesos— sigui molt més ràpid.