PHPackages                             silverstripeltd/user-configurable-smime-forms - 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 &amp; Notifications](/categories/mail)
4. /
5. silverstripeltd/user-configurable-smime-forms

ActiveSilverstripe-vendormodule[Mail &amp; Notifications](/categories/mail)

silverstripeltd/user-configurable-smime-forms
=============================================

A module for extending user forms, so that form submissions can be emailed with S/MIME encryption.

0.0.4(3y ago)123BSD-3-ClausePHPPHP ^8.0 || ^8.1

Since Feb 23Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/silverstripeltd/user-configurable-smime-forms)[ Packagist](https://packagist.org/packages/silverstripeltd/user-configurable-smime-forms)[ RSS](/packages/silverstripeltd-user-configurable-smime-forms/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (15)Versions (9)Used By (0)

SilverStripe SMIME Forms
========================

[](#silverstripe-smime-forms)

This module provides an extension to [Silverstripe Elemental User Forms](https://github.com/dnadesign/silverstripe-elemental-userforms)that allows you to choose whether or not the emails for form submissions should be encrypted and/or digitally signed, for added security.

It uses S/MIME encryption.

Requirements
------------

[](#requirements)

- SilverStripe ^5
- SilverStripe Elemental Forms

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

[](#installation)

To start using this module, just add it as a dependency to your project.

```
composer require silverstripeltd/user-configurable-smime-forms

```

License
-------

[](#license)

See [License](license.md)

Documentation
-------------

[](#documentation)

When configuring user forms within the CMS you can specify whether the submitted form data is emailed to a list of Recipients.

This module provides an additional option to encrypt the email. This is specifically useful when you are sending emails to known recipients, and requires the recipient's encryption certificate (.crt file). This module adds an admin section (ModelAdmin) for managing and uploading S/MIME certificates for the purpose of encryption and digital signing of emails.

### Enable Encryption of Emails

[](#enable-encryption-of-emails)

To enable encryption, go to the **Configuration** tab for your form and check the **Enable S/MIME Encryption** option. With this option set when a form submission is sent to a recipient the system will check for an uploaded encryption certificate for that user. Note: If one does not yet exist the email will be sent unencrypted with a warning (**UNENCRYPTED: CHECK CMS CONFIGURATION**) added to the email subject.

[![](./docs/assets/EncryptionOption.png)](./docs/assets/EncryptionOption.png)

### Managing S/MIME Certificates

[](#managing-smime-certificates)

This module adds an S/MIME Certificates ModelAdmin to the CMS left hand menu for managing encryption and signing certificates and by default it is available to administrators with full access rights.

To provide specific CMS groups (e.g., IT administrator users) with the ability to manage these certificates, you can add the `Manage S/MIME certificates` permission to their permissions group in the Security section of the CMS.

[![](./docs/assets/CertificatesModelAdmin.png)](./docs/assets/CertificatesModelAdmin.png)

### Adding recipient encryption certificates

[](#adding-recipient-encryption-certificates)

To add encryption certificates to the CMS:

- Log into the CMS as an administrator or user/group with the **Manage S/MIME certificates** permission
- From the CMS left hand menu select **S/MIME Certificates**
- The default view shows a grid view of uploaded encryption certificates.
- Click on **Add Encryption Certificate**
- Enter a valid **Email address**
- Upload a valid `.crt` file to the **Encryption Certificate** field
- Click **Create**

[![](./docs/assets/RecipientCertificate.png)](./docs/assets/RecipientCertificate.png)

### Adding sender certificates for digitally signing emails

[](#adding-sender-certificates-for-digitally-signing-emails)

This module supports digital signing of emails, which provides further assurance for the recipient of where the email comes from.

To sign an email you need both the certificate .pem and private key .pem files. To upload these into the CMS:

- Log into the CMS as an administrator or user/group with the **Manage S/MIME certificates** permission
- From the CMS left hand menu select **S/MIME Certificates**
- Select the **Signing Certificates** tab
- Click on **Add Signing Certificate**
- Enter a valid **Email address**
- Upload a valid `.pem` file containing the certificate to the **Signing Certificate** field
- Upload a valid `.pem` file containing the private key to the **Signing Key** field
- Enter the passphrase for the `.pem` file (this will not be shown and will be stored in an encrypted format)
- Click **Create**

Maintainers
-----------

[](#maintainers)

- Andrew Dunn
- Paul Jayme

Bugtracker
----------

[](#bugtracker)

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

- Create a new issue
- Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
- Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution
----------------------------

[](#development-and-contribution)

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance59

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.4% 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 ~9 days

Total

5

Last Release

1191d ago

Major Versions

0.0.4 → 4.x-dev2023-03-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/6171b1ee49749a6bae03341370fb418481ad8ea004f078dfd65612f58c8574b1?d=identicon)[edwilde](/maintainers/edwilde)

![](https://www.gravatar.com/avatar/c908aac2ff1c0c0763a662df79bd03e53edcb12fb3115a7304f7e6892e0751ec?d=identicon)[silverstripe-serviceaccount-ssltd](/maintainers/silverstripe-serviceaccount-ssltd)

![](https://www.gravatar.com/avatar/69462a6c2cf3f553ade59e0221748542f342abbc015e4f3d95d189953f813882?d=identicon)[adunn49](/maintainers/adunn49)

---

Top Contributors

[![edwilde](https://avatars.githubusercontent.com/u/415374?v=4)](https://github.com/edwilde "edwilde (5 commits)")[![pjayme](https://avatars.githubusercontent.com/u/27745093?v=4)](https://github.com/pjayme "pjayme (2 commits)")

---

Tags

encryptionemailsilverstripecmsFormssmime

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/silverstripeltd-user-configurable-smime-forms/health.svg)

```
[![Health](https://phpackages.com/badges/silverstripeltd-user-configurable-smime-forms/health.svg)](https://phpackages.com/packages/silverstripeltd-user-configurable-smime-forms)
```

###  Alternatives

[silverstripe/cms

The SilverStripe Content Management System

5253.6M1.4k](/packages/silverstripe-cms)[lekoala/silverstripe-mandrill

Adds mandrill in the SilverStripe CMS

1927.4k](/packages/lekoala-silverstripe-mandrill)[unclecheese/silverstripe-permamail

Adds database storage of emails and CMS definition of email templates.

2114.9k](/packages/unclecheese-silverstripe-permamail)

PHPackages © 2026

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