Filament Activity Log

https://github.com/alizharb/filament-activity-log
Admin
A powerful, feature-rich activity logging solution for FilamentPHP v4 & v5. Seamlessly track, view,...
Tokens:102,069
Snippets:775
Trust Score:6.4
License:MIT
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Development Setup Commands

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Use these commands to clone the repository, install dependencies, run tests, and format the code.

```bash
# Clone repository
git clone https://github.com/alizharb/filament-activity-log.git

# Install dependencies
composer install

# Run tests
composer test

# Format code
composer format
```

--------------------------------

### Install via Composer

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Run this command to install the package in your project.

```bash
composer require alizharb/filament-activity-log
```

--------------------------------

### Publish Config and Migrations

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Run the installation command to publish necessary files.

```bash
php artisan filament-activity-log:install
```

--------------------------------

### Scheduled compliance pipeline example

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ArtisanCommands.md

Example of chaining commands in a scheduler.

```bash
# In a scheduler:
php artisan filament-activity-log:backfill --only-missing
php artisan filament-activity-log:verify-integrity --chunk=500
php artisan filament-activity-log:doctor
```

--------------------------------

### filament-activity-log:install

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ArtisanCommands.md

Runs the interactive installation flow for the package. It publishes configuration and migrations, optionally prompts for translations and views, and can run migrations and the doctor command.

```APIDOC
## filament-activity-log:install

### Description
Runs the interactive installation flow for the package. It publishes Spatie's activitylog config and migrations, the package config, and the audit migration. It prompts to publish translations and views (default no) and to run migrations; if accepted, runs `migrate` then `filament-activity-log:doctor`. Prints support links.

### Method
Artisan Command

### Endpoint
`php artisan filament-activity-log:install`

### Parameters
None

### Request Example
```bash
php artisan filament-activity-log:install
```

### Response
Returns `self::SUCCESS` on success.
```

--------------------------------

### Run filament-activity-log:backfill

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ArtisanCommands.md

Examples of running the backfill command with different options.

```bash
php artisan filament-activity-log:backfill --chunk=500 --only-missing
php artisan filament-activity-log:backfill --chunk=500 --from-id=12345   # resume
```

--------------------------------

### Upgrade to v2

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Commands for upgrading an existing installation to v2.

```bash
php artisan vendor:publish --tag=filament-activity-log-migrations
php artisan migrate
php artisan filament-activity-log:backfill
php artisan filament-activity-log:verify-integrity
php artisan filament-activity-log:doctor
```

--------------------------------

### Validate installation

Source: https://github.com/alizharb/filament-activity-log/blob/main/UPGRADE.md

Run the doctor command to verify the installation status.

```bash
php artisan filament-activity-log:doctor
```

--------------------------------

### Implementing TenantActivityScope

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/Contracts.md

An example implementation of ScopesActivityQueries to enforce a tenant boundary using a tenant_id.

```php
use AlizHarb\ActivityLog\Contracts\ScopesActivityQueries;
use Illuminate\Database\Eloquent\Builder;

class TenantActivityScope implements ScopesActivityQueries
{
    public function apply(Builder $query): Builder
    {
        return $query->where('tenant_id', current_tenant_id());
    }
}
```

--------------------------------

### Querying activities

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityQuery.md

Examples of counting activities and retrieving the latest records using the ActivityQuery singleton.

```php
use AlizHarb\\\ActivityLog\\\Support\\\ActivityQuery;

$count = app(ActivityQuery::class)->query()->count();

$latest = app(ActivityQuery::class)->withRelations()
    ->latest()
    ->limit(10)
    ->get();
```

--------------------------------

### Run development commands

Source: https://github.com/alizharb/filament-activity-log/blob/main/CONTRIBUTING.md

Use these commands to install dependencies, run checks, and audit the project during development.

```bash
composer install
composer check
composer audit
```

--------------------------------

### Verify release with smoke test

Source: https://github.com/alizharb/filament-activity-log/blob/main/docs/releasing.md

Create a fresh Laravel project and install the package to verify the release in a clean environment.

```bash
composer create-project laravel/laravel release-smoke
cd release-smoke
composer require alizharb/filament-activity-log:^2.0
php artisan filament-activity-log:install
php artisan filament-activity-log:doctor
```

--------------------------------

### Configure tenant-scoped activities and tables

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Example of scoping activities to a tenant and customizing table behavior using the plugin configuration methods.

```php
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Filament\Tables\Table;

$panel->plugins([
    ActivityLogPlugin::make()
        ->scopeActivitiesUsing(
            fn (Builder $query, ?Model $tenant): Builder => $query->when(
                $tenant,
                fn (Builder $query): Builder => $query->where('tenant_id', $tenant->getKey()),
            ),
        )
        ->configureTableUsing(fn (Table $table): Table => $table->deferLoading(false)->poll('30s'))
        ->configureRelationManagerTableUsing(fn (Table $table): Table => $table->paginated([10, 25])),
]);
```

--------------------------------

### Handle IntegrityException

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityIntegrity.md

Example of catching an IntegrityException when the integrity key is missing.

```php
use AlizHarb\ActivityLog\Exceptions\IntegrityException;

try {
    $hash = app(ActivityIntegrity::class)->hash($activity);
} catch (IntegrityException $e) {
    // 'integrity.missing_key' — set ACTIVITY_LOG_INTEGRITY_KEY or APP_KEY
}
```

--------------------------------

### Usage Example: Listening for Audit Findings

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/SupportServices.md

Example of listening for AuditRuleMatched and RetentionHoldChanged events in a Laravel application.

