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.
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.
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