General

Order Questions

Answers to common pre-purchase questions or issues about buying the plugin.

Do I have to buy the plugin every year?

Nope!  The license is structured on a per site basis.

If you only have one website, you can purchase the plugin one time and it’s yours.  You do not have to subscribe each year.

If you are running multisite (or plan to use this for clients), you will need to purchase a developer’s license to cover an unlimited number of sites.

Permalink

How do I request an invoice?

If you need an invoice for tax or business purposes, please use the Contact form and include all pertinent information such as Address, Tax/Vat ID, Phone number, etc.

Permalink

I didn’t receive my download

When you purchase the plugin, the order is then processed and a download email is sent.  The download emails are sent to the email that was used at time of purchase.

If you think you have not received the download email, please check your SPAM folder(s).  You may also search for your order to see if it is in the system.

Permalink

What types of payment are accepted?

All major credit cards and PayPal are acceptable forms of payment.

If you would like to use a credit card instead of PayPal, please select the “Checkout” button instead of the “Checkout with PayPal” button.  On the next screen, select “Pay with a debit or credit card” and enter your credit card details.

PayPal accepts the following cards:

  • Visa / Delta / Electron
  • MasterCard / Eurocard
  • Maestro
  • American Express

Debit cards (also known as bank cards) are accepted if they have a Visa or MasterCard logo.

Permalink

What’s the difference between the free and Pro versions?

The main difference between the free and Pro versions are the feature set.  Visual Form Builder Pro includes many new features that are not and will not be available in the free version.

 

For example, these are just some of the great features you gain access to when you upgrade to the Pro version:

 

  • Additional field types
  • Drag and Drop to create new items
  • Conditional Logic
  • Import
  • Export to CSV, Tab Delimited, and MS Excel
  • Email Designer
  • Analytics
  • Optional SPAM Verfication
  • Akismet Integration
  • Bulk Add Options
  • Scheduling
  • Limit Form Entries
  • Unique Entries
  • Access to tons of hooks
  • Access to Add-Ons

Permalink

Where can I download the plugin?

After purchase, you will receive a download email containing your Order Number as well as a download link.

If you cannot find your download email, you can visit the order search page and insert the Transaction ID and email address.  Please note that the Transaction ID is not the same as your receipt number.

Permalink

Support Questions

Answers about the support system, what's covered, and how to use the ticketing system.

How do I report a bug?

If you find a bug with Visual Form Builder Pro, please report it by submitting a ticket on this site.

These are the types of bugs that can be reported:

  • Unconfirmed Bug: Needs more information. Ex: a way to replicate, more details on observed behavior, etc.
  • Confirmed Bug: Known and confirmed bug. Ex: repeatable in very specific situations, lines of plugin source code with errors, etc.

Permalink

How do I request a feature?

Do you have a feature suggestion that will benefit the majority of Visual Form Builder Pro users? You can submit a Ticket with your idea.

Permalink

How long until I get a response?

Support is available Monday – Friday. During this time you can expect a response to your inquiry within 24-48 hours from the time you submit a ticket. If you submit a ticket or a reply over the weekend, communication will resume on the following Monday.

Permalink

Visual Form Builder Pro

General Info

General questions and answers relating to the main plugin, Visual Form Builder Pro.

Can I automatically backup my VFB data?

Sorry, this is not a feature at this time.

Permalink

Can I have a form with multiple pages?

Visual Form Builder Pro includes a unique form paging method. Click here to view the video.

Permalink

Can I print an entry?

Yes!

  1. Go to Visual Form Builder Pro > Entries.
  2. Click on View to view the entry you’d like to print.
  3. Click the Print button in the Details box on the right

Permalink

Can users edit their own entries?

At this time, users are not able to edit their own entries.

 

Permalink

Can you export data as a CSV or MS Excel file?

Yes!

You can export your entries in three different formats:

  • Comma Separated (.csv)
  • Tab Delimited (.txt)
  • Microsoft Excel (.xls)

Permalink

Email Routing/Email Distribution Based on Selection

So you want to distribute emails to your team based on a selection in Visual Form Builder Pro.

It is actually quite simple to configure:

1. Go to your form builder
2. Go to form settings
3. Go to email
4. You will see a button called “Email Rules”
5. Click the button and configure your email rules.

Note: You will want to have your form drop down or radio designed and setup in your form, before setting up your email rules.

visual form builder pro email rules

Permalink

How can I help with the translations?

If you would like to offer corrections to a language file, you will need to follow these instructions:

 

 

  1. Install and activate the Codestyling Localization plugin
  2. Go to the Tools > Localization menu
  3. Scroll down to find the Visual Form Builder Pro entry
  4. Find your language, if it exists, and click on the Edit button
  5. Edit the strings
  6. When editing is complete, click the generate mo-file button
  7. Create a new ticket and attach the .po and .mo files for that language

Permalink

How do I add forms to my site?

You have two available options to add forms to your site: the shortcode or the PHP template tag.

Shortcode

The easiest way to add your form to a Post/Page is by using the shortcode.  You can either click the “Add Form” button above the visual editor or copy and paste the following into your content:

[vfb id='1']

Change the ID number to match the form you wish to display.

PHP template tag

If you would like to display a form by using a custom WordPress template page, use the PHP template tag.  This is useful if you want to manually control the placement or need a form to display in a popup/lightbox.

<?php vfb_pro( 'id=1' ); ?>

Change the ID number to match the form you wish to display.

Permalink

How do I uninstall?

To uninstall the plugin:

  1. Go to Plugins screen.
  2. Find the Plugin you wish to deactivate and uninstall.
  3. Click Deactivate.
  4. Click Delete.

 

