Caldera Forms

Updated 6 months ago by Chris Hiller

Caldera Forms is a great way to have beautiful and responsive forms on your WordPress website. They also integrate perfectly with Referral Rock!

Setting up the Referral Redirect Page

  1. In your program editor, navigate to the Referral Page and choose Redirect for Referral Capture.
  2. Click on the Redirect URL button and paste the form link from to the page with your Caldera Form.
  3. Click save.

Referral Conversion Tracking in Caldera Forms

The next step in setting up Referral Rock to work with Caldera Forms is tracking conversions on your form. This will tell us which referral filled out the form, which member sent them, and any information we choose to send back from the form submission to Referral Rock.

Confirm Page With Redirect

In our testing, we've found that the confirm page with redirect option for conversion tracking works great with Caldera Forms. In this scenario, we will redirect users from your Caldera Form to a Referral Rock page and then on to a final destination. The trick is appending the form submissions onto the end of the URL from Caldera Forms in a way that the Referral Rock page can pick them up.

Step 1: Set your Referral Rock confirm page with redirect settings. You'll need to log in to Referral Rock to do this.

  1. Navigate to this link and scroll down to the section titled Redirect URL.
  2. In the box, enter the URL you want users to end up on after they submit the form. Generally this is your home page or a custom landing page or thank you page.
  3. Next, copy the URL under the Confirmation Page section at the top for use in the next step.

Step 2: Set up your Caldera Forms Redirect Processor. More details on setting up the redirect can be found here

  1. On your WordPress Admin Dashboard, click Caldera Forms.
  2. Click edit under your referral form.
  3. Click Processors on the top menu.
  4. Click Add Processor and select a Redirect processor.
  5. Add your Confirmation Page URL from step 1.
  6. At the end of the URL, add a '?' and then each parameter's name followed by '=' and then the field value from the drop down menu. Between each parameter, add a '&'. See the example URL below.
Here's an example URL, yours should look similar:
https://yoursite.referralrock.com/confirm/?firstname=%first_name%&lastname=%last_name%&email=%email_address%

Key Parameters

  • externalidentifier - Typically something unique to the customer like customer/order number
  • firstname - Passed as customer’s first name
  • lastname - Passed as customer’s last name
  • fullname - Full name can be sent as one field and will try to be parsed into first and last name, it’s preferred to use the separate first and last name fields
  • email - Passed as an email address
  • amount- Passed order amount/total

Additional Parameters

  • companyname - company name
  • referralcode - Can set to a member referral code, you can set to “TESTID” for testing
  • phone - Passed as customer’s phone number
  • note- Passed as any note or other information you want to see tied to the Referral
  • publicnote - Passed as any note that you want to be publicly tied to the Referral
  • preferredcontact - Passed as the customer’s selected preferred contact method
  • customoption1name - Passed as a custom option 1 name
  • customoption2name - Passed as a custom option 2 name
  • customtext1name - Passed as a custom text 1 name
  • customtext2name - Passed as a custom text 2 name
  • customtext3name- Passed as a custom text 3 name
  • customoption1value - Passed as a custom value tied to customoption1name
  • customoption2value - Passed as a custom value tied to customoption2name
  • customtext1value - Passed as a custom value tied to customtext1name
  • customtext2value - Passed as a custom value tied to customtext2name
  • customtext3value - Passed as a custom value tied to customtext3name

How did we do?