How to Install & Configure Logic Hop

Quick Reference

• Overview
• Manage your Logic Hop License Key
• Configure your Logic Hop Data Plan
• Logic Hop on a Staging Server
• Install the Logic Hop Plugin
• Logic Hop Plugin Settings
• Managing License Keys
• Logic Hop Data Storage
• Updating to a new version of Logic Hop
• Update Package Not Available Error
• Logic Hop Back-up
• Troubleshooting

Overview

If you’re familiar with WordPress plugins, Logic Hop can be easily installed and configured by completing the following steps.

If you have any questions you can book a free, live help session or click here to contact us.

Note:

• Logic Hop requires WordPress 4.6+ with PHP 5.4+
• Logic Hop will not work with WordPress.com hosted websites

Installing Logic Hop requires Administrator level access to the WordPress Dashboard. If you’re unfamiliar with installing WordPress plugins, speak with your Administrator about getting help installing Logic Hop.

Configure your Logic Hop License Key

1. Sign up for a Logic Hop License Key
2. Login to your Logic Hop account
3. Click the Order link & click on your order
4. Click License Manage
5. Copy your License Key

Generate Additional License Keys

1. On your Order page under Key Generator click Generate License Key
2. Copy your License Key

Deactivate a License Key for a Domain

1. On your Order page under Key Generator click Deactivate for the license you wish to deactivate

Delete a License Key

1. On your Order page under Key Generator click Delete for the license you wish to delete

Optional: Configure your Logic Hop Data Plan

1. Sign up for a Logic Hop Data Plan
2. Login to your Logic Hop account
3. Click the My Subscription link
4. Make sure the Domain Name is correct
5. Copy your API Key

Data Plan: Domain Name

The Domain Name in your Subscription settings should be the primary domain name of your website without any sub-domain or www. Your Logic Hop API Key will work with your primary domain name and any sub-domain.

As an example:

• By setting your Domain Name to stage.logichop.com your API Key will work with:
  • stage.logichop.com
  • www.stage.logichop.com
  • demo.stage.logichop.com

Working on a Dev or Staging Server?

If you’re working on development or staging server you will need to use the full URL for your staging website. This will typically be something like:

• dev-site-name.wpengine.com
• dev-site-name.pantheonsite.io
• dev-site-name.flywheelsites.com

Once you push your website to production, or “make it live”, you will need to update your Logic Hop Subscription with the domain name of your live website.

Data Plan: Multiple Domain Names

As of Logic Hop 3.2.3, you can add multiple domain names separated by commas for your Domain Name setting. This will allow Logic Hop to use a single API Key across multiple environments for development, staging, and production such as:

• stage.logichop.com, logichop-stage.wpengine.com, logichop-dev.wpengine.com

You can also use a single API Key across multiple domains. However it is important to note that data from one domain will not be available to any other domain as they are treated as separate websites.

Install the Logic Hop Plugin

1. In your WordPress Dashboard navigate to Plugins > Add New
2. Search for Logic Hop using the Keyword search plugins on the upper right
3. Locate the Logic Hop – Personalized Marketing for WordPress plugin and click Install Now
4. After the Logic Hop plugin installs, click Activate

Install the Logic Hop Local Storage Plugin

1. In your WordPress Dashboard navigate to Plugins > Add New
2. Click Upload
3. Select the Logic Hop Local Storage Plugin on your computer and click Install Now
4. After the Logic Hop Local Storage plugin installs, click Activate

Note: If you have a Logic Hop Data Plan you should not install the Logic Hop Local Storage Plugin.

Logic Hop Plugin Settings

1. In your WordPress Dashboard navigate to Logic Hop > Settings
2. Enter your Domain Name & License Key
3. Enter your domain name for the Javascript Referrer
4. Set your desired time for Delete Local Storage
5. Click Save Changes

Note: If you have a Logic Hop Data Plan you will not have a Delete Local Storage option.

Using an optional Data Plan?

If you’re using an optional Logic Hop Data Plan enter your API Key instead of a License Key in step 2.

