Major Additions - TIO/FTL Compatible Ranking Ladder System LITE

This ranking system is based very loosely on the Association of Tennis Professionals ATP Entry Ranking System (as apposed to their ATP Race System). What this means, is that players are ranked by the total scores of their best performances within a specified time period. Using this system solves many problems within other ranking systems; especially race systems that tend to give preference to players who attend the most tournament events. This system ensures a more accurate calculation on the relative performances of players.

With this system, a player's rank is calculated using their best scores within a specified time period. Stronger players are not penalized because they had a "bad day", and weaker players are not rewarded by attending the most events. By specifying best scores limit, a player's weakest performances will be ignored in the ranking calculations (provided that player attends enough tournaments to exceed the limit). By specifying a time period, the system will automatically weed out stale rankings and remove players who are no longer active.

What is this mod?

Using this system, you can put together a fully featured ranking system for your tournaments. The purpose of this system is to give users a method to calculate rankings for all manner of events, even events that exist outside the spectrum of your forums. Because of this, this mod does NOT integrate with your forum user database; if it did, people who attended your event, but are not members of your forum, would be left out and it would skew the point values for events.

Product Demo:

http://www.8wayrun.com/ranking.php
http://www.thebreak.net/tekken/

Basic LITE Feature Listing:

• Fully integrated into the product manager with built in plugins.
• Fully phrased and built on templates for easy reskinning and styling.
• Fully administratable and a myriad of settings for personalization.
• Submission form for users to submit their tournaments for addition.
• Ability to define specific point modifier values for categories.
• Ability to define tournaments to specific categories and games.
• Keeps a paginated history of past tournaments and their values.
• Each event has full listings of attendance and earned player scores.
• Ability to upload images for each event, such as bracketted results.
• Keeps a paginated list of all players, their scores and their ranks.
• Each player has a full listing of attendance history and scores.
• Ability to link a player on the ladder to their vbulletin profile.

Advanced PRO Feature Listing:

• Ability to parse data instantly and directly from TIO files.
• Ability to automatically generate brackets based on TIO files.
• Ability to parse data instantly and directly from Forum Tournaments & Ladders.
• Ability to automatically generate brackets based on Forum Tournaments & Ladders.
• Ability to embed brackets directly into posts with [bracket]ID[/bracket]

Installation Procedure:

1. Upload all files in the "upload" directory to your forum root.
2. CHMOD /ranking/events and /ranking/games to 777.
3. Import the product "product-rankingladder.xml" in your Product Manager.
4. OPTIONAL: Import the VBAdvanced RankLad module into your VBAdvanced Pages.

Upgrade Procedure:

1. Upload all files in the "upload" directory to your forum root.
2. Take note of the information stored in Ranking Award Values of Ranking Ladder Settings.
3. Import the product "product-rankingladder.xml" in your Product Manager.
4. Re-establish your previous Ranking Award Values settings in Ranking Ladder Settings.

NOTES:

• Before you can add any event listings, you must have both a category, and a game to assign it to.
• Before you can add any scores for an event, each player in your event must have a Ladder-ID (INT).
• When adding scores to an event, you need to input their earned rank (INT), and their Ladder-ID (INT).
• If you are using the PRO version, you should put a player's Ladder-ID as their "Name" field in TIO. Then use the "Edit Existing Event" link and use the "Upload Scores from TIO" form. If you properly added all of your player's Ladder-IDs in your TIO file, the script will automatically add all scores to the event with a single click.
• If you are using the PRO version, you can automatically generate bracketted results based on the event.
• You should only need to use the "Rebuild All Events" function if your change the modifier values for your categories or awards; then you will need to rebuild all events to recalculate the scores for events.
• In order to recalculate scores for player, you will need to run the "Rebuild All Players" function; I do it once a week.
• Immediately after running "Rebuild All Players", you should also run "Rebuild All Rankings" to calculate ladder positions.

Don't forget to click INSTALL!

For more information on how to purchase the PRO version, feel free to send me a message.

[Jaxel]

================================================== =========
Version 1.4.0
================================================== =========

• Added support for displaying a user's linked rank within the profile blocks.
  
  • The profile block lists a player's top 10 ranked performances in order.
    
• Fixed broken profile link in the postbit and the postbit plugin.
• Fixed infinite loop problems while rebuilding event, player and rank data.
• FILE EDITS SINCE 1.3.0: (make sure you upload these new versions!)
  
  • upload/ranking.php
    