Warning!

This will completely remove all Visual Form Builder Pro files and data.

 

To keep your data intact, you can delete the files off the server:

  1. Deactivate the Plugin.
  2. Login to the site via your FTP Program.
  3. Go to the Plugin directory and find the visual-form-builder-pro folder.
  4. Delete the the folder and/or files from your server.

Permalink

Initial Troubleshooting Steps

Before submitting a support request, it is important that you take steps to narrow down the exact issue.  The majority of all problems are typically problems with your installed theme or another WordPress plugin.

Update all VFB plugins

Are you using the latest version of Visual Form Builder Pro and/or a related add-on? If not, please update before continuing.  In many cases, a problem with Visual Form Builder Pro itself has been resolved in a newer version.

Switch to the default WordPress theme

Switching to the default WordPress theme will often tell you if the problem lies with your installed theme or with something else.  If you are still having problems, it may be another plugin.

Deactivate all other plugins

With the default WordPress theme still active, it’s time to deactivate all other WordPress plugins.

  1. Deactive ALL plugins
  2. Activate Visual Form Builder Pro
  3. Test your site to see if the issue still occurs

If everything works with only Visual Form Builder Pro activated, you have a plugin conflict. Re-activate the plugins one by one until you find the problematic plugin(s).

Server settings

If after checking for theme/plugin conflicts you are still experiencing problems, it could be a server setting.  Please check the recommended server settings.

Permalink

Max number of fields

Visual Form Builder Pro does not have any assigned limits when building your forms.

However, you are limited by your server’s capabilities.  When you are saving a large form with many fields and options, this increases the amount of data that must be sent to the server during saving.  Depending on your server setup, this may result in problems during saving.

If you anticipate having very large forms, it’s best to increase the max_input_vars PHP setting to something like 5000. The default is usually set to 1000. Please note that if your server uses the Suhosin patch, those settings will also need to be updated.

Please check the Recommended Server Settings to achieve the best possible results when building your forms.  Also, it’s important to keep in mind that the longer the form, the less likely it is your user will want to fill it out.

Permalink

Protecting your forms with Akismet

We all hate SPAM.  Especially when it comes through our contact forms.

If you want to have the absolute best SPAM protection for your Visual Form Builder Pro forms, it’s highly recommended you install Akismet.

For the best protection, you should add as many of the following fields to your forms:

  • Name
  • Email
  • Textarea

You can include one or as many combination of the above fields and Akismet will take care of the rest.  If you don’t include one of those fields on your form, the data will not be submitted to Akismet.

Visual Form Builder Pro will still send out the email regardless of whether or not Akismet marks it as spam.  This is to ensure you always get your data even if there are false positives.  You should routinely check your Entries to manage entries that should or should not be marked as spam.

That’s all it takes to have some of the best spam protection around.

Permalink

Recommended Server Settings

Depending on your hosting environment, you may or may not have trouble with certain aspects of Visual Form Builder Pro.

Minimum Requirements

  1. PHP version 5.2.4 or greater
  2. MySQL version 5.0 or greater
  3. WordPress version 3.5 or greater
  4. The wp-content folder permissions should be set to 0755 or 0750

Here are some guidelines on certain web server settings that may alleviate such problems. All settings can be changed in your php.ini file.

post_max_size 50M
upload_max_filesize 50M
memory_limit 64
max_input_vars 1000
max_input_nesting_level 64

Your server may be protected by Suhosin. These are other settings to check for.

suhosin.post.max_vars 1000
suhosin.request.max_vars 1000
suhosin.get.max_vars 100

mod_security is an Apache module that can protect your site from certain attacks. Most hosts customize this module to suit each customer. Some configurations may prevent Visual Form Builder Pro from functioning as intended.

Because these configuration are varied and complex, you should contact your host for assistance in troubleshooting.

mod_security Recommended Base Configuration

Note!

These settings are merely recommendations and may not solve the problems with your host. There may be other settings not listed here that your particular hosting environment runs that interferes with Visual Form Builder Pro. Please contact your host in any event if you are experiencing problems.

Permalink

Theme requirements

All themes must include the wp_head and wp_footer functions in order for all Visual Form Builder Pro styles and scripts to be properly added to the page.

 

If your theme includes an external version of jQuery or jQuery UI (such as those from Google’s CDN), you will need to update your theme to use wp_enqueue_script instead.

 

Permalink

Troubleshooting

If the plugin doesn't look or work quite right, these troubleshooting tips will help.

Drag and Drop does not work

The most common problem with drag-and-drop not working is a theme/plugin conflict.  Please follow the instructions to resolve any conflicts before continuing.

If you have following the instructions to resolve any conflicts and are still having problems, your browser might be caching the older JavaScript file.
  1. Log out of the WordPress admin
  2. Go to your browser’s preferences and clear the cache
  3. Log back in and test the drag and drop
If you are still experiencing problems, please submit a ticket and include an admin login.

Permalink

Emails are not being sent

Note!
Form submissions will always be saved in the database whether or not the email was sent.

Check SPAM folder

A quick look in the SPAM folder will tell you if the emails are being routed into the folder. If so, simply train your email client to not treat those emails as SPAM

Configure your site to use SMTP

Some people have reported that after the form is submitted, no email is received. If this is the case for you, it typically means that your server or web host has not properly configured their SMTP settings.

Try using a plugin such as WP Mail SMTP to correct the issue.

Set the Reply-To email to a same domain email

Setting up SMTP will get you part of the way there. For most, it solves the problem. For others, it requires additional configuration

