Integrates Challonge, a handy bracket generator, into WordPress.
Do you use Challonge for your gaming or sport events? The Challonge plugin integrates your Challonge tournaments into your WordPress website so your users may easily see recent tournaments, their progress, and even sign up and participate.
In order to use the API, you will need cURL. Most PHP installations include cURL.
Keep up to date with upcoming release information on my website:
Before you start using this plugin, here's what you'll need:
Once you have the Challonge plugin installed and activated on your website, you will need to enter your Challonge.com API key in 'Settings' > 'Challonge'. Once you have done that, you have unlocked the full power of this nice plugin.
You may use a shortcode in posts and pages to display a tournament or list out tournaments.
[challonge]- This will list out all tournament brackets in your account, excluding all organizations.
[challonge url="w4la9fs6"]- This will embed a tournament bracket. This may be any Challonge bracket, not just your own.
[challonge subdomain="my_sub"]- This will list out all tournament brackets in the 'my_sub' organization. (eg: my_sub.challonge.com)
[challonge url="w4la9fs6" theme="2" show_final_results="1" width="90%" height="600px"]- This is just a more customized version of the first shortcode.
If you have a tournament bracket within an organization, you will have to use the
subdomain attribute along with the
url attribute, like so:
[challonge url="w4la9fs6" subdomain="my_sub"]
Here's all the shortcode attributes available to you:
url- The URL to a tournament.
subdomain- The subdomain of the tournament URL or if no tournament URL is provided, the listing will be tournaments within the specified subdomain.
theme- The theme ID you would like to use.
multiplier- Scales the entire bracket.
match_width_multiplier- Scales the width allotted for names.
show_final_results- Display the final results above your bracket.
show_standings- For round robin and Swiss tournaments, you can opt to show a table of the standings below your bracket.
width- The width of the embedded tournament bracket.
height- The height of the embedded tournament bracket.
limit- Limit the number of returned results for tournament listings.
denyroles- A comma separated list of users or roles you would like to specifically allow or deny from viewing the tournament bracket or tournament listings.
To allow your users to signup and report their own scores, just add the plugin widget.
The widget has the following options:
My * Tournamentwill match 'My Big Tournament' but not 'Your Big Tournament'. If you need a more robust filter, you may use Regular Expressions (PCRE) like so:
/My \d+(st|nd|rd|th) Tournament/iwill match 'My 3rd tournament' but not 'My Third Tournament'
Challonge.com tournaments may be easily setup to allow your WordPress users to signup and report scores. Here are a few things you should know when setting up your Challonge.com tournaments:
If you run the same tournaments on multiple WordPress websites, your WordPress users will be tracked in your Challonge.com tournaments by their email address and login name, even if their display name differs. With this in mind, users may signup and report their score using either website. Also note, users who change their email address will lose access to any of their preexisting tournament signups.