```APIDOC
## Usage Example: Listening for Audit Findings

### Description
Example of listening for audit findings and retention hold changes.

### Code
```php
// App\Providers\EventServiceProvider
use AlizHarb\ActivityLog\Events\AuditRuleMatched;
use AlizHarb\ActivityLog\Events\RetentionHoldChanged;

Event::listen(function (AuditRuleMatched $event): void {
    logger()->warning('audit-finding', [
        'finding' => $event->finding->context,
        'activity' => $event->activity->getKey(),
    ]);
});

Event::listen(function (RetentionHoldChanged $event): void {
    // $event->held indicates whether the hold was placed or released
});
```
```

--------------------------------

### Configure permissions with custom authorizer

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityPolicy.md

Example configuration for enabling permissions and defining a custom authorization callback in the package configuration file.

```php
// config/filament-activity-log.php
'permissions' => [
    'enabled' => true,
    'custom_authorization' => fn ($user): bool => $user->id === 1,
],
```

--------------------------------

### Tenant-Scoped with Table Customization

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Example of configuring the plugin for tenant scoping and customizing the table and relation manager table.

```APIDOC
## Tenant-Scoped with Table Customization

### Description
Example of configuring the plugin for tenant scoping and customizing the table and relation manager table.

### Code Example
```php
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Filament\Tables\Table;

$panel->plugins([
    ActivityLogPlugin::make()
        ->scopeActivitiesUsing(
            fn (Builder $query, ?Model $tenant): Builder => $query->when(
                $tenant,
                fn (Builder $query): Builder => $query->where('tenant_id', $tenant->getKey()),
            ),
        )
        ->configureTableUsing(fn (Table $table): Table => $table->deferLoading(false)->poll('30s'))
        ->configureRelationManagerTableUsing(fn (Table $table): Table => $table->paginated([10, 25])),
]);
```

```

--------------------------------

### Implementing AuditRule

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/Contracts.md

An example implementation of the AuditRule interface that checks for specific activity log names and events to return a custom AuditFinding.

```php
use AlizHarb\ActivityLog\Contracts\AuditRule;
use AlizHarb\ActivityLog\ValueObjects\AuditFinding;
use Spatie\Activitylog\Models\Activity;

class ImportActivityRule implements AuditRule
{
    public function evaluate(Activity $activity): ?AuditFinding
    {
        if ($activity->log_name !== 'import' || $activity->event !== 'created') {
            return null;
        }

        return new AuditFinding(
            title: 'Bulk import performed',
            severity: 'medium',
            description: (string) $activity->description,
            context: ['subject_id' => $activity->subject_id],
        );
    }
}
```

--------------------------------

### Build a unified old to new diff

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityChanges.md

Example showing how to retrieve redacted old and new values to build a diff for display.

```php
use AlizHarb\ActivityLog\Support\ActivityChanges;

$old = ActivityChanges::getRedactedOldValues($activity);
$new = ActivityChanges::getRedactedNewValues($activity);

foreach ($new as $field => $value) {
    $before = $old[$field] ?? null;
    // render before/after for $field
}
```

--------------------------------

### Guard for a per-field view

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityChanges.md

Example showing how to check for changes before accessing the attribute changes array.

```php
if (ActivityChanges::hasChanges($activity)) {
    $changes = ActivityChanges::getAttributeChanges($activity);
    // $changes['attributes'] / $changes['old'] if present
}
```

--------------------------------

### Implement ActivityLog Contracts

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogTitle.md

Example of implementing HasActivityLogTitle and HasActivityLogUrl on a model to provide custom title and URL resolution.

```php
use AlizHarb\ActivityLog\Contracts\HasActivityLogTitle;
use AlizHarb\ActivityLog\Contracts\HasActivityLogUrl;

class User extends Model implements HasActivityLogTitle, HasActivityLogUrl
{
    public function getActivityLogTitle(): string
    {
        return "User: {$this->email}";
    }

    public function getActivityLogUrl(): ?string
    {
        return '/admin/users/'.$this->getKey();
    }
}
```

--------------------------------

### Render a timeline for a record

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

Example of using ActivityTimeline to retrieve activities for a specific record with a custom limit.

```php
use AlizHarb
ActivityLog
Timeline
ActivityTimeline;

$activities = app(ActivityTimeline::class)->for($post, limit: 25);
```

--------------------------------

### Preview revert actions for bulk processing

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityMutation.md

Use previewRevert to analyze changes before applying them. This example demonstrates filtering out changes that have conflicts.

```php
$preview = app(ActivityMutation::class)->previewRevert($activity);

$conflictFree = collect($preview)
    ->reject(fn (array $change): bool => $change['conflict'])
    ->keys()
    ->all();
```

--------------------------------

### Add ActivityLogTimelineTableAction to a Table

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/RelationManagerAndTimelineAction.md

Example of configuring a slim timeline action with custom icons and colors within a Filament table.

```php
use AlizHarb\\ActivityLog\\Actions\\ActivityLogTimelineTableAction;
use Filament\\Tables\\Table;

Table::make()->recordActions([
    ActivityLogTimelineTableAction::make()
        ->slim()
        ->icons(['deleted' => 'heroicon-m-trash'])
        ->colors(['deleted' => 'danger']),
])
```

--------------------------------

### Usage example: Attach relation manager and configure table

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogResource.md

Shows how to attach the ActivitiesRelationManager to a Filament resource and configure the table per panel using ActivityLogPlugin::configureTableUsing.

