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

[BadgerDog]

Originally Posted by nitra1000

Updated to reflect this bug, let me know how it handles :up:

Note the change to the Settings page now you must enter the DISABLED text not the enabled text!

Seems to work fine now and is ON by default. :up:

Interesting though, I forgot to change what you said:

"Note the change to the Settings page now you must enter the DISABLED text not the enabled text!"

.... and, it still worked with that field set to On, although I have gone back and set it now to Off as you suggested, but I thought I'd let you know about this anomaly in case it was important.

The little drop down bar can get annoying, but it's nice they have the arrows in the top left corner so one can cause it to not drop down, at least for the page you're on. Unfortunately, it starts dripping down again as soon as you refresh any page. It would be better if they stored that condition in a cookie so that it remembered the user's setting of active or not, from session to session.

Thanks again ..

Regards,
Doug

[nitra1000]

Originally Posted by BadgerDog

Interesting though, I forgot to change what you said:

"Note the change to the Settings page now you must enter the DISABLED text not the enabled text!"

.... and, it still worked with that field set to On, although I have gone back and set it now to Off as you suggested, but I thought I'd let you know about this anomaly in case it was important.

This suggests that it hasn't been setup properly.. basicly if it can't find the exact value in the fieldid you give it, it will pass the test and carry on

Originally Posted by BadgerDog

The little drop down bar can get annoying, but it's nice they have the arrows in the top left corner so one can cause it to not drop down, at least for the page you're on.

You can turn this off, in the apture account settings

[The Rocketeer]

Originally Posted by nitra1000

Are you blocking javascript or running an adblock?

adblock!

i forgot about that. now working... thanks

[BadgerDog]

Originally Posted by nitra1000

This suggests that it hasn't been setup properly.. basicly if it can't find the exact value in the fieldid you give it, it will pass the test and carry on

Interesting ...

I have field15 setup in the profile as a redio buttons field, exactly as you suggested (see pic). I also have the mod setup as in the pic as well.

Does that look ok?

I know it worked (default ON) with text in last field for disabled mode set to On and it also works fine with that field now set to Off .....

Regards,
Doug

[BadgerDog]

By the way, has anyone noticed that it automatically puts in "Facebook", Twitter" and "Email" buttons. Is there any Apture settings to remove any or all of those? I can't find them if there are.

Also, I notice the results returned on a "search" are limited to a few. How does one increase the number of items found in a "search", particularly on our own site?

Thanks ...

Regards,
Doug

[Robbie P]

Thanks for this, i'll try it out!!!

[nitra1000]

Originally Posted by BadgerDog

Interesting ...

I have field15 setup in the profile as a redio buttons field, exactly as you suggested (see pic). I also have the mod setup as in the pic as well.

Does that look ok?

I know it worked (default ON) with text in last field for disabled mode set to On and it also works fine with that field now set to Off .....

Regards,
Doug

I'll pm you tonight sometime (BST) otherwise this thread is going to get messy

[Taurus1]

I like this. Thank you very much. However, I do not like the fact that I have a white page for like a second between opening any page. When I disable this, the white page is gone. Why does this happen?

[8thos]

I have both your apture and wibiya modifications working well on my site. Your awesome!

Question though, have you ever tried getting your amazon affiliates ID working with this mod? Theirs a tutorial on their site on how to do it but it's not working. I emailed them about it yesterday and haven't got an answer yet.

[BadgerDog]

Originally Posted by nitra1000

I'll pm you tonight sometime (BST) otherwise this thread is going to get messy

Something is wrong with the usergroup setting and the guest setting ....

I have it set for just Admin Group 6 to test and NO guests, yet it's appearing for all users as well as guests.

I've installed you wibiya add-on as well and it's doing the same thing there, but that mod has the original problem that was here, of it not showing for users unless they go into their profile, click and save the settings at least once.

Thought I'd let you know ....

Regards,
Doug