Úpravy a systémové správy

Messages::message() vráti handle pre jednu správu:

use RoundlyConsulting\Messages\Facades\Messages;

Messages::message($message)->edit('edited body', by: $alice);
Messages::message($message)->delete(by: $alice); // soft delete ("unsent")

Správu smie upraviť len jej autor — ani vlastník či administrátor, a to bez ohľadu na messages.permissions.enabled. Zmazať ju smie autor a v skupinovom vlákne s vynucovanými rolami aj vlastníci a administrátori. V oboch prípadoch musí byť vykonávateľ stále účastníkom vlákna. Pri dôveryhodných serverových volaniach by: vynechajte.

Úprava alebo zmazanie už zmazanej správy vyhodí typovanú RoundlyConsulting\Messages\Exceptions\MessageException. Úprava spustí MessageEdited, zmazanie MessageDeleted. Správa sa považuje za upravenú, len keď sa jej text naozaj zmenil: zmena textu zapíše meta.edited_at (ISO-8601) a edited_at v MessageResource číta práve to — nikdy updated_at, ktorý nastaví aj zrušenie odoslania a obnovenie. Správy upravené pred verziou 1.1.0 túto značku nemajú a edited_at u nich vráti null.

Obmedzené na vlákno

Ak vlákno aj správa prichádzajú z požiadavky, choďte cez vlákno — správa z iného vlákna vyhodí MessageException::notInThread():

// PATCH /threads/{thread}/messages/{message} — refuses a message of another thread
Messages::thread($thread)->message($message)->edit($request->body, by: $request->user());
Messages::thread($thread)->message($message)->delete(by: $request->user());

Čo robí zrušenie odoslania

• Správa sa zmaže mäkko (soft delete) — riadok zostáva až do trvalého zmazania alebo prune.
• Broadcasty a MessageResource skryjú text (null) a preview() vráti „This message was deleted.“ (v slovenčine „Táto správa bola odstránená.“).
• Ukazovateľ poslednej správy vlákna sa presunie na predchádzajúcu zachovanú správu.
• Súbory príloh zostanú; odstráni ich len trvalé zmazanie alebo prune.

Systémové správy

Systémové správy zapnete cez messages.system-messages.enabled (MESSAGES_SYSTEM_MESSAGES). Ukladajú sa ako správa typu MessageType::System bez odosielateľa, s prekladovým kľúčom ako textom a parametrami v JSON stĺpci meta, takže sa správne zobrazia v ľubovoľnom jazyku. Po zapnutí ich balík zapisuje sám:

• pridanie účastníka — messages::messages.system.participant_joined s poľom participateAs() účastníka v meta.participant;
• odchod účastníka — messages::messages.system.participant_left, rovnaké meta;
• premenovanie vlákna — messages::messages.system.thread_renamed s meta.name.

preview() ich zobrazí v aktuálnom jazyku. Za :participant dosadí kľúč name z uloženej snímky — a ak ho snímka nemá alebo model neimplementuje ParticipatesInMessaging, text „bez mena“ (v angličtine „An unnamed participant“). Rovnako sa zobrazia aj správy uložené verziami 1.0.0–1.0.1.

Vlastné systémové správy zapíšete cez builder. preview() preloží kľúč a skalárne hodnoty z meta použije ako náhrady:

use RoundlyConsulting\Messages\Facades\Messages;

$message = Messages::to($thread)
    ->asSystem('messages::messages.system.thread_renamed', ['name' => 'Launch'])
    ->send();   // type System, no sender, body = the translation key, params in meta

$message->preview();   // "The conversation was renamed to Launch."

Prekladové kľúče

Angličtina a slovenčina sú súčasťou balíka. Ak chcete texty preformulovať alebo pridať ďalší jazyk, publikujte ich tagom messages-translations:

UnauthorizedMessagingAction::for(Model $actor, string $action) aj requiresRole(Model $actor, ParticipantRole $required, string $action) očakávajú v $action kľúč messages::messages.permissions.actions.* a prečítajú ho v aktuálnom jazyku — bežnú frázu, ktorá kľúčom nie je, použijú tak, ako je. Požadovanú rolu berú z messages::messages.permissions.roles.* (owner, admin, member), takže celé odmietnutie je v jednom jazyku. Po slovensky znie napríklad takto: […] potrebuje rolu „vlastník“, ak chce odovzdať vlastníctvo.