```APIDOC
## Usage example

### Description
Attach the relation manager and configure the table per panel.

### Code
```php
use AlizHarb\ActivityLog\RelationManagers\ActivitiesRelationManager;
use Filament\Tables\Table;

public static function getRelations(): array
{
    return [ActivitiesRelationManager::class];
}

// per-panel table customization
ActivityLogPlugin::make()->configureTableUsing(
    fn (Table $table): Table => $table->paginated([10, 25, 50])
);
```

```

--------------------------------

### Displaying Risk Badges in Views

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityRisk.md

Example of iterating through activities to display their risk level, color, and label in a custom view.

```php
use AlizHarb\
ActivityLog\\Support\\ActivityRisk;

foreach ($activities as $activity) {
    echo ActivityRisk::level($activity);   // 'low' | 'medium' | 'high' | 'critical'
    echo ActivityRisk::color($activity);   // 'gray' | 'info' | 'warning' | 'danger'
    echo ActivityRisk::label($activity);   // e.g. 'Critical (90)'
}
```

--------------------------------

### Basic Registration

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Example of registering the ActivityLogPlugin with basic configuration options such as label, plural label, navigation group, cluster, navigation count badge, and dashboard.

```APIDOC
## Basic Registration

### Description
Example of registering the ActivityLogPlugin with basic configuration options.

### Code Example
```php
use AlizHarb\ActivityLog\ActivityLogPlugin;

$panel->plugins([
    ActivityLogPlugin::make()
        ->label('Log')
        ->pluralLabel('Logs')
        ->navigationGroup('System')
        ->cluster(SystemCluster::class)
        ->navigationCountBadge(true)
        ->dashboard(),
]);
```

```

--------------------------------

### Custom Timeline Source Implementation

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

Example of implementing a custom timeline source by implementing the ProvidesTimelineActivities contract and registering it in the configuration.

```APIDOC
## Custom Timeline Source

### Description
Shows how to create a custom timeline source by implementing the ProvidesTimelineActivities interface and registering it in the timeline.sources configuration.

### Interface
ProvidesTimelineActivities

### Method
activitiesFor(Model $record, int $limit): Collection

### Example Implementation
```php
use AlizHarb\ActivityLog\Contracts\ProvidesTimelineActivities;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Collection;

class ApprovalActivitySource implements ProvidesTimelineActivities
{
    public function activitiesFor(Model $record, int $limit): Collection
    {
        return \App\Models\Approval::where('record_id', $record->getKey())
            ->latest()
            ->limit($limit)
            ->get()
            ->map(fn ($approval) => $approval->toActivity());
    }
}
```

### Configuration
```php
// config/filament-activity-log.php
'timeline' => [
    'sources' => [\App\ApprovalActivitySource::class],
],
```
```

--------------------------------

### Custom subject restorer example

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ContextCollectorsAndTaps.md

Shows a custom subject restorer implementing RestoresActivitySubjects. The restore method creates an Order model with attributes, throws ActivityMutationException('mutation.restore_failed') if creation fails, and returns the order.

```php
use AlizHarb\ActivityLog\Contracts\RestoresActivitySubjects;
use AlizHarb\ActivityLog\Exceptions\ActivityMutationException;
use Spatie\Activitylog\Models\Activity;

class OrderRestorer implements RestoresActivitySubjects
{
    public function restore(Activity $activity, array $attributes): \Illuminate\Database\Eloquent\Model
    {
        $order = \App\Models\Order::create([
            'customer_id' => $attributes['customer_id'],
            'status' => $attributes['status'] ?? 'draft',
            'note' => $attributes['note'] ?? null,
        ]);

        if (! $order) {
            throw new ActivityMutationException('mutation.restore_failed');
        }

        return $order;
    }
}
```

--------------------------------

### Re-sign activity after update

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityIntegrity.md

Example of updating an activity attribute and re-signing the record to maintain integrity.

```php
use AlizHarb\ActivityLog\Support\ActivityIntegrity;

$activity->setAttribute('retention_hold', true);
$activity->setAttribute('integrity_hash', app(ActivityIntegrity::class)->hash($activity));

$activity->newQueryWithoutScopes()->whereKey($activity->getKey())->toBase()
    ->update(['retention_hold' => true, 'integrity_hash' => $activity->integrity_hash]);
```

--------------------------------

### Build causer filter options

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogCauser.md

Example of building a causer filter option set by resolving the model class and plucking options from the query.

```php
use AlizHarb\ActivityLog\Support\ActivityLogCauser;
use AlizHarb\ActivityLog\Support\ActivityQuery;

$model = ActivityLogCauser::resolveModelClass();

if (! $model || ! class_exists($model)) {
    return [];
}

$query = $model::query()->whereIn('id', app(ActivityQuery::class)->query()
    ->distinct()
    ->whereNotNull('causer_id')
    ->pluck('causer_id'));

$options = ActivityLogCauser::pluckOptions($query);
```

--------------------------------

### Cache a Computed Aggregate

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityCache.md

Example of using the remember method to cache a total count of activities.

```php
use AlizHarb\ActivityLog\Support\ActivityCache;
use AlizHarb\ActivityLog\Support\ActivityQuery;

$count = app(ActivityCache::class)->remember('dashboard:total', fn (): int =>
    app(ActivityQuery::class)->query()->count()
);
```

--------------------------------

### Test Sensitive Key

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogRedactor.md

Example of checking if a specific key is considered sensitive using isSensitiveKey.

```php
if (ActivityLogRedactor::isSensitiveKey('password_confirmation')) {
    // true
}
```

--------------------------------