If you find that emails are not being sent, you should first confirm that you have completed all of the details in the Form Settings > Email section. Next, be sure to set the Reply-To option to an email that exists on the same domain as your WordPress site.

Set the Sender email to an email that exists on the domain

In addition to the Reply-To header, some hosts require that the Sender header is also set to an email that exists on the domain.  By default, the Sender email is automatically set to either your admin email if the domain matches.  If it does not match, then a local email address is created (wordpress@yoursitename.com).

To change this behavior to use an email that exists on the domain, you will need to set either the “Send Mail Header” setting under the VFB Pro > Settings menu or the vfb_sender_mail_header filter.

Possible mod_security conflict

Some servers are overzealous in their restrictions on the $_POST object and will block anything with certain keywords. Check your server logs and look for any 403 Forbidden or 500 Internal Server errors. If you notice these errors when submitting a form, contact your host and find out if there are any restrictions.

Enable local mail for your domain

Be sure to enable local mail delivery for your domain. Disabling local mail delivery is common if you are using an external mail server, but can cause bounce-backs saying the email user does not exist.

Also, if possible, check your server’s email logs or have your host check them for you and see if it’s refusing to send an email. It’s possible your email server is attempting to send the emails but can’t for missing mail resources, security, SPAM filtering, or other technical problems.

Permalink

Error: Call to a member function entries_errors () on a non-object …

The only reason you’d be getting this error is if the Entries class isn’t loaded, which means that the file isn’t included for you for some reason.

Make sure you have an updated copy of the plugin and that your wp-content folder permissions are set to either 750 or 755.

 

Permalink

Fatal error: Call to undefined method WP_Screen::get_columns()

If you are receiving this error, your WordPress installation is out-of-date. Update to at least WordPress 3.4.1.

Permalink

Form items have bullets when editing in admin

You are limited somewhat to your server’s limits and capabilities when building or managing your forms. If you see bullets next to your items when editing the form in the admin, this means you have reached a limit.

Most often, these limits have to do with how much data your server can handle when submitting forms or maybe a database connection error. These are most common when adding, deleting, or saving the form items or entries.

Solutions

  • If you have a lengthy form, consider reducing the number of items or splitting into two separate forms
  • If you have bullets next to your form, the easiest solution is to recreate your form
  • Contact your host and see if you meet the recommended server settings

Permalink

I stopped receiving e-mails

If you recently noticed your forms are no longer sending emails, something on your server might have changed.  Here are some steps to help narrow down the issue.

 

Troubleshooting

 

  1. Try a different email and test the form
  2. Go over the Emails are not being sent article for troubleshooting tips and solutions
  3. Make sure that you meet the recommended server settings.
  4. Follow the steps to resolve theme/plugin conflicts.
  5. Contact your host and ask them to examine the email logs for errors
Do you have a really long form?
If you have a really long form with many fields and/or options, you might be reaching the limits of your server.  The recommended server settings may need to be increased to accommodate your large dataset.
Try increasing the post_max_size and max_input_vars values until the form successfully submits.  You may also have to adjust other values listed in the recommended server settings to achieve optimum functionality.

Permalink

Missing Fieldset message appears

Front-end form

If you are seeing the “Oops! Missing Fieldset” message on your form, this means you need to add a Fieldset to the beginning of your form.

Admin

Sometimes after an update you may see this message when editing a form in the admin.  This can be remedied by clearing your browser’s cache.

Permalink

Problems with email image header and Rackspace

If you are on a Rackspace server, you may have issues when it comes to the email header image.

Visual Form Builder Pro allows you to upload an image header to be included in the HTML email.  However, the default WordPress install on Rackspace servers can cause problems with this.

The Rackspace WordPress install wizard will automatically include a plugin called Root Relative URLs. This plugin replaces WP’s absolute links with root-relative links.  And this is what causes problems with the image header.  Images in emails need to use an absolute path to point to the image on your website.

The fix

Even if you’ve never activated this plugin, there will be several constants inserted into your wp-config.php file by Rackspace.  All you need to do is remove the following lines:

define('WP_HOME', 'http://' . $_SERVER['HTTP_HOST']);
define('WP_SITEURL', 'http://' . $_SERVER['HTTP_HOST']);
define('WP_CONTENT_URL', '/wp-content');
define('DOMAIN_CURRENT_SITE', $_SERVER['HTTP_HOST']);

Permalink

Resolving Theme or Plugin Conflicts

Visual Form Builder Pro is built using preferred WordPress coding standards. In many cases, some theme authors or plugin developers do not follow these standards and it causes conflicts with those that do follow the standards. The two most common issues have to do with either jQuery or CSS.

jQuery conflicts

Visual Form Builder Pro requires at least jQuery version 1.7. Please make sure your theme is updated to use the latest version of jQuery.

CSS conflicts

If your forms do not look as expected, chances are there’s some CSS in your theme conflicting with the built-in CSS of Visual Form Builder Pro. Please follow the instructions on how to customize the CSS.

Theme conflicts

If you have confirmed that you are using the latest version of jQuery and can rule out CSS conflicts, there’s probably something in your theme still causing problems.

  1. Activate the default Twenty Eleven theme
  2. Test your site to see if the issue still occurs

Still having problems even with Twenty Eleven running? If not, it’s a conflict with your theme. Otherwise, it’s probably a plugin conflict.

Plugin conflicts

Before following this process, make sure you have updated all plugins to their latest version (yes, even Visual Form Builder Pro).

  1. Deactive ALL plugins
  2. Activate Visual Form Builder Pro
  3. Test your site to see if the issue still occurs

If everything works with only Visual Form Builder Pro activated, you have a plugin conflict. Re-activate the plugins one by one until you find the problematic plugin(s).

