User Guide (V. 4.3)

WP Triggers has been upgraded with some awesome new features like two types of Wildcards, Button Styling controls, Exporting capabilities and more.  This page will show you how to use it.

Click an icon to jump down to that section

WPTriggers Basics

If you’ve never used WPTriggers before, you should begin with this section.

Trigger History

Easily export the triggers that users submitted with new powerful new controls.

Wildcards

Wildcards let you represent a character(s) so you don’t have to type tons of triggers.

TriggerBox Management

Learn how to easily Export, Duplicate and Import your Trigger Boxes.

General Options

Learn how to use the new Trigger Boxes options (Placeholders, Shake It, Numbers Only, etc…)

Examples

Instantly download a Virtual Scavenger Hunt, a Zip Code search and more.

Styling Controls

You don’t have to fight with your Trigger Boxes to style them anymore. It’s now a lot easier!

License

In order to activate WP Triggers you'll need a valid CodeCanyon Purchase Code

WPTriggers Basics

At it's core, WP Triggers is plugin that makes websites way more interactive.  It lets you pre-populate triggers (ie: "90210" OR "WALTERWHITE") and an action (ie: display a YouTube video OR redirect the user to a secret URL).  Once your settings are saved it gives you a shortcode to paste on any page/post in your site.  Once a website visitor types in one of your triggers, it performs the action.  It's simple and full of potential!

WP Triggers is kind of like IFTTT for your website content, essentially it's an if/then statement:

The interface is incredible simple but powerful.  When adding/editing a Trigger Box you add Triggers on the left and Actions on the right.  You can specify multiple Triggers for one Action, like this:


There are more settings on this page but for now let's say that you are done editing your Trigger Box, once saved you simply copy and paste the shortcode onto a page/post and visitors can then type in Triggers and (if correct) see the associated action.

Wildcards

Using Wildcards is extremely useful if your trigger has slightly different variations that you want to include.  For example if you are making a zip code search instead of typing the following triggers: 33624, 33625, 33626, 33627 you could just type one trigger 3362_.  The underscore represents a single character, WPTriggers also support a percent sign which represents multiple characters.  Here's some useful examples:

WP Triggers supports two types of Wildcards

Once you understand Wildcard, you can get a fancy with it! For example you can have a trigger like this 336%45 which would make these valid triggers: 3367245 and 3369245 but NOT these: 3369925 and 3362874.

NOTE: You can combine Wildcards and the option to “Only allow numbers” (in the General Options) to make a very useful Zip Code search.

General Options

Being able to create a customized experience has always been the goal of WP Triggers and these General Options help you do just that.  Experiment with these fun and useful options to add new functionality to your Trigger Box.

Placeholder Text: This is text that displays in the Trigger Box when the page loads and disappears when the user clicks in the box.  This is useful to instruct visitors what to type in the box.

Only Allow numbers to be entered into this Trigger Box: This is useful for US zip codes and phone numbers.

Hide this trigger Box after a visitor searches for a trigger: This is useful when you do not want the user to enter in anymore triggers, it also makes the page look cleaner once submitted.

Scroll the visitor down: If you are putting a Triggerbox towards the bottom of your website AND you are using WordPress shortcodes check this box.  This will bring the visitor back down to the Trigger Box when the page reloads (which it needs to so it can render the WP shortcode).

Shake: If you want to draw a little attention to your Trigger Bos check this box (NOTE: Works in MOST browsers / devices)

Styling Controls

There are two sections that deal with styling Trigger Box Styling and Button Options.  By default those elements are controlled by your theme, however WPTriggers 4 now has the ability to easily override those CSS styles and apply it's own styling.  Below is an overview of each section:

Trigger Box Styling
Button Options
Trigger Box Styling

The default Trigger Box styling values are great but if you want to customize it a bit more use the controls below.

  • Text Alignment: How should the text align within the Trigger Box?
  • Text Color: What color should the text be?
  • Background Color: What color should the background be?  Hint: make sure that you'll be able to read the text that appears over it!
  • Border Color: There is a 1 pixel border, what color should that be?
  • Text Size: How big should the text be? Hint: 2em is a good size!  Start there.
  • Corner Radius: Want rounded corners?  Enter a number here.  Hint: 3 is a good radius!
  • Vertical Padding: How much space should be between the text and the top/bottom border?
  • Horizontal Padding: How much space should be between the left/right border?
Button Options

