Gravity Forms QR Code

What does it do?

Gravity Forms QR Code allows you to generate QR codes from Gravity Forms field values, or scan QR codes to insert values into Gravity Forms fields.

Captured field values can be output as QR codes in form confirmations, notifications, and anywhere else merge tags are supported. QR codes can be scanned into Single Line Text fields directly on forms. QR codes can also be scanned into other field types by filter.

Here’s how you can use QR codes to enhance forms and business workflows:

• Sell tickets to an event and check in attendees.
• Integrate with flows where existing QR codes are created, such as government agencies or trade shows, and easily facilitate the transfer of data between online and offline spaces.
• Generate scannable coupon codes and scan them into your order form.

Features

Documentation

1. How do I enable this functionality?
   1. Generate QR Codes
   2. Scan QR Codes
2. Feature Details
   1. QR Code Merge Tags
      1. Modifiers for the QR Code Merge Tag
      2. Generate QR Code From a Choice Field’s Value
      3. Supported Barcode Types
         1. Linear
         2. Square
   2. [gpqr] Shortcode
   3. Scan QR Codes In Forms
      1. Supporting Additional Formats
3. Integrations
   1. Preview Submission
   2. Unique ID
   3. Populate Anything
4. Use Cases
   1. Use-case: Event Registration
   2. Use-case: Integrating Into Existing QR Flows
   3. Use-case: Generate Scannable Coupon Codes
   4. Use-case: Product Inventory
5. Known Limitations
6. FAQs
   1. Where is the QR field/feed?
   2. How can I use the QR code scanner on other fields?
   3. Why does my browser request camera permission every time I use the in-field QR scanner?
   4. Why does my QR code look strange in GravityPDF?
7. Hooks

How do I enable this functionality?

After installing and activating Gravity Forms QR Code, QR codes can be generated via merge tags and scanned with a Single Line Text field.

The following instructions will show you how to generate a QR code and scan that QR code using a Single Line Text field.

Generate QR Codes

	Navigate to a form’s notification settings.
	Edit an existing notification or create a new one.
	Insert the merge tag for a field and add the :qr merge tag modifier.

Scan QR Codes

	Add a Single Line Text field to your form.
	Open the field’s settings, navigate to the Perks section, and check Enable QR Code Scanner.
	Preview the form to see the code scanner button is auto-appended to your field.

Feature Details

QR Code Merge Tags

Gravity Forms QR Code can turn any field’s value into a QR code with the :qr merge tag modifier. Simply add it to any merge tag in any place field merge tags are supported, such as Confirmations and Notifications. When the merge tag is rendered, instead of showing the field’s value it will show a QR code of that value.

The :qr merge tag works with most merge tags that are available on Notifications and Confirmation pages. Generate QR codes for entry IDs, post/page IDs, or combine them with field values using the [gpqr] shortcode!

Modifiers for the QR Code Merge Tag

• :url – Returns the URL of the generated QR code rather than the HTML image.

  {My Field:1:qr,url}

• :size – Specify the size (height and width) in pixels of QR codes. This does not support non-QR codes.

  This would generate a 200px QR code.

  {My Field:1:qr,size[200]}

• :sizefactor – Specify the size of non-QR codes such as PDF417 and UPCA. Since each code has a different standard size, the size output is relative to the default size for that code.

  This would generate a double size PDF417.

  {My Field:1:qr,type[PDF417],sizefactor[2]}

  This would generate a half size UPCA.

  {My Field:1:qr,type[UPCA],sizefactor[.5]}

• :bg_color – Specify a hex color for the QR code background.

  This would generate a QR code with a red background.

  {My Field:1:qr,bg_color[#f00]}

• :fg_color – Specify a hex color for the QR code foreground.

  This would generate a QR code with a blue foreground.

  {My Field:1:qr,fg_color[#00f]}

• :type – Specify a barcode type for the code. Here is a list of supported barcode types.

  This would generate a PDF417 barcode.

  {My Field:1:qr,type[PDF417]}

Generate QR Code From a Choice Field’s Value

By default, merge tags in Gravity Forms will render any choice-based fields, such as Drop Down or Radio Button, as the field’s label. If you have activated the show values option on the choice field and set a different value, you might want to display a QR code from that value instead of the label. To do this, add the :value merge tag modifier to your merge tag.

{Drop Down:2:qr,value}

Supported Barcode Types

By default, the :qr merge tag modifier will output a QR code, but GF QR Code supports outputting a wide variety of barcode types using the :type modifier. Below are some examples of popular barcode types and the output from GF QR Code.

PDF417	{My Field:1:qr,type[PDF417]}
UPCA	{My Field:1:qr,type[UPCA]}
PHARMA	{My Field:1:qr,type[PHARMA]}

Currently GF QR Code supports outputting the following barcode types.

Linear

[gpqr] Shortcode

Use the [gpqr] shortcode to combine multiple fields or any other data you need in your QR code. For example, to add a static prefix to your QR code, you can combine a string with the field’s merge tag.

[gpqr]Ticket Number: {Ticket ID:3}[/gpqr]

The shortcode accepts the following attributes:

• format string

  When set to url, will return a link to the QR image file. Defaults to html, which returns the image markup for the QR code.

• size integer

  The size, in pixels, of the QR code image file. Defaults to 200. This does not support non-QR codes.

• sizefactor integer

  Specify the size of non-QR codes such as PDF417 and UPCA.

• bg_color string

  Specify a hex color for the QR code background.

• fg_color string

  Specify a hex color for the QR code foreground.

• type string

  Specify a barcode type for the code.

The following example will output a 500 pixel QR code that contains 2 field values and some static text.

[gpqr size="500"]Ticket Info: {Ticket ID:3} {Price:4.3}[/gpqr]

The following will output a URL to the hosted QR code image that is 300 pixels.

[gpqr size="300" format="url"]{Ticket ID:3}[/gpqr]

This is the URL generated from the above shortcode:

http://yoursite.local/wp-content/uploads/gravity_forms/gpqr-codes/25b22f6b66f94db6d1e889b9a85c7fe4.png

Scan QR Codes In Forms

Gravity Forms QR Code supports scanning QR codes directly into fields on your forms. To activate this feature, navigate to the Perks tab for the desired Single Line Text field on your form, then check Enable QR Code Scanner.

By default, the scanner only supports Single Line Text fields; however, other field types can be enabled by filter. Learn more.

Once activated, GF QR Code will add a QR code icon to the end of the field. When clicked, the user can use their device’s camera to scan the QR code.

Supporting Additional Formats

GF QR Code supports scanning in additional formats outside of QR code, with the use of the gpqr_scanner_config hook. By default, only QR code scanning is supported, but the library that powers GF QR Code supports scanning UPC, EAN, and many additional formats.

Integrations

GF QR Code integrates seamlessly with our Perks and other Gravity Forms add-ons.

Preview Submission

QR code merge tags can be displayed in a submission preview in multi-page forms using Preview Submission. Insert the QR code merge tag into an HTML field on the last page of your form, and it will be displayed when the user navigates to the page.

Unique ID

Unique ID field values can be used to generate QR codes. The :qr merge tag modifier fully supports Unique ID fields.

Populate Anything

Using Populate Anything’s Live Merge Tags, QR codes can be generated live on the page when a user enters values into a field.

Use Cases

Use-case: Event Registration

Selling tickets and checking in attendees is made easy by combining QR Code with Easy Passthrough. One form sends a QR code to customers after purchasing tickets, and another form scans those QR codes at the event entrance.

Start by setting up your ticket purchase form however you’d like. Our form captures Name, Email, and Ticket Type.

On that form’s notification, use the [gpqr] shortcode to generate a QR code for a link to the event check-in form. Include the Easy Passthrough Token in the URL to enable purchase lookup.

[gpqr]https://mysite.com/check-in/?ep_token={Easy Passthrough Token}[/gpqr]

For the check-in form, add the fields you want to load from the customer’s purchase. Then, set up an Easy Passthrough feed to pass through the values from the purchase form.

At the event entrance, staff can scan the QR code using any QR scanning app on their phone. Once the code is scanned, a browser will open the check-in form and pre-load the user’s information. Attendees could even self check-in at a kiosk.

Use-case: Integrating Into Existing QR Flows

Many sites generate QR codes to ease data transfer between the online and offline spaces. For example, many government sites use QR codes to denote vaccination status. With GF QR Code, you can easily retrieve the data in the QR code and store it in a field on your form.

Start by adding a Single Line Text to your form. Then, navigate to the Perks tab and check Enable QR Code Scanner.

Once activated, GF QR Code automatically adds a scan button to the field, making it easy to scan codes.

Use-case: Generate Scannable Coupon Codes

Pairing GF QR Code, the Gravity Forms Coupons add-on, and GF Unique ID, you can easily create scannable coupon codes for use with your purchase forms.

Begin by adding a Unique ID field to your form. Note the field ID, as you will be using it in the configuration of our coupon generation snippet.

Configure the snippet for the type of coupon, amount, and set the source_field_id to match your Unique ID field’s ID.

new GW_Create_Coupon( array(
	'form_id'         => 608,
	'source_field_id' => 1,
	'plugin'          => 'gf',
	'amount'          => 15,
	'type'            => 'flat'
) );

In your form’s notification, insert the merge tag for your Unique ID field and add the :qr merge tag modifier to output a QR code of the unique ID.

On your purchase form, add a Coupon field and check Enable QR Code Scanner in the Perks tab.

Customers can then scan the QR code to apply the discount to their purchase.

Use-case: Product Inventory

Take WooCommerce product creation one step further by adding scannable QR codes to track product SKUs. By pairing GF QR Code with GF Unique ID, you can easily generate product SKUs when creating a WooCommerce product, and then output a QR code for that product SKU in your form confirmation, notification, or a printable PDF.

Simply add a Unique ID field to your product creation form and map it to the _sku Custom Field as shown in our How to Create WooCommerce Products with Gravity Forms article.

You can then create a product restock request form that uses Populate Anything to populate product details. When inventory is low, the product’s QR code is scanned, the rest of the product info is automatically populated, and the only thing that needs to be manually entered is the desired quantity.

Known Limitations

• Translating the text in the QR code scanner is not supported due to a limitation in the 3rd-party library that provides it.

FAQs

Where is the QR field/feed?

Instead of introducing new fields to handle QR codes, we opted to integrate them with existing Gravity Forms functions. QR code generation is done with the :qr merge tag modifier. QR codes are scanned in Single Line Text fields. Simply enable the QR code scanner in the Perks tab.

How can I use the QR code scanner on other fields?

To add the QR code scanner to a field that isn’t currently supported, use the gpqr_is_supported_field hook.

Here are a few examples:

• To enable the scanner on a Parapgraph field, use this snippet.
• To enable the scanner on an Email field, use this snippet.

Why does my browser request camera permission every time I use the in-field QR scanner?

Camera permissions vary significantly between your devices and applications. We will do our best to document each combination as it is reported here.

iPhone Safari

It is possible to grant a specific website permission to use your iPhone camera permanently. We recommend only granting this permission if you own the website. If you are certain that website can be trusted, follow these instructions.

Why does my QR code look strange in GravityPDF?

GravityPDF caps the height of images in the header and footer. You can work around this limitation by generating the image tag manually and setting a max-height style property like this:

<img src="{:1:qr,url,size[200]}" style="max-height:200px">

Hooks

• gp_qr_code_merge_tag_value
  
• gpqr_content_pre_generate
  
• gpqr_encoding
  
• gpqr_file_content
  
• gpqr_is_supported_field (JS)
  
• gpqr_on_scan_success (JS)
  
• gpqr_params_pre_generate
  
• gpqr_scanner_config (JS)