Referrer Statistics

[akanevsky]

I no longer support my hacks. Please feel free to update them and release new versions elsewhere as long as I get the credit for the original modification.

/*==================================*\
|| Referrer Statistics
||
|| Author : Anton Kanevsky
|| Works on : vBulletin 3.5 / 3.6
|| Released : Nov 22, 2006
||
|| Time required to install: 30 seconds
|| Difficulty: easy
\*==================================*/

DESCRIPTION

The modification enchances your vBulletin community with a sophisticated listing of referrers and users they have referred.

STATISTICS

File Uploads: 1
Template Changes: 1
Products to Install: 1


FEATURES


Referrers are sorted first by the amount of referred users and then by username.
Referred users are sorted by username.
On top of the page, there is a message offering to invite more users, which is helpful in terms of expanding your community.
Automatic integration with vS-Invites System.
Graphical representation of the amount of users referred by each referrer as a percentage of total referred users.


VERSION HISTORY

1.3.1
[+] The modification is now officially compatible with vBulletin 3.6.0 and above.
[+] Internal optimization of code: the script now finishes loading twice as fast compared to the previous version.

1.3.0
[+] Corrected a bug, which caused numerous error messages on a board with no referrers.
[+] Corrected a bug, which caused bar widths to be displayed incorrectly at 100%.

1.2.0
[+] Separate phrasegroup for the phrases used solely by this modification.
[+] Redesigned visual look.

1.1.0
[+] Corrected a minor template bug.

1.0.0
Initial Release

The installation manual is contained within the attached file.

IF YOU LIKE MY HACK, PLEASE CLICK INSTALL (https://vborg.vbsupport.ru/vborg_miscactions.php?do=installhack&threadid=102452)

[Boofo]

Didn't Michelle already release a hack that does this same thing?

[Lea Verou]

I can't believe this... This is almost identical to mine!!
Even the graphcal represenatation!!
And no credit at all... :(

Ok... I get it that it's due to your age... I hope you grow up to maturity in a few years... :(

[Daniel]

Because he made the same type of hack as you he is immature? Never heard that one before.

[akanevsky]

I do apologize for forgetting to put in the credits. That kind of missed my attention as I was concentrating on my homework :) The credits have been put in :)

I cannot say I agree on the immaturity part... Nice invention though.

Anyway, this is just an alternative. You didn't accept my code and I wanted to share it. Considering the fact that I gave you an opportunity to use this code as your own hack before you ever released it, I don't think it's such a big deal :)

Oh, and not that it is of a big importance, but my graphical formula is a bit different than yours.

[Dead End Society]

Wow this one works for me perfect, thanks! *Clicks Install*

[The Chief]

Installed but where is this supposed to show?? Where do we click to see this?

[RMS-Chef]

Any options on this?
For some reason I could not get Michelle's date range option to work properly and was hoping this one would. But it does not seem to have any options. Are there any plans to add any options to this?

[Snake]

Seems to be a copy of Michelle's hack but I'll check this out soon. Thanks!

[lazyseller]

Psionic Vision Thanks alot exactly what i was looking for...

clicked installed....

[akanevsky]

Seems to be a copy of Michelle's hack but I'll check this out soon.

Won't seem that way after you compare the code :)

[lazytown]

Nice, but I still like Michelle's better. Plus you shouldn't really be copying her template without getting her permission first. Credit alone is not enough.

-vissa

[akanevsky]

Ok, then template will be changed to something else.

[Injektilo]

people register when i invite them... i am the referrer but, it doesnt show up in the statistics. why?

[akanevsky]

You must have mis-installed something in one of the hacks.

[Injektilo]

You must have mis-installed something in one of the hacks.


i just skipped the step for the navbar edit "<if condition="$show['registerbutton']">" because i found 2 of entries of this code, and didnt know which one to use :)

[Snake]

Ok, then template will be changed to something else.

And probably add more features & additions?

[akanevsky]

Like what?

[Snake]

You know...

[akanevsky]

Strangely enough, I do not...

[Snake]

Ever thought of guessing? :p

[akanevsky]

No...

[akanevsky]

<u>UPDATE: 1.2.0</u>