### Registering a listener for AuditRuleMatched

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/AuditRuleEngine.md

Example of how to listen for the AuditRuleMatched event in AppServiceProvider to handle findings, such as sending notifications.

```php
// AppServiceProvider::boot()
use AlizHarb\
ActivityLog\\Events\\AuditRuleMatched;

Event::listen(function (AuditRuleMatched $event): void {
    // $event->activity, $event->rule, $event->finding
    Notification::route('mail', 'compliance@example.com')
        ->notify(new AuditFindingNotification($event->finding));
});
```

--------------------------------

### Authorize programmatic prune

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityPolicy.md

Example of using the Gate facade to check if the current user is authorized to perform a prune operation on the activity model.

```php
use Illuminate\
Support\
Facades\
Gate;

if (Gate::allows('pruneAny', app(\AlizHarb\ActivityLog\Support\ActivityQuery::class)->modelClass())) {
    // run the prune
}
```

--------------------------------

### Place a Hold on a Single Record

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/RetentionManager.md

Example of using setHold to place a retention hold on a single activity record, including exception handling.

```php
use AlizHarb\ActivityLog\Support\RetentionManager;
use AlizHarb\ActivityLog\Exceptions\RetentionException;

try {
    $changed = app(RetentionManager::class)->setHold($activity, true);
    // $changed === true -> hold placed, event dispatched
} catch (RetentionException $e) {
    // 'retention.unavailable' | 'retention.outside_boundary'
} catch (\Illuminate\Auth\Access\AuthorizationException $e) {
    // user lacks 'manage_activity_retention_holds'
}
```

--------------------------------

### Backfill metadata with AuditMetadata::persist

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/AuditMetadata.md

Usage example for backfilling metadata on an existing activity record, matching the pattern used by the filament-activity-log:backfill command. Pass refresh: false to avoid a per-record refresh query.

```php
use AlizHarb\ActivityLog\Support\AuditMetadata;

app(AuditMetadata::class)->persist($activity, refresh: false);
```

--------------------------------

### Run package integrity checks

Source: https://github.com/alizharb/filament-activity-log/blob/main/docs/releasing.md

Run these artisan commands in a clean Laravel application to verify the package installation and integrity.

```bash
php artisan filament-activity-log:doctor
php artisan filament-activity-log:verify-integrity
```

--------------------------------

### Listen for Audit Findings and Retention Changes

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/SupportServices.md

Example of how to register listeners for AuditRuleMatched and RetentionHoldChanged events in an EventServiceProvider.

```php
// App\Providers\EventServiceProvider
use AlizHarb\ActivityLog\Events\AuditRuleMatched;
use AlizHarb\ActivityLog\Events\RetentionHoldChanged;

Event::listen(function (AuditRuleMatched $event): void {
    logger()->warning('audit-finding', [
        'finding' => $event->finding->context,
        'activity' => $event->activity->getKey(),
    ]);
});

Event::listen(function (RetentionHoldChanged $event): void {
    // $event->held indicates whether the hold was placed or released
});
```

--------------------------------

### Attach ActivitiesRelationManager to a Resource

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/RelationManagerAndTimelineAction.md

Example of how to register the ActivitiesRelationManager within a Filament resource's getRelations method.

```php
use AlizHarb\\'ActivityLog\\RelationManagers\\ActivitiesRelationManager;

class UserResource extends Resource
{
    public static function getRelations(): array
    {
        return [
            ActivitiesRelationManager::class,
        ];
    }
}
```

--------------------------------

### Usage example: prune logs older than 90 days

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityPruner.md

Calls pruneBefore with a cutoff of 90 days ago. Catches AuthorizationException when pruning is disabled or the user lacks the 'prune_activity_logs' permission, then aborts with 403.

```php
use AlizHarb\ActivityLog\Support\ActivityPruner;
use Illuminate\Auth\Access\AuthorizationException;

try {
    $count = app(ActivityPruner::class)->pruneBefore(now()->subDays(90));
    // $count rows removed; held records were skipped
} catch (AuthorizationException $e) {
    // pruning disabled or the user lacks 'prune_activity_logs'
    abort(403);
}
```

--------------------------------

### Revert specific attributes with conflict handling

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityMutation.md

Use the revert method to roll back specific attributes. This example includes checks for authorization and handles ActivityMutationException for conflicts or invalid attribute states.

```php
use AlizHarb\ActivityLog\Support\ActivityMutation;
use AlizHarb\ActivityLog\Exceptions\ActivityMutationException;
use Illuminate\Auth\Access\AuthorizationException;

$mutation = app(ActivityMutation::class);

if (! $mutation->canRevert($activity)) {
    return;
}

try {
    $mutation->revert($activity, ['name', 'status']);
} catch (ActivityMutationException $e) {
    // 'mutation.conflict' -> attribute changed after the activity
    // 'mutation.no_attributes' -> nothing safe to write back
    notify()->danger($e->getMessage());
} catch (AuthorizationException $e) {
    abort(403);
}
```

--------------------------------

### Render Subject Column

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogTitle.md

Example of using ActivityLogTitle to retrieve the title and URL for a record subject, typically used in tables or infolists.

```php
use AlizHarb\ActivityLog\Support\ActivityLogTitle;

$title = ActivityLogTitle::get($record->subject);   // 'User: alice@example.com' or 'App\Models\User #42'
$url   = ActivityLogTitle::getUrl($record->subject); // ?string
```

--------------------------------

### Catch ActivityLogException and AuthorizationException

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/errors.md