If all your information is correct, the page should reload and display Logic Hop API Status: Connected. Congratulations – You’re ready to start using Logic Hop!

Getting a Not Connected message? See our troubleshooting tips.

GDPR Data Storage Settings

Logic Hop is fully GDPR compliant and provides a variety of built-in options for fine tuning your data storage. Learn how to set your GDPR Data Storage options.

Is your site using a caching plugin or service?

1. In the Logic Hop > Settings check the Enable Javascript Mode option
2. Check the Enable Javascript Variable Display option
3. Click Save Changes

Learn more about personalization & caching

Using WPEngine? No problem! Click here for a few quick additional steps.

Managing License Keys

To manage your license key:

• Login to your account
• Click Orders
• Click the License Manage button
• Manage your license on the My Order License Keys page

Move a License Key to a New Site

On the My Order License Keys page you can click the Deactivate button to release a license key from the domain to which it is currently assigned. The license key will then be available to activate within your new site’s Logic Hop Settings.

Generate a New License Key

Some license key plans include multiple licenses. To generate a new license key, click the Generate License Key button at the bottom of the My Order License Keys page.

Logic Hop Data Storage

Logic Hop uses PHP Sessions to temporarily store personalization data. If you prefer not to use PHP Sessions, or if your hosting provider does not support them, Logic Hop can store data using the WordPress Transient API.

To store data using WordPress Transients API you will need to download, install and activate the free WP Session Manager plugin. Once WP Session Manger is activated Logic Hop data will be automatically use Transients.

Updating to a new version of Logic Hop

Logic Hop plugin updates will appear as notifications within your WordPress Dashboard. To update, simply click the Update link for the Logic Hop plugin. Prior to updating, we recommend that you back up your Logic Hop data.

Update Package Not Available Error

If you receive this error or notice when trying to automatically update the Local Storage plugin one of the following has happened:

• Your license key is not in place or has expired
  • Solution: Add your active license key on the Logic Hop Settings page
• Server cache settings which cause the old package return from the server tmp folder
  • Solution: Clear server cache settings
• Server has a proxy which denies access to Logic Hop server
  • Solution: Ensure the Logic Hop IPs are white listed on your server
    • 54.86.204.72
    • 13.35.119.190
• Firewall blocking access to Logic Hop servers
  • Solution: Ensure the Logic Hop IPs are white listed on your firewall
    • 54.86.204.72
    • 13.35.119.190
• Server file/folder permissions are improperly configured
  • Solution: Ensure the following permissions are set on your server:
    • 755 for all folders and sub-folders
    • 644 for all files
• Trying to update on a multi-site network site that doesn’t have administrator permission
  • Solution: Update the plugin as a network administrator
• Plugin conflict
  • Solution: Try deactivating plugins and then try updating
• Missing Remote Get function or cURL package for PHP
  • Solution: Install the appropriate cURL packages are installed on your server

If you are unable to identify and solve the issue you can always manually update the Logic Hop Local Storage plug.

To manually update the Logic Hop Local Storage plugin

• Login to your Logic Hop account, click Downloads and download Logic Hop Local Storage
• From your WordPress Dashboard, navigate to the Plugins page
• Deactivate the Logic Hop Local Storage plugin
• Delete the Logic Hop Local Storage plugin
• Follow the instructions to Install the Logic Hop Local Storage Plugin

Logic Hop Back-up

In your WordPress Dashboard navigate to Tools > Export

• Individually select each of the following:
  • Logic Hop Conditions
  • Logic Blocks
  • Logic Bars
  • Logic Hop Goals
• Click Download Export File

Important Note: Do not click the Delete option for the Logic Hop plugin. Doing so will delete your Logic Hop data. If you accidentally delete your plugin, your Logic Hop data can be restored from your back-up files.

Troubleshooting

• Are you seeing Logic Hop API Status: API Disabled?
  • Make sure the API Key is correct
  • Make sure the Domain Name matches the domain name on your Subscription Page
• Make sure your website is running WordPress 4.5+ and PHP 5.6+

Need a hand getting up & running?

We’re here to help! You can book a free, live help session or click here to contact us with any questions.