VLP Documentation

Visitor Logic Pro WordPress Plugin is a powerful tool that allows users to incorporate programmer type logic to their site through an easy to use interface.


VLP was built to help site admins apply dynamic “Logic” to the content of their sites without needing to find and hire a developer every time it needed adjusted.  By using the settings on a “Logic Block” the admin can adjust under what conditions that block of content will be displayed. In order to get the most out of Visitor Logic Pro, please read through this document to get an idea of the capabilities and example uses.  By no means are the examples all inclusive


VLP uses “Logic Blocks” as the foundation of its functionality.  You think of Logic blocks as a block of content that has settings associated with it to allow the plugin to determine when to show or to not show the content. Logic Blocks use your WP editor like pages and posts so you have the same control over the style of content as you do within any page or post.


Logic Blocks also allow you to use each blocks dynamic logic and apply that logic to existing content, just by wrapping the existing content with the logic-pro shortcode.  This works anywhere shortcodes are allowed in your site.You can also apply this logic to any WordPress widget by using the additional setting that VLP adds to all of your widgets. You can use Logic Blocks anywhere on your site that widgets or shortcodes are allowed without any special coding. This usually covers 99% of your site. If you want to use the Logic Block logic anywhere else in your site it will require a small amount of coding.

Lets Start With The Basics

VLP is installed by using the zip file upload method of installing WP plugins. Once installed updates can normally be applied by using the standard WP plugin update features.

After installations, simply activate the plugin.  You will need your VLP License code to unlock the advanced features of the VLP plugin.


Once activated you will find a new section in the Wordpress menu for Visitor Logic Pro.


nav_menu


Navigate to the Visitor Logic Pro Options page > General Settings tab > to enter your VLP license.


options_page


Enter your license code to unlock the advanced features of Visitor Logic Pro.


Once a valid VLP license is entered, you will be able to setup some of the advanced integration that VLP offers.

The General Settings tab has 2 functions that will help you when setting up and testing your Logic Blocks.


Clear Cached Data
VLP uses local WP storage as a short lived cache for some data retrieved from the integrated third party services. This helps to speed up the processing and also reduces the number of API calls that need to be made to the third party services. The cached values will typically not last longer than about 15 minutes, but If you are making changes to the third party service settings and need to test them right away, you can use the Clear Cached Data feature to immediately purge the local cache. 


Enable Debug for all Logic Blocks 
This will turn on a Global debugging option for all logic blocks.  Very useful for testing your logic block settings.  When enabled, any place that you use a logic block and the plugin determines that piece of content should not be displayed, a small message will be displayed to indicate why it is not being displayed.

What is a Block?

Creating Logic Blocks

Here we will cover the basics of how to create and use a Logic Block.  You can find creative examples of how to use VLP in your site at VisitorLogicPro.com.


Creating Logic Blocks is very similar to creating pages or posts. Logic Blocks are custom post types in WP.   In the Visitor Logic Pro menu you can find a list of your Logic Blocks or use the “Add New Logic Block” to quickly create a new one.


The Logic Block editor screen is basically a WP editor with a VLP settings area.


new_logic_block


 

Logic Block Title Field:  The Title field is not used by VLP for display purposes, so it is recommend that you use the title field to name your Logic Block with something that helps you remember what the settings for that Logic Block are meant to achieve.  Example.  If you are setting a Logic Block to only display on a certain category of posts, then you might want to set the something like “Display in xxxxxxx category”.  Or if using cookies, then you could use “Cookie – show after 1 day”.  Use the title to help you organize your Logic Blocks.


Logic Block Content Area:  The content area is what will displayed if the logic settings are met. You can use this are just like you do to edit any page or post.  It does support the use of shortcodes within the content area so you can use whatever other features your WP site may have.  Although technically you could use a VLP shortcode within a Logic Block,  it is not recommended that you do this.   Nesting Logic Blocks is not supported and could result in unpredictable results.

general_settingsMaster Switch:  The Logic Block master switch has 3 settings


On (Always Show) – The setting are ignored and this block will always be shown.


