PHPackages                             binomeway/nova-contact-tool - 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. [Mail & Notifications](/categories/mail)
4. /
5. binomeway/nova-contact-tool

AbandonedArchivedLibrary[Mail & Notifications](/categories/mail)

binomeway/nova-contact-tool
===========================

A Laravel Nova tool to configure contact details and send mails based on them.

v1.0.6(4y ago)015MITPHPPHP >=8.0

Since Jul 20Pushed 4y agoCompare

[ Source](https://github.com/binomeway/nova-contact-tool)[ Packagist](https://packagist.org/packages/binomeway/nova-contact-tool)[ RSS](/packages/binomeway-nova-contact-tool/feed)WikiDiscussions master Synced 5d ago

READMEChangelog (7)Dependencies (6)Versions (8)Used By (0)

Contact
=======

[](#contact)

[![Latest Version on Packagist](https://camo.githubusercontent.com/30583b135bf37d55a3f27285f401235107d34051eaff741e5f7a9560a14eb7cf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62696e6f6d657761792f6e6f76612d636f6e746163742d746f6f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/binomeway/nova-contact-tool)[![GitHub Tests Action Status](https://camo.githubusercontent.com/3cff33817a4a7b84c68ad59a47f3c52e13c1668ba27f2738489b6b0ca4915287/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f62696e6f6d657761792f6e6f76612d636f6e746163742d746f6f6c2f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/binomeway/nova-contact-tool/actions?query=workflow%3ATests+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/dff8d9ee1fbe63d3793dace62bc2595637f3a3b0b15daf2c4e677ef9a3a366b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62696e6f6d657761792f6e6f76612d636f6e746163742d746f6f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/binomeway/nova-contact-tool)

A package to manage contact information such as: email, phone, socials and forms.

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

[](#installation)

You can install the package via composer:

```
composer require binomeway/nova-contact-tool
```

Install nova-settings

```
composer require optimistdigital/nova-settings
```

Add the following line to the boot method within the NovaServiceProvider.php in order to be able to modify contact data withing Nova.

```
// NovaServiceProvider.php
public function tools()
{
    return [
        \OptimistDigital\NovaSettings\NovaSettings\NovaSettings::make(),
        \BinomeWay\NovaContactTool\NovaContactTool\NovaContactTool::make(),
    ];
}
```

You have to publish and run the migrations

```
php artisan vendor:publish --provider="BinomeWay\NovaContactTool\ToolServiceProvider" --tag="nova-contact-tool-migrations"
php artisan migrate
```

You can publish the config file with if needed.

```
php artisan vendor:publish --provider="BinomeWay\NovaContactTool\ToolServiceProvider" --tag="nova-contact-tool-config"
```

This is the contents of the published config file:

```
return [
    'default_to' => '',
    'default_subject' => '',
    'save_messages' => true,
    'save_subscribers' => true,
    'priority' => 3,
    'delete_on_unsubscribe' => false,
    'enable_gmail_api' => env('ENABLE_GMAIL_API', false),
];
```

Usage
-----

[](#usage)

### Subscribers

[](#subscribers)

Making a new subscriber.

```
use BinomeWay\NovaContactTool\Facades\Contact;

$subscriber = Contact::subscribe($email, $name, $phone);
```

```
use BinomeWay\NovaContactTool\Facades\Contact;

Contact::unsubscribe($subscriber);
```

### Sending Mails

[](#sending-mails)

Send emails easy as that.

```
use BinomeWay\NovaContactTool\Facades\Contact;

Contact::send($message, $subscriber);
```

Example

```
use BinomeWay\NovaContactTool\Facades\Contact;
use BinomeWay\NovaContactTool\Models\Subscriber;
// Perform validations
// Create a subscriber
$subscriber = new Subscriber();
// or use the subscribe method
$subscriber = Contact::subscribe($email, $name, $phone);

$message = 'Hello!';
$to = 'hello@binomeway.com'; // Optional

$contact = Contact::send($message, $subscriber, $to);

// Checking if the mail was sent.

if($contact->hasSucceded()){
     flash()->message('success', 'Yay! Email was sent.');
}

if($contact->hasFailed()){
    flash()->message('error', $contact->errorMessage());
}
```

### Sending using Gmail API

[](#sending-using-gmail-api)

First you need to enable the Gmail API features.

```
ENABLE_GMAIL_API=true
```

Further, add the credentials in the `.env` file.

```
GOOGLE_PROJECT_ID=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=
```

Or use a JSON credentials file by adding it to the path: `storage/gmail/tokens/gmail-json.json`

Adding more options

```
GOOGLE_ALLOW_MULTIPLE_CREDENTIALS=true
GOOGLE_ALLOW_JSON_ENCRYPT=true
```

Next step is to authorize a Gmail Account by using the admin panel.

That's it. Now you can use the same `send` method, and it will work.

*Note: The authorization login won't work on localhost. Gmail doesn't allow local domains*

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.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Codrin Axinte](https://github.com/codrin-axinte)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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 ~4 days

Total

7

Last Release

1739d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f68765a77418f8056ef39ed2491f2b2b544a58166a462bf3d5f1332d539241d4?d=identicon)[codrin-axinte](/maintainers/codrin-axinte)

---

Top Contributors

[![codrin-axinte](https://avatars.githubusercontent.com/u/6564791?v=4)](https://github.com/codrin-axinte "codrin-axinte (9 commits)")

---

Tags

laravelnovalaravelcontactnova

### Embed Badge

![Health badge](/badges/binomeway-nova-contact-tool/health.svg)

```
[![Health](https://phpackages.com/badges/binomeway-nova-contact-tool/health.svg)](https://phpackages.com/packages/binomeway-nova-contact-tool)
```

###  Alternatives

[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)[wnx/laravel-sends

Keep track of outgoing emails in your Laravel application.

200427.3k](/packages/wnx-laravel-sends)[spatie/laravel-discord-alerts

Send a message to Discord

151408.0k](/packages/spatie-laravel-discord-alerts)[inspheric/nova-email-field

A Laravel Nova email field.

33456.9k1](/packages/inspheric-nova-email-field)[spatie/laravel-mailcoach-sdk

An SDK to easily work with the Mailcoach API in Laravel apps

41290.2k1](/packages/spatie-laravel-mailcoach-sdk)[coreproc/nova-notification-feed

A Laravel Nova package that adds a notification feed in your Nova app.

10149.1k](/packages/coreproc-nova-notification-feed)

PHPackages © 2026

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