Use this try-catch block to handle domain exceptions like ActivityMutationException and AuthorizationException. The example catches a mutation conflict and aborts with 403 on gate denial. All domain exceptions extend RuntimeException, so table actions catch them via InvalidArgumentException|RuntimeException.

```php
use AlizHarb\ActivityLog\Exceptions\ActivityLogException;
use AlizHarb\ActivityLog\Exceptions\ActivityMutationException;
use AlizHarb\ActivityLog\Exceptions\IntegrityException;
use AlizHarb\ActivityLog\Exceptions\RetentionException;
use Illuminate\Auth\Access\AuthorizationException;

try {
    app(\AlizHarb\ActivityLog\Support\ActivityMutation::class)->revert($activity, ['name']);
} catch (ActivityMutationException $e) {
    // Key: 'mutation.conflict' etc.
    report(['key' => $e->translationKey, 'context' => $e->context()]);
} catch (AuthorizationException $e) {
    // Gate-level denial
    abort(403);
}
```

--------------------------------

### Custom context collector example

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ContextCollectorsAndTaps.md

Shows a custom context collector implementing CollectsActivityContext. The collect method returns an array with a trace_id from the request header X-Trace-ID. The comment shows the config key 'auto_context' => ['collectors' => [TraceContextCollector::class, ...]].

```php
use AlizHarb\ActivityLog\Contracts\CollectsActivityContext;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Request;

class TraceContextCollector implements CollectsActivityContext
{
    public function collect(Request $request, ?Model $subject = null, ?Model $causer = null): array
    {
        return ['trace_id' => $request->header('X-Trace-ID')];
    }
}

// config: 'auto_context' => ['collectors' => [TraceContextCollector::class, ...]]
```

--------------------------------

### Conditionally enable features based on schema support

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/AuditSchema.md

Example of using AuditSchema to check for column support before enabling specific features in custom code.

```php
use AlizHarb\ActivityLog\Support\AuditSchema;

$schema = app(AuditSchema::class);

if ($schema->hasRetentionHold() && $schema->hasIntegrityHash()) {
    // enable hold UI + integrity signing in your custom code
}
```

--------------------------------

### ActivityLogPlugin::boot(Panel $panel)

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Empty hook provided for the Plugin contract.

```APIDOC
## ActivityLogPlugin::boot(Panel $panel)

### Description
Empty hook, provided for the `Plugin` contract.

### Method
public function boot(Panel $panel): void

### Parameters
- **$panel** (Panel) - Required - The Filament panel.

### Return Value
- **void**
```

--------------------------------

### Redact Single Value

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogRedactor.md

Example of using the redactValue method to sanitize a single key-value pair.

```php
$display = ActivityLogRedactor::redactValue($key, $oldValue);
```

--------------------------------

### Create ActivityLogPlugin instance

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Use the make() static factory method to instantiate the plugin within the panel configuration.

```php
use AlizHarb\ActivityLog\ActivityLogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel->plugins([
        ActivityLogPlugin::make(),
    ]);
}
```

--------------------------------

### Redact Properties Bag

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogRedactor.md

Example of using the redact method to sanitize an array of properties for display.

```php
use AlizHarb
ActivityLog
Support
ActivityLogRedactor;

$safe = ActivityLogRedactor::redact($rawProperties);
// ['password' => '[redacted]', 'nested' => ['token' => '[redacted]'], 'title' => 'OK']
```

--------------------------------

### Configure Tracking

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Add the generic tap to your config/activitylog.php to capture IP addresses and user agent information.

```php
'activity_logger_taps' => [
    \AlizHarb\ActivityLog\Taps\SetActivityContextTap::class,
],
```

--------------------------------

### Invalidate Cache

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityCache.md

Example of manually triggering a cache flush to invalidate all entries for the current namespace.

```php
app(ActivityCache::class)->flush();
```

--------------------------------

### ActivitiesRelationManager::infolist()

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/RelationManagerAndTimelineAction.md

Delegates to ActivityLogInfolist::configure() to set up the infolist schema.

```APIDOC
## ActivitiesRelationManager::infolist()

### Description
Delegates to ActivityLogInfolist::configure() to set up the infolist schema.

### Method
PHP Method

### Signature
public function infolist(Schema $schema): Schema

### Parameters
- $schema (Schema) - Required - The schema instance to configure.

### Returns
Schema - The configured schema.
```

--------------------------------

### Configure Activity Log Widgets

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Enable or disable widgets and adjust their settings like chart duration or list limits in the configuration file.

```php
'widgets' => [
    'widgets' => [
        \AlizHarb\ActivityLog\Widgets\ActivityChartWidget::class,
        \AlizHarb\ActivityLog\Widgets\LatestActivityWidget::class,
    ],
    'activity_chart' => [
        'enabled' => true,
        'days' => 30,
        'fill_color' => 'rgba(16, 185, 129, 0.1)',
        'border_color' => '#10b981',
    ],
    'latest_activity' => [
        'enabled' => true,
        'limit' => 10,
    ],
],
```

--------------------------------

### Error Handling for Invalid Timeline Source

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

Example of catching InvalidConfigurationException when a configured timeline source is invalid.

```APIDOC
## Error Handling

### Description
Demonstrates how to handle InvalidConfigurationException when a configured timeline source class is invalid.

### Exception
InvalidConfigurationException

### Error Code
'configuration.timeline_source'

### Example
```php
use AlizHarb\ActivityLog\Exceptions\InvalidConfigurationException;

try {
    $activities = app(ActivityTimeline::class)->for($record);
} catch (InvalidConfigurationException $e) {
    // 'configuration.timeline_source' — a configured source class is invalid
}
```
```

