vBulletin LTS

[Mod-Mall] Apture - Keep visitors on your pages longer (as used at economist.com)
Mod Version: 1.00, by nitra1000

What Apture Does
Apture allows the users to select a piece of text and then searchs your website (or websites) to find pages releavent to that text. This keeps people on your pages and website longer, as they don't go and google the next topic of interest.

It has too many features to list but if you go to there website you will get a decent idea..

http://www.apture.com/

You can try it out on the http://www.economist.com/node/16316937

What This Mod Does
This mod inserts the javascript in your header template, saving you from having to edit or revert your templates every upgrade.

It also has built in conditionals to allow you (or your users) to configure who the script is active for

Currently supports

• Disable for guests
• Allow users to enable/disable from their options
• Only show for certain usergroups (for example only people who donate)
• Only show to people above a certain post count
• More coming soon...

How to install

1. Import the xml
2. Register at http://www.apture.com/, and configure your settings
3. It should give you some code that looks like the below to insert into your header
   
   Code:

   <script id="aptureScript">
   (function (){var a=document.createElement("script");a.defer="true";a.src="http://www.apture.com/js/apture.js?siteToken=#######";document.getElementsByTagName("head")[0].appendChild(a);})();
   </script>

4. copy and paste this into the script box found in your admincp under Settings>Options>Add apture Script
5. Activate and configure the add on in the same screen

To allow users to turn Apture on and off

1. Do all the steps listed in install
2. in your admincp go to "Add New User Profile Field"
3. Select "Single Selection Radio Buttons" and fill in the following
   (you can change these as you see fit but these are my setup)
   • Title: Apture
   • Description: Turn Apture Search on or off.
   • Profile Field Category: Doesn't matter
     
   • Options:
     • On
     • Off
   • Set Default: Yes (VERY IMPORTANT!)
   • Display Order: Doesn't Matter
   • Field Required: No
   • Field Editable by User: Yes
   • Private Field: No
   • Field Searchable on Members List: No
   • Show on Members List: No
4. Save that, and note down the name (note this isn't the title and should be something like "field13"
5. Go back to Settings>Options>Add apture Script
6. Fill in the What is the fieldid box with the name of your field
7. Fill in the Disabled text (in the example above this would "Off" without the quotes)
8. Select Yes to allow users to enable/disable toolbar

How to upgrade

1. Import the xml, set overwrite to allow/yes/on
2. Check the settings at Settings>Options>Add Apture Script

Releases
V1.0 - Initial Release
V1.1 - Added support for different options, usergroups, post counts
V1.2 - Bug fix (to do with how VB handles defaults)

To Do List

• Additional user checks (User ID, Usergroup) - Done V1.1
• Allow different field options (i.e different to on/off) - Done V1.1
• Vbulletin NULLS the field values, which disabled the addon - Fixed V1.2
• Additional forum checks (Forum ID)
• Style checks

Notes
I will support this modification but not Apture... if you need help signing up or using the service... You can find help on the http://apture.com website.

Do not remove the attributation link...

Please note I have nothing to do with apture, I just needed this for my forum and thought I would be nice....