Fasáda Comments

Comments — RoundlyConsulting\Comments\Facades\Comments — je celé API na jednom mieste. Zápisy začínajú fluentným builderom, ktorý sa číta ako veta; čítanie začína dotazom:

use RoundlyConsulting\Comments\Facades\Comments;

// Write — a fluent builder, or a typed DTO
$comment = Comments::on($post)->as($user)->body('Nice write-up!')->post();
Comments::write($writeCommentData);

// Edit and moderate
Comments::update($comment, 'Edited body');
Comments::delete($comment);
Comments::restore($comment);
Comments::approve($comment);
Comments::hide($comment);

// Read — site-wide, per subject or per author
Comments::query()->pending()->mostReported()->paginate();
Comments::for($post)->visible()->rootsOnly()->withReplies()->get();
Comments::byAuthor($user)->get();

// Lock a subject, or the thread under one comment
Comments::lock($post);         Comments::unlock($post);         Comments::isLocked($post);
Comments::lockThread($comment); Comments::unlockThread($comment); Comments::isThreadLocked($reply);

Comments::…	Vracia	Čo robí
`on($subject)`	`CommentBuilder`	Začne komentár: as(), body(), visible(), reply(), post().
`write(WriteCommentData $data)`	`Comment`	Zápis z typovaného DTO.
`update($comment, $body)`	`Comment`	Upraví telo.
`delete($comment) / restore($comment)`	`void / Comment`	Mäkké zmazanie a obnovenie.
`approve($comment) / hide($comment)`	`Comment`	Moderovanie.
`query()`	`CommentQuery`	Čítací a moderovací dotaz naprieč celým webom — všetky subjekty.
`for($subject) / byAuthor($author)`	`CommentQuery`	Ten istý dotaz zúžený na subjekt alebo autora.
`lock($subject) / unlock($subject) / isLocked($subject)`	`CommentLock / void / bool`	Zamkne celý subjekt.
`lockThread($comment) / unlockThread($comment) / isThreadLocked($comment)`	`Comment / Comment / bool`	Zamkne vlákno pod komentárom.
`fake()`	`CommentsFake`	V testoch zaznamená každú zmenu — pozrite Testovanie.

Buildery

Comments::on($subject) vráti CommentBuilder — as(), body(), visible(), reply() a nakoniec post(). Subjekt určuje rozsah: odpoveď na komentár iného subjektu vyhodí InvalidCommentParentException.
Comments::query(), for($subject) a byAuthor($author) vrátia CommentQuery — filtre, radenie, get() / paginate() / count() a hromadné approveAll() / hideAll() / deleteAll(). Vytvárajte ho cez fasádu alebo manažér: hromadné terminály bežia cez manažér.

Skratky na modeloch

$user->writeComment() a $comment->lockReplies() / unlockReplies() sú len skratky nad tým istým manažérom, takže správanie, udalosti aj Comments::fake() sú rovnaké, nech použijete ktorýkoľvek zápis.

Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

Ďalšie spôsoby podpory vrátane kryptomien

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

Ponuka do 48 hodín Prezrieť všetky balíky