Add-On Releases - gXboxLive - Xbox Live Leaderboard

What is it?
gXboxLive is a modification for vBulletin which allows you to display a Xbox Live Leaderboard for your users.

If you use this mod, please Mark as Installed, and if you really enjoy this mod, please Nominate for MOTM, and if you really really enjoy this mod, feel free to Support Developer! Thank you!

Visit this thread for vBulletin 4 compatible version.

[hr]-[/hr]
Support
[hr]-[/hr]I use my released mods daily, if I find an issue with them or add features for myself I will release updates. If there are significant bugs or simple feature requests I will do my best to release fixes. Some of my mods rely on fetching data from 3rd party websites, due to the unreliable results, my mods will require users to troubleshoot for themselves if they find the addon is not working for them specifically. I am offering my personal mods that work ok for me for you to use, I am sorry I do not have time to troubleshoot many user specific issues. Thank you for your understanding.

Features
[hr]-[/hr]

• Lists all ranked Gamertags, each updated once per day
• Optionally show unranked Gamertags (Original Xbox Users).
• Optionally allow Xbox Live message sending.
• Optionally allow Xbox Live friend requests.
• Optionally to choose how many User Names Per Page to display.
• Optionally require a minimum post count.
• Optionally to add a navbar link.*
• Optionally to add a miscellaneous quick link.*
• Choose how recently users must be active to be displayed.
• Optionally display leaderboard statistics
• Limit usergroups to display.
• Limit access by usergroup.
• Optionally display Forumhome stats
• Optionally display Memberinfo gamercard
• Optionally display Postbit leaderboard rank
• Monitors invalid gamertags, 5 attempts to verify the gamertag and then the users gamertag profile field is blanked to prevent further checks.
• Can link directly to a gamertag position in the leaderboard with gxboxlive.php?gt=Gamertag

*Depends on your vBulletin version and template configuration.

Installation
[hr]-[/hr]

1. Download the latest version and upload all files. Images go in the folders specific to your style.
2. Install the product.
3. Create a Single-Line Text Box User Profile Field for members to enter their Gamertag into.
   • Go to yourdomain.com/forumdir/admincp/?loc=profilefield.php%3Fdo%3Dadd
   • Single-Line Text Box
   • Continue
   • Title: Xbox Live Gamertag
   • Description: Enter your Xbox Live Gamertag
     [S]
   • Regular Expression: ^([A-Za-z0-9 ]+)?$[/S] (regex not required)
   • The rest of the settings is your prefrence.
   • Save
   • Look and see what the field id number is for Xbox Live Gamertag, example field25.
4. Fill in the gXboxLive configuration options, make sure to enter the field id for the newly created Xbox profile field above.
   • Go to yourdomain.com/forumdir/admincp/?loc=options.php%3Fdo%3Doptions%26dogroup%3Dgxbl_g roup
5. Send people to their user cp to enter their gamertags.
6. Wait up a few minutes for the gamertags to appear on the leaderboard.

Examples
[hr]-[/hr]Authors

• http://alliedtribalforces.com/gxboxlive.php
• http://thzclan.com/forums/gxboxlive.php

Others

• http://forums.3drealms.com/vb/gxboxlive.php
• http://www.alanwake.com/forum/gxboxlive.php

Google

• http://www.google.com/search?q=allin...oxlive.php+-gt

Changes
[hr]-[/hr]
v2.2.6 - import product with Overwrite enabled, upload functions_gxboxlive.php and miner.gxboxlive.php

• Updates for April 18 gamercard changes.
• Uses DOMDocument PHP class now for parsing.

v2.2.5 - import product with Overwrite enabled, upload gxboxlive.php, functions_gxboxlive.php and miner.gxboxlive.php

• Updates for January 20th gamercard changes. Thanks Ronin Storm.

v2.2.4c - import product with Overwrite enabled.

• Quick xbox.com url changes, there is no longer any way to directly link to add a friend.

v2.2.4b - upload miner.gxboxlive.php

• Quick fix for miner, no other updates.

v2.2.4a - upload miner.gxboxlive.php

• Quick fix for num_rows error, no other updates.

v2.2.4 - upload functions_gxboxlive.php, miner.gxboxlive.php, import product with Overwrite enabled.

• Minor update, confirmed bogus gamertags do not cause issues with updating the rest of the leaderboard.
• Changed cron output to help find the people with bad usernames.
• Extended strikeout rule for bad usernames.

