Blog and Comment Hooks

Hook::add('gate:client.blog_comment_moderate', 10,
    function ($cid, $action, $actor_id, $author_id, $owner_id) {
        // 'pin' is a TOGGLE request: you cannot tell the result from here.
        if ($action === 'spam' && Acme::protectedAuthor($author_id))
            return 'Comments from this author cannot be marked as spam.';

        return null;
    });

Hook::add('action:client.blog_comment_moderated', 10,
    function ($cid, $action, $actor_id, $author_id, $owner_id) {
        // FOUR values here: the toggle has split in two.
        if ($action === 'approved' && $author_id) Acme::thankAuthor($author_id);
    });

Hook::add('action:client.blog_comment_edited', 10,
    function ($cid, $actor_id, $author_id, $old, $new) {
        // Both bodies arrive ENCODED.
        Acme::auditEdit($cid, $actor_id, html_entity_decode($old), html_entity_decode($new));
    });

Hook::add('action:client.blog_comment_deleted', 10,
    function ($cid, $actor_id, $author_id, $owner_id, $parent_id) {
        // On a root comment the replies went too, with no separate call.
        if ($parent_id === 0) Acme::dropBranch($cid);
        else Acme::dropComment($cid);
    });

Hook::add('action:client.blog_comment_voted', 10,
    function ($cid, $viewer_id, $active, $count) {
        if ($active && $count >= 10) Acme::promoteComment($cid);
    });

Hook::add('filter:client.blog_comment_message', 10, function (&$message, &$ctx) {
    // The body is RAW: encoding happens afterwards.
    $message = Acme::stripLinks($message);
});

Hook::add('filter:client.blog_comment_list', 10, function (&$items, &$ctx) {
    // When an administrator looks, pending comments are in the list too.
    if ($ctx['is_admin'] ?? false) return;

    $items = Acme::hideFlagged($items);
});