PHPackages                             enginedigital/model-notes - 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. [Security](/categories/security)
4. /
5. enginedigital/model-notes

ActiveLibrary[Security](/categories/security)

enginedigital/model-notes
=========================

Create notes on eloquent models. Supports multiple note types as well as multi-tenancy

1.7.0(4y ago)01.6k1MITPHPPHP ^8.0

Since Jul 28Pushed 4y ago3 watchersCompare

[ Source](https://github.com/enginedigital/model-notes)[ Packagist](https://packagist.org/packages/enginedigital/model-notes)[ Docs](https://github.com/enginedigital/model-notes)[ GitHub Sponsors](https://github.com/EngineDigital)[ RSS](/packages/enginedigital-model-notes/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (9)Dependencies (8)Versions (13)Used By (0)

Create notes on eloquent models. Supports multiple note types as well as multi-tenancy
======================================================================================

[](#create-notes-on-eloquent-models-supports-multiple-note-types-as-well-as-multi-tenancy)

[![Latest Version on Packagist](https://camo.githubusercontent.com/0e56d80b99d0c7d84869867d998ea7288986c5f5dcb98e671eb4a31a278f55a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656e67696e656469676974616c2f6d6f64656c2d6e6f7465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/enginedigital/model-notes)[![GitHub Tests Action Status](https://camo.githubusercontent.com/c7b590f189e84ea4f9dcbc1468cb4dc5f07c2579b804101d26daf219f414e552/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f656e67696e656469676974616c2f6d6f64656c2d6e6f7465732f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/enginedigital/model-notes/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/23a40ee793189e1974a4ea39770c255c1ea8415f1b0a9149826b1316d4b68aac/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f656e67696e656469676974616c2f6d6f64656c2d6e6f7465732f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/enginedigital/model-notes/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/3d1fafebccd5365cf3de3702fbcbacd00faff5ed05ba6476898edbe7afb643e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656e67696e656469676974616c2f6d6f64656c2d6e6f7465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/enginedigital/model-notes)

> Create notes on eloquent models. Supports multiple note types as well as multi-tenancy.

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

[](#installation)

You can install the package via composer:

```
composer require enginedigital/model-notes
```

You can publish and run the migrations with:

```
php artisan vendor:publish --provider="EngineDigital\Note\NoteServiceProvider" --tag="model-notes-migrations"
php artisan migrate
```

You can publish the config file with:

```
php artisan vendor:publish --provider="EngineDigital\Note\NoteServiceProvider" --tag="model-notes-config"
```

This is the contents of the published config file:

```
return [
    'note_model' => EngineDigital\Note\Note::class,
    'note_default_type' => 'none',
    'note_default_group' => 'admin',
    // key => 'formatter_class_with_invoke',
    // key => ['formatter', 'method'],
    'note_types' => [
        'none' => null, // dont touch formatted output
        'plain' => 'e', // escape in formatted output
        'html' => null, // dont touch formatted output
        'markdown' => [\Illuminate\Support\Str::class, 'markdown'],
        'json' => 'json_decode', // treat the note content as JSON
    ],
    'model_primary_key_attribute' => 'model_id',
    'encrypt_notes' => false,
    'tenant_model' => null, // App\Models\Company::class
    'tenant_resolver' => null, // a class that uses `__invoke` or a container function to get the id of the current tenant
    'author_model' => null, // App\Models\User::class
    'author_resolver' => null, // a class that uses `__invoke` or a container function to get the id of the current user
    'cache_time' => null, // cache time in seconds
    'load_with' => [], // which note relationships to eager load. Example: ['author', 'author.profile', 'author.roles'] or only specific columns ['author:id,name']
];
```

Usage
-----

[](#usage)

```
// User model uses EngineDigital\Note\HasNotes
$user->setNote('This is my cute little note!');
```

Testing
-------

[](#testing)

```
composer run test
```

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

[](#contributing)

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

Credits
-------

[](#credits)

- [James Doyle](https://github.com/james2doyle)
- [Tim Wernke](https://github.com/tawernke)

License
-------

[](#license)

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

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 75.7% 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 ~36 days

Recently: every ~49 days

Total

9

Last Release

1462d ago

### Community

Maintainers

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

---

Top Contributors

[![james2doyle](https://avatars.githubusercontent.com/u/1425304?v=4)](https://github.com/james2doyle "james2doyle (28 commits)")[![tawernkeed](https://avatars.githubusercontent.com/u/49538720?v=4)](https://github.com/tawernkeed "tawernkeed (9 commits)")

---

Tags

laravelencryptionnotestenantmulti-tenancyEngineDigital

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/enginedigital-model-notes/health.svg)

```
[![Health](https://phpackages.com/badges/enginedigital-model-notes/health.svg)](https://phpackages.com/packages/enginedigital-model-notes)
```

###  Alternatives

[spatie/laravel-ciphersweet

Use ciphersweet in your Laravel project

416718.4k1](/packages/spatie-laravel-ciphersweet)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[ercsctt/laravel-file-encryption

Secure file encryption and decryption for Laravel applications

642.6k](/packages/ercsctt-laravel-file-encryption)

PHPackages © 2026

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