Permalink

Security check: referal does not match this site

Typically, this error message appears when the form was submitted from a URL not on your site.  It’s a security precaution to prevent CSRF, or Cross Site Request Forgery.

However, some themes may interfere with how the referrer was set.  The most common are those that load via AJAX interject their own referrer variables, thus overriding what is commonly used by WordPress.

If you are a user of such a theme (or plugin) that breaks the referrer, you can set the vfb_skip_referrer_check filter. Please refer to the documentation for more information.

Permalink

The migration link never appears

Visual Form Builder Pro includes a one-click method to migrate your data over to the Pro version if you’ve been using the free version.

If you’ve activated the Pro version but the migration banner does not appear, you can manually trigger the migration.

To manually trigger the migration:

  1. Click on the Visual Form Builder Pro menu
  2. Add the following to the URL in your browser’s address bar: &action=upgrade
  3. Your full URL should look like this: http://mysiteurl.com/wp-admin/admin.php?page=visual-form-builder-pro&action=upgrade
  4. Press enter on your keyboard to trigger the migration process

Permalink

Why does the form preview look different than the form on my site?

When viewing the form preview, you may notice that the form might look different when embedded onto your site.  This is because the form preview is rendered without using your form’s CSS.  While every effort is taken to ensure your forms look great when live, some themes add styles that override those provided by Visual Form Builder Pro.

Permalink

Customizing

There is plenty to customize in Visual Form Builder Pro.

Can I customize the HTML generated by the plugin?

No.  The HTML generated by the form cannot be customized.  These include the IDs, labels, and certain class names.

However, you are allowed to insert your own CSS class names into each field by using the CSS Class option when editing a form item.

Permalink

Can I customize where the files are uploaded?

Yes!

By default, all files uploaded through your Visual Form Builder Pro forms are stored in the Media Library. Follow the tutorial below to customize where the files are stored.

Visual Form Builder Pro uses a WordPress function called wp_handle_upload to handle uploading and moving the file to the appropriate content directory.  The upside (or downside, depending on how you look at it) is that is handles everything you need in a single function.  You just need to pass it the $_FILES reference.  With this simplification comes a price and the reason for this tutorial: customizing wherethe files goes is handled outside this function.

upload_dir filter

The upload_dir filter takes an array of all the path and URL info it needs to upload a file.  For our purposes, though, we only want to affect uploads that happen through Visual Form Builder Pro and not every upload. This is done by checking to see if our file upload field is set and, if so, change the upload directory. Otherwise, leave as is and continue as normal.

add_filter( 'upload_dir', 'vfb_upload_dir' );

function vfb_upload_dir( $upload ){
    /* If our File Upload field is detected.
       To change all forms, use $_POST['vfb-submit']
    */
    if ( isset( $_FILES['vfb-611'] ) ) {
        /* Customize this to fit your needs */
        $dir = WP_CONTENT_DIR . '/vfb-uploads';
        $url = WP_CONTENT_URL . '/vfb-uploads';

        $bdir = $dir;
        $burl = $url;
        $subdir = '';

        /* Append year/month folders if that option is set */
        if ( get_option( 'uploads_use_yearmonth_folders' ) ) {
            if ( !$time )
                $time = current_time( 'mysql' );

            $y = substr( $time, 0, 4 );
            $m = substr( $time, 5, 2 );

            $subdir = "/$y/$m";    
        }

        $dir .= $subdir;
        $url .= $subdir;

        /* Set the $uploads array with our new paths */
        $upload['path'] = $dir;
        $upload['url'] = $url;
        $upload['subdir'] = $subdir;
        $upload['basedir'] = $bdir;
        $upload['baseurl'] = $burl;
        $upload['error'] = false;
    }
	return $upload;
}

This function can be customized to fit your needs as you see fit.  This particular function will only run for the form that has the ‘vfb-611′ field, but you can expand it to include or exclude more forms.  You can even change it to pick up on all VFB forms if that’s what you want to do.

IMPORTANT NOTE!

Changing the upload directory in this way will affect how these uploads work in the Media Library.  In other words, you won’t see the thumbnail and the links in the Media Library will be pointing to the wrong file location.  WordPress stores the file location attachment metadata as a relative path, so it’s always going to be in reference to your default upload directory.

If customizing the upload path is more important than seeing thumbnails in the Media Library, then this detail can be overlooked.

Permalink

Can I password protect my forms?

No, Visual Form Builder Pro cannot password restrict a form.

However, you can use the built-in WordPress password feature .

 

Permalink

Can I send an email as Plain Text instead of HTML?

Yes!

  1. Go the Email Design page under the VFB Pro menu
  2. Select the form you want to edit
  3. Scroll down to the ‘Email Format’ option
  4. Select Plain Text
  5. Save

Permalink

Customizing the Date Picker

The jQuery UI Date Picker is a complex and highly configurable plugin. By default, Visual Form Builder’s date field will use the default options and configuration.

To use the more complex features of the Date Picker plugin, please read these tutorials from the blog:

  1. How to customize the Date Picker
  2. Even more Date Picker customizations

Permalink

Customizing the form design

The easiest way to customize the form design is by using the Form Designer add-on.

If you prefer to manually customize the design with CSS, please refer to this tutorial on customizing the CSS

Permalink

How can I include the URL or a Unique ID in the email?

The Hidden field in Visual Form Builder Pro has several options to include data like the page URL in the email.  User’s do not see Hidden fields.

 

