Lo mismo pasa con Filament. Por defecto, usa el nombre del modelo («Productos»), pero quizás tú quieres que diga «Artículos», «Mercancía» o lo que sea. Ahí entra $modelLabel: es la etiqueta que le pones a tu carpeta para que todo el mundo entienda qué hay adentro.
¿Qué ve el usuario sin personalizar?Si no haces nada, Filament usa el nombre del modelo. Como llamamos nuestro modelo
Producto, el menú dirá «Productos». Pero mira, aquí está el truco: tú puedes cambiar eso.
📊 Así se ve el menú ahora (sin personalizar):
👆 Dice «Productos» porque así se llama el modelo
Cambiar la etiqueta del menúVamos a decirle a Filament que queremos que diga «Artículos» en vez de «Productos». Es como cambiar la etiqueta de la carpeta.
📝 ESTE ES EL CÓDIGO QUE VAMOS A APRENDER:
📍 Archivo: app/Filament/Resources/Productos/ProductoResource.php
protected static ?string $modelLabel = 'artículo';
protected static ?string $pluralModelLabel = 'artículos';🔍 ¿Por qué dos líneas? Vamos a entender:
protected static ?string $modelLabel = 'artículo';
→ Esta es para el singular. La usa Filament cuando habla de UN solo producto. Por ejemplo, en el botón que dice «Crear artículo» o «Editar artículo».
protected static ?string $pluralModelLabel = 'artículos';
→ Esta es para el plural. La usa Filament cuando habla de TODOS los productos. Por ejemplo, en el menú lateral donde dice «Artículos».
📊 Así se verá el menú después del cambio:
✅ Ahora dice «Artículos» como queríamos
¿Dónde exactamente aparecen estos nombres?Fíjate bien, porque estos textos aparecen en varios lugares:
- Menú lateral: «Artículos» (el plural)
- Título de la página: «Artículos» cuando ves la lista
- Botón de crear: «Crear artículo» (el singular)
- Título al editar: «Editar artículo» (el singular)
- Mensajes: «Artículo guardado exitosamente»
Un truco avanzado (opcional)Si algún día necesitas que el nombre cambie según el usuario (por ejemplo, que los administradores vean «Productos administrativos» y los demás vean «Artículos»), puedes usar métodos en vez de propiedades. Pero eso ya es más avanzado, así que guárdalo para cuando lo necesites.
📁 ¿Quieres ver el código completo del archivo? (opcional)
Esto es solo para que veas dónde va tu código:
📍 Archivo: app/Filament/Resources/Productos/ProductoResource.php
<?php
namespace App\Filament\Resources\Productos;
use App\Models\Producto;
use Filament\Resources\Resource;
class ProductoResource extends Resource
{
protected static ?string $model = Producto::class;
// 👇 ESTAS SON LAS LÍNEAS QUE AGREGAMOS
protected static ?string $modelLabel = 'artículo';
protected static ?string $pluralModelLabel = 'artículos';
// ... resto del código
}¡Momento de la verdad!Guarda los cambios, recarga tu panel de administración y fíjate en el menú lateral. ¿Ahora dice «Artículos» en vez de «Productos»? ¡Eso significa que lo lograste!
💡 Si entras a la sección, también verás que el botón dice «Crear artículo» en vez de «Crear producto». Son pequeños detalles, pero hacen que tu aplicación se sienta más tuya.
🎉 ¿Qué aprendimos hoy?
$modelLabeles la etiqueta en singular (para «Crear artículo», «Editar artículo»)$pluralModelLabeles la etiqueta en plural (para el menú que dice «Artículos»)- Con solo estas dos líneas, personalizas todo el lenguaje de tu panel
- Tu aplicación se siente más profesional cuando usa los términos correctos para tu negocio
En la siguiente lección veremos cómo decirle a Filament cuál campo usar como «nombre principal» de cada producto. ¡Nos vemos allí! 🚀