Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/relayercore/formrelayer/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
A powerful, lightweight WordPress contact form plugin with admin dashboard, submissions viewer, auto-reply, and more.
🚀 Features
- Simple Setup – Add a contact form to any page with a shortcode
- Submissions Dashboard – View and manage all form submissions in WordPress admin
- Email Notifications – Get notified instantly when someone submits the form
- Auto-Reply – Automatically send a confirmation email to users
- Spam Protection – Built-in honeypot protection and rate limiting
- Customizable Colors – Match your brand with custom primary colors
- Dynamic Locations – Add location options for multi-location businesses
- Responsive Design – Looks great on all devices
- Dark Mode Support – Automatic dark mode for users who prefer it
- Translation Ready – Fully translatable to any language
📦 Installation
From WordPress.org (Coming Soon)
- Go to Plugins > Add New
- Search for "FormRelayer"
- Click Install Now and then Activate
Manual Installation
- Download the latest release
- Upload to
/wp-content/plugins/form-relayer/ - Activate through the Plugins menu in WordPress
🎯 Usage
Add the shortcode to any page or post:
[form_relayer]Shortcode Attributes
| Attribute | Default | Description |
|---|---|---|
location |
"" |
Pre-select a location |
button_text |
"Send Message" |
Custom button text |
show_phone |
"true" |
Show/hide phone field |
show_location |
"true" |
Show/hide location dropdown |
Examples
[form_relayer button_text="Get in Touch"]
[form_relayer location="New York Office" show_phone="false"]⚙️ Configuration
- Go to FormRelayer > Settings
- Configure recipient email, success message, and colors
- Set up auto-reply email template
- Add location options if needed
📧 Email Templates
Placeholders
Use these placeholders in your auto-reply message:
| Placeholder | Description |
|---|---|
{name} |
Submitter's name |
{email} |
Submitter's email |
{subject} |
Form subject |
{site_name} |
Your site name |
{site_url} |
Your site URL |
🔌 Hooks & Filters
Actions
// After submission is created
do_action('fr_submission_created', $post_id, $data);
// After successful submission
do_action('fr_after_submission', $post_id, $data, $_POST);
// Form rendering hooks
do_action('fr_form_after_message', $atts);
do_action('fr_form_before_submit', $atts);Filters
// Modify validation errors
add_filter('fr_validation_errors', function($errors, $data) {
return $errors;
}, 10, 2);
// Modify rate limit
add_filter('fr_rate_limit', function($limit) {
return 10; // 10 submissions per hour
});
// Modify admin email recipients
add_filter('fr_admin_email_recipients', function($to, $data) {
return $to;
}, 10, 2);💎 Pro Features
Upgrade to FormRelayer Pro for:
- ✅ File Attachments
- ✅ Google reCAPTCHA / hCaptcha
- ✅ Export to CSV/Excel
- ✅ Advanced Email Templates
- ✅ Multiple Forms
- ✅ Conditional Logic
- ✅ Zapier/Webhook Integrations
- ✅ Priority Support
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
This project is licensed under the GPL v2 or later - see the LICENSE file for details.
🙏 Credits
Created with ❤️ by RelayerCore
📞 Support
- Documentation: GitHub Repository
- Support: GitHub Issues
- Pro Support: RelayerCore Profile