misaf/vendra-faq

Frequently Asked Questions management system with categorization

v1.7.1 2026-07-22 21:53 UTC

Requires

• php: ^8.3
• awcodes/filament-badgeable-column: ^4.0
• lara-zeus/spatie-translatable: ^2.0.1
• misaf/filament-jalali: ^5.1.4
• misaf/vendra-multimedia: v1.7.1
• misaf/vendra-support: v1.7.1
• spatie/eloquent-sortable: ^5.0.1
• spatie/laravel-package-tools: ^1.93.1
• spatie/laravel-sluggable: ^4.0.2

Requires (Dev)

• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.10.0
• laravel/boost: ^2.4.12
• laravel/pint: ^1.29.3
• misaf/vendra-testing: v1.7.1
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.9.4
• orchestra/testbench: ^11.1
• pestphp/pest: ^4.7.5
• pestphp/pest-plugin-arch: ^4.0.2
• pestphp/pest-plugin-laravel: ^4.1
• pestphp/pest-plugin-profanity: ^4.2.1
• pestphp/pest-plugin-type-coverage: ^4.0.4
• phpstan/extension-installer: ^1.4.3

Suggests

• misaf/vendra-tagger: Install this in the host application to assign typed tags to FAQs.

MIT

• Ehsan Mahmoodi

• FAQ
• laravel
• filamentphp
• vendra
• misaf

Published on Packagist.org on 2026-07-23 21:51 UTC

README

Tenant-aware FAQ management for Vendra applications.

Features

• FAQ categories
• FAQs with translatable content
• Filament resources on the admin panel

Requirements

• PHP 8.3+
• Laravel 13
• Filament 5
• Livewire 4
• Pest 4
• Tailwind CSS 4
• misaf/vendra-multimedia
• misaf/vendra-support

Optional:

• misaf/vendra-tagger — enables assigning faq-typed tags through the shared Support resolver

Installation

composer require misaf/vendra-faq
php artisan vendor:publish --tag=vendra-faq-migrations
php artisan migrate

Optional translations publish:

php artisan vendor:publish --tag=vendra-faq-translations

The service provider and Filament plugin are auto-registered.

Usage

Create an FAQ category:

use Misaf\VendraFaq\Models\FaqCategory;

$category = FaqCategory::query()->create([
    'name' => ['en' => 'General'],
    'description' => ['en' => 'General questions'],
    'slug' => ['en' => 'general'],
    'position' => 1,
    'active' => true,
]);

Create an FAQ:

use Misaf\VendraFaq\Models\Faq;

Faq::query()->create([
    'faq_category_id' => $category->id,
    'name' => ['en' => 'How do I create an account?'],
    'description' => ['en' => 'Use the register page and verify your email.'],
    'slug' => ['en' => 'how-do-i-create-an-account'],
    'position' => 1,
    'active' => true,
]);

Load FAQs with their category:

$faqs = Faq::query()
    ->with('faqCategory')
    ->where('active', true)
    ->get();

When Tagger is installed, FAQ forms and tables expose tags automatically. Create tags with the reserved faq type:

use Misaf\VendraTagger\Models\Tagger;

Tagger::findOrCreate('Account', type: 'faq', locale: 'en');

FAQ imports neither Vendra Tagger nor Spatie Tags.

Filament

Resources are available in the shared Content cluster on the admin panel:

• FAQ Categories
• FAQs

Testing

Run the package checks from the package directory:

composer test
composer analyse

License

MIT. See LICENSE.