Contact Form - Magento 2 module documentation

Author: Marek Milewski

Contact Form Module

Module overview

Contact Form allows you to create your own, highly customizable contact forms in Magento 2. You do not need to have any coding skills. Simply create and configure a field and decide whether you want to include it in your form or just save it for later.

Module compatibility

This module is compatibile with Magento Community versions: 2.2 and 2.3.

How it works

After installing the module, default Contact Us fields provided with Magento 2 will be erased. To add your custom form fields, head to Admin Panel go to Content > Form Fields. Click on Add New Field button to create your own field.

Image 14

Image 4

Enable – turns on or off visibility of the field
Label – set name for label
Type – pick input type:

  • Text - short text inputs
  • Textarea - longer text inputs
  • Select - create your custom options from which user will pick one

Image 3

  • Email list - create list of emails for user to pick

Image 3

  • Reply to - lets user add email to which replay will be send to
  • Subject - lets user write subject for email

Required – set if field is required to be filled
Validation Type - set validation type for your field input
Sort Order - fill with number to keep your fields in desired order
Store View – a store/store view that this fields should be visible in

Your newly created fields will be shown, where Contact Us form was before (in homepage/contact).

Image 6

Module is fully compatible with Magento 2 native functions, so you can with no problem add captcha to your custom Contact Us Form (Stores > Configuration > Customers > Customer Configuration > Captcha.

Image 5

To configure Sender and Recipient of Contact Form, go to Admin Panel Stores > Configuration > General > Contacts > Email Options.

Email Options En

Send Emails To - e-mail address to which Contact Form should be sent (Recipient)
Email Sender - e-mail address from which Contact Form should be sent (Sender)

Demo

Installation

Composer

  1. Add repo to composer.json:
"repositories": [
    ...
    {
        "type": "vcs",
        "url": "git@git.auroracreation.com:aurora-modules/aurora-contact.git"
    }
    ...
],
  1. Add package to composer.json:
"require": {
    ...
    "aurora/contact-form": "*"
    ...
},
  1. In Magento root folder run commands:
composer update aurora/contact-form
php bin/magento module:enable Aurora_Contact
php bin/magento setup:upgrade

Manual

  1. Unzip archive.
  2. Upload extension files on your server to:
{Magento root}
└── app/
    └── code
  1. In Magento root folder run commands:
php bin/magento module:enable Aurora_Contact
php bin/magento setup:upgrade

Thank you for your interest in our products!

ChangeLog

v1.1.19

  • Update gitlab ci
  • Fix ReCaptcha validation
  • Fix validation in js
  • PSR improvement

v1.1.18

  • Improved controllers
  • Added translated name of Add Field/Edit Field button
  • PSR improvement
  • Improved error information
  • Improved the logic of sending a contact inquiry
  • Improved validation of sent data

v1.1.17

  • Fix DataProvider

v1.1.16

  • Field creation/editing controller improved
  • Fix DataProvider

v1.1.15

  • Improved contact form field list - removing uicomponent context

v1.1.14

  • Fixed a bug with displaying form fields

v1.1.13

  • Improved contact form field list - using uicomponent context

v1.1.13

  • Fix validation of non-required fields

v1.1.12

  • Downgrading Magento required version

v1.1.11

  • Fix validation of non-required fields

v1.1.10

  • Update enabling operation on Magento 2.4
  • PSR improvement
  • Added TypeHint
  • Added strict_types
  • Correction of copyrights

v1.1.9

  • Added option: contact page title and description configurable for each store view

v1.1.8

  • Correction of copyright
  • Added option: Placing information about the privacy policy in the contact form
  • Added option: Consent to data processing as select
  • Added option: Content of information about consent to data processing
  • Added information about required fields
  • Added translations

v1.1.7

  • Correction of copyright in readme

v1.1.6

  • Fixed column types in db_schema

v1.1.5

  • Changing the way of creating a table in the database - using db_schema

v1.1.4

  • PSR improvement

v1.1.3

  • PSR improvement
  • Improved the display of the contact form
  • Added serializer interface
  • Improved UnitTests

v1.1.2

  • Improved UnitTest
  • PSR improvement

v1.1.1

  • Correction of copyright

v1.0.5

  • Update enabling operation on Magento 2.3

v1.0.4

  • Added display of error information

v1.0.3

  • Fields form refactoring