These are the types of data you can include with the Hidden field:

 

  • Form ID
  • Form Title
  • IP Address
  • Unique ID
  • Post/Page ID
  • Post/Page Title
  • Post/Page URL
  • Custom (this option allows for a static variable you create)

You are also not limited to the number of Hidden fields you want to include.

 

Permalink

How do I include the Post/Page Title?

The Hidden field in Visual Form Builder Pro has several options to include data like the Post/Page Title in the email.  Users do not see Hidden fields.

These are the types of data you can include with the Hidden field:

  • Form ID
  • Form Title
  • IP Address
  • Unique ID
  • Post/Page ID
  • Post/Page Title
  • Post/Page URL
  • Custom (this option allows for a static variable you create)

You are also not limited to the number of Hidden fields you want to include.

Permalink

How do I limit the number of characters for a field?

n some cases, you need to set a minimum or maximum length on the number of characters that are inserted into a field.  This is where some custom validation comes into play.

 

The way to insert this validation is easy.

  1. Find the field to edit and click on the down arrow
  2. Go to the CSS option and insert either of the following
  3. For minimum: {minlength:10}
  4. For maximum: {maxlength:10}

Customize the number for your needs.

 

Works with text and checkbox fields.

 

Permalink

How do I redirect to another URL after submission?

Here is how to setup the form to redirect to another URL or web link after form submission:

 

Redirect to a non-WordPress URL

 

  1. Go to your form and click on Settings
  2. Go to the Confirmation section
  3. Click on the Redirect option
  4. Enter a URL
  5. Click Save

 

Redirect to a WordPress Page

 

  1. Go to your form and click on Settings
  2. Go to the Confirmation section
  3. Click on the Page option
  4. Select a WordPress Page from the drop down menu
  5. Click Save

 

Permalink

How do I remove the link at the bottom of the email?

  1. Go to Visual Form Builder Pro > Email Design
  2. Click ‘No’ on the Link Back to Visual Form Builder Pro option

Permalink

How do I remove the Verification?

  1. Go to your form and click on the Form Settings button
  2. Click on the General section, if not expanded
  3. Change the Display SPAM Verification option to No.

Permalink

How do I translate the error messages to my language?

The validation messages (ex: ‘This field is required’ or ‘Please enter a valid email address’) are generated by the jQuery Form Validation plugin.

By default, these messages are in English. To translate them, you can either use the free add-on Custom Validation Messages or follow the manual JavaScript method.

Recommended

The recommended method to translate the messages is by installing the free Custom Validation Messages add-on.  This will let you easily change the messages for all forms from within the WordPress admin.

Manual Method

In your theme folder, create a JavaScript file. In this example, I’m using my-js.js. Add the following code to it and customize the language to what you need:

/*
 * Translated default messages for the jQuery validation plugin.
 * Locale: DE (German, Deutsch)
 */
jQuery(document).ready(function($) {
    $.extend($.validator.messages, {
        required: "Dieses Feld ist ein Pflichtfeld.",
	email: "Geben Sie bitte eine gültige E-Mail Adresse ein.",
	url: "Geben Sie bitte eine gültige URL ein.",
	date: "Bitte geben Sie ein gültiges Datum ein.",
	number: "Geben Sie bitte eine Nummer ein.",
	digits: "Geben Sie bitte nur Ziffern ein.",
	equalTo: "Bitte denselben Wert wiederholen.",
	range: $.validator.format("Geben Sie bitte einen Wert zwischen {0} und {1} ein."),
	max: $.validator.format("Geben Sie bitte einen Wert kleiner oder gleich {0} ein."),
	min: $.validator.format("Geben Sie bitte einen Wert größer oder gleich {0} ein.")
    });
});

Now, in your functions.php file, add the following piece of code:

add_action( 'wp_enqueue_scripts', 'my_scripts_method' );
function my_scripts_method() {
   wp_register_script( 'my-vfb-validation',
       get_template_directory_uri() . '/js/my-js.js',
       array( 'jquery', 'jquery-form-validation' ),
       '1.0',
       false );

   wp_enqueue_script( 'my-vfb-validation' );
}

More Languages

If you are looking for other languages that have already been translated, you can find many listed here at the official jQuery Validation GitHub repository.

Permalink

How do I use an image CAPTCHA for verification?

Visual Form Builder Pro includes two different “captcha” methods.

The first method, which is the default, is a text CAPTCHA.  This is the recommended method as it is more accessible and allows you to have multiple forms on the same page.

The second method is using Google’s reCAPTCHA.  This is known as an image CAPTCHA because it uses images of distorted text as the security question.  Multiple forms with reCAPTCHA fields are not allowed, per Google’s requirements.

How to configure VFB Pro to use reCAPTCHA

  1. Go to http://www.google.com/recaptcha and create an account
  2. Follow the directions on the reCAPTCHA site to add your site(s)
  3. Go to the VFB Pro > Settings menu
  4. Copy and paste the reCAPTCHA Public and Private keys into the respective boxes on the Settings menu
  5. Go to the form you want to use reCAPTCHA on and find the Secret field
  6. Check the “Use reCAPTCHA” box
  7. Save your form

Permalink

Including an image (or any other HTML) in your descriptions

Did you know that the Description option can handle HTML?  With just a basic understanding of HTML tags, you can customize your descriptions to achieve all sorts of different looks.

 

But one thing that’s pretty cool is that you can even include images.

 

First, begin by uploading the image to your site or finding an image that has already been uploaded.  What we need is the File URL of the image.  If you have uploaded the image through your WordPress Media Library, you can click on the image and the File URL will be listed at the bottom.

 

Next, go to your form and find the field you want to customize.  In the Description option, enter the following, changing the src attribute with the File URL you copied:

<img src="http://mysite.com/wp-content/uploads/2011/04/muro.jpg" style="">

You can input any HTML you want here so if you need an ordered list, an image, and some headings, you can totally do that.

Permalink

Using Visual Form Builder Pro

Check out how to do some interesting things with Visual Form Builder Pro.

Can I rearrange the select/checkbox/radio options?

Yes!

Look for the directional arrow icon next to each option.  Drag and drop the options in the desired order and save the form.

Permalink

File Upload Field: control what file types are accepted

The File Upload field allows you to control what file types are accepted on the form.  By default, it’s set to allow only images.  But this is easy to change if you know the file extensions.

If you are building a contact form to accept job applications, you might want the user to only upload a PDF, DOC, or TXT.

Using the Accepted File Extensions option on the File Upload field, here’s what you need to enter:

pdf|doc|txt

Note the pipe character ( | ) in between each file extension.

Advanced Configuration

If you are familiar with Regular Expressions, you can add a bit of logic into this.  Let’s say you also want DOCX files as well.  Here’s how that would look:

pdf|doc?x|txt

The question mark tells it to optionally accept either a DOC or a DOCX file.

Default Configuration

Here is the default configuration for a File Upload field:

png|jpe?g|gif

Permalink

How do I allow only unique entries?

To only allow unique submissions to your forms, you will need to set the Allow only unique entries based on IP option.

 

 

  1. Go to Settings > General
  2. Check the Allow only unique entries based on IP box
Please note that the same user can go to a different computer in another location and complete the form again.

Permalink

How do I arrange fields into multiple columns?

You can arrange fields into multiple columns by using the Field Layout option.  You can read this tutorial or watch the video below to learn how to use this feature.

Permalink

How do I arrange Radio or Checkbox options into multiple columns?

Arranging your Radio or Checkbox options from a single, vertical column into multiple columns is possible by using the Options Layout setting.  You can read this tutorial or watch the video below that will explain how to use this feature.

Permalink

How do I move the labels from the top to the side?

By default, the field names (i.e. labels) are arranged on top of each field item.  However, this can be customized by changing the Label Alignment option.  Go to Form Settings > General > Label Alignment. and select from either Top Aligned, Left Aligned, or Right Aligned.

  • Top Aligned: labels are arranged on top of each field item
  • Left Aligned: labels are arranged to the left of each field item and aligned left
  • Right Aligned: labels are arranged to the left of each field item and aligned right

Permalink

How do I upload multiple files?

To upload more than one file on a single form, you will need to add multiple File Upload fields.

Permalink

How to generate a unique number with each entry

To include a unique number with each entry, follow these steps:

 

 

  1. Add a Hidden field to your form
  2. Change the Dynamic Variable option to Unique ID
This number will be automatically generated upon the submission of the form and included in the email.  Because it is a hidden field, it will not be seen by the user on the form.

Permalink

How to limit the number of entries

To limit the number of entries a form can have, you will need to do the following:

 

  1. Go to Settings > General
  2. Find the Entries Allowed option
  3. Enter the number of entries you want to collect
Once your form has collected that many entries, the form will stop accepting submissions.
If you would like to collect unlimited entries, leave the option blank.

 

Permalink

Load CSS when using the template tag

While the recommended way to display a form on your page is by using the shortcode, you are also able to use a PHP template tag.  When using the shortcode, the CSS loads only on pages where a form exists.  However, this is not possible with the template tag and the CSS must be loaded manually.

All that you need to do is find the “Always Load CSS” option in the Visual Form Builder Pro > Settings menu.

Permalink

Scheduling the form to turn on or off by date/time

  1. Go to Settings > General
  2. Find the Schedule Start Date and Schedule End Date options
  3. Use the date and time picker to set your schedule
You can use either or both options.  So, if you need a form to end at a certain time only, just set the Schedule End Date.  Similarly, if you need a form to start accepting submissions at a certain time but be available forever thereafter, just set the Schedule Start Date.

 

Permalink

Using Bulk Add Options

To add multiple options, all at once, is easy with the Bulk Add Options feature.  You can select from predefined options such as Countries, Days, Months, Years, and several other categories.  Watch the video below to see how to use this feature.

Permalink

Using Conditional Logic

Conditional Logic is a way to apply rules to your form based on the user’s input and behavior. If you need a way to show or hide particular fields (or even entire sections) based on the what users have selected, then conditional logic is how you do it.

Permalink

Using the Name or Email field as the Reply-To

By default, the email that is sent out by Visual Form Builder Pro uses a static name and email address that you enter into Settings > Email.  However, you can set this to dynamically change based on the user’s input.  This makes it much more convenient if you want to directly reply to someone who contacts you.

When you make an email in a program such as Gmail or Outlook, that program controls the sending details.  It knows your display name (usually your first and last name), your email address, subject line, and all other things that go along with an email.

However, when sending an email without one of these programs we have to tell the server what each of those are.

Instructions

  1. Go to your form
  2. Make sure you have a Name and/or Email field
  3. These fields must be required (Required = Yes)
  4. If they are not required, change the options and click Save
  5. Go to Settings > Email
  6. Change the User’s Name and/or User’s Email to your Name and Email fields, respectively

Permalink

What is the Instructions field for?

The Instructions field is a special form item that isn’t really a form item.

With this item you are able to insert custom text or HTML in the middle of your form.  You can even include images!

Because this item does not collect any data, it is not part of the submitted form data and thus not included in the email.

Permalink

Advanced Topics

These topics are for those brave souls who aren't afraid of code.

How do I add my own category to Bulk Add Option

