Configuration

All options live in config/vgcomment.php after:

php artisan vendor:publish --tag=vgcomment-config

Many values can also be changed at runtime from Admin → Settings. Runtime DB settings override the file where applicable.

Languages

php artisan vendor:publish --tag=vgcomment-lang

Translations: lang/vendor/vgcomment.

Routing & database

Key	Default	Notes
prefix	vgcomments	Base path: /vgcomments/...
connection	env('VCOMMENT_DB_CONNECTION', 'mysql')	Package migrations/models use this connection
table.*	vgcomments, vgcomment_files, …	Change before first migrate

Guests & targets

'allow_guests' => true,

// Empty = page_id only (recommended default)
'allowed_commentable_types' => [
    // \App\Models\Post::class,
],

'reaction_types' => ['👍', '❤️', '😄', '😮', '😢', '😡'],

Morph comments only work for classes listed in allowed_commentable_types.

User columns

Map your user model attributes:

'user_column_name' => 'name',
'user_column_email' => 'email',
'user_column_url' => 'url',
'user_column_avatar_url' => 'avatar_url',

Moderation

'moderation' => false,          // hold all new comments for approval
'moderation_users' => [
    'web' => [1],               // who can open /{prefix}/admin
],
'moderation_keys' => [],        // words → pending queue
'blacklist_keys' => [],         // words → spam

Content rules

'min_length' => 10,
'max_length' => 1000,
'throttle_max_rate' => 10,
'throttle_per_minutes' => 1,
'max_links' => 10,
'duplicates_check' => false,
'censor' => true,
'censors_text' => [],
'report_status' => 'pending',   // or 'spam'
'max_reports' => 5,

Avatars

'gravatar' => true,
'gravatar_imageset' => 'wavatar', // mp, identicon, monsterid, wavatar, retro, robohash, blank, 404

Uploads

'disk_filesystem' => config('filesystems.default', 'local'),
'upload_rules' => ['max:5120', 'mimes:doc,pdf,jpg,jpeg,png,gif'],
'upload_rules_max' => 5,

NSFW (Sightengine)

'nsfw' => false,
'nsfw_api_user' => '',
'nsfw_api_key' => '',

reCAPTCHA v3

'recaptcha' => false,
'recaptcha_key' => env('RECAPTCHA_KEY', ''),
'recaptcha_secret' => env('RECAPTCHA_SECRET', ''),

RECAPTCHA_KEY=your-site-key
RECAPTCHA_SECRET=your-secret

UI packages load Google’s script when recaptcha is enabled.

Broadcast

'broadcast' => false,

Optional realtime for Livewire (Echo). Leave off unless you configure broadcasting.

Env cheat sheet

VCOMMENT_DB_CONNECTION=mysql
RECAPTCHA_KEY=
RECAPTCHA_SECRET=