Udalosti

Pridajte trait DispatchesTranslationEvents a model pri každom uložení, ktoré zmenilo niektorý prekladateľný atribút, vyšle jednu udalosť TranslationsChanged. Základný trait HasTranslations ostáva bez vedľajších efektov — bez tohto traitu sa nič nespustí:

use RoundlyConsulting\Translatable\Concerns\DispatchesTranslationEvents;
use RoundlyConsulting\Translatable\Concerns\HasTranslations;

final class Topic extends Model implements Translatable
{
    use HasTranslations;
    use DispatchesTranslationEvents;
    // …
}

Pri vytvorení sú zmenenými atribútmi tie s neprázdnou mapou; pri aktualizácii prekladateľné atribúty, ktoré sa skutočne zmenili. Uloženie, ktoré mení len neprekladateľné stĺpce, nevyšle nič. „Zmenený“ znamená, že sa zmenila dekódovaná mapa: PostgreSQL aj MySQL vracajú JSON s inými medzerami a v inom poradí kľúčov, no opätovné uloženie nezmenenej mapy na žiadnej databáze nespustí UPDATE ani udalosť.

Počúvanie

Udalosť nesie model a zoznam názvov zmenených atribútov — ideálne na zaradenie AI služby, ktorá doplní missingLocales(), do fronty alebo na vyčistenie cache:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Translatable\Events\TranslationsChanged;

Event::listen(TranslationsChanged::class, function (TranslationsChanged $event): void {
    foreach ($event->changedAttributes as $attribute) {          // list<string>
        if ($event->model->missingLocales($attribute) !== []) {
            FillMissingTranslations::dispatch($event->model, $attribute);
        }
    }
});