v2.2.3 - upload functions_gxboxlive.php, import product with Overwrite enabled.

• Reverted, no problems that I can find with leader board.

v2.2.2 - upload functions_gxboxlive.php, import product with Overwrite enabled.

• Temporary fix till more time can be spent to make updates for NXE

v2.2.1 - import product with Overwrite enabled.

• Added NXE avatar display

v2.1.9 - import product with Overwrite enabled.

• Security token update.
• Postbit style update.

v2.1.8 - upload gxboxlive.php, import product with Overwrite enabled.

• Security Fix.

v2.1.7 - upload functions_gxboxlive.php, import product with Overwrite enabled.

• Fix for query error.

v2.1.6 - upload gxboxlive.php, functions_gxboxlive.php, miner.gxboxlive.php, import product with Overwrite enabled.

• Update to close the leaderboard when product is disabled.

v2.1.5 - upload functions_gxboxlive.php, import product with Overwrite enabled.

• Fix for error when running cron manually.

v2.1.4 - upload files, import product with Overwrite enabled.

• Added some safety checks to keep the wrong field id from breaking the forums.

v2.1.3 - upload functions_gxboxlive.php, import product with Overwrite enabled.

• Fixed a broken update query.

v2.1.2 - import product with Overwrite enabled.

• Fix a bug that prevented total number of users to display when stats were turned off.

v2.1.1 - import product with Overwrite enabled.

• Navbar location selectable
• Quick Links location selectable
• Postbit location selection slightly changed, you will need to revisit this setting.

v2.1.0 - upload all files, import product with Overwrite enabled.

• Nearly all database queries rewritten to be more efficient
• Member listing is more stable, shouldn't see people disappear/reappear
• Image directories changed, /rank directory now called /silk
• New images for message user and add friend
• Leaderboard will now properly filter banned users
• New option to choose what usergroups are displayed on the board separate from who can view the board
• Database structure changed, so the leaderboard will need to repopulate after upgrade.
• Updated regex in the instructions above, this makes sure that people enter gamertags in the correct format.

v2.0.2 - upload all files, import product with Overwrite enabled.

• Stats display reorganized
• Gamertag linking is case insensitive now
• Fix for page navigation disappearing for leaderboards with over 1000 members.
• Fix another headinclude bug
• Temporarily disabled user update hooks

v2.0.1 - import product with Overwrite enabled.

• Fix headinclude bug

v2.0.0 - Upload all files import product with Overwrite enabled. Double check settings, field id method has changed, it is digit only now. In case of error upon upgrading from a previous version, uninstall and then reinstall.

• Rewritten much of the caching code to be more efficient
• Optionally display Forumhome stats
• Optionally display Memberinfo gamercard
• Optionally display Postbit leaderboard rank
• Can link directly to a gamertag position in the leaderboard
• Monitors invalid gamertags, 5 attempts to verify the gamertag and then the users gamertag profile field is blanked to prevent further checks.
• Many more improvements

Copyright
[hr]-[/hr]gXboxLive, Copyright ? Ghryphen (https://github.com/ghryphen)
Please maintain copyrights in derivative works, thank you.

overLIB javascript library Copyright Erik Bosrup.

[Fallback]

I think I figured it out. If you change your setting it waits until someone else adds theirs then it removes or edits yours. So basically if you update your profie gamertag the update to the main list seems to be triggered when someone new is added.

[alfieuk]

I have the XBL leaderboard installed on my site, but tonight for some reason it has stopped updating and has also deleted 400 members information, have you any ideas as to why it has done this ?

Its also not updated since Thursday at 19.12 pm and when try run it myself is says updated 0 deleted 0 etc etc....Any help

I have tried disabling it and installing again but its no good it still wont do anything ?

These are the reports :

6944 gXboxLive Update 19:21, 2nd Aug 2007 Updated Accounts: 0. Deleted Entries: 0. Process Time: 11,272s. Total Queries: 9.
6943 gXboxLive Update 19:12, 2nd Aug 2007 Updated Accounts: 546. Deleted Entries: 1795. Process Time: 4,322s. Total Queries: 3082.
6942 gXboxLive Update 19:00, 2nd Aug 2007 Updated Accounts: 849. Deleted Entries: 0. Process Time: 529s. Total Queries: 4747.

Now as you can see it did it ok on number 6942 took 5.29 seconds
6943 only updated 546 and deleted 1795
6944 updated 0 deleted 0 but took 11.272 seconds

Thanks
Angela

[alfieuk]

Originally Posted by alfieuk

I have the XBL leaderboard installed on my site, but tonight for some reason it has stopped updating and has also deleted 400 members information, have you any ideas as to why it has done this ?

Its also not updated since Thursday at 19.12 pm and when try run it myself is says updated 0 deleted 0 etc etc....Any help

I have tried disabling it and installing again but its no good it still wont do anything ?

These are the reports :

6944 gXboxLive Update 19:21, 2nd Aug 2007 Updated Accounts: 0. Deleted Entries: 0. Process Time: 11,272s. Total Queries: 9.
6943 gXboxLive Update 19:12, 2nd Aug 2007 Updated Accounts: 546. Deleted Entries: 1795. Process Time: 4,322s. Total Queries: 3082.
6942 gXboxLive Update 19:00, 2nd Aug 2007 Updated Accounts: 849. Deleted Entries: 0. Process Time: 529s. Total Queries: 4747.

Now as you can see it did it ok on number 6942 took 5.29 seconds
6943 only updated 546 and deleted 1795
6944 updated 0 deleted 0 but took 11.272 seconds

Thanks
Angela

It has now removed all but 1

[alfieuk]

Just to let you know i have sorted this problem.

Thanks for the help

[JGM007]

I would rather keep the IM style entry because I have it in the post bit along with wii code and Xfire profile and the other IM goodies, also it just looks cleaner in the user options.
How does the query draw the value from the field? If it is a single query that fetches the player's value it seems like it would not be a big deal to point it at something else.
In gxboxlive.php I see this part of the code:

	if (is_numeric($vbulletin->options['gxbl_user_field']) && $vbulletin->options['gxbl_user_field'] != '0')
	{
		$gxbl_user_field = "field" . $vbulletin->options['gxbl_user_field'];
	} else {
		$gxbl_user_field = $vbulletin->options['gxbl_user_field'];
	}

Is this the only point where the system looks for the value of the field? if it is could I in theory change it so it is not looking for a numeric value and change the value to look in a field with a name? such as

	if ($bbuserinfo[xbox] != '0')
	{
		$gxbl_user_field = $bbuserinfo[xbox]
	}

$bbuserinfo[xbox] is the name of the field that already exists in the user options.

Originally Posted by Gryphon

Unfortunately it is a bit more involved than replacing the variable, the cron job would need the queries re-written for one as well as some other checks in place that expect an id.

Another solution would be to use a query to move every body's IM style entries to a profile field and then remove the IM style mod.

[Peench]

Originally Posted by alfieuk

Just to let you know i have sorted this problem.

Thanks for the help

I am currently running into the same issue you had also. Would you mind sharing your fix? I've tried a few things, but none have worked.

Thanks.

[JVCode]

Where it says add (*GamerTAG*) to your friends list or send this user a message, is it possible to replace it with a small image?, the text looks really ugly.

[jribz]

I tried searching for an answer to this, I really did, but I cant seem to find it.

Is there a way to use images for the send messages and add to friends list feature? Also, the images for the reputation are not showing up for me when I set it to the folder option, they come up from Xbox.com but they don't match my site at all. I just have reputation:20, etc.

Thanks.

[Greenskull]

Hey man! I really need this mod but I set it up and it's just blank. I see the page and everything but there are no gamertags in it. The field is correct. What's wrong?! Thanks.

PS: Will it make a difference if I use the gamertag field from the postbit?

[Gryphon]

Originally Posted by JVCode

Where it says add (*GamerTAG*) to your friends list or send this user a message, is it possible to replace it with a small image?, the text looks really ugly.

Originally Posted by jribz

I tried searching for an answer to this, I really did, but I cant seem to find it.

Is there a way to use images for the send messages and add to friends list feature? Also, the images for the reputation are not showing up for me when I set it to the folder option, they come up from Xbox.com but they don't match my site at all. I just have reputation:20, etc.

Thanks.

Make sure that you upload the images to your specific styles misc directory. You are probably using Firefox which is not showing you that there is a broken image and just showing the alt text.

Originally Posted by Greenskull

Hey man! I really need this mod but I set it up and it's just blank. I see the page and everything but there are no gamertags in it. The field is correct. What's wrong?! Thanks.

PS: Will it make a difference if I use the gamertag field from the postbit?

Have you waited for the cron to run? I am not sure what you mean by gamertag field from the postbit.