Saltar al contenido
MovieMaster

Desarrolladores: plugins y themes

Introducción para desarrolladores: tu primer plugin

5 min de lectura 7 apartados

En esta página

MovieMaster se amplía con plugins y themes escritos en PHP 8.2, sin Composer ni frameworks. Esta guía te explica cómo funciona por dentro, monta un sitio local y crea tu primer plugin en cinco minutos.

Qué puedes construir #

ExtensiónPara qué sirveDónde viveManifest
PluginAñadir funciones: filas en la portada, páginas nuevas, ajustes, tareas programadas, importadores, reproductores, publicidad, cuentas de usuario, comentarios…content/plugins/<slug>/plugin.json
ThemeCambiar el aspecto del sitio público: plantillas, CSS, JavaScript e imágenes de marca.content/themes/<slug>/theme.json
Child themeRetocar un theme existente (normalmente Cinema, slug default) cambiando solo los archivos que necesitas.content/themes/<slug>/ con "parent"theme.json

Un sitio puede tener muchos plugins activos y un solo theme activo. Los plugins y los themes se comunican mediante hooks (acciones y filtros) y contratos con nombre (player@1, mylist@1…), nunca conociendo las clases del otro.

Cómo arranca una petición #

Saber el orden te dice dónde engancharte:

  1. Arranque del núcleo: configuración, contenedor de servicios y base de datos. Se dispara la acción booted.
  2. Carga de extensiones: se ejecuta el plugin.php de cada plugin activo (recibe $plugin) y después el functions.php del theme activo (primero el del padre, luego el del hijo).
  3. Rutas: el núcleo registra las suyas, después las de los plugins (routes con prioridad 5) y se dispara routes.
  4. Se dispara init: todo está cargado. Es el sitio para lo que necesite plugins, theme y rutas a la vez.
  5. Middleware (HTTPS, mantenimiento, barra final, idioma, URL antiguas, caché de páginas) y controlador de la ruta.
  6. En las páginas públicas: template_data → before_render → template_path → plantilla del theme (con sus hooks head, body_open, nav_items, before_content, after_content, footer, body_close).
  7. La respuesta sale (y se guarda en la caché estática si es cacheable) y se dispara terminate.

En consola (php bin/console.php …) y en el cron se cargan igual los plugins, así que tus hooks cron, cron_hourly, cron_daily y migrate funcionan sin hacer nada más.

Las reglas que no se negocian #

MovieMaster saca 100 en las cuatro métricas de Lighthouse en móvil y escritorio. Toda extensión debe mantenerlo:

  • CSS solo en línea y con presupuesto: 20 480 bytes por página (32 768 como máximo para un theme con su propio critical.css). Nada de <link rel="stylesheet"> ni @import.
  • JavaScript inicial ≤ 5 120 bytes. Lo demás se carga bajo demanda con import().
  • Sin fuentes web ni scripts o recursos de terceros en la carga inicial.
  • Imágenes siempre con img() (AVIF → WebP → JPEG con srcset), nunca <img src> escrito a mano.
  • Reproductores y tráileres por facade: el iframe se crea al hacer clic.
  • Páginas cacheables: lo que dependa de quién mira (sesión, listas, permisos) se pide con fetch a una ruta con cache => false, nunca se imprime en el HTML.
  • URL siempre con route(), url() o lang_url(): el dueño del sitio puede cambiar las palabras de las URL (/movie/ → /pelicula/) en Admin → SEO.
  • Nunca borres contenido con SQL a mano: usa los repositorios para que se escriban los 410, se purgue la caché y se actualicen los sitemaps.

Monta un sitio local #

Necesitas PHP 8.2 o superior con pdo (pdo_mysql o pdo_sqlite), mbstring, json, fileinfo, sodium y gd o imagick; zip, curl e intl son recomendables. Para compilar el CSS de los themes, Node. Desde la carpeta del CMS:

