Configuration

The published config/likes.php, without its comments:

use RoundlyConsulting\Likes\Models\Like;

return [
    'model' => Like::class,
    'table' => env('LIKES_TABLE', 'likes'),
    'key_type' => env('LIKES_KEY_TYPE', 'bigint'),
    'reactions' => ['like'],
    'default_reaction' => env('LIKES_DEFAULT_REACTION', 'like'),
    'actor_resolver' => null,
    'facade_alias' => env('LIKES_FACADE_ALIAS', 'Likes'),

    'weights' => [
        // 'like' => 1,
        // 'love' => 4,
    ],
    'default_weight' => 1,

    'trending' => [
        'window' => '7 days',
        'recent_multiplier' => 3,
        'driver_expressions' => [
            // 'pgsql' => 'SUM(1 / POWER(EXTRACT(EPOCH FROM (NOW() - created_at)) / 3600 + 2, 1.8))',
        ],
    ],

    'broadcast' => [
        'enabled' => env('LIKES_BROADCAST', false),
        'channel_prefix' => 'likes',
        'channel_type' => 'private',
    ],
];

Every key

A key that is not set — absent, null, or blank like a host’s LIKES_TABLE= — takes its default (a blank driver expression: the portable score). A value that is set must fit: a non-string table, default_reaction, trending.window or broadcast.channel_prefix, a reactions list that is empty or holds a non-string, a non-numeric weight, multiplier or default weight, a non-string driver expression or a broadcast.channel_type typo — it no longer reads as private — throws InvalidConfigurationException instead of falling back or being dropped.

Environment

The deployment-sensitive keys are env-backed, so you rarely need to publish the config at all:

LIKES_TABLE=likes
LIKES_KEY_TYPE=bigint
LIKES_DEFAULT_REACTION=like
LIKES_FACADE_ALIAS=Likes
LIKES_BROADCAST=false

Rules worth knowing

• table and key_type are read when the migration runs — set them before you migrate.
• default_reaction must be one of reactions; otherwise every call without an explicit type throws InvalidReactionTypeException.
• A closure in actor_resolver works, but Laravel can’t cache config that contains closures — prefer an invokable class-string with php artisan config:cache.
• Broadcasting is off until broadcast.enabled is true; the events are dispatched to your listeners either way.