Untorch

Simple Integration

  1. Copy the line of code from your dashboard.
  2. Paste it on your website where you want the form to appear.

Example

<script type="text/javascript" data-untorch-campaign="###" src="https://untorch.com/js/untorch.min.js"></script>

Result


Note: You can only add one snippet (email capture form) per page with the simple integration.



Customize the look

Seamlessly integrate Untorch with the look and feel of your website.


  1. Paste the widget from your dashboard with your other script tags (i.e. header or footer).

    <script type="text/javascript" data-untorch-campaign="###" 
    src="https://untorch.com/js/untorch.min.js"></script>
  2. Add these 3 elements to your page

    <input type="text" data-untorch-element="email" />
    <button data-untorch-element="submit"></button>
    <div class="alert-message" data-untorch-element="alert"></div>
  3. Style them with CSS

When the widget loads, it will find those 3 elements and bind to them.

Note: Only include the line of HTML from your dashboard once. Even if you have more than one email capture form.  Untorch.js will connect to all of your email capture forms as long as they have the data-untorch attribute.

Example

<head>
  <script type="text/javascript" data-untorch-campaign="###" 
src="https://untorch.com/js/untorch.min.js"></script> </head> <body> <form> <div data-untorch-element="alert"></div> <input type="text" data-untorch-element="email" placeholder="Email" /> <button data-untorch-element="submit">Sign up</button> </form> </body>


API

Untorch's API opens a myriad of possibilities -- like building your own success page/modal.

Include the api on your site

(from your dashboard, make sure it is the API one).

<script type="text/javascript" data-untorch-campaign="###" src="https://untorch.com/js/api.min.js"></script>

submitSignup(email, callback)

Checks if the person signing up was referred and submits that information with their email address.

Untorch.submitSignup(email, function (error, data) {
  // this function is called asynchronously
});

Untorch returns a JSON object that looks like this:

data = {
  // unique url for sharing
  url: "https://..."
  // the email address that was submitted
  email: "example@mail.com",
  // number of people who signed up with this person's unique url
  referrals: 0,
  // the unique token from their unique url
  referralToken: "ABC123"
}

Optional: If you need to, you can submit the referral token with their email.

var signup = {email: ..., referralToken: ...}
Untorch.submitSignup(signup, function (error, data) { ... });

getSignup(email, callback)

Untorch.getSignup(email, function (error, data) { ... } );

After an email address has been submitted, you can get their information by using Untorch.getSignup( ).

It returns the same JSON object as Untorch.submitSignup( ).



Examples / Tutorials

SquareSpace

https://youtu.be/2RYjeh94nsg

Weebly

https://youtu.be/scTsorvLmkA

Wordpress

  1. Install plugin: Shortcoder Wordpress plugin:

    https://wordpress.org/plugins/shortcoder/
  2. Create a new shortcode with Shortcoder and call it: untorch.

  3. Open the Shortcoder plugin (most likely under the Settings tab on your Wordpress side menu), and have the shortcode contain the following code (replace "###" with your own id):

    <script type="text/javascript" data-untorch-campaign="###" 
    src="https://untorch.com/js/untorch.min.js"></script>

    Note: Copy paste the script code under the "text" (not "visual") tab in the plugin. Failing to do so may result in your script being read as text and not Javascript.

  4. If you are experiencing issues with the input field getting disabled, create a new shortcode with the following code and name it enable_input:

    <script type="text/javascript">
    setInterval(function () {
        document.getElementsByClassName("untorch-email-input")[0].removeAttribute("disabled");
    }, 500);
    </script>
  5. Add the following text on the page you wish to have the capture form:
    [sc:untorch] (and [sc:enable_input], if necessary)



Support and Limitations

Untorch does not support implementations with any platform where you cannot add your own javascript code.

If you have problems putting Untorch on your site, feel free to contact us at support@untorch.com.