• TEMPLATE EDITS SINCE 1.3.0: (make sure you revert these templates!)
  
  • rankings_postbit
    
  • rankings_profile
    
  • rankings_profile_bit
    

[EWGF]

Originally Posted by Jaxel

You can edit the template and add 2007 in if you want, but I didn't see the point.

How do I edit $selectYEA?
Edit: file edit did the job.


1.4 working nicely here



Edit2: Another question to bug you with: why do numbers 6-10 get even points? In brackets you mostly end somewhere with 8 players, meaning 2 players advanced less but get equal points here

[Jaxel]

Our tournaments usually get 16+, so 6-10 get more points that 11+...

If you wish, you can easily set it so that 6-10 dont get points.

[Jaxel]

================================================== =========
Version 1.5.0
================================================== =========

• Changes made to the PRO functions to be compatible with the new version of TIO.
• Changed the copyright and license notice to make it less obstrusive.
• Added seperate bracket icons for bracket images and bracket TIO-XML files.
• Added ladder-ids in event result and player listings for reference.
• Event scores are no longer rebuilt when you edit the details for the event.
  
  • This fixes a MYSQL error for updating details for events with no scores.
    
  • If you change the event category, you will need to "Rebuild All Events".
    
• FILE EDITS SINCE 1.4.0: (make sure you upload these new versions!)
  
  • upload/ranking.php
    
  • upload/ranking/functions_rank.php
    
  • upload/ranking/functions_rank_pro.php
    
• TEMPLATE EDITS SINCE 1.4.0: (make sure you revert these templates!)
  
  • rankings_category
    
  • rankings_category_bit
    
  • rankings_event
    
  • rankings_events
    
  • rankings_events_bit
    
  • rankings_event_bit
    
  • rankings_game
    
  • rankings_game_bit
    
  • rankings_players
    
  • rankings_players_bit
    
  • rankings_submit
    
  • rankings_SHELL
    

[EWGF]

Next question: I've edited functions_rank to change (for example) 1st to 1e; to match it with my own language. But I have noticed those changes aren't applied to the postbit. How can this be done?

[Jaxel]

Originally Posted by EWGF

Next question: I've edited functions_rank to change (for example) 1st to 1e; to match it with my own language. But I have noticed those changes aren't applied to the postbit. How can this be done?

Rebuild your ranks. While the ranking system runs the fetch_ordinal everytime, the postbit doesnt, as it would add too much overhead to the server. I did this so that it doesnt affect performance.

[EWGF]

Invalid SQL:
SELECT COUNT(eventID) AS count FROM vbrank_events
			LEFT JOIN vbrank_categories AS rank_categories ON rank_events.categoryID = rank_categories.categoryID
			WHERE rank_categories.categoryID = 1;

MySQL Error   : Unknown column 'rank_events.categoryID' in 'on clause'

Script: /forum/ranking.php?do=category&cid=1

Is this a bug that rarely shows up or a crappy error on the server?

[AzzidReign]

Where do you purchase the PRO version and for how much? I tried searching the thread and couldn't find anything.

Nevermind, found it at the bottom of the original post...not sure how I didn't see it last time:

For more information on how to purchase the PRO version ($100), feel free to send me a message.
The PRO version makes this mod easier to manage by integrating this mod directly with your TIO files.

[Jaxel]

================================================== =========
Version 1.6.0
================================================== =========

• Added a MERGE PLAYERS function so you can now merge linked events.
  
  • Event history of source player will be merged into destination player.
    
  • If duplicate event scores exist, the destination's score will be retained.
    
• Added the ability to SEARCH for Players by Names, Regions and Teams.
• Added the ability to SEARCH for Events by Names, Organizers and Venues.
• Renamed some phrases in the system for administrative functions.
• BUG FIX: Fixed bug where category browsing for those with table prefixes.
• FILE EDITS SINCE 1.5.0: (make sure you upload these new versions!)
  
  • upload/ranking.php
    
  • upload/ranking/functions_rank.php
    
• TEMPLATE EDITS SINCE 1.5.0: (make sure you revert these templates!)
  
  • rankings_category_add
    
  • rankings_events
    
  • rankings_event_add
    
  • rankings_game_add
    
  • rankings_players
    
  • rankings_players_bit
    
  • rankings_player
    
  • rankings_player_add
    
  • rankings_postbit
    
  • rankings_scores_merge
    
  • rankings_SHELL
    

[Jaxel]

Hey, I'm curious how people are using this mod at all... Would anyone mind sending me links showing examples of how they are using this system?