README

Pacote de perguntas frequentes (FAQs) para o painel administrativo (Admix). Entrega o CRUD completo de FAQs (pergunta, slug, resposta, status e ordenação), com filtros, lixeira e auditoria.

Requisitos

PHP ^8.4
Laravel ^12.0 | ^13.0
Filament ^5.0
agenciafmd/filament-admix v1.x-dev | dev-master

Instalação

Instale o pacote via Composer:

composer require agenciafmd/filament-faqs

Execute as migrações:

php artisan migrate

Populando o banco com dados de testes

Adicione o seeder no database/seeders/DatabaseSeeder.php:

use Agenciafmd\Faqs\Database\Seeders\FaqSeeder;

$this->call([
    FaqSeeder::class,
]);

Ou rode o seeder manualmente:

php artisan db:seed --class="Agenciafmd\Faqs\Database\Seeders\FaqSeeder"

Ativando no painel

O pacote inclui o plugin FaqsPlugin, que registra o FaqResource. Adicione-o na config do Admix config/filament-admix.php:

use Agenciafmd\Faqs\FaqsPlugin;

return [
    'plugins' => [
        FaqsPlugin::class,
    ],
];

Após isso, o menu Perguntas frequentes aparecerá no painel, com as páginas de Listar, Criar e Editar.

Configuração

Arquivo: config/filament-faqs.php

return [
    'name' => 'FAQs',
    'navigation_group' => null,
    'navigation_sort' => 11,
];

Chave	Padrão	Descrição
`name`	`FAQs`	Nome do pacote.
`navigation_group`	`null`	Grupo do menu em que o Resource aparece.
`navigation_sort`	`11`	Posição do item no menu.

O pacote não publica o arquivo de config. Para sobrescrever, crie config/filament-faqs.php no projeto; ele é mesclado com o do pacote.

FAQs excluídas há mais de 30 dias são removidas definitivamente pelo model:prune, agendado diariamente às 03h (os minutos vêm de filament-admix.schedule.minutes).

Permissões

O FaqResource entra automaticamente no controle de acesso por Grupos do Admix, com as permissões de visualizar, criar, editar, excluir, restaurar e auditoria. Usuário sem grupo é administrador e tem acesso total. Não há permissões extras.

Auditoria

O FaqResource inclui o relation manager Tapp\FilamentAuditing\RelationManagers\AuditsRelationManager, exibindo o histórico de auditorias do registro (o tapp/filament-auditing é instalado pelo filament-admix).

Licença

Este pacote é software livre e está disponível nos termos da licença MIT.

agenciafmd / filament-faqs

Package info

Security

Statistics