Off (Always Hide) – The settings are ignored and this block will never be shown.


Use VLP Logic – Use the Logic Block settings to determine if the content will be shown.


Login Status: Default is everyone.  If you only want to show the block based on if the visitor is logged into WP or not, change the value in the dropdown to Logged in or Not Logged in.


Display Start and End Dates:  You can schedule when this content block will be displayed.  The dates can be scheduled down to the minute. The fields have a date time picker to help you set the values in the correct format.  dd-mm-yyyyhh:ii (am/pm)


KeyStrings:  This field allows you to display the content based on KeyString (or simply a sequence of characters) in the url. This setting can help in situations where none of the other settings quite cover the exact criteria you want to set.  You could combine this setting with others and more precisely target when a block of content is displayed.

pages_settingsInclude on Pages:  Select the pages that you want to display this content block on.  Default is ALL.


Exclude from Pages:  Select the pages to exclude this content block from.  Default is NONE.


You can use both settings at the same time if needed, however it will be easier to understand and maintain the settings if you only used either include or exclude.


If you select a page in the include list, and the exclude list, then the exclude list will be used. 

posts_settingsPosts work like pages, except…


Since there can be a large number of posts on a WordPress site, the field to set the include and excluded post is a comma separated list of post id’s.  To make it easier to use,  the fields include an auto-complete feature that allows you to start typing the title of the post you are looking for and it will help you find the ID.   Also as you can see in the image, once you have selected posts,  they are not only displayed in the comma separated list,  but also the is a list of the posts below each field that includes the post title.

category_settingsCategories have the same type of select lists like pages. Select the categories that this content block will be included / excluded on.


Category settings only apply if the page the visitor is accessing is a single post page, or is a page of posts for a category. If you have a category called “Newsletter” and have configured a block of content to only be displayed for the “Newsletter” category, the block will only be displayed if the visitor is accessing the “Newsletter” category or one of the posts that has “Newsletter” as one of its categories.

authors_settingsAuthors function very similar to Categories. Select the authors that this content block will be included / excluded on.


Author settings only apply if the page the visitor is accessing is a single post page, or is a page of posts for an author. If you have author named “Fred” and have configured a block of content to only be displayed for the “Fred” author, The block will only be displayed if the visitor is accessing content that “Fred” has authored.  Either by visiting a single post authored by “Fred” or the page of posts for “Fred”.

cookie_settingsVLP uses a cookie to track each visitor’s activity. Therefore, you can use the cookie settings to determine when and how a logic block is displayed.


Site Visits: You can use the site visits to determine when a visitor is able to view a logic block. Any range can be set.


Day Range: Allows users to set a range of when a logic block is displayed after a visitor first comes to your site.


Block Views: Can be set to limit the amount of times a logic block is displayed to each user.


Tracking Pixel: To use the tracking pixel, you must place the code on any page on any site. Once a user visits that site, the tracking pixel sets a cookie. When they return to the page that includes the logic block, it till read to cookie and be displayed.


Pages & Posts: This section performs the same way as the tracking pixel except there is no need to add the tracking pixel because It is already included on the pages and posts that VLP is installed on.


Reset Rule: In order to use the reset, you must add a tag to all the logic blocks that you want the cookie to be reset for. For example, you have 3 logic blocks. They all are set to display 1 time each but the 3rd is set to reset. When the visitor sees the third block, it will reset the cookie for all 3 blocks that have that tag, resulting in the 1st block being shown again.

wishlist_settingsVLP integrates with WishList Member so the user can select member levels in conjunction with the other VLP settings to control what logic blocks are displayed. There are options to show or hide the logic block depending on what level that visitor is subscribed to.


 

aweber_settingsVLP integrates with some of the top auto-responders with more being added in the near future. This gives users the ability to show or hide a logic block depending on whether or not the visitor is subscribed the designated email list. If they are not, VLP will show the opt-in form, once they subscribe, they will gain access to the content!


 

Leave a Comment

Your email address will not be published.

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

(required)