Forum Home Enhancements - [AJAX] Websites who have referred today (in the last 24 hours)

Websites who have referred today (in the last 24 hours)


Description:
Lists all websites who have sent you visitors in the last day.

Each time a person arrives at your forum by clicking on a link from another website, the website URL they arrived from is listed on the index page of your forum in the same manner as members who are logged in. Screenshots at the foot of this post.


Options: (AdminCP > vBulletin Options > Websites who have referred today)
Turn it on or off
Mod goes on, mod goes off. Mod goes on, mod goes off.

Enable display for UsergroupIDs
Enter the IDs of the usergroups you wish to be able to view referring links, separated by commas (,). (i.e 1,2,3). Leave blank to display referring links to everyone.

Enable referrer page title? (https://vborg.vbsupport.ru/attachmen...0&d=1170326535)
Choose Yes to store the page title of the referrer, which will be used as the link text. If this is not enabled or not available, a trimmed version of the URL will be used.

This may incur a slight penalty on page-load time when a visitor first arrives from a referrer or possibly be problematic where referring pages time out or redirect.

Trim URL variables?
Choose Yes to remove variables from the end of URLs to shrink listing repeats. (i.e. Set to No, every different search from Google will add a new www.google.com referral to the listings. Set to yes, all will be compressed into one listing but the search terms will be lost.)

Blockword List:
Enter character strings to be prevented from being added to the URL database, separated by commas (,). You may use any part of domains (www.xxx or xxx or www.xxx.com or .com).

Highlight arrivals from a referrid link?
Choose Yes to highlight in italics referrers using a forum member's referral link.

For this to work, you must have "Trim URL variables" to No.

Highlight domain list
Enter domains to be highlighted using the markup belowe, separated by commas (,). You must use the format domain.ext, exclude the http://(www.) part. (i.e. redtyger.co.uk)

Opening tag for highlighted domain markup
Enter HTML and/or text that will be placed before the domain name.

Closing tag for highlighted domain markup
Enter HTML and/or text that will be placed after the domain name.


Additional Features:
AJAX inline moderation (https://vborg.vbsupport.ru/attachmen...2&d=1170095586)
Click on the X next to any domain to remove it from the database. No page loads, no waiting.

Scheduled Task (Cron)
All domains are cleared at midnight daily. You can edit the Scheduled task to have the database cleared when and as often as you like. All scheduled clearances are logged and phrased. Like any other vBulletin Scheduled task you must have activity or the scheduled task will not run.

Manual database clearance
As well as removing any individual domain, you can clear the referral database at any time using a link from the index page.

Queries:
This modification adds one very small query for every arrival from an external link. One additional larger query is used on the index page to construct the list.


Installation Instructions:
1. Go to AdminCP > Plugins & Products > Manage Products > Add/Import Product.
2. Upload the websites_who_have_referred_today.xml file.
3. Upload the wwhrt.php file to the includes/cron folder of your forum directory.
4. Open AdminCP > Styles & Templates > (Your Theme) Edit Templates > Forumhome templates > FORUMHOME.
5. FIND:

<!-- end logged-in users -->
</if>

BELOW, ADD:

<if condition="$vboptions[referrers_onoff] AND is_member_of($bbuserinfo, $referrers_usergroupids) OR !$vboptions[referrers_usergroupids]">
<!-- websites who have referred today -->
<thead>
	<tr>
		<td class="thead" colspan="2"><a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('referrers_today')"><img id="collapseimg_referrers_today" src="$stylevar[imgdir_button]/collapse_thead$vbcollapse[collapseimg_referrers_today].gif" alt="" border="0" /></a>
			$vbphrase[referrers_today]: $url_count <if condition="$url_count >= $vboptions[referrers_last_x_referrers] AND $vboptions[referrers_last_x_referrers]"><phrase 1="$vboptions[referrers_last_x_referrers]"> ($vbphrase[referrers_last_x_count])</phrase></if>
			<if condition="$bbuserinfo['usergroupid'] == '6'"> (<a href="index.php?$session[sessionurl]do=kill_all_referrers">$vbphrase[referrers_kill_all]</a>)</if>
		</td>
	</tr>
</thead>
<tbody id="collapseobj_referrers_today" style="$vbcollapse[collapseobj_referrers_today]">
	<tr>
		<td class="alt2">
			<img src="$stylevar[imgdir_misc]/stats.gif" alt="$vbphrase[referrers_today]" border="0" />
		</td>
		<td class="alt1 smallfont">
			$referrers
		</td>
	</tr>
</tbody>
<!-- end websites who have referred today -->
</if>

And save the template. Done!


Donations

If you have a pressing wish to donate money to me (and of course, you do) to say thank you and to possibly encourage more future work then you can do via the link below. Also, you will go to heaven.

http://redtyger.co.uk/donations.php

Don't panic! The donations link is only hosted on my website so it can be encrypted and not open my email address to spammers.


Changelog

v1.1 Added AJAX inline moderation (Yay!) and ability to clear the list via a link on the index page without waiting from the Scheduled Task to do it. Admins only may do either task.
v1.1 Changed the screenshot to show the inline deletion links.
v1.1 Fixed incorrect cron timing (Scheduled Task) and phrased it.
v1.1 Fixed issue with domains that sometimes had www. and sometimes did not. This also now shortens any URL which I was meaning to do anyway, so www.google.com will appear in the list as google.com. Smartens things up and gives a bit more room too.
v1.1 Changed URL encoding to avoid problems with domains that contained hypens.
v1.1 Fixed blockwords not working. They are still only checked when a domain is first added, but inline moderation means you can now take care of it yourself afterwards if necessary..
v1.1 Minor optimisations.

v1.5 Added Archive referral recording.
v1.5 Added Usergroup display controls.
v1.5 Added option to record and use referring page title as link text instead of trimmed domain. (https://vborg.vbsupport.ru/attachmen...0&d=1170326535)
v1.5 Added option to highlight referrals that have arrived from a forum member's referral link.
v1.5 Added option to highlight with custom markup any domains of your choice.
v1.5 Fixed workaround for apparent PHP bug where a letter would occasionally be removed from the beginning of URLs
v1.5 Fixed issue with multiple blockwords, I swear to God it's fixed this time. Probably.
v1.5 Fixed issue with AJAX inline moderation only deleting the last URL in the list.
v1.5 Changed minor optimisations.

v1.51 Fixed bug where multiple versions of the same forum URL were used for access.

v1.6 Added option to limit number of recent URLs displayed
v1.6 Added option to trim referrer additions to the domain name only to further limit repeat listings
v1.6 Added URL sorting, referrers are now listed in reverse order (last addition first)
v1.6 Fixed catch for https and ftp URLS.
v1.6 Fixed bug where a w would be trimmed off the beginning of URLS.
v1.6 Fixed blockwords not working (Oh please, oh please, oh please)
v1.6 Minor optimisations

v1.61 Added compatiblity with vBulletin 3.5.x
v1.61 Probably fix to possible referrer text exploit.

v1.62 Added securing of HTML tags as a security measure.

[Tulsa]

Originally Posted by keyness

I've uninstalled it because my forum was working slowly because of the mods i've installed. But now i have one extra table at the bottom of forum (above of forum statistics) how can i remove it? Thanks in advance

Go into your forumhome template and remove the following.

<!-- begin websites who have referred today -->
<if condition="$vboptions[referrers_onoff] AND is_member_of($bbuserinfo, $referrers_usergroupids) OR !$vboptions[referrers_usergroupids]">
</if>     
<!-- websites who have referred today -->

<thead>
    <tr>
        <td class="thead" colspan="2"><a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('referrers_today')"><img id="collapseimg_referrers_today" src="$stylevar[imgdir_button]/collapse_thead$vbcollapse[collapseimg_referrers_today].gif" alt="" border="0" /></a>
            $vbphrase[referrers_today]: $url_count <if condition="$url_count >= $vboptions[referrers_last_x_referrers] AND $vboptions[referrers_last_x_referrers]"><phrase 1="$vboptions[referrers_last_x_referrers]"> ($vbphrase[referrers_last_x_count])</phrase></if>

            <if condition="$bbuserinfo['usergroupid'] == '6'"> (<a href="index.php?$session[sessionurl]do=kill_all_referrers">$vbphrase[referrers_kill_all]</a>)</if>
        </td>
    </tr>
</thead>
<tbody id="collapseobj_referrers_today" style="$vbcollapse[collapseobj_referrers_today]">
    <tr>
        <td class="alt2">
            <img src="$stylevar[imgdir_misc]/stats.gif" alt="$vbphrase[referrers_today]" border="0" />
        </td>
        <td class="alt1 smallfont">
            $referrers
        </td>
    </tr>
</tbody>
<!-- end websites who have referred today -->

[WiseOne38221]

Hi, GREAT MOD! Does anyone have a list they made of bad words to remove? Like sex, viagra and the other morons who always try their crap? Thanks again!

[WiseOne38221]

v1.6 Fixed bug where a w would be trimmed off the beginning of URLS.

This is still happening to me and I just downloaded and installed this...

[Fungsten]

Why does it keep showing referrals from my own site? Can I not show them?

[BadgerDog]

Can anyone explain what this error means, or is causing it?

It seems to be originating from this mod?

Database error in vBulletin 3.6.7:

Invalid SQL:

INSERT INTO referrers
(url, count)
VALUES

('by110fd.bay110.hotmail.msn.com%2Fcgi-bin%2Fgetmsg%3Fmsg%3D2B0F0D0F-519D-4805-8CBA-C59B9317F6E5%26start%3D0%26len%3D2735%26msgread%3D 1%26imgsafe%3Dy%26curmbox%3D00000000%252d0000%252d 0000%252d0000%252d000000000001%26a%3De0b263e460958 acc462e7c1bb64010a96de94397ae98d48c6754a9a1fecaafb 1', 1);

MySQL Error : Duplicate entry 'by110fd.bay110.hotmail.msn.com%2Fcgi-bin%2Fgetmsg%3Fmsg%3D2B0F0D' for key 1 Error Number : 1062
Date : Wednesday, September 12th 2007 @ 01:45:25 PM
Script : http://www.xxxx.com/
Referrer : http://by110fd.bay110.hotmail.msn.co...54a9a1fecaafb1
IP Address : xxx.xxx.xxx.xxx
Username : Unregistered
Classname : vB_Database

Thanks ..

Regards,
Badger

[Fungsten]

Originally Posted by BadgerDog

Can anyone explain what this error means, or is causing it?

It seems to be originating from this mod?



Thanks ..

Regards,
Badger

You might want to take your IP address out.

[BadgerDog]

Originally Posted by Fungsten

You might want to take your IP address out.

Good point...

It's not mine, it was generated as part of this mod trying to store the referrer (I think), but I will X it out...

Thanks

Regards,
Badger

[Fungsten]

Originally Posted by Fungsten

Why does it keep showing referrals from my own site? Can I not show them?

Bump.

[ijob]

I've installed this again but I have a request:

If I limit display to 100 referals on screen, can there be a feature that continues the referals but orgainses them into page 1, page 2, page 3 etc.... so I could look back at previous referals at a later date?

[onehost]

Someone left a hacked message on my forum today, and it was left right under:

Websites who have referred today.

anyone have any idea on how it was done, or if this scipt needs
a fix or something. They could have left this msg anywhere, but
it was left under the title of this mod.

Thanks