bash
composer install && npm install
php bin/console.php install --url=http://127.0.0.1:8090 --name="Dev" --admin=admin \
  [email protected] --password='Cambia-esto-2026!' --lang=es --langs=es,en
php bin/console.php demo:seed            # catálogo de ficción con imágenes, sin llamadas externas
php bin/dev-server.php 127.0.0.1:8090    # sitio en / y panel en /admin

bin/dev-server.php envuelve php -S con un router que imita las reglas de Apache y nginx (caché de páginas, carpetas protegidas). Los errores van a content/logs/app.log. Para ver las colas sin cron, ejecuta php bin/console.php queue:work en otra terminal.

Tu primer plugin en cinco minutos #

1. Genera el esqueleto #

bash
php bin/console.php make:plugin hola-mundo --name="Hola Mundo"

Crea content/plugins/hola-mundo/ listo para pasar plugin:check:

text
content/plugins/hola-mundo/
  plugin.json      manifest spec 1
  plugin.php       punto de entrada: recibe $plugin y solo orquesta
  Lifecycle.php    instalar / actualizar / desinstalar
  src/Plugin.php   tus clases (namespace HolaMundo\)
  lang/es.php      textos traducibles: __('hola-mundo::clave')
  lang/en.php

2. Añade una fila a la portada #

Sustituye el contenido de plugin.php:

php
<?php
/** @var MovieMaster\Extensions\PluginContext $plugin */
declare(strict_types=1);

use HolaMundo\Fila;

$plugin->lang(__DIR__ . '/lang');

$plugin->setting('titulo', [
    'type' => 'text',
    'label' => __('hola-mundo::ajuste_titulo'),
    'default' => 'Recomendadas',
]);

add_filter('home_rails', fn(array $rails) => Fila::add($rails, $plugin));

Y crea src/Fila.php:

php
<?php
declare(strict_types=1);

namespace HolaMundo;

use MovieMaster\Content\Repositories\TitleRepository;
use MovieMaster\Extensions\PluginContext;

final class Fila
{
    public static function add(array $rails, PluginContext $plugin): array
    {
        $items = app(TitleRepository::class)->list(['order' => 'rating', 'type' => 'movie'], 12);

        $rails['hola_mundo'] = [
            'title' => (string) $plugin->get('titulo'),
            'url' => url('/movies') . '?sort=rating',
            'items' => $items,          // una fila sin items no se pinta
            'style' => 'cards',         // cards | top10 | episodes
        ];

        return $rails;
    }
}

Añade la clave a lang/es.php ('ajuste_titulo' => 'Título de la fila') y a lang/en.php.

3. Valida, activa y prueba #

bash
php bin/console.php plugin:check hola-mundo

Activa el plugin en Admin → Plugins. La fila aparece al final de la portada y su ajuste en Ajustes, en el apartado de plugins del índice lateral («Hola Mundo»). No hace falta CSS ni JavaScript: la fila usa el marcado del theme, así que no gasta presupuesto.

Modo seguro #

Al activar un plugin, MovieMaster comprueba sus requisitos (requires) y lo carga en prueba. Si un plugin activo lanza una excepción al arrancar, se desactiva solo y el panel muestra un aviso con el error: un plugin roto nunca deja el sitio en blanco. Revisa content/logs/app.log para ver el detalle.

Dónde seguir #

Quiero…Guía
Rellenar bien plugin.json o theme.jsonReferencia del manifest
Ajustes, rutas, migraciones, cola, cron, traduccionesCrear plugins
Ver todas las acciones y filtros con sus argumentosReferencia de hooks
Consultar helpers, base de datos, repositorios, caché, correoAPI PHP
Escribir plantillas .tplMotor de plantillas
Diseñar un theme o un child themeCrear themes
Añadir pantallas al panelPáginas de administración
Validar, empaquetar y publicar en la tiendaValidar, empaquetar y publicar

¿Te quedó alguna duda?

Escríbenos y te ayudamos con tu caso.

Hablar con nosotros
¿Hablamos?