Laravel Testimonial

A Laravel package for managing testimonials, with translatable content powered by spatie/laravel-translatable.

Features

• Testimonials — Name, role, company, avatar, rating (1-5), order, and active flag
• Translatable Content — Testimonial content is translatable via spatie/laravel-translatable, with automatic fallback to the app's fallback locale
• Ordering & Activation — ordered() and active() query scopes
• Configurable Table Name — Override the testimonials table name via config
• Configurable Locales — Mirrors app.available_locales (or the app locale) to describe supported translation locales

Requirements

• PHP 8.2+
• Laravel 12.x or 13.x

Installation

You can install the package via composer:

composer require jeffersongoncalves/laravel-testimonial

Publish and run the migrations:

php artisan vendor:publish --tag="testimonial-migrations"
php artisan migrate

Publish the config file (optional):

php artisan vendor:publish --tag="testimonial-config"

Configuration

The config file (config/testimonial.php) covers:

Table Names

'table_names' => [
    'testimonials' => 'testimonials',
],

Locales

'locales' => config('app.available_locales')
    ? array_keys(config('app.available_locales'))
    : [config('app.locale', 'en')],

Reads from app.available_locales (an array keyed by locale code, e.g. ['en' => 'English', 'pt_BR' => 'Português']) when present, otherwise falls back to the app's default locale. The package also configures spatie/laravel-translatable's fallback behavior on boot, so a missing translation for the current locale falls back to app.fallback_locale (or any available locale if that is also missing).

Usage

Testimonials

use JeffersonGoncalves\Testimonial\Models\Testimonial;

$testimonial = Testimonial::create([
    'name' => 'Jane Cooper',
    'role' => 'CEO',
    'company' => 'Acme Inc.',
    'avatar' => 'avatars/jane-cooper.jpg',
    'content' => ['en' => 'This product changed how we work.', 'pt_BR' => 'Este produto mudou a forma como trabalhamos.'],
    'rating' => 5,
    'order' => 1,
    'is_active' => true,
]);

$testimonial->content; // resolved for the current app locale, with fallback

Only content is translatable — name, role, company, and avatar are plain strings.

Scopes

Testimonial::active()->ordered()->get();

Translations

Because the model uses Spatie\Translatable\HasTranslations, the full spatie/laravel-translatable API is available:

$testimonial->getTranslation('content', 'pt_BR');
$testimonial->setTranslation('content', 'pt_BR', 'Recomendo muito!');
$testimonial->getTranslations('content'); // ['en' => '...', 'pt_BR' => '...']
$testimonial->translate('content', 'pt_BR');

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Gonçalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.