Better Contact Form: setup and help

1. Upload the Better Contact Form ZIP in Modules > Module Manager and open Configure.
2. Open Contact Form > Forms and edit Default Contact Form.
3. Review Form Title, Description, Admin Email, Success Message and GDPR Label in each language.
4. Open Fields and check the installed name, email, phone, subject and message fields.
5. Configure the contact page and email settings described below.
6. Submit a test message. Confirm it appears in Submissions and check both notification mailboxes.

Requires PrestaShop 1.6.1 or later and PHP 7.1 or later.

The module menu contains Dashboard, Forms, Fields, Submissions and Settings. Configure opens the configuration screen under Settings.

General

Without replacement, you can open the module's display front controller through a PrestaShop-generated module link. Form-specific id_form pages are treated as noindex, follow variants by the module's own SEO handling. A central page SEO authority can control the final metadata.

Business Info

Social Links and FAQ Items are stored JSON values, not editable fields in the current configuration form. Social links default to an empty list. FAQ content defaults to three generic questions about response time, telephone support and visiting the office. Review that content before enabling the section for customers. It may not describe your business.

Location & Hours

The stored opening_hours JSON defaults to Monday through Friday 09:00 to 17:00, with Saturday and Sunday closed. The current form has no timetable editor. A developer can update the stored structure with keys mon, tue, wed, thu, fri, sat, sun; each has open and close strings. Empty values mean closed. Verify the displayed timetable and timezone before publishing it.

Email

The installed form has its own email switches. Change those in Forms when you want to stop mail for that form. The global switch is not a master override of populated per-form settings.

Spam Protection

The hidden honeypot is website_url_confirm. The time check uses the submitted render timestamp and flags missing or invalid timestamps too. These checks do not display a CAPTCHA.

Spam messages are stored with a reason but skip email notifications. The visitor receives the normal success message. This is flagging, not a ban on visiting the store.

Open Forms and add or edit a row. The installed form is called Default Contact Form internally. Its English Form Title is Contact us, and its description is Send us a message and we will get back to you as soon as possible. New text fields need your own wording.

Open Fields and select the intended Form. New fields default to Text, not required, active, Position 0, with empty text and validation values.

For a topic dropdown, enter one line each for Order question, Return request, Product advice, Business account and Other. Email, phone, URL, number and select fields also receive type-specific checks.

Keep an email-type field if you want customer confirmations. Use name or full_name as the name key if you want it copied into the submission's customer name column.

File Upload displays a file field, but uploaded files are not saved. Do not use it to collect attachments. Required file fields can be rejected as empty.

Use a theme or module Smarty template that executes hooks. Pasting Smarty into ordinary CMS HTML does not make PrestaShop execute it.

{hook h='displayMprContactForm'}
{hook h='displayMprContactForm' id_form=2}

The first call uses the default active form. The second selects a form by ID.

In Theme styles, review the detected palette, text, backgrounds, borders, success/error colors, focus color and radii. Private settings include Form spacing (20px), Card shadow (0 1px 3px rgba(0, 0, 0, 0.06), 0 1px 2px rgba(0, 0, 0, 0.04)), Raised card shadow (0 4px 6px -1px rgba(0, 0, 0, 0.07), 0 2px 4px -2px rgba(0, 0, 0, 0.05)) and WhatsApp color (#25D366).

For markup changes, override these module templates in your theme:

themes/your-theme/modules/mprcontactform/views/templates/front/contact_form.tpl
themes/your-theme/modules/mprcontactform/views/templates/front/contact_page.tpl

Use .mpr-contactform .mpr-cf-title, .mpr-contactform .mpr-cf-btn and .mpr-contact-page .mpr-cp-card--whatsapp for custom theme styles.

A developer updating stored social links can use a JSON object keyed by facebook, instagram, x, linkedin, youtube, tiktok, pinterest or whatsapp, with a profile URL as each value. This does not create an extra back-office field.

Mail templates under views/templates/mails/ receive {form_title}, {customer_name}, {customer_email}, {field_data}, {submission_date}, {ip_address}, {shop_name} and {shop_url}.

Submit a normal message after waiting longer than the form's minimum time. Check Submissions for the form, name, email, IP, status, spam flag, date and field values. Use the row detail to read the values. Bulk actions let you mark messages read, mark spam or delete them.

If mail is missing, check the saved submission first: its spam reason, then the per-form mail switches, recipient addresses and PrestaShop mail delivery. A saved submission means the form worked; the email can still fail to arrive.

If a form is missing, check its Active state, active fields and selected form ID. If replacement routing fails, check Replace Core Contact Page and the shop's contact URL rewrite. If the map or social links are absent, check their switches and stored coordinates or links.

Back up form definitions and submissions before uninstalling. Uninstall removes the module schema, including forms, fields and submissions, together with module configuration and admin entries. It also removes its Theme Detector registration. Use the per-form Active switch or disable the module when you need to pause it while retaining records.