We can put our email address on social links so that readers can contact us. Unfortunately, emails will be more or less treated as spam and even filtered. Therefore, we bring a feature called contact form.
Prerequisites
We need to create a contact page called contact/index.md
in the content
directory, so that we can access the contact form.
1+++
2title = "Contact Us"
3layout = "contact"
4+++
Once created, the link will appear in the profile widget.
Parameters
Name | Type | Default | Description |
---|---|---|---|
contact | Object | - | |
contact.endpoint | String | - | See also Backends. |
contact.file | Boolean | false | Enable/Disable file upload. |
contact.fileField | String | - | The name of file field. |
contact.reCaptcha | Object | - | Google reCAPTCHA |
contact.reCaptcha.siteKey | String | - |
Backends
It is designed to be compatible with most backends, such as Netlify form, Getform, Formspree and Fabform.io. Also works with self-hosted alternative Formailer.
Netlify
Netlify form are supported out of box, therefore, you don’t need to specify the contact.endpoint
parameter.
The demo site uses Getform instead of Netlify form, because the Netlify will upgrade your form level automatically if you exceed the limit of current plan, which will lead to additional expenses.
Please make sure the
contact.endpoint
parameter is empty if you intend to use Netlify form.
Formailer
Formailer is supported with a contact form hook to inject a missing input to the form.
See also Google Cloud Functions example upstream.
Others
Let’s take Getform as an example:
1[contact]
2 endpoint = "YOUR_ENDPOINT"
reCAPTCHA
In addition to set the contact.reCaptcha.siteKey
parameter, you need to perform additional steps according to the backend:
Comments