Pirate Forms Documentation
Stay in touch with your visitors very easily. Pirate Contact Forms offers you a great and friendly contact form for your website. This is an easy-to-use WordPress contact form with captcha plugin. To create a contact form you just need to use the [pirate_forms] shortcode or the 'Pirate Forms' widget.
How to Install
After you have purchased the plugin go to Purchase History to download the Pirate Forms plugin. After downloading the plugin, navigate to Plugins > Add New > Upload, in your WordPress dashboard. Now, click the Choose File button, select the archive of your plugin from your local computer and press the Install Now button. In few seconds, WordPress will upload and extract the plugin archive for you. All you need to do next is to press the Activate link under the message for successful plugin installation.
Configure Pirate Forms
You can configure Pirate Forms from Settings> Pirate Forms, in your WordPress dashboard.
You can access all the form options from Settings > Pirate Forms > Options. There you have the following options:
- Contact notification sender email: Email to use for the sender of the contact form emails both to the recipients below and the contact form submitter (if this is activated below). The domain for this email address should match your site's domain. Insert [email] to use the contact form submitter's email.
- Contact submission recipients: Email address(es) to receive contact submission notifications. You can separate multiple emails with a comma.
- Store submissions in the database: Should the submissions be stored in the admin area? If chosen, contact form submissions will be saved in Contacts on the left (appears after this option is activated).
- Add a nonce to the contact form: Should the form use a WordPress nonce? This helps reduce spam by ensuring that the form submitter is on the site when submitting the form rather than submitting remotely. This could, however, cause problems with sites using a page caching plugin. Turn this off if you are getting complaints about forms not being able to be submitted with an error of "Nonce failed!"
- Send email confirmation to form submitter: Adding text here will send an email to the form submitter. The email uses the "Successful form submission text" field from the "Alert Messages" tab as the subject line. Plain text only here, no HTML.
- "Thank You" URL: Select the post-submit page for all forms submitted.
In Field Settings, you can manage all the fields of your form, as well as add a reCaptcha to it. It has following options:
- Name: Do you want the name field to be displayed? If yes then you can also set whether or not to make it required.
- Email Address: Do you want the email address field to be displayed? If yes then you can also set whether or not to make it required.
- Subject: Do you want the subject field to be displayed? If yes then you can also set whether or not to make it required.
- Message: Do you want the message field to be displayed? If yes then you can also set whether or not to make it required.
- Add a reCAPTCHA: You can add Google's reCAPTCHA to your form to prevent spam submissions. If selected, you are required to fill Site & Secret keys.
- Site & Secret keys: Create an account here to get the Site key and the Secret key for the reCaptcha.
- Add an attachment field: Do you want an attachment field to be displayed?
Fields Labels & Alert Messages
In Fields Labels, you can put the labels that you want for your fields. It includes: Name, Email, Subject, Message & Submit Button.
While in Alert Messages, you can fill in the alerts which will appear when the required form fields aren't filled. Also, you can select a text for successful form submission message.
SMTP is a communication protocol for mail servers to transmit email over the Internet. We highly recommend you to contact your hosting provider to ask your SMTP details. It has the following fields:
- Use SMTP to send emails?: Choose this if you want to send emails over SMTP Instead of PHP mail function.
- SMTP Host: Your SMTP host, ask your hosting provider for more details.
- SMTP Port: Your SMTP port, ask your hosting provider for more details.
- Use SMTP Authentication?: If you check this box, make sure the SMTP Username and SMTP Password are completed.
- SMTP Username: Your SMTP username, ask your hosting provider for more details.
- SMTP Password: Your SMTP password, ask your hosting provider for more details.
Using Pirate Forms
There are 3 ways of using your newly created form:
Adding a widget: You can add Pirate Forms widget to your theme from Appearance > Widgets. Make sure your theme has a registered sidebar.
Using a shortcode: Pirate Forms can also be added to any post or page using the [pirate_forms] shortcode.
Inside your theme: If you wanna call Pirate Forms inside your theme files, then it can be called using do_shortcode function by putting the following line in your theme files:
<?php echo do_shortcode( '[pirate_forms]' ) ?>
Submit the form with AJAX
If you don't want your page to be reloaded after the successful submission of the form, you can use the AJAX parameter in the Pirate Forms shortcode and in the Pirate Forms widget. Here's how you can do that.
Are you enjoying Pirate Forms? Rate our plugin on WordPress.org. We'd really appreciate it!