--------------------------------

### ActivityLogPlugin::make()

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Creates a new plugin instance via the container. This is the primary way to instantiate the plugin for registration with a Filament panel.

```APIDOC
## ActivityLogPlugin::make()

### Description
Creates a new plugin instance via the container.

### Method
public static function make(): static

### Parameters
None

### Return Value
- **static** - A new plugin instance.

### Example
```php
use AlizHarb\ActivityLog\ActivityLogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel->plugins([
        ActivityLogPlugin::make(),
    ]);
}
```
```

--------------------------------

### Error Handling - Invalid Cluster

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Example of handling an invalid cluster configuration, which throws an InvalidConfigurationException with a translation key.

```APIDOC
## Error Handling - Invalid Cluster

### Description
Example of handling an invalid cluster configuration, which throws an InvalidConfigurationException.

### Code Example
```php
use AlizHarb\ActivityLog\ActivityLogPlugin;
use AlizHarb\ActivityLog\Exceptions\InvalidConfigurationException;

$plugin = ActivityLogPlugin::make()->cluster('App\Models\NotACluster');

try {
    $cluster = $plugin->getCluster(); // throws
} catch (InvalidConfigurationException $e) {
    // $e->translationKey === 'configuration.cluster'
}
```

```

--------------------------------

### ActivityLogPlugin::get()

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Returns the plugin instance for the current panel. Throws an exception if the plugin is not registered on the panel.

```APIDOC
## ActivityLogPlugin::get()

### Description
Returns the plugin instance for the current panel (`filament(app(static::class)->getId())`). Throws if the plugin is not registered on the panel. Package internals call this in try/catch and fall back to config when no panel is booted.

### Method
public static function get(): static

### Parameters
None

### Return Value
- **static** - The plugin instance for the current panel.

### Exceptions
- Throws an exception if the plugin is not registered on the panel.
```

--------------------------------

### Implement and register a custom timeline source

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

Create a class implementing ProvidesTimelineActivities and register it in the configuration file.

```php
use AlizHarb\ActivityLog\Contracts\ProvidesTimelineActivities;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Collection;

class ApprovalActivitySource implements ProvidesTimelineActivities
{
    public function activitiesFor(Model $record, int $limit): Collection
    {
        return \App\Models\Approval::where('record_id', $record->getKey())
            ->latest()
            ->limit($limit)
            ->get()
            ->map(fn ($approval) => $approval->toActivity());
    }
}

// config/filament-activity-log.php
'timeline' => [
    'sources' => [\App\ApprovalActivitySource::class],
],
```

--------------------------------

### Run audit migration and maintenance commands

Source: https://github.com/alizharb/filament-activity-log/blob/main/UPGRADE.md

Execute these commands to publish migrations, update the database schema, backfill existing data, and verify integrity.

```bash
php artisan vendor:publish --tag=filament-activity-log-migrations
php artisan migrate
php artisan filament-activity-log:backfill
php artisan filament-activity-log:verify-integrity
```

--------------------------------

### Run local release checks

Source: https://github.com/alizharb/filament-activity-log/blob/main/docs/releasing.md

Execute these commands to validate composer configuration, check code style, audit dependencies, and verify git whitespace before releasing.

```bash
composer validate --strict --no-check-publish
composer check
composer audit
git diff --check
```

--------------------------------

### SpatieActivitySource activitiesFor implementation

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

The internal implementation of activitiesFor using ActivityQuery to retrieve activities for a record.

```php
app(ActivityQuery::class)
    ->forRecord($record)
    ->with(['causer', 'subject'])
    ->latest()
    ->limit($limit)
    ->get();
```

--------------------------------

### Run doctor, backfill, and verify integrity commands

Source: https://github.com/alizharb/filament-activity-log/blob/main/docs/operations.md

Run these artisan commands after deploying code that enables persisted risk filters. Backfill and verification honor the configured activity query scope. For very large tables, resume a reviewed run with --from-id=<last completed id>.

```bash
php artisan filament-activity-log:doctor
php artisan filament-activity-log:backfill --chunk=500 --only-missing
php artisan filament-activity-log:verify-integrity --chunk=500
```

--------------------------------

### ActivityLogPlugin::getWidgets()

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Returns the list of widgets configured for the plugin, with validation.

```APIDOC
## ActivityLogPlugin::getWidgets()

### Description
Returns an array of widget class strings or widget configurations. Returns an empty array when widgets are disabled. Validates the configuration and throws exceptions for invalid entries.

### Method
public function getWidgets(): array

### Parameters
None

### Return Value
- **array** - Returns `array<class-string<Widget>|WidgetConfiguration>`. Empty array when `widgets.enabled` is `false`; otherwise the configured `widgets.widgets` list.

### Exceptions
- Throws `InvalidConfigurationException('configuration.widgets_array')` if the configured widgets list is not an array.
- Throws `InvalidConfigurationException('configuration.widget_invalid')` for any entry that is neither a `WidgetConfiguration` nor a string subclass of `Filament\Widgets\Widget`.
```

--------------------------------

### Register the Plugin

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Add the ActivityLogPlugin to your AdminPanelProvider to enable the plugin.

```php
use AlizHarb\ActivityLog\ActivityLogPlugin;
use App\Filament\Clusters\SystemCluster;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivityLogPlugin::make()
                ->label('Log')
                ->pluralLabel('Logs')
                ->navigationGroup('System')
                ->cluster(SystemCluster::class), // Optional: Group inside a cluster
        ]);
}
```

--------------------------------

