PHPackages                             idoneo/humano-mailer - 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. idoneo/humano-mailer

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

idoneo/humano-mailer
====================

Email marketing and messaging system for Humano applications

v0.1.3(7mo ago)08AGPL-3.0PHPPHP ^8.1|^8.2|^8.3|^8.4

Since Sep 28Pushed 7mo agoCompare

[ Source](https://github.com/diego-mascarenhas/humano-mailer)[ Packagist](https://packagist.org/packages/idoneo/humano-mailer)[ Docs](https://github.com/diego-mascarenhas/humano-mailer)[ RSS](/packages/idoneo-humano-mailer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (15)Versions (5)Used By (0)

Humano Mailer
=============

[](#humano-mailer)

A comprehensive email marketing and messaging system for Laravel applications, designed specifically for the Humano ecosystem.

Features
--------

[](#features)

- **Email Campaigns**: Create and manage email marketing campaigns
- **Multiple Providers**: Support for SMTP and generic email APIs (MailBaby, Mailgun, SendGrid, etc.)
- **Message Templates**: Integration with template system for rich HTML emails
- **Contact Management**: Target specific contact categories and statuses
- **Tracking & Analytics**: Open tracking, click tracking, and detailed statistics
- **Team-based**: Multi-tenant support with team isolation
- **Rate Limiting**: Configurable sending limits and delays between emails
- **Unsubscribe Management**: Automatic unsubscribe handling
- **Campaign Controls**: Start, pause, and monitor campaigns
- **Test Sending**: Send test emails before launching campaigns

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

[](#installation)

Install the package via Composer:

```
composer require idoneo/humano-mailer
```

Publish and run the migrations:

```
php artisan vendor:publish --tag="humano-mailer-migrations"
php artisan migrate
```

Optionally, publish the config file:

```
php artisan vendor:publish --tag="humano-mailer-config"
```

Configuration
-------------

[](#configuration)

The package automatically registers the "Mailer" module in your application. Configure your email providers in the `.env` file:

### SMTP Configuration (Default)

[](#smtp-configuration-default)

```
MAIL_MAILER=smtp
MAIL_HOST=your-smtp-host
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
```

### Email API Configuration (MailBaby, Mailgun, etc.)

[](#email-api-configuration-mailbaby-mailgun-etc)

For external email service providers, use these simplified variables:

```
# Generic API configuration - works with any email service
MAIL_API_KEY=your-api-key-here
MAIL_API_DOMAIN=your-domain.com  # Optional, only if your provider needs it

# Examples:
# For MailBaby: MAIL_API_KEY=your-mailbaby-api-key
# For Mailgun: MAIL_API_KEY=your-mailgun-secret-key and MAIL_API_DOMAIN=your-domain.mailgun.org
# For SendGrid: MAIL_API_KEY=your-sendgrid-api-key
```

The package will automatically detect if you have an API key configured and enable API-based sending.

Usage
-----

[](#usage)

### Creating Messages

[](#creating-messages)

Messages can be created through the web interface or programmatically:

```
use Idoneo\HumanoMailer\Models\Message;

$message = Message::create([
    'name' => 'Welcome Campaign',
    'type_id' => 1,
    'template_id' => 1,
    'text' => 'Welcome to our platform!',
    'status_id' => 1,
    'team_id' => auth()->user()->currentTeam->id,
]);
```

### Starting Campaigns

[](#starting-campaigns)

Campaigns can be started through the web interface or API:

```
$message = Message::find(1);
$message->update([
    'status_id' => 1, // Active
    'started_at' => now(),
]);
```

### Tracking

[](#tracking)

The package provides comprehensive tracking:

- **Open Tracking**: Tracks when emails are opened
- **Click Tracking**: Tracks link clicks within emails
- **Delivery Status**: Monitors delivery success/failure
- **Unsubscribe Tracking**: Handles unsubscribe requests

Models
------

[](#models)

### Message

[](#message)

The main campaign model with relationships to:

- `MessageType`: Campaign type (newsletter, promotional, etc.)
- `Category`: Target contact category
- `Template`: Email template for HTML content
- `MessageDelivery`: Individual email deliveries

### MessageDelivery

[](#messagedelivery)

Individual email delivery records with:

- Delivery status tracking
- Provider-specific data
- Open/click timestamps
- Error handling

### MessageType

[](#messagetype)

Campaign types for categorizing messages.

Routes
------

[](#routes)

The package registers the following routes:

- `GET /message/list` - List all messages
- `GET /message/create` - Create new message form
- `GET /message/{id}` - View message details
- `POST /message/{id}/start` - Start campaign
- `POST /message/{id}/pause` - Pause campaign
- `POST /message/{id}/test` - Send test email

Team Integration
----------------

[](#team-integration)

The package is designed for multi-tenant applications:

- All models are scoped to teams automatically
- Email configuration can be team-specific
- Statistics and deliveries are isolated by team

Dependencies
------------

[](#dependencies)

- `spatie/laravel-package-tools`: Package development tools
- `yajra/laravel-datatables-oracle`: DataTables integration
- `guzzlehttp/guzzle`: HTTP client for API calls
- `tijsverkoyen/css-to-inline-styles`: Email CSS processing

License
-------

[](#license)

This package is licensed under the [GNU AGPLv3](https://www.gnu.org/licenses/agpl-3.0.html).

Support
-------

[](#support)

For support and documentation, visit the [Humano documentation](https://docs.humano.app) or contact .

###  Health Score

33

—

LowBetter than 74% of packages

Maintenance68

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

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

Total

4

Last Release

218d ago

### Community

Maintainers

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

---

Top Contributors

[![diego-mascarenhas](https://avatars.githubusercontent.com/u/1038571?v=4)](https://github.com/diego-mascarenhas "diego-mascarenhas (12 commits)")

---

Tags

laravelemailmailermessagingnewslettercampaignsidoneohumano

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/idoneo-humano-mailer/health.svg)

```
[![Health](https://phpackages.com/badges/idoneo-humano-mailer/health.svg)](https://phpackages.com/packages/idoneo-humano-mailer)
```

###  Alternatives

[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[fedeisas/laravel-mail-css-inliner

Inline the CSS of your HTML emails using Laravel

5974.6M3](/packages/fedeisas-laravel-mail-css-inliner)[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[propaganistas/laravel-disposable-email

Disposable email validator

5762.6M6](/packages/propaganistas-laravel-disposable-email)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[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)

PHPackages © 2026

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