PHPackages                             postare/filament-contact-logs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. postare/filament-contact-logs

ActiveLibrary[Utility & Helpers](/categories/utility)

postare/filament-contact-logs
=============================

Filament Contact Logs

1.0.1(2y ago)181MITPHPPHP ^8.1

Since Dec 1Pushed 2y ago1 watchersCompare

[ Source](https://github.com/postare/filament-contact-logs)[ Packagist](https://packagist.org/packages/postare/filament-contact-logs)[ Docs](https://github.com/postare/filament-contact-logs)[ GitHub Sponsors](https://github.com/postare)[ RSS](/packages/postare-filament-contact-logs/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (10)Versions (3)Used By (0)

Filament Contact Logs
=====================

[](#filament-contact-logs)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b087b26148de3c4bd8a0ad7066dec4318a3146b49507edc9404dc96d4512df47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706f73746172652f66696c616d656e742d636f6e746163742d6c6f67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/postare/filament-contact-logs)[![GitHub Tests Action Status](https://camo.githubusercontent.com/d69c5953b8f753ac9f8e5d7c395cb04803a685f0c79c439012c9308761e7e4a5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706f73746172652f66696c616d656e742d636f6e746163742d6c6f67732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/postare/filament-contact-logs/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/05000b3de31be0555c77cff88b182eda426527bab1b49a1cbbf3507fb57b314f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f706f73746172652f66696c616d656e742d636f6e746163742d6c6f67732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/postare/filament-contact-logs/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/036aaf94e41fea7687498b017befa269d9947b04c0b07adb5e4c4800128c6f26/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706f73746172652f66696c616d656e742d636f6e746163742d6c6f67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/postare/filament-contact-logs)

Filament Contact Logs is a Filament 3.x plugin that performs a clear and critical function: it records in a log every time a contact is sent. Regardless of the contact's final destination, the plugin ensures that each submission is tracked in detail. This allows operators to have a complete history of all communications received, providing a clear and organized picture of interactions and feedback. Thus, its main function is to ensure total traceability of contacts, facilitating management and follow-up by operators.

Installation
------------

[](#installation)

Install the package via composer:

```
composer require postare/filament-contact-logs
```

Publish and run the migrations:

```
php artisan vendor:publish --tag="filament-contact-logs-migrations"
php artisan migrate
```

Publish the config file:

```
php artisan vendor:publish --tag="filament-contact-logs-config"
```

Published config file contents:

```
return [
    /*
     * When the clean-command is executed, all recording activities older than
     * the number of days specified here will be deleted.
     */
    'delete_records_older_than_days' => 365,

    /*
     * Model to use to log activity.
     */
    'contact_log_model' => \Postare\FilamentContactLogs\Models\ContactLog::class,

    /*
     * List of Models associated with contact messages, it is not mandatory
     * to specify them, it is for obtaining a more user-friendly table.
     */
    'mappings' => [
        //        EXAMPLE:
        //        'App\Models\Property' => [
        //            'type' => 'Property',
        //            'pluralType' => 'Properties',
        //            'label' => 'ID: {id}',
        //            'titleField' => 'name',
        //            'route' => 'property',
        //            'record_identifier' => 'slug',
        //        ],
    ],
];
```

Usage
-----

[](#usage)

### Integrating with Filament Panel

[](#integrating-with-filament-panel)

```
// app\Providers\Filament\AdminPanelProvider.php
$panel
    ...
    ->plugins([
        ...
        \Postare\FilamentContactLogs\FilamentContactLogsPlugin::make(),
    ]);
```

### Associating Models with Contact Logs

[](#associating-models-with-contact-logs)

```
// Use HasContactLogs trait in your model
use Postare\FilamentContactLogs\Traits\HasContactLogs;
```

### Examples

[](#examples)

Add a contact log to a model:

```
Property::find(1)->addContactLog([
    'content' => 'A beautiful message',
    'subject' => 'A subject',
    'sender_id' => auth()?->id(),       // optional
    'sender_email' => 'user@email.com',
    'sender_name' => 'John Doe',
    'sender_phone' => '1234567890',     // optional
]);
```

Add a contact log without a model:

```
contactLog([
    'content' => 'A beautiful message',
    'subject' => 'A subject',
    'sender_id' => auth()?->id(),       // optional
    'sender_email' => 'user@email.com',
    'sender_name' => 'John Doe',
    'sender_phone' => '1234567890',     // optional
]);
```

### Auto-Deleting Logs

[](#auto-deleting-logs)

Automatically delete logs based on config settings:

```
// Add the following to your app\Console\Kernel.php
protected function schedule(Schedule $schedule): void
{
    $schedule->command('contact-logs:clean')->daily();
}
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Francesco Apruzzese](https://github.com/inerba)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~102 days

Total

2

Last Release

790d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9951f7bf6251c81aceb7df0a295359cd0d2356543350c6a1a988d4b60f3f981?d=identicon)[inerba](/maintainers/inerba)

---

Top Contributors

[![inerba](https://avatars.githubusercontent.com/u/5882517?v=4)](https://github.com/inerba "inerba (2 commits)")

---

Tags

laravelpostarefilament-contact-logs

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/postare-filament-contact-logs/health.svg)

```
[![Health](https://phpackages.com/badges/postare-filament-contact-logs/health.svg)](https://phpackages.com/packages/postare-filament-contact-logs)
```

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[swisnl/filament-backgrounds

Beautiful backgrounds for Filament auth pages

54149.2k6](/packages/swisnl-filament-backgrounds)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)