### Configure tenant scoping with scopeActivitiesUsing

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Use this snippet to scope all package-owned activity queries to the current tenant. The closure receives the query and the tenant model, and applies a where clause on tenant_id when a tenant is present. Configure this once for tenant-separated applications.

```php
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

ActivityLogPlugin::make()
    ->scopeActivitiesUsing(
        fn (Builder $query, ?Model $tenant): Builder => $query->when(
            $tenant,
            fn (Builder $query): Builder => $query->where('tenant_id', $tenant->getKey()),
        ),
    );
```

--------------------------------

### configureRelationManagerTableUsing

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Same as configureTableUsing() but for the ActivitiesRelationManager table.

```APIDOC
## configureRelationManagerTableUsing(?Closure $callback): static

### Description
Same as configureTableUsing() but for the ActivitiesRelationManager table.

### Method
configureRelationManagerTableUsing

### Parameters
- **$callback** (?Closure) - Required - The closure to apply to the relation manager table.

### Returns
- **static** - The current instance for chaining.
```

--------------------------------

### Run filament-activity-log:verify-integrity

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ArtisanCommands.md

Executes the integrity verification command.

```bash
php artisan filament-activity-log:verify-integrity --chunk=500
```

--------------------------------

### Implement Custom Authorizer Class

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Create an invokable class to define custom access logic for the activity log.

```php
// app/Authorizer/ActivityLogAuthorizer.php
namespace App\Authorizer;

class ActivityLogAuthorizer
{
    public function __invoke(User $user): bool
    {
        // Define your custom logic to determine if the user can access the activity log.
        return $user->id === 1;
    }
}
```

--------------------------------

### Tag and push release

Source: https://github.com/alizharb/filament-activity-log/blob/main/docs/releasing.md

Commands to ensure the main branch is up to date, create a signed semantic version tag, and push it to the origin.

```bash
git switch main
git pull --ff-only origin main
git tag -s v2.0.0 -m "Release v2.0.0"
git push origin v2.0.0
```

--------------------------------

### Activity Model

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/SupportServices.md

Empty subclass of Spatie\Activitylog\Models\Activity. The package resolves the configured activity model via ActivityQuery::modelClass().

```APIDOC
## Activity Model

### Description
Empty subclass of `Spatie\Activitylog\Models\Activity`.

### Usage
The package resolves the configured activity model via `ActivityQuery::modelClass()`.
```

--------------------------------

### ActivityLogException::context

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/errors.md

Returns an array with the translation key and replacements for structured application logging.

```APIDOC
## ActivityLogException::context

### Description
Returns an array with the translation key and replacements for structured application logging.

### Method
context

### Signature
public function context(): array

### Returns
- **array** - Returns `['activity_log_error' => translationKey, 'activity_log_error_context' => replacements]`.
```

--------------------------------

### ActivityLogTimelineTableAction::make()

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/RelationManagerAndTimelineAction.md

Creates a new instance of the action with an optional name.

```APIDOC
## ActivityLogTimelineTableAction::make()

### Description
Creates a new instance of the action with an optional name.

### Method
PHP Static Method

### Signature
public static function make(?string $name = null): static

### Parameters
- $name (string|null) - Optional - The action name. Defaults to 'timeline'.

### Returns
static - A new action instance.
```

--------------------------------

### Enable Logging on Models

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Use the LogsActivity trait in your models to enable activity tracking.

```php
// Spatie v5:
use Spatie\Activitylog\Models\Concerns\LogsActivity;
use Spatie\Activitylog\Support\LogOptions;

class User extends Authenticatable
{
    use LogsActivity;

    public function getActivitylogOptions(): LogOptions
    {
        return LogOptions::defaults()
            ->logAll();
    }
}
```

--------------------------------

### ActivityLogServiceProvider

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/SupportServices.md

The service provider that configures the package, registers singletons, and wires model events. It extends Spatie\LaravelPackageTools\PackageServiceProvider and is auto-discovered.

```APIDOC
## ActivityLogServiceProvider

### Description
Service provider that configures the package, registers singletons, and wires model events.

### Class
`ActivityLogServiceProvider` extends `Spatie\LaravelPackageTools\PackageServiceProvider`

### Methods
- `configurePackage(Package $package): void` - Configures the package with config, translations, views, migration, and commands.
- `bootingPackage(): void` - Publishes CSS assets.
- `packageRegistered(): void` - Registers singletons for ActivityQuery, ActivityMutation, ActivityPruner, ActivityCache, AuditSchema, RetentionManager.
- `packageBooted(): void` - Registers ActivityPolicy, CSS asset, and model events.
- `getAssetPackageName(): string` - Returns the asset package name.
- `getAssets(): array` - Returns the assets to publish.

### Hooks
- `configurePackage()`: hasConfigFile(), hasTranslations(), hasViews() (namespace `filament-activity-log`), hasMigration('upgrade_activity_log_with_audit_control_columns'), hasCommands([InstallCommand, BackfillAuditMetadataCommand, VerifyIntegrityCommand, DoctorCommand]).
- `bootingPackage()`: Publishes `resources/css/filament-activity-log.css` to `resource_path('vendor/...')` (tag `filament-activity-log-styles`) and `public_path('vendor/...')` (tag `filament-activity-log-public`).
- `packageRegistered()`: Registers singletons: `ActivityQuery`, `ActivityMutation`, `ActivityPruner`, `ActivityCache`, `AuditSchema`, `RetentionManager`.
- `packageBooted()`: Registers `ActivityPolicy` for the activity model via `Gate::policy(...)`; registers the CSS asset with `FilamentAsset`; wires model events: on `created` → `AuditMetadata::persist()`, `AuditRuleEngine::evaluate()`, `ActivityCache::flush()`; on `deleted` → `ActivityCache::flush()`.

### Publish Tags
- `filament-activity-log-config`
- `filament-activity-log-migrations`
- `filament-activity-log-translations`
- `filament-activity-log-views`
- `filament-activity-log-styles`
- `filament-activity-log-public`
```

