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.

[Gryphon]

Originally Posted by Spinball

I've had to disable it for now - that's why it's not appearing correctly.
Try disabling it on yours and then accessing the page - you'll probably get the same results.
Maybe if you set an option to allow it to update only between certain times. I would have it work between 2am and 7am for example.
It's a pity I've had to disable it - look at the reception it got : http://www.avforums.com/forums/showthread.php?t=696978

You are right, I thought it disabled the whole page when the product was disabled, I will have to change that.

I don't know why it is causing such load. There are leadboards with 10k members running on an older version of gXboxLive which trys to update all the cards every 30 minutes, extremely inefficient.

With only 1000 members it should be making 5 gamercard updates at a time, and should be done between 12am and 3:30am.

Of course, I am always working on optimizing it more, it has been a main goal since the release of v2.

[gundarN]

It appears that after installing 2.1.4 last night (and now 2.1.6 today), when a user who is set to use the postbit_legacy tries to view a thread, none of the post contents are appearing.
Is this a coincidence or something that gXboxLive may have caused in some way?

Thankefully only one user currently uses the postbit_legacy, all others use the normal postbit.

Cheers.

[Silviu]

Hi Gryphon, great hack, been using it for a while, however, ever since the 2.1.3 version, the Leaderboard simply refuses to update the scores. As you can see here, the score shown for angelcrying is 37799, but if you hover to see his Gamertag, the actual score is 37899 (not to mention the fact that his games aren't even listed on the scoreboard).

This is what I get when i run the cron job manually:

gXboxLive Update
Updated Accounts: .

Process Time: 6s.
Total Queries: 58.

Done

I've tried running the cron job manually, but the end result is the same. Is there anything I can do, short of reinstalling the mod altogether?

[Gryphon]

I can not view the board as a guest. However, the scores update once per day, so changes mid day will not be picked up until the next day. When Update Accounts has no user names, all of the accounts for the day have been processed.

If you are not seeing the games listed, that is an odd problem, I am not sure what could be causing that off the top of my head.

@gundarN, I'm not sure why that would be the case. The way the postbit template is modified is exactly the same between the two. I use legacy by default on my boards ok. I will dig into this and see if I can find anything.

[Silviu]

Originally Posted by Gryphon

I can not view the board as a guest.

I enabled the Live Scoreboard for the Guest usergroup, now you should be able to access it.

Originally Posted by Gryphon

However, the scores update once per day, so changes mid day will not be picked up until the next day. When Update Accounts has no user names, all of the accounts for the day have been processed.

If you are not seeing the games listed, that is an odd problem, I am not sure what could be causing that off the top of my head.

Well, the problem is that the scores haven't been updated in almost a week. I've attached a screenshot to underline the problem.

[Spinball]

I have my own XBL Gamercard functionality which, in specific forums (just the Xbox ones), the user's avatar or gamercard will be displayed depending on a choice they make in their CP options page.
(I have the system create a narrower version of the gamercard which fits into postbit_legacy without forcing the cell width wider. I use an iFrame which calls an external script because I don't know how to code using the new plugin system).
The way I update the gamercards is to make a check only when the gamercard needs to be displayed. I.e. a users' post is displayed. Then it looks to see if the card has been updated in the last 24 hours, and if it hasn't, it updates it right away.
Maybe your system could do a full update once a week at a specified time -2am, say.
And then update as needed like my system does.
I would alter my system to use the info from your tables if your mod was working ok on our board.

[Gryphon]

Originally Posted by Silviu

Well, the problem is that the scores haven't been updated in almost a week. I've attached a screenshot to underline the problem.

Silviu, Are there any errors when you run the scheduled task manually?

[Silviu]

No, it seems to be working fine:

gXboxLive Update
Updated Accounts: .

Process Time: 5s.

Total Queries: 58.

Done

In the end I think a reinstall is the only option to fix this.

[XFSImperial]

When I run the cron job manually, I get this error:

gXboxLive Update 

Warning: mysql_num_rows(): supplied argument is not a valid MySQL result resource in \includes\cron\miner.gxboxlive.php on line 85
Updated Accounts: gamertag, gamertag, gamertag

Process Time: 2s.

Total Queries: 79.
Done

[theoz1]

I give members the option put this in their profile under edit profile, but to those that dont have a tag or do not want to add one keep getting an error that says :"You did not enter the correct format for the Xbox Live GamerTag field. Please read the field description for the expected format." and I have it set to be optional. Any idea?