Essentials
Configuration
Full reference for config/activity-log.php.
Every knob the package exposes lives in config/activity-log.php. Publish it with php artisan vendor:publish --tag=activity-log-config (covered in /getting-started/installation) and edit in place. The table below is the canonical reference — every key, every default, every effect.
Keys
| Key | Type | Default | Effect |
|---|---|---|---|
default_per_page | int | 20 | Used by $builder->paginate(null) only. The Filament UI surfaces (infolist, relation manager, action) have their own defaults — see /essentials/filament-ui#defaults-at-a-glance. |
pagination_buffer | int | 2 | Per-source over-fetch multiplier: cap = perPage × (page + buffer). See /essentials/refining-the-timeline#pagination-buffer-mechanics. |
deduplicate_by_default | bool | true | Builder dedup default; overridable per-call via ->deduplicate(false). |
source_priorities.activity_log | int | 10 | Priority for ActivityLogSource. |
source_priorities.related_activity_log | int | 10 | Priority for RelatedActivityLogSource. Note: priority key only — entries from this source carry type='activity_log', NOT 'related_activity_log'. See /concepts/how-it-works#type-taxonomy. |
source_priorities.related_model | int | 20 | Priority for RelatedModelSource. |
source_priorities.custom | int | 30 | Priority for CustomEventSource. |
renderers | array | [] | Event-or-type → renderer map. See /essentials/customization#registration-channels. |
cache.store | ?string | null (default cache) | Laravel cache store name. See /essentials/caching. |
cache.ttl_seconds | int | 0 | Reserved; not currently consulted by TimelineCache. The per-call ->cached($ttl) is the working knob. |
cache.key_prefix | string | 'activity-log' | Prefix for all cache keys. |
Removed key: date_groups
Earlier versions of
config/activity-log.php shipped a date_groups key listing 6 bucket labels (today, yesterday, this_week, last_week, this_month, older). It has been removed.The key was dead.Grep src/ returns zero references. The actual buckets emitted by ActivityLogLivewire::bucketFor() are this_week, last_week, and week_of <date> (3 buckets, not 6).Do NOT add date_groups to your published config expecting the buckets to change — it has no effect.Tracked by issue #10.See also
- Renderer registration channels: /essentials/customization.
- Cache invalidation caveats: /essentials/caching.
- Pagination buffer mechanics: /essentials/refining-the-timeline.