--------------------------------

### Customize Table Columns in Config

Source: https://github.com/alizharb/filament-activity-log/blob/main/README.md

Configure visibility, searchability, and sortability for table columns within the filament-activity-log.php configuration file.

```php
'table' => [
    'columns' => [
        'log_name' => [
            'visible' => true,
            'searchable' => true,
            'sortable' => true,
        ],
        // ...
    ],
],
```

--------------------------------

### Configure tenant isolation scope

Source: https://github.com/alizharb/filament-activity-log/blob/main/UPGRADE.md

Apply a global activity query scope for applications with tenant-separated data.

```php
ActivityLogPlugin::make()->scopeActivitiesUsing(
    fn (Builder $query, ?Model $tenant): Builder => $query->when(
        $tenant,
        fn (Builder $query): Builder => $query->where('tenant_id', $tenant->getKey()),
    ),
);
```

--------------------------------

### previewRevert(Activity $activity): array

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityMutation.md

Returns a preview of the revert operation, showing old, audited, and current values for each safe attribute, along with conflict detection.

```APIDOC
## previewRevert(Activity $activity): array

### Description
Returns an array of attribute previews for a potential revert. Each entry contains the old value, the audited new value, the current value on the subject, and a conflict flag indicating whether the current value differs from the audited value. Excludes system and sensitive attributes based on configuration.

### Method
previewRevert

### Signature
public function previewRevert(Activity $activity): array

### Parameters
- **$activity** (Activity) - Required - The activity to preview.

### Return Value
- **array** - Associative array mapping attribute names to arrays with keys: old, audited, current, conflict. Returns an empty array if the activity has no subject.
```

--------------------------------

### ActivityLogPlugin::register(Panel $panel)

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Registers the plugin with a Filament panel, including resources, widgets, middleware, and pages.

```APIDOC
## ActivityLogPlugin::register(Panel $panel)

### Description
Registers the plugin with the panel. This includes the configured resource, configured widgets, the ActivityLogContextMiddleware panel middleware, the UserActivitiesPage (when enabled), and the AuditDashboard page (when enabled).

### Method
public function register(Panel $panel): void

### Parameters
- **$panel** (Panel) - Required - The Filament panel to register the plugin with.

### Return Value
- **void**
```

--------------------------------

### configureTable

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Evaluates the configurator (['table' => $table]) and returns the resulting table, or the original table when no configurator is set.

```APIDOC
## configureTable(Table $table): Table

### Description
Evaluates the configurator (['table' => $table]) and returns the resulting table, or the original table when no configurator is set.

### Method
configureTable

### Parameters
- **$table** (Table) - Required - The table to configure.

### Returns
- **Table** - The configured table.
```

--------------------------------

### ActivityLogException::__construct

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/errors.md

Constructor for the base exception class. Accepts a translation key and optional replacements array, and an optional previous throwable.

```APIDOC
## ActivityLogException::__construct

### Description
Constructor for the base exception class. Accepts a translation key and optional replacements array, and an optional previous throwable.

### Method
__construct

### Signature
public function __construct(
    public readonly string $translationKey,
    public readonly array $replacements = [],
    ?Throwable $previous = null,
)

### Parameters
- **translationKey** (string) - Required - Stable key, e.g. `mutation.conflict`. Combined with the literal prefix `filament-activity-log::activity.exceptions.` to build the message.
- **replacements** (array) - Optional - `array<string, scalar>` used to interpolate the localized message.
- **previous** (Throwable) - Optional - Previous throwable for exception chaining.

### Returns
No return value (constructor).
```

--------------------------------

### ActivityTimeline and SpatieActivitySource class definitions

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityTimeline.md

The core class interfaces for ActivityTimeline and the default SpatieActivitySource.

```php
// ActivityTimeline
class ActivityTimeline
{
    public function for(Model $record, ?int $limit = null): Collection;
}

// SpatieActivitySource implements ProvidesTimelineActivities
class SpatieActivitySource
{
    public function activitiesFor(Model $record, int $limit): Collection;
}
```

--------------------------------

### scopeActivitiesUsing

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ActivityLogPlugin.md

Sets a per-panel activity query boundary. Accepts a closure, a string class name, or null. The closure receives a Builder and optional Model tenant and must return a Builder or null.

```APIDOC
## scopeActivitiesUsing(Closure|string|ScopesActivityQueries|null $scope): static

### Description
Sets a per-panel activity query boundary. A callable closure receives (Builder $query, ?Model $tenant) and must return a Builder or null. A string is a ScopesActivityQueries class name.

### Method
scopeActivitiesUsing

### Parameters
- **$scope** (Closure|string|ScopesActivityQueries|null) - Required - The scope to set.

### Returns
- **static** - The current instance for chaining.
```

--------------------------------

### Define filament-activity-log:verify-integrity signature

Source: https://github.com/alizharb/filament-activity-log/blob/main/_autodocs/api-reference/ArtisanCommands.md

The command signature definition for verifying activity integrity.

```php
protected $signature = 'filament-activity-log:verify-integrity {--chunk=500 : Records verified per chunk}';
```
Tokens:
Raw