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ón | Para qué sirve | Dónde vive | Manifest |
|---|---|---|---|
| Plugin | Añadir funciones: filas en la portada, páginas nuevas, ajustes, tareas programadas, importadores, reproductores, publicidad, cuentas de usuario, comentarios… | content/plugins/<slug>/ | plugin.json |
| Theme | Cambiar el aspecto del sitio público: plantillas, CSS, JavaScript e imágenes de marca. | content/themes/<slug>/ | theme.json |
| Child theme | Retocar 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:
- Arranque del núcleo: configuración, contenedor de servicios y base de datos. Se dispara la acción
booted. - Carga de extensiones: se ejecuta el
plugin.phpde cada plugin activo (recibe$plugin) y después elfunctions.phpdel theme activo (primero el del padre, luego el del hijo). - Rutas: el núcleo registra las suyas, después las de los plugins (
routescon prioridad 5) y se dispararoutes. - Se dispara
init: todo está cargado. Es el sitio para lo que necesite plugins, theme y rutas a la vez. - Middleware (HTTPS, mantenimiento, barra final, idioma, URL antiguas, caché de páginas) y controlador de la ruta.
- En las páginas públicas:
template_data→before_render→template_path→ plantilla del theme (con sus hookshead,body_open,nav_items,before_content,after_content,footer,body_close). - 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 consrcset), 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
fetcha una ruta concache => false, nunca se imprime en el HTML. - URL siempre con
route(),url()olang_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:
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 /adminbin/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 #
php bin/console.php make:plugin hola-mundo --name="Hola Mundo"Crea content/plugins/hola-mundo/ listo para pasar plugin:check:
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.php2. Añade una fila a la portada #
Sustituye el contenido de plugin.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
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 #
php bin/console.php plugin:check hola-mundoActiva 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.json | Referencia del manifest |
| Ajustes, rutas, migraciones, cola, cron, traducciones | Crear plugins |
| Ver todas las acciones y filtros con sus argumentos | Referencia de hooks |
| Consultar helpers, base de datos, repositorios, caché, correo | API PHP |
Escribir plantillas .tpl | Motor de plantillas |
| Diseñar un theme o un child theme | Crear themes |
| Añadir pantallas al panel | Páginas de administración |
| Validar, empaquetar y publicar en la tienda | Validar, empaquetar y publicar |