************************************************************************
This file is part of a package from:
www.freecontactform.com

Version 2026.2

Free to use on your own and your clients' websites.
You cannot share, sell or repackage this download.

Important legal notice:
You must retain the attribution to www.freecontactform.com
It must be visible on the same page as the form.
Unbranding licence: www.freecontactform.com/licence
See LICENSE.txt and www.freecontactform.com/licence

************************************************************************


Thank you for picking freecontactform.com

This is the FEEDBACK FORM. It is the same form engine as the free contact
form, with a rating, an optional topic and the feedback itself. Name and
email are optional, so visitors can leave feedback without saying who they
are. The email subject shows the rating, for example "Feedback: Good".

Requires PHP 8.2 or newer.


Quick guide on how to add to your website:

    1. In your hosting control panel (cPanel: "Email Accounts") create a
       mailbox for the form, e.g. website@yourdomain.com
    2. Open the file: fcf-config/fcf.settings.php
    3. Add the address that should RECEIVE the messages:
        define('EMAIL_TO', 'your email address in here');
    4. Add the mail server details of the mailbox from step 1:
        SMTP_HOST  the HOSTNAME OF THE SERVER your site runs on (in cPanel it
                   is "Server Name" on the main page, e.g. server123.example.com).
                   Do NOT use your own domain name, even if the mailbox's
                   Connect Devices page shows it: your domain may point to a
                   different server and the connection will time out.
        SMTP_USER  the full mailbox address, e.g. website@yourdomain.com
        SMTP_PASS  the mailbox password
       (Port 465 and SMTPS are already filled in.)
    5. Save
    6. Add the content of fcf.form.htm to your feedback page.
    7. Upload ALL files (the fcf-assets and fcf-config folders too)
    8. Send yourself a test message.

Using an email service instead (SendGrid, Mailjet, Brevo and similar)? Put the
SMTP details they give you in SMTP_HOST, SMTP_PORT, SMTP_USER and SMTP_PASS, and
set EMAIL_FROM to a sender address you have verified with them. See
docs/DELIVERABILITY.md.

Cannot create a mailbox? Set USE_SMTP to NO and EMAIL_FROM to an address on
your own domain. That can work on shared hosting, but delivery is less
dependable. Read docs/DELIVERABILITY.md.

Messages going missing or into spam? Read docs/DELIVERABILITY.md.
There is also a self-test page that checks your server and settings and can
send a test email, see SELFTEST_TOKEN in fcf-config/fcf.settings.php.

Want different fields, colours or an "I agree" box? Make your form at
www.freecontactform.com/form-builder and upload the files it gives you.
Your fcf.settings.php stays as it is.

Want each answer to "What is it about?" to go to a different address (sales,
accounts...)? See docs/EMAIL-ROUTES.md.

Upgrading from an earlier version: read docs/UPGRADING.md. From version
2026.1, the self-test page makes the new settings files for you.

More detailed installation details can be found at:

https://www.freecontactform.com/form-guides/contact-form-installation-free


Please tell us what you think:

Let us know if you like it or not, or just say thanks.
All feedback is very much appreciated!
This is important as it helps us want to make future improvements.

https://www.freecontactform.com/contact


Thanks again and have a great day!

Stuart Cochrane (Owner and Developer at freecontactform.com)
