Tools

aGo Contact v1.0

Lightweight contact form with anti-spam protection for WordPress

Quick Start

aGo Contact provides a clean, fast contact form with triple-layer anti-spam protection. No account needed, no external dependencies. Just activate and place the form.

Installation

  1. Upload ago-contact.zip from Plugins → Add New → Upload Plugin
  2. Activate the plugin
  3. Go to aGo Tools → Contact Form to configure

Quick Setup

  1. Set the recipient email where you want to receive messages
  2. Add the form to any page using the shortcode [ago_contact] or the Gutenberg block
  3. Save and you are done — the form is ready to receive submissions
Tip: The form works immediately with the default settings. Customize fields, anti-spam protection and appearance as needed.

Form Fields

The form includes sensible defaults out of the box. You can enable or disable fields as needed.

FieldTypeDefaultRequired
NameTextEnabledYes
EmailEmailEnabledYes
PhoneTelEnabledNo
SubjectTextEnabledNo
MessageTextareaEnabledYes
  • All fields include proper HTML5 validation
  • The email field validates format on both client and server side
  • The phone field accepts international formats
  • Fields can be enabled/disabled from the settings page

Anti-Spam Protection

aGo Contact uses a triple-layer approach to block spam without bothering your visitors.

Layer 1: Honeypot Field

A hidden field invisible to humans but filled by bots. If the field has content, the submission is silently rejected. Zero impact on user experience.

Layer 2: Math CAPTCHA

A simple math question (e.g., "What is 3 + 5?") that is easy for humans but stops most automated bots. The numbers change on every page load.

SettingDescription
Enable Math CAPTCHAShow the math question on the form
Max NumberHighest number used in the question (default: 10)

Layer 3: Cloudflare Turnstile

An invisible, privacy-friendly CAPTCHA from Cloudflare. Much lighter than reCAPTCHA — most visitors never see a challenge.

  1. Get free keys at Cloudflare Turnstile
  2. Enter the Site Key and Secret Key in the settings
  3. Enable Turnstile — it replaces or complements the math CAPTCHA
Recommendation: Use honeypot + Turnstile for the best balance of security and user experience. The math CAPTCHA is a good fallback if you do not want to use Cloudflare.

Email Notifications

Admin Notification

When someone submits the form, an email is sent to the configured recipient address with all form data.

SettingDescription
Recipient EmailWhere to send notifications (default: admin email)
Email SubjectSubject line for notification emails
From NameSender name displayed in the email
From EmailSender address (use a real address for deliverability)

Auto-Reply

Optionally send an automatic confirmation email to the visitor after they submit the form.

SettingDescription
Enable Auto-ReplyEnable/disable automatic replies
Auto-Reply SubjectSubject line the visitor sees
Auto-Reply MessageBody text. Use {name} as a placeholder for the visitor's name
Tip: A well-written auto-reply makes visitors feel heard. Include expected response time and alternative contact methods.

Submission Management

All form submissions are stored in the WordPress database and accessible from the admin panel.

View Submissions

Go to aGo Tools → Contact Form → Submissions to see all entries in a sortable table.

ColumnDescription
DateWhen the submission was received
NameVisitor's name
EmailVisitor's email (clickable mailto link)
SubjectMessage subject (if enabled)
StatusNew, Read or Replied
  • Click any row to view the full message
  • Mark submissions as Read or Replied to track your workflow
  • Bulk delete old submissions

CSV Export

Click Export CSV to download all submissions as a spreadsheet. Useful for importing into CRM systems, mailing lists or for record keeping.

  • Exports all fields: name, email, phone, subject, message, date, status
  • UTF-8 encoded for proper special character support
  • Filter by date range before exporting

Form Themes

Choose from three built-in visual themes for your form, or let it inherit your theme's styles.

Modern (default)

Clean design with floating labels, rounded corners and subtle shadows. Looks great on any site.

Classic

Traditional form layout with labels above fields and standard borders. Familiar and accessible.

Minimal

Borderless fields with bottom-line accents. Ultra-clean look for modern websites.

Select your theme in aGo Tools → Contact Form → Appearance. The preview updates in real time.

Custom CSS: All form elements use BEM-style classes (.ago-contact__field, .ago-contact__submit) making it easy to override styles in your theme's CSS.

Shortcode and Gutenberg Block

Shortcode

Place the form anywhere using:

[ago_contact]

Works in posts, pages, widgets and page builder text modules.

Gutenberg Block

  1. In the block editor, click + to add a block
  2. Search for "aGo Contact"
  3. Insert the block — the form renders with a live preview
Tip: The shortcode and the block produce the same output. Use whichever is more convenient for your workflow.

aGo SMTP Integration

For reliable email delivery, pair aGo Contact with the aGo SMTP plugin. Without proper SMTP configuration, WordPress sends emails through wp_mail() using PHP's mail() function, which often ends up in spam.

How They Work Together

  • aGo SMTP routes all WordPress emails through your SMTP server
  • aGo Contact notifications and auto-replies automatically use the SMTP connection
  • No additional configuration needed — if aGo SMTP is active, aGo Contact uses it
Recommended Setup: Install aGo Contact and aGo SMTP. Configure your SMTP credentials once, and all contact form emails will be reliably delivered through your email provider.

Frequently Asked Questions

Do I need Cloudflare Turnstile?

No. The honeypot field alone blocks most bots. Add math CAPTCHA or Turnstile for extra protection on high-traffic sites.

Why are emails not arriving?

Most likely your server's mail() function is blocked or emails go to spam. Install aGo SMTP and configure a real SMTP server (Gmail, SendGrid, Mailgun, etc.).

Can I have multiple forms on one page?

Currently one form configuration per site. You can place the same form on multiple pages using the shortcode or block.

Are submissions saved if the email fails?

Yes. All submissions are saved to the database regardless of email delivery status. You will always have a record in the Submissions panel.

Can I customize the success message?

Yes. Set a custom message in Settings → Messages → Success Message. HTML is supported.

Does the form work with caching plugins?

Yes. Form submission uses AJAX, so page caching does not interfere. The math CAPTCHA is regenerated via JavaScript on each load.

How do I comply with GDPR?

Add a consent checkbox (enable in settings), link to your privacy policy, and regularly delete old submissions you no longer need.

Need help?

Contact us at ago.cl/contacto or write to [email protected].