If you find yourself using the Bulk Add Options quite a bit, you might find it useful to add your own category so you aren’t always having to copy and paste your options in.

 

In this case, you can use the vfb_bulk_add_options filter.  Refer to the documentation for more information.

 

Permalink

How do I change the action attribute on the form?

The action attribute for a form is in reference to the HTML code for a form.  For example, a Visual Form Builder Pro form may look something like this:

<form id="contact-us-1" method="post" enctype="multipart/form-data" action="">

 

By default, the form’s action will always use the current page, which is why it’s blank.  However, by using the vfb_form_action filter, you can change the behavior for what happens when a form is submitted.  The most common reason for changing this would be to point to your own script for processing and sending.  This is great for when you want to use Visual Form Builder Pro to build the form but utilize your own scripts for saving or sending the data.

 

Permalink

How do I collect information from logged in users?

In some cases, you want to save your users time having to enter in information that may already be stored in your WordPress database.  Such information might be their name, email, or any custom field that exists.

 

Visual Form Builder Pro includes the vfb_field_default filter.  The sample PHP code on the documentation page shows how to add the user’s name and email address to certain fields.

Permalink

How do I customize the Address field?

The Address field is comprised of several different inputs that is combined on form submission to present a single block of text.

However, you may only want a few of these fields instead.  To customize the Address field, you will need to use the vfb_address_labels filter.  Please refer to the documentation for that filter for some sample code.  Code for filters and actions should be placed in your theme’s functions.php file.

Permalink

How do I keep the form displayed after submission?

By default, Visual Form Builder Pro will hide the just-completed form and display the confirmation message (if that’s what is selected).

 

You may want to display the confirmation message and keep the form displayed.  This is where the vfb_prepend_confirmation filter comes in.  Setting this filter for a form will prepend the confirmation message to the beginning of a form after is has been submitted.

 

Please note that this filter will only work if your confirmation form settings are set to display a Text Message after submission.

Permalink

How do I remove empty fields from the email?

If you have a particularly long form, the email that is built can get pretty long, too.  If you’d rather only receive the data that was filled out instead of every form item (blank or not), you have a couple of options.

The easiest option is to check the “Skip Empty Fields in Email” setting in the VFB Pro > Settings menu. This will affect all forms.

If you’d like to control this option for each form, you can use the vfb_skip_empty_fields filter.

Please refer to the documentation for that filter for some sample code.  Code for filters and actions should be placed in your theme’s functions.php file.

Permalink

How to require min or max character length

In some cases, you need to set a minimum or maximum length on the number of characters that are inserted into a field.  This is where some custom validation comes into play.

The way to insert this validation is easy.

  1. Find the field to edit and click on the down arrow
  2. Go to the CSS option and insert either of the following
  3. For minimum: {minlength:10}
  4. For maximum: {maxlength:10}
  5. To combine the two: {minlength:10,maxlength:10}

Customize the number for your needs.

Works with text and checkbox fields.

That’s it!

Permalink

How do I include the “Instructions” field in the emails?

By default, there are several fields not included in the emails. The majority are things like the verification and submit data; information that is passed along via PHP but unnecessary when viewing in an email.

The “Instructions” field is one of these fields not included.  Using one of the many hooks, however, this can be controlled.

Please see the vfb_removed_field_types filter for more information.

Permalink

Payments Add-On

General Info

General information about the Payments Add-On.

Can I accept a coupon with my payment?

Coupon codes are not supported by PayPal at this time.

An alternative is to use the discount_amount or discount_rate advanced variables.  See the PayPal documentation  for more information.

 

Permalink

Can I use another payment gateway other than PayPal?

At this time, PayPal Standard is the only payment gateway.

Other gateways are planned for integration in future versions.

Permalink

What happens after the Payments form is submitted?

When a user submits the form, the content is emailed just like every other Visual Form Builder Pro form and saved in the database just like a new Entry.

The only difference is that users will be redirected to PayPal to complete their purchase.  Users can still choose to back out of the transaction, so consider the email a notification that a payment was intended.  You will still need to confirm their payment within PayPal.

Permalink

Using the Payments Add-On

Frequently asked questions for performing certain actions with the Payments Add-On.

How do I add taxes?

PayPal

 

To apply taxes to your PayPal cart, you will need to utilize the Advanced Variables section.  PayPal has two different types of taxes you can apply to your cart: flat tax or percentage.

 

Flat Tax

Add the following variable and a custom tax value to the Advanced Variables section:

tax=1.25

 

Percentage

Add the following variable and a percentage value to the Advanced Variables section. Allowable values are numbers 0.001 through 100

tax_rate=1.25

 

Note: if you do not set these variables, tax may still be applied if you have configured your PayPal profile to charge tax.

 

Permalink

How do I assign quantity?

At this time, you cannot assign quantities directly to the pricing structure.

 

However, you can use your Radio/Select/Checkbox options to indicate the quantity desired.

 

Example

 

How many people will be attending?

  • 1 – $10
  • 2 – $15
  • 3 – $25

 

When assigning prices for the above field, simply enter the prices (10.00, 15.00, 25.00) into the matching option.

Permalink

Negative Prices

When assigning prices to your fields, you may want to have certain options that allow you to deduct a certain amount from the total.  This can be done by inserting negative prices.

 

All you need to do is insert a negative amount into the price field: -10.00

 

Permalink

Troubleshooting

Tips for troubleshooting common errors or problems with the Payments Add-On.

“Empty cart” error

If you have setup your form to accept PayPal payments but see the “Empty cart” error when proceeding to PayPal, it could be one of a number of things.

