Integration with vBulletin - [Mod-Mall] Apture - Keep visitors on your pages longer (as used at economist.com)

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..

Apture Website

You can try it out on the economist.com

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 apture.com, and configure your settings
3. It should give you some code that looks like the below to insert into your header
   

   <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

• [S]Additional user checks (User ID, Usergroup)[/S] - Done V1.1
• [S]Allow different field options (i.e different to on/off)[/S] - Done V1.1
• [S]Vbulletin NULLS the field values, which disabled the addon[/S] - 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 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....

[nitra1000]

Reserved for other tips/advice

[Juggernaut]

Tagged for later.

[nitra1000]

Small update:

Now Supports checks for

• Set which usergroups to show Apture to (i.e only to members who have donated)
• Set a postcount at which the Apture is available

And you can now use different options i.e instead of on/off

[mfnforex]

I will try , thx

[BadgerDog]

Ok, I'm confused ...

Installed fine and tested with Apture from their set-up site. It says it's installed fine and running, but I don't see anywhere how to type anything into a bar or use it?

I must be missing something obvious.. sorry about that ... give me a coffee break and you have to retrain me...

Any help would be appreciated ...

Regards,
Doug

[nitra1000]

Originally Posted by BadgerDog

Ok, I'm confused ...

Installed fine and tested with Apture from their set-up site. It says it's installed fine and running, but I don't see anywhere how to type anything into a bar or use it?

I must be missing something obvious.. sorry about that ... give me a coffee break and you have to retrain me...

Any help would be appreciated ...

Regards,
Doug

Its really simple just select some text, and the learn more button will come up

[BadgerDog]

Originally Posted by nitra1000

Its really simple just select some text, and the learn more button will come up

Well, their demo site shows that, plus just if I start scrolling the bar drops down using their test demo window.

However, when on our live site logged in, nothing happens ...

It works fine if I log out and only be a "guest"?

Regards,
Doug

[nitra1000]

Check your settings, it's most likely that a setting is not setup properly....

If you can't solve it pm me a screenshot of your settings page and a url of your forum

[Juggernaut]

Installed, and looking good, does Apture support any language other than english?