Skip to content

Adds a bunch of additional controls (cc, bcc, reply-to, plaintext) to the Craft CMS Contact Form plugin.

License

Notifications You must be signed in to change notification settings

miranj/craft-contact-form-tuner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contact Form Tuner icon

Contact Form Tuner

This Craft CMS plugin extends functionality offered by the official Contact Form plugin by allowing you to:

  • Control Cc recipients
  • Control Bcc recipients
  • Control Reply-To recipients
  • Force plain text only emails
  • Use a custom template for the plain text email body
  • Use a custom template for the HTML email body

Contents

Configuration

All settings for this plugin can be configured from the Control Panel under Settings → Contact Form Tuner. You can also configure the plugin programmatically by creating a contact-form-tuner.php file in your config/ folder. This file supports Craft's standard multi-environment configurations, and any values defined here will override those set via the Control Panel.

Here is a sample config file along with a list of all possible settings and their default values:

<?php

return [
    'ccEmail'       => '',      // e.g. 'ccme@example.com' or ['one@example.com', 'two@example.com']
    'ccName'        => '',
    'bccEmail'      => '',
    
    'hideReplyTo'   => false,
    'replyToEmail'  => '',      // leaving this empty preserves the reply-to set by Contact Form
    'replyToName'   => '',
    
    'textOnly'      => false,   // enabling this forces the email to be sent in plain text only
    
    'textTemplate'  => '',      // templates have access to submitted values
    'htmlTemplate'  => '',      // such as `fromName`, `fromEmail`, `subject` and `message`
];

Installation

You can install this plugin from the Plugin Store or with Composer.

From the Plugin Store

Go to the Plugin Store in your project’s Control Panel and search for “Contact Form Tuner”. Then click on the “Install” button in its modal window.

Using Composer

Open your terminal and run the following commands:

# go to the project directory
cd /path/to/project

# tell composer to use the plugin
composer require miranj/craft-contact-form-tuner

# tell Craft to install the plugin
./craft plugin/install contact-form-tuner

Requirements

This plugin requires Craft CMS 3, 4, or 5 and the Contact Form plugin (v2.0, v3.0 or later).


Brought to you by Miranj

About

Adds a bunch of additional controls (cc, bcc, reply-to, plaintext) to the Craft CMS Contact Form plugin.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published