Troubleshooting Steps

  1. Make sure you have checked the “Enable Payment” setting
  2. Make sure you have assigned prices to at least one field
  3. If you have done all of the above, check for theme/plugin conflicts

Quick Test

  1. Check the “Enable Payment” setting
  2. Check the “Show Running Total” setting
  3. View your form and see if the total adjusts as you use the form
  4. If the running total updates properly, the PayPal error should be resolved
  5. If not, check for theme/plugin conflicts

Permalink

Form Designer Add-On

General Info

General information about the Form Designer Add-On.

Can I use my custom form design on another site?

At this time, the only way to export a form design to another site is by using the ‘All Forms’ export option under the Visual Form Builder Pro > Export menu.

Please note that when importing this file to another site, you should take care to only import when no other forms exist.

 

Permalink

Does the Form Designer Add-On work in multisite?

Yes, all Visual Form Builder Pro products work in multisite.

When network activated, each site will gain their own Visual Form Builder Pro menu with a Form Design option in said menu.

 

Permalink

Using the Form Designer Add-On

Frequently asked questions for performing certain actions with the Form Designer Add-On.

Can I adjust the width of my forms?

Yes!

Visual Form Builder Pro is built with responsive, fluid layouts in mind.  Your forms will automatically adjust to the width of your theme’s content container.

If you need more control, the Form Designer add-on has a width setting. You can adjust the width for each form by electing to use percentages, pixels, or auto (the default).

Permalink

Can I change the font size?

Yes!

The Form Designer add-on allows you to change the font size of the following output:

  • Labels
  • Fields
  • Descriptions
  • Paging Buttons
  • Validation Errors

Permalink

Create User Add-On

General Info

General information about the Create User Add-On.

Do regular Visual Form Builder Pro fields get added to the User Profile, too?

No.  Typical fields such as those under the Standard and Advanced tabs are not added to the newly created User.  Only the Username, Password, and Email fields are added to the new user account.

Permalink

How are new users saved in the database?

The Create User add-on will create a normal WordPress user in the standard user table.

 

Permalink

What happens after the Create User form is submitted?

When a user submits the form, the content is emailed just like every other Visual Form Builder Pro form and saved in the database just like a new Entry.

The only difference is that a new user is created.  The WordPress “New User” registration email will be automatically sent as well.

That’s it!

Permalink

Using the Create User Add-On

Frequently asked questions for performing certain actions with the Create User Add-On.

How do I make a form that will create a user?

After you have installed and activated the Create User add-on, you will need to add several fields to a form in order to initiate the process.

 

Add each of these fields to your form if they do not exist:

 

  1. Username (Advanced tab)
  2. Password (Advanced tab)
  3. Email (Standard tab)
Mark all of them as Required to ensure a user is properly created.

 

Permalink

Create Post Add-On

General Info

General information about the Create Post Add-On.

Can I create the registration forms without password and email?

No.  Every new WordPress user must have a username, password, and email.

Permalink

Do regular Visual Form Builder Pro fields get added to the Post, too?

No.  Typical fields such as those under the Standard and Advanced tabs are not added to the newly created Post.  Only fields under the Post tab are inserted into the Post.

Permalink

What happens after the Create Post form is submitted?

When a user submits the form, the content is emailed just like every other Visual Form Builder Pro form and saved in the database just like a new Entry.

The only difference is that a new Post is created.  By default, it’s set as a Draft.

Permalink

Using the Create Post Add-On

Frequently asked questions for performing certain actions with the Create Post Add-On.

How do I make a form that will create a post?

After you have installed and activated the Create Post add-on, you will need to add several fields to a form in order to initiate the process.

 

Add any of these fields to your form if they do not exist:

 

  1. Post Title (required)
  2. Post Content
  3. Post Excerpt
  4. Post Category
  5. Post Tag
  6. Custom Field
As noted above, the only required field is the Post Title.

 

Permalink

Display Entries Add-On

General Info

General information about the Display Entries Add-On.

Can I display more than one table on a page?

Yes!

To display another table on the same page, simply make a new shortcode and add it to the page.  You can have as many tables displaying different data or dorms on a page as you want.

 

Permalink

The table is only displaying the first 1000 entries

The Display Entries limits a single table to the first 1000 entries.

 

To display the next set, you will need to add the page attribute to the shortcode.

 

Example

[[vfb-display-entries id=1]]

[[vfb-display-entries id=1 page=2]]

Permalink

Using the Display Entries Add-On

Frequently asked questions for performing certain actions with the Display Entries Add-On.

How do I display a single entry?

To display a single entry instead of every entry for a form, you will need to use the entry_id attribute.

 

Example

[vfb-display-entries id=1 entry_id=15]

 

Permalink

How do I display a table of entries on my site?

Here is how to use the Display Entries add-on:

 

 

  1. Once you have activated the plugin, simply visit the Visual Form Builder Pro menu and go to the new Display Entries page.
  2. Select a form to work with
  3. Check or uncheck fields you want to be displayed
  4. When finished customizing, copy and paste the shortcode into a Post or Page.  Alternatively, you can use the Template Tag from directly within your theme.
By default, the following fields are displayed:
  • Entries ID
  • Date Submitted
  • IP Address
  • Subject
  • Sender Name
  • Sender Email
  • Emailed To

Permalink

How do I display the user’s data after the form has been submitted?

Please note that this feature is only available for customers with Visual Form Builder Pro and the Display Entries add-on installed.

 

To display the user’s data after a form has been submitted, follow these instructions:

 

  1. Select your form to edit
  2. Click on the Settings button
  3. Open the Confirmation section
  4. Select the Display Entry option
  5. Enter in optional confirmation text

Permalink