DEV Community

Cover image for How to add a contact form to a static website
Silvestar Bistrović
Silvestar Bistrović

Posted on • Updated on • Originally published at codementor.io

How to add a contact form to a static website

This post was originally published on Codementor.

With the rise of static sites, developers need a service that could handle forms. Static website contact form is the most common case, and in this article, you would learn how to add one with Kwes form builder.

Adding a contact form to a static site could be a challenge because the static site usually doesn't have a backend that could handle the form submissions. In that case, we could use a service that would do this for us. There are many services out there, like Netlify forms or Typeform, but in this case, we are going to use the Kwes service.

We are going to build a contact form with the following fields:

Form element Form field
Name Text input
Email Email input
Message Textarea input
Button Submit button

All input fields should be required, and the email form field should be validated.

Integration

Since we are going to add Kwes form to our site, we should sign up for free first.

After signing up, add a new website, and a new form from Kwes dashboard.

kwes-dashboard.png

To complete the integration, you should add JavaScript file at the bottom of your body tag of your contact page.

<script src="https://kwes.io/js/kwes.js"></script>
Enter fullscreen mode Exit fullscreen mode

I am using Hexo static page generator for my site, but it works with other static site generators like Hugo or Jekyll. Since most of the static site generators support Markdown, you could paste the contact code directly in Markdown, and it would work, too. Otherwise, you could create a separate page or layout and paste the code there.

Pro tip: There is no need to add JavaScript file to pages that don't have a contact form.

Next, we would add an HTML form to our contact page. To do this, add the usual form tags and attributes.

Pro tip: Don't forget to add labels with for attributes with matching input's IDs to make your form more accessible.

Now we should add the Kwes attributes. It is important to wrap your form in a div with the kwes-from class. After this, add the action attribute to the form element, and then add rules attribute to your input fields. The code should look something like this:

<div class="kwes-form">
  <form method="POST" action="https://kwes.io/api/foreign/forms/youruniqueid">
    <label for="name">Name</label>
    <input type="text" name="name" id="name" rules="required">
    <label for="email">E-mail</label>
    <input type="email" name="email" id="email" rules="required|email|max:255">
    <label for="message">Message</label>
    <textarea name="message" id="message" rules="required"></textarea>
    <button type="submit">Submit</button>
  </form>
</div>
Enter fullscreen mode Exit fullscreen mode

You could see all the rules options at the Kwes official documentation.

Before you publish the form, you should test the form first. With Kwes, you could do it in two different ways:

  • by providing a testing domain in the site settings, or
  • by adding HTML attribute mode="test" to your form element.

During the testing mode, all your submission would not affect the data in your plan. You could view test data in the dashboard by switching the toggle. As easy as that.

The last step is setting the code to the production mode. Now we should sit back and wait for the submissions knowing that Kwes would handle everything for us—from form validation, through spam filtering, to sending confirmation emails.

You could customize the style of the notification messages to match your brand.

Kwes features

Kwes has a built-in logic for showing or hiding any content on a condition. For example, you could show different plan details based on the selected plan.

For me, the most significant advantage is form validation. The validation takes action on both frontend and backend site. Not having to reinvent the wheel and writing validation rules over and over again is time-saving but also a task that I would very happily like to avoid on every project. With more than 50 validation rules, Kwes should cover the most scenarios, even the most complicated ones, like handling dates, times, passwords, and file uploads.

When your form is public, there is a high chance that you would get a spam submission. With Kwes, you could get spam protection and even help Kwes learn which messages to filter out.

If you want more control over your form and integrate it with other services like Zapier, you could do it. You could even take advantage of the Kwes API and manage submissions on your own.

Conclusion

Kwes comes with the cost, but you should think about saving yourself and your team hours of development time. I think it is worth to leave the validation to developers who specialize in this field of area and focus on other parts of your project or business.

Contact page

Top comments (11)

Collapse
 
trostcodes profile image
Alex Trost

Very cool, I didn't know about this one. I'll give it a look.

I always use Netlify for hosting, and their forms package is built-in and free up to 100 submissions.

Collapse
 
starbist profile image
Silvestar Bistrović

Netlify forms is a way to go, for sure. But they are lacking some features, like client-side validation.

Collapse
 
rnrnshn profile image
Olimpio

I was looking for this... Thanks 😊

Collapse
 
starbist profile image
Silvestar Bistrović

I am glad to hear that. Good luck!

Collapse
 
haosik profile image
Nikolay Mochanov

What if "some user" deletes rules attributes by dev tools?

Collapse
 
miguejarias profile image
Miguel Arias

Hi Nikolay, im Miguel Co-Founder of Kwes.

The rules are synced server side on page load. So if someone tries to delete any rules via devtools, it will not affect the form in anyway since the rules were already synced and saved server-side every time the form is loaded. Same goes for the number of fields, the type attribute, etc. this means it also prevents people from injecting fake fields via devtools as well. Any of those changes via devtools are ignored by Kwes.

Collapse
 
starbist profile image
Silvestar Bistrović

I am not sure how to prevent users/devs from messing around with dev tools. If you find out how, let me know. ✌

Collapse
 
ypedroo profile image
Ynoa Pedro

Very cool thanks

Collapse
 
abdurrahmaanj profile image
Abdur-Rahmaan Janhangeer

Nice and easy option!

Collapse
 
srezas profile image
SeyedReza SeyedMohseni

Do you know any library witch directly sends an email with logged information on the Contact-Us page?

Collapse
 
starbist profile image
Silvestar Bistrović

What do you mean? Could you explain, please?