Having a submit button helps some people understand how to submit your Trigger Box (if you do not enable a button, the visitor will have to hit the Enter key on their keyboard).  Below are some tips on how to use this section.

Activate Button: This allows you to use a button with your Trigger Box
Button Layout: Where do you want the button to appear?

Regular Button OR an Image Button: Selecting one of these options allows you to either use a regular button or any image button (this gives you more flexibility in designing your button).

  • Regular Button Options: You can give it a custom label and then either style the button using easy custom styles OR chose to use the button styles that come with your WordPress theme.  You could also style the trigger box using the custom CSS class.
  • Image Button Options: Paste in a URL to the image button and then adjust the vertical and horizontal margin to line it up perfectly!

Trigger History

Being able to know what triggers visitors entered into your trigger boxes is really useful and the Trigger History section has some new features that make this even better!  WP Triggers 4.0 now supports deleting triggers (individually or a group) and exporting triggers as a CSV! Here's how to use it:

  • Better Filtering: If you're looking for submitted triggers from a particular Trigger Box or Date Range you can specify those parameters here.  You can also choose has many triggers per page to display.
  • Export CSV: If you need to do some analysis in a spreadsheet program or export email address into your mailing list service, simply get the triggers you want to export on your screen (using the filtering options described above) check all the boxes (or just check the box in the row header which selects all the items on our screen) and click the Export as .CSV button.  You can then import that CSV into most data driven applications.
  • Delete: If there are triggers you want to clean up your data, select the items you want to remove and click the Delete button.

TriggerBox Management

WP Triggers now includes the ability to Export Settings, Import Settings and Duplicate Trigger Boxes.  This is useful to keep a local copy of your Trigger Box settings or to share your unique Trigger Boxes with the world (the Triggers that visitors have submitted are NOT included in these export files).

On the All Triggers screen simply move your mouse over any of your Trigger Boxes to see the new options.

Export Settings: This will download all your Trigger Box settings (the submitted Triggers are NOT included) as an .XML file.

Duplicate: Clicking this will duplicate the Trigger Box (useful if you want to test something new).

Import: This is where you can import any XML Trigger Box settings file (you can find some in the Examples section of this page)

Examples

WPTriggers is incredibly flexible and to get you started we've created a bunch of Triggers Boxes.  Simply download and Import the example Trigger Boxes below then tweak for your particular needs.  If you've come up with a great use For WPTriggers, we'd love to hear about it.

Zip Code Search

Only offer your service to a limited area? Let visitors search by zip.

Scavenger Hunt

Integrate Google Maps Streetview for a cool sight-seeing feature!

Author / Book Promo

Get more people to buy your book by giving away a free video to readers.

Music Band Promo

Offer a special version of a song to your fans that bought your last album.

Physical Product Offer

If your physical product has a unique serial number, use that as a trigger.

Secret Page Redirect

Create a new page (not on your navigation menu) and use a trigger box to access it.

Use WP Shortcodes

Easily integrate the shortcode from any other plugin (or another Trigger Box)!

Email Collection

Collect email addresses for a free giveaway (use Trigger History to download them).

Adventure Story

Let people explore your story how they want to!

License (CodeCanyon Purchase Code)

In order to use WP Triggers on your website you'll need to have a valid CodeCanyon Purchase Code for every WordPress installation you want to install it on.

Once you activate WP Triggers you'll be presented with a screen that asks for your purchase Code.  Simply by pasting in your Purchase Code and clicking Activate, you'll unlock the full power of WP Triggers.

MOVING SITES? If you are going to move the website to another domain or just want to use your purchased copy on another domain, simply click the Remove Purchase Code button BEFORE you move the site.

WP Triggers Changelog

Version 4.3

  • Added CodeCanyon License functionality
  • Added new WP admin menu icon (the new infinity symbol)

Version 4.2

  • Trigger Box sections now collapse/expand (cleaner interface)
  • Instead of giving no values for styling elements (like color), we created a beautiful set of default settings
  • Added a quick link to the Wildcard section on this page to help people understand how to use Wildcards
  • The Trigger Box editing screen now fills the screen for easy editing (it used to only fill about 60%)
  • Removed some unnecessary formatting, cleaned up some text instructions
  • Fixed the dropdown menu styling problem
  • Trigger Boxes can now be submitted with either the form button or the Enter button on your keyboard
  • When using a button on a Trigger Box that contains WP shortcode, the button no longer disappears.
  • Checkboxes now have a slick IOS feel to them