PHPackages                             philippoehrlein/kirby-email-manager - 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. philippoehrlein/kirby-email-manager

ActiveKirby-plugin

philippoehrlein/kirby-email-manager
===================================

A Kirby plugin for managing email templates

1.1.0(3mo ago)227↓50%proprietaryPHPPHP >=8.1.0

Since Oct 18Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/philippoehrlein/kirby-email-manager)[ Packagist](https://packagist.org/packages/philippoehrlein/kirby-email-manager)[ Docs](https://email-manager.philippoehrlein.de)[ RSS](/packages/philippoehrlein-kirby-email-manager/feed)WikiDiscussions main Synced 1mo ago

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

Kirby Email Manager
===================

[](#kirby-email-manager)

[![License](https://camo.githubusercontent.com/ccc9333ff49f88664037095560cb9838344b4308d6c220a087f9103263b00586/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d50726f70726965746172792d677265656e)](https://camo.githubusercontent.com/ccc9333ff49f88664037095560cb9838344b4308d6c220a087f9103263b00586/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d50726f70726965746172792d677265656e)[![Version](https://camo.githubusercontent.com/1be24fb8c15dfc0fbcefb8d7da7e795ea189b1297b5e3640d4d51b1cf6953af3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d312e312e302d626c7565)](https://camo.githubusercontent.com/1be24fb8c15dfc0fbcefb8d7da7e795ea189b1297b5e3640d4d51b1cf6953af3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d312e312e302d626c7565)

The **Email Manager** is a powerful plugin for [Kirby CMS](https://getkirby.com/) that simplifies email form creation and management. Designed for developers, it ensures a seamless experience while giving CMS users the flexibility to adapt content dynamically.

[![Cover Kirby Email Manager](.github/kirby-email-manager-cover.png)](.github/kirby-email-manager-cover.png)

> Complete documentation is available in the [Email Manager Documentation](https://email-manager.philippoehrlein.de).

Features
--------

[](#features)

- **Quick Setup:** Forms ready in minutes.
- **Customizable:** Adapt snippets and keep layouts flexible.
- **Your Styles:** Use your own CSS classes for full design control.
- **Extensible:** Add custom CAPTCHA solutions and webhooks.
- **Secure:** CSRF protection, validation, optional rate limiting.
- **Spam Protection:** Filters block bots and unwanted submissions.
- **Easy to Use:** Use as blocks or tabs via blueprints; manage in the Panel.
- **Stay Compliant:** Maintain texts and policies directly in the Panel.
- **Multi Email:** Route to different recipients based on user input.

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

[](#installation)

### Composer Installation (recommended)

[](#composer-installation-recommended)

Run the following command in your site's root folder:

```
composer require philippoehrlein/kirby-email-manager
```

### Manual Installation

[](#manual-installation)

1. Download and extract the plugin
2. Copy the `kirby-email-manager` folder to `/site/plugins/`

Quick Start
-----------

[](#quick-start)

### 1. Configure Kirby for Email Sending

[](#1-configure-kirby-for-email-sending)

In your Kirby configuration file (`site/config/config.php`), set up the email transport settings. It's recommended to use a noreply email address for sending emails:

```
return [
    'email' => [
        'noreply' => 'no-reply@yourdomain.com',
        'transport' => [
            'type' => 'smtp',
            'host' => 'smtp.server.com',
            'port' => 465,
            'security' => true,
            'auth' => true,
            'username' => 'SMTP_USERNAME',
            'password' => 'SMTP_PASSWORD'
        ]
    ]
];
```

> ⚠️ Don't store credentials directly in the production configuration. Consider using the [Kirby ENV Plugin](https://github.com/beebmx/kirby-env) to manage sensitive credentials.

### 2. Create the Email Template

[](#2-create-the-email-template)

#### Blueprint

[](#blueprint)

Create the file `site/blueprints/emails/contact-form.yml`:

```
type: managed-template
name: Contact Form

emails:
  mail:
    subject: Contact Form Submission
    sender: Contact Form

fields:
  name:
    label: Name
    placeholder: Enter your name
    type: text
    required: true
    validate: alpha
    username: true
  email:
    label: Email
    placeholder: Enter your email
    type: email
    required: true
    replyto: true
  message:
    label: Message
    placeholder: Enter your message
    type: textarea
    resizable: vertical
    rows: 6
    required: true
    minlength: 10
```

#### Email Template File (optional)

[](#email-template-file-optional)

If you don't create custom templates, the plugin uses built-in default templates (mail + reply). To customize, create `site/templates/emails/contact-form/mail.text.php`:

```
From:

Name:

Message:

```

### 3. Add the Form to a Page

[](#3-add-the-form-to-a-page)

#### Blueprint

[](#blueprint-1)

Create `site/blueprints/pages/contact.yml`:

```
title: Contact Page

tabs:
  email-manager: email-manager
```

#### Page Template

[](#page-template)

Create `site/templates/contact.php`:

```