Changes: See First Post (and the screenshot)
To Upgrade:
1. Overwrite the Product XML
2. Re-upload the referrers.php file
3. Do the navbar template change described in the manual

[Snake]

That's more I like it! :)

[Injektilo]

Psionic Vision : any ideas for my problems please?

[akanevsky]

people register when i invite them... i am the referrer but, it doesnt show up in the statistics. why?

Did they specify you as a referrer?

[Injektilo]

Did they specify you as a referrer?


yes, they are also added automaticaly as my friends... the only thing is that it doesnt count in statistics

[akanevsky]

OK I'll check

[akanevsky]

Just checked, it does work for me... Try reinstalling the invites hack.

[Injektilo]

Just checked, it does work for me... Try reinstalling the invites hack.

still the same :(

[VB-STYLE]

Warning: krsort() expects parameter 1 to be array, null given in /referrers.php on line 132

Warning: Invalid argument supplied for foreach() in /referrers.php on line 134

any ideas for my problems please?

[akanevsky]

Hmm... Will the following fix the problem?

In referrers.php, find

unset($refusercache);

add above:

if (!is_array($a_refusercache))
{
eval(standard_error(fetch_error('sorry_but_there_a re_no_referrers_on_this_board')));
}

[VB-STYLE]

It's working fine now thanks. :)

[akanevsky]

UPDATE: Version 1.3.0

See changelog for details.
To upgrade, overwrite product XML and re-upload referrers.php.

[LBSources]

works great! thanks..

INSTALLED clicked

[harry1951]

Seems that it is not working correctly. I invited some people with your inviteshack. I see in my UCP that they accepted and registered, but I don't see them in the stats...

[akanevsky]

It is working fine for me..

[harry1951]

*clicks uninstall*

[akanevsky]

Since you clicked uninstall, you won't receive any support from now on.
Even though I know what the cause of the problem is. :)
You might want to check out the last item in the FAQ post of invite system hack though.

[harry1951]

Don't need your support anymore as I uninstalled it...

[akanevsky]

Fine with me, as it's your loss. Keep in mind that none of the other referrer statistics hacks will show new registrants, nor will any other invite hacks mark users as referrers, because of a particular setting on your board (particular = known to me) (and not because this or any other hack is poorly written).

[VB-STYLE]

*clicks install*
:)

[VB-STYLE]

It's show me
( There are no referrers on this board. ) but there is some invite accepted.

[akanevsky]

You must enable "User Referrers" in vBulletin Options. And it will only work for future accepted invites.

[VB-STYLE]

I can't fined "User Referrers" in vBulletin Options.

[akanevsky]

It's an option under "User Registration"

[VB-STYLE]

Thanks,

[Smiry Kin's]

very nice, :) very usfull!

[akanevsky]

Smiry,
you seem to forget to click the Install button where you post.

[Smiry Kin's]

Yep well i just got in! so i will be installing some hacks soon :P
don't worrie i will be clicking install! :)

[Smiry Kin's]

Would just like to say thank you, installed, worked perfectly.

any chance in future updates, give a kinda badge to the highest 3 refferals e.g 1st,2nd,3rd

just a thought. :)

[mikepmm]

Very nice - and easy mod :-) - thank you :-)

I would like to see more sort options in the "referrers.php"

For example:
sort by date, posts , user group , my referrers... for referrers competitions

greetings from germany

mikepmm

[akanevsky]

That might happen but please stop posting URLs in your posts thx.

[mikepmm]

That might happen but please stop posting URLs in your posts thx.

remove the url and send you 5 US$ thanks :-)

[shortbus1662]

I'd like to suggest an add on that keeps track of stats by day/week/month/etc.
so that I can use this to have referral contests. For instance, I might give away a prize for the most referrals each week in the month of February and also I might give a prize to the user with the most total referrals for the month.

Great hack, thanks.

[Snake]

Uh it doesn't work for me. I just get a blank page even the pharses are not functioning properly. O.o

http://www.metalgearforums.com/referrers.php

[akanevsky]

Maybe there are no referrers? If there are, it may be conflicting with some other hack.

[Snake]

Oh I got Michelle's version installed already but since I made a fresh install of my forums, I believe it's gone now. So what could cause the problem yet?

[msimplay]

I have idea for this hack .
On the profile it shows the amount of people the person has referred it would be nice to give this information a link to a popup of who they have referred and then in turn a link in the popup to the full refferer stats and their position on the refferer table.

What do you think ?

[kofoid]

This is going to be a DUMB question - where do I administer this darn thing?

[kofoid]

OK let me clarify my last post - I have gone thru the entire admin CP and there is nothing in there to change settings for this hack. Any help would be appreciated

[akanevsky]

vBulletin Options ->> Referer Statistics

[kofoid]

it's not there - The invites system is showing up but not the referrer statistics. Anything I can tweak to get it to work? The URL works fine, I just can't configure it

[akanevsky]

You need to install the product xml as per instructions.

[kofoid]

I did, man. I did everything you instructed. Are there known hacks that conflict with this one?? want me to PM you info and you can look? any help is appreciated

[kofoid]

Plus it's not like it's a difficult install! :) Is there some code I can look at - just point me in the right direction

[kofoid]

so no assistance, eh?

[Boofo]

Are the referred users listed alphabetically for easy finding of someone's name? And is there an option to lists referrers the name alphabetically, again to make finding someone easer?

[akanevsky]

I believe they are :) No, there is no option because they are sorted by default.

[Boofo]

Can it be added, sir?

[akanevsky]

How could you even think that a complicated feature like that could be added? :) j/k.

If it is already sorted by username by default, then what would be the purpose of the option?

[carnid]

OK let me clarify my last post - I have gone thru the entire admin CP and there is nothing in there to change settings for this hack. Any help would be appreciated

I have the very same problem - did you manage to fix this?

[akanevsky]

There is nothing to fix. The settings are in vBulletin options.

[ubblite]

Just a FYI - this hack is working great for me with vb3.6 beta3. :)

[akanevsky]

Thanks for the info.

[ubblite]

There is nothing to fix. The settings are in vBulletin options.
I'm having the same problem as other users; there is no option to configure this hack as you mentioned earlier in this thread:
vBulletin Options ->> Referer Statistics

[akanevsky]

Perhaps there is nothing to configure then? :)

[Titania]

Is there a way to only include certain usergroups and exclude others in the statistics? Michelle's mod does this but it doesn't work on my forum. Yours works but I need the above function.

[Lee]

Will you share the way to show the referred users' post count next to their username on the referrer.php page (as seen here http://www.wiizer.com/forum/referrers.php? Thanks!

[Sha Platinum?]

Thanks!

[nicolerork]

I'm confused as to where I'm supposed to upload the "referrers.php" file, can someone help me out?

nicolerork@gmail.com

[akanevsky]

You upload it to where you have vBulletin installed.

[da420]

Any word to if this is working with 3.6? If not, heck, I'll give'er a go.

[akanevsky]

It should work fine.

[Coach_Guru]

Good work

[da420]

It should work fine.

Yup, works fine here on 3.6 gold. :)

Thanks Psionic Vision.

[mrahul]

Is it possible to show the referrals only to the registered users & not to the unlogged in/banned users & is there a way to show the referrals only for the registered usergroup excluding the banned & deleted members group ?

[Ohiosweetheart]

Is there a way to wipe clean the referral stats as of now, so that one can have a contest?

[akanevsky]

No, it is not possible without altering the database of users and voiding the referrer information.

[Ohiosweetheart]

well rats. thanks anyway

[rezapci]

we need the updated oneeee, the VB version is 3.6.1 mannnn

[JenniferK]

This is not working for me - I get this error message:

Warning: Invalid argument supplied for foreach() in /referrers.php on line 97

Warning: Invalid argument supplied for foreach() in /referrers.php on line 111

Warning: Invalid argument supplied for foreach() in /referrers.php on line 118

Any idea what I could do to fix it?

[triphp]

Is there a way to group the referrals by UserGroup and count the total number in each group?

For example, I have three UserGroup in my forum (newbie, junior, senior).

REFERRERS----------------------------REFERRED USERS
User 1--------------------------------Newbie - 3 (auser, buser, cuser )
--------------------------------------Junior - 1 (x_user)
--------------------------------------Senior - 0

User 2--------------------------------Newbie - 0
--------------------------------------Junior - 1 (xxx_user)

etc....

Is this possible?

Can this be also integrated in the User CP? I want that in my User CP, I can see ONLY my referrals :)

[VBUsers]

if i want to reset everyones referals how do i do that?

[gamelandz]

I am so confused....

Everything is working well, but i can't adjust it to only show referrers for a specific month?????

[StEaLtH666]

could you add some kind of mods, so that in userpfofiles it will list who invited them, and who they have invited?

would be handy and apreciated if possible?

[akanevsky]

if i want to reset everyones referals how do i do that?

You can't without resetting the actual referrer connections in your database.

Everything is working well, but i can't adjust it to only show referrers for a specific month?????

Where in the description of the hack does it say that it can do that?

could you add some kind of mods, so that in userpfofiles it will list who invited them, and who they have invited?

would be handy and apreciated if possible?

Yes, I might. As for "Who the person was referrered by", see my "referrer in memberinfo" hack.

[VBUsers]

You can't without resetting the actual referrer connections in your database.


thats fine i want to make em all 0 for now. i have a contest going on and i want them all at 0.

[akanevsky]

Ok... Run this query at your own risk:
UPDATE user SET referrerid = 0

[Murdoch]

I installed it on v3.6.0 just fine, but when I view the page, people who have no referrer are not shown in one row but in multiple rows for some reason, See for yourself here: http://www.habbohut.com/board/referrers.php?

Is there anyway to fix this? :)

[akanevsky]

I installed it on v3.6.0 just fine, but when I view the page, people who have no referrer are not shown in one row but in multiple rows for some reason, See for yourself here: http://www.habbohut.com/board/referrers.php?

Is there anyway to fix this? :)

That's not a no referrer, it is a referrer that is a deleted user. That is why they are separate.... And there is no way to fix this.

[farooqaaa]

Nice, will it work for 3.6.1 vb version?

[akanevsky]

It should.

[da420]

It does work on mine. ;)

[DaNIEL MeNTED]

Oddly I see less "referrers" in the ACP user properties than in the referrer stats. I'm also using the invite system.

[akanevsky]

Oddly I see less "referrers" in the ACP user properties than in the referrer stats. I'm also using the invite system.

In standard vBulletin package, there is no such thing as "referrers" in the ACP.

[DaNIEL MeNTED]

In standard vBulletin package, there is no such thing as "referrers" in the ACP.

Sorry... I mean under ACP>USERS>Referrals

Any idea why the numbers don't match?

[akanevsky]

They match on my installation. This hack covers refferers from the beginning - make sure to set appropriate dates for admincp referrrers.

[FireFish]

Yet another nice one from Psionic Vision.

If vbulletin.org had a 'Favorite Coder' poll, he'd be my vote.
So far, no bugs or chained issues with his mods (knock on wood).

[akanevsky]

Yet another nice one from Psionic Vision.

If vbulletin.org had a 'Favorite Coder' poll, he'd be my vote.
So far, no bugs or chained issues with his mods (knock on wood).

Thanks for that. :)

[Hornstar]

Would be cool, if this could also do a weekly (cron job set) save. basically save the data, so i can bring up a certain period of time, and see how much they have referred from one period of time to another.

i want to hold an event on my site, and this feature would be a killer.

thanks.

[Drix]

Yes, this works great on my forum. Thanks a lot!

[induslady]

Hello,

I like this mod showing referrer details.

Want to know if this words on vB version 3.6.3 onwards?
ALso, can any member run to find out their referrer statistics? Will they be able to see the referrals made by other members?

Please let me know.

[Hornstar]

Would love for this mod to be picked up again and made for when vb 3.8 goes gold, there are quite a few good suggestions already listed above that will make this mod very useful for a forum. I would even pay to have some of those features listed.

[Battle_Ring]

dont work on 3.7

[SVTCobraLTD]

Installed on 3.6.11 and working.

[akanevsky]

This hack has been discontinued due to having been assimilated by psiStats 2009.