Title: Challonge
Author: zavaboy
Published: <strong>5 de noviembre de 2013</strong>
Last modified: 2 de septiembre de 2017

---

Buscar plugins

![](https://ps.w.org/challonge/assets/banner-772x250.png?rev=879372)

Este plugin **no se ha probado con las últimas 3 versiones mayores de WordPress**.
Puede que ya no tenga soporte ni lo mantenga nadie, o puede que tenga problemas 
de compatibilidad cuando se usa con las versiones más recientes de WordPress.

![](https://ps.w.org/challonge/assets/icon.svg?rev=1044546)

# Challonge

 Por [zavaboy](https://profiles.wordpress.org/zavaboy/)

[Descargar](https://downloads.wordpress.org/plugin/challonge.zip)

 * [Detalles](https://es-do.wordpress.org/plugins/challonge/#description)
 * [Valoraciones](https://es-do.wordpress.org/plugins/challonge/#reviews)
 *  [Instalación](https://es-do.wordpress.org/plugins/challonge/#installation)
 * [Desarrollo](https://es-do.wordpress.org/plugins/challonge/#developers)

 [Soporte](https://wordpress.org/support/plugin/challonge/)

## Descripción

Do you use [Challonge](https://challonge.com/) 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.

#### Features

 * Adaptive caching and background refresh allows your pages to load a lot faster
   than before! – **New in 1.1.6!**
 * Only registered users may sign up to your tournaments.
 * Likewise, your users may forfeit a tournament after signing up, but only before
   it begins.
 * Participating users may report their own scores.
 * Includes role capabilities. You will need a role management plugin to change 
   who has these capabilities.
 * Custom participant name templating.

#### Languages

 * English
 * Spanish (68%) – Thanks to Andrew Kurtis from [WebHostingHub](http://www.webhostinghub.com/)
   for translating!

#### Requirements

In order to use the API, you will need [cURL](http://php.net/manual/en/book.curl.php).
Most PHP installations include cURL.

#### Latest Information

Keep up to date with upcoming release information on my website:

https://zavaboy.org/challonge-wordpress-plugin/

#### Getting Started

Before you start using this plugin, here’s what you’ll need:

 * A [Challonge.com](https://challonge.com/) account. Registration is free.
 * A valid [Developer API Key](https://challonge.com/settings/developer) so the 
   Challonge plugin can talk with your Challonge.com account.

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.

#### Shortcode

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.
 * **`allowusers`** / **`denyusers`** / **`allowroles`** / **`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.
 * **`statuses`** / **`excludestatuses`** – A comma separated list of tournament
   statuses you would like to specifically show or hide from the tournament listings.
   All statuses: "Pending,Checking In,Checked In,Underway,Awaiting Review,Complete"
 * **`listparticipants`** – List participants currently in the tournament. (Must
   be used with `url`) – **New in 1.1.6!**

#### Widget

To allow your users to signup and report their own scores, just add the plugin widget.

The widget has the following options:

 * **Title** – The title of the widget, nothing special here. Defaults to 'Challonge'.
 * **Subdomain** – The subdomain to list your tournaments from. (Optional)
 * **Tournament Filter** – Only tournament names that match this filter will be 
   listed. (Optional) This may be a simple wildcard filter, for example `My * Tournament`
   will 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/i` will match 'My 3rd tournament' but not 'My Third Tournament'
 * **Status Filter** – Only list tournaments with the selected statuses, unless 
   none are selected.
 * **Max tournaments listed** – The maximum number of tournaments that the widget
   will list. Defaults to 10.

#### Integrating Challonge.com Tournaments

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:

 * Turning 'Host a sign-up page' on will allow your users to signup through the 
   widget.
 * In 'Advanced Options' > 'Permissions': Turning 'Allow participants with Challonge
   accounts to report their own scores.' on will allow your users to report their
   own scores through the widget.
 * In 'Advanced Options' > 'Permissions': Turning 'Exclude this event from search
   engines and the public browsable index.' on will hide the tournament from the
   shortcode and widget tournament listings.

#### Did You Know?

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.

Good luck!

## Capturas

 * [[
 * It’s easy to embed a tournament bracket with the shortcode. The widgets make 
   singing up to a tournament and reporting scores easy.
 * [[
 * If no "url" attribute is set in your shortcode, a tournament listing will be 
   displayed.
 * [[
 * Signing up to a tournament is easy.
 * [[
 * Reporting your score is also easy.
 * [[
 * Control things like how player names are defined and how scoring works in the
   settings page.

## Instalación

 1. Upload the `challonge` folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the 'Plugins' menu in WordPress.
 3. You should add your Challonge.com 'Developer API Key' to 'Settings' > 'Challonge'.

## FAQ

  Installation Instructions

 1. Upload the `challonge` folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the 'Plugins' menu in WordPress.
 3. You should add your Challonge.com 'Developer API Key' to 'Settings' > 'Challonge'.

  Why was this Challonge plugin made?

At first, I needed a WordPress plugin to help with some tournaments I was involved
with and nobody had made one or was working on one at that time, so I started making
this plugin. Later, I no longer needed a plugin, but I already started the project
and people have already noticed. After about a year of life distractions and general
procrastination, I completed the first version.

  Do I need a Challonge.com account to use this plugin?

Actually, no you don’t. (Keep reading!) Without an account, you will only be able
to embed tournament brackets into posts and pages with the shortcode, but you will
not be able to get any tournament listings with the shortcode or in the widget. 
You will need a valid Challonge API key, which you can get easily with a [Challonge.com](https://challonge.com/)
account, to use all the Challonge WordPress plugin has to offer. A Challonge.com
account is free.

  I think I found a bug. What do I do?

Although I do my best to avoid introducing bugs, especially with complexity growing
every release, it gets increasingly difficult for me to squish them all before I
make a release. That said, please report any bugs you come across in the [support forum](https://wordpress.org/support/plugin/challonge).
I try to get to bug reports quickly depending on the severity. If I’m already aware
of the bug, you will find it in the [upcoming release notes](https://zavaboy.org/challonge-wordpress-plugin/)
on my website.

  Can you make the plugin do this?

Got an idea for a new feature or don’t like how something already is? Please speak
up in the [support forum](https://wordpress.org/support/plugin/challonge)! A lot
of the features in the plugin today have been suggested or influenced by the community.
If there’s something you’d like to see, chances are others may want to see it as
well.

  How can I help you out?

I do not have a lot of time to actually test everything I put into this plugin. 
It has already happened where I make something work and the next thing I know, it
doesn’t work because I forgot one small detail. So, testing this plugin out for 
me and letting me know what you find would be a big help! If you don’t want to do
that, you could always [donate](https://zavaboy.org/challonge-wordpress-plugin/).
Donating will keep me active on this project.

## Reseñas

![](https://secure.gravatar.com/avatar/a62295d9cb4f713a0e3b6bc557f9a59c1acfc0727497b0cb10e41969bd46922b?
s=60&d=retro&r=g)

### 󠀁[Abandoned, doesn’t work](https://wordpress.org/support/topic/abandoned-doesnt-work/)󠁿

 [rcharbonxx](https://profiles.wordpress.org/rcharbonxx/) 27 de marzo de 2020

Don’t bother trying.

![](https://secure.gravatar.com/avatar/5d49c656e9bb1be6a0200491f8f38d8c16f15806537b5588ab0a0e4a35a96f08?
s=60&d=retro&r=g)

### 󠀁[Do not download](https://wordpress.org/support/topic/do-not-download-17/)󠁿

 [Xyphien](https://profiles.wordpress.org/xyphien/) 28 de mayo de 2019

Once you download this, you’re unable to delete it. You get a page not available
every time you download it. The actual displays of the tournament are ugly, and 
clunky compared to how challonge looks and it doesn’t update very well if not at
all either. I changed the url and tried to refresh multiple times but it kept displaying
the original url no matter what. I wouldn’t recommend this.

![](https://secure.gravatar.com/avatar/2d0cbcb5009b677bd585fd83d3caf31209fb3d5cecf11dec6a47620a90d6151d?
s=60&d=retro&r=g)

### 󠀁[Good](https://wordpress.org/support/topic/good-2736/)󠁿

 [hiveclub](https://profiles.wordpress.org/hiveclub/) 20 de julio de 2017

This is unique plugin, that gives me the way to use challonge brackets on my own
site

![](https://secure.gravatar.com/avatar/3398b6da70317a1700be0ec81dd9c5a33a0d0868b3741009fe732713995134d9?
s=60&d=retro&r=g)

### 󠀁[Nice plugin! need some help too.](https://wordpress.org/support/topic/nice-plugin-need-some-help-too/)󠁿

 [kazuhiko](https://profiles.wordpress.org/dase66/) 30 de enero de 2017 3 replies

The plugin works fine. I had some problems with displaying it for public but I fixed
it easily. I just can’t find a way to disable the ads in the module which is displaying
the tournament. They’re are located in the bottom of module and I really need to
disable them or disable the whole div which shows the bottom_bar. I would appreciate
it if u could help me with this! Thank you, Kazuhiko

![](https://secure.gravatar.com/avatar/dec00161ec185caf4b08fa30692e03c19fa6a805174eb623befcd0ba1e2c4c0b?
s=60&d=retro&r=g)

### 󠀁[Awesome](https://wordpress.org/support/topic/awesome-3568/)󠁿

 [Dustin](https://profiles.wordpress.org/dustamaphone/) 3 de septiembre de 2016

Just started using this and at first I thought it was overly simplistic but there
are actually a lot of great features in this plugin. Makes it quick and easy to 
pull in tournament information from Challonge into your website. THANK YOU very 
much for doing this. Saved me a ton of programming that would have come along with
manually pulling in the API myself. Might have been a fun learning experience, but
you saved me a ton of time. Thank you so much. Cheers.

 [ Leer todas las 9 reseñas ](https://wordpress.org/support/plugin/challonge/reviews/)

## Colaboradores y desarrolladores

"Challonge" es un software de código abierto. Las siguientes personas han colaborado
con este plugin.

Colaboradores

 *   [ zavaboy ](https://profiles.wordpress.org/zavaboy/)

"Challonge" ha sido traducido a 2 idiomas locales. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/challonge/contributors)
por sus contribuciones.

[Traduce "Challonge" a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/challonge)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/challonge/) , echa
un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/challonge/) o 
suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/challonge/)
por [RSS](https://plugins.trac.wordpress.org/log/challonge/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.1.6

 * Tested in WordPress 4.9
 * Fixed issue where widget Signup buttons on tournaments with one or more participants
   are not displayed for users not logged in. Thanks to sagund07 for finding the
   cause and giving a solution for this issue.
 * Added comments in code about relevant functionality changes in WordPress 4.6.
 * Changed some class names in settings to be less conflicting with other plugin
   CSS that may be loaded as well.
 * Added a way to list participants to shortcodes.
 * Fixed insecure content loading in iframes on secure pages.
 * Improved caching for much faster page loads.
 * Added adaptive caching where the expire date is determined by the cached content.
 * Added cache age to bottom corner shortcodes and widgets which also allows manual
   refreshing.

#### 1.1.5

 * Moved widget content functions to a new class for Ajax related methods.
 * Moved development features to separate class.
 * Made an option to disable the exclusion setting in each tournament from Challonge.
   com.
 * Added status-specific visibility options to shortcodes.
 * Added option to manage shortcode tournament listings.
 * Added user meta fields to participant name templating.
 * Bumped tested WordPress version from 4.1 to 4.5.
 * Fixed action buttons from replacing tournament link in listing.
 * All buttons for the tournament now update after an action has taken place.
 * Some general code cleanup.

#### 1.1.4

 * Added version information to settings page.
 * Made plugin translation ready.
 * Added version mismatch check to development notices.
 * Added Spanish translation by Andrew Kurtis from WebHostingHub.com
 * Fixed limits from displaying oldest instead of newest.
 * Increased minimum WordPress version requirement from 3.2 to 3.3.
 * Bumped tested WordPress version from 3.9 to 4.0.
 * Fixed a issue when viewing a bracket from the widget on secondary multisite.
 * Tournament information now displays the amount of time before a tournament is
   scheduled to start in addition to its created date.
 * Added support for checking in during the check in period if the participant isn’t
   already checked in.
 * Participants may now forfeit during the check in period.
 * Widget and shortcode displays an "unavailable" message instead of displaying "
   no tournaments" when the API request fails.
 * Added "checking in" and "checked in" to widget status filter. Additionally added"
   Unknown/Other" to cover new or unknown statuses.
 * Return an error if an AJAX request fails.
 * Fixed dates from API. (I was doing it wrong.)
 * Thickbox is sized to fit the screen when viewing a tournament bracket.
 * Improved regular expressions for more flexibility for input values.
 * Added flexibilty to Subdomain input in widget settings. (eg. now accepts "my-
   subdomain.challonge.com")
 * Added a Challonge TinyMCE editor button. (Just copy/paste the URL of the listing
   or tournament you want to add to the page.)
 * Made minor improvements in the code and some cleanup.

#### 1.1.3

 * Increased CSS z-index for thickbox.
 * Added proper support for SSL verification.
 * The API key verification on the settings page will now catch response failures
   and display an error.
 * Added cURL detection to notify user if cURL is not installed.
 * Added a way to hide the donation box in case it gets in the way.
 * Changed default caching value to "0″.
 * Added method to handle version update changes. (I didn’t need it until now.)
 * Improved admin notice transient.
 * Added a screenshot of the settings page.
 * Increased minimum WordPress version requirement from 3.1 to 3.2.
 * Made additional minor changes.

#### 1.1.2

 * Fixed a few misspellings in the settings page.
 * Removed the minor security fix I released with last update. It caused a redirection
   loop with some plugins.
 * Updated CSS to force thickbox on top of theme elements. This takes the place 
   of the previous CSS fix for the twentyeleven theme.
 * Tested in WordPress 3.9.

#### 1.1.1

 * Fixed API Caching from handling non-XML responses as XML and throwing a fatal
   error.
 * Added a way around secondary copies of jQuery from overriding the Challonge plugin.
 * Fixed score reporting when scoring is on second setting and opponent scoring 
   is disabled and the participant is matched with a opponent that signed up via
   other means.
 * Fixed a minor security issue.
 * Fixed the Signup button actions for unregistered users.
 * Added some CSS to prevent twentyeleven theme header from showing over thickboxes.
 * Some general code cleanup.

#### 1.1.0

 * Added participant name templating with tokens.
 * Added scoring settings.
 * Widget and short code bracket names no longer are direct links to the brackets.
 * Added tournament description inside signup window.
 * Added administrative notices to aid my development.
 * Added caching for API responses.
 * Fixed tournament list sorting.
 * Added "limit" attribute to short code.
 * The signup button can now optionally be displayed publicly.
 * If a tournament has "Quick Advance" enabled, only a win or loss can be reported.
 * Added status filter to widgets.

#### 1.0.7

 * Fixed progress bars for Google Chrome v32.
 * Corrected link to get a Challonge API key. (It was moved.)

#### 1.0.6

 * Fixed unregistered user permissions.

#### 1.0.5

 * Fixed subdomain tournament actions in widget.

#### 1.0.4

 * Fixed issue with widget tournament limit.
 * Made changes to readme.

#### 1.0.3

 * The API Key setting will display unexpected errors instead of nothing.
 * Added a way to disable SSL verification in settings.
 * Signing up for a tournament with a participant with the same username will now
   give you an alternate username.
 * Tied games are reported correctly now.

#### 1.0.2

 * Updates for WordPress.org. There were no changes to the code.

#### 1.0.1

 * API key validation fix
 * Additional API key related fixes

#### 1.0

 * Initial release.

## Meta

 *  Version **1.1.6**
 *  Last updated **hace 9 años**
 *  Active installations **80+**
 *  WordPress version ** 3.3 o superior **
 *  Tested up to **4.9.29**
 *  PHP version ** 5.5 o superior **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/challonge/), [Polish](https://pl.wordpress.org/plugins/challonge/)
   y [Swedish](https://sv.wordpress.org/plugins/challonge/).
 *  [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/challonge)
 * Tags
 * [api](https://es-do.wordpress.org/plugins/tags/api/)[embed](https://es-do.wordpress.org/plugins/tags/embed/)
   [integration](https://es-do.wordpress.org/plugins/tags/integration/)[shortcode](https://es-do.wordpress.org/plugins/tags/shortcode/)
   [widget](https://es-do.wordpress.org/plugins/tags/widget/)
 *  [Vista avanzada](https://es-do.wordpress.org/plugins/challonge/advanced/)

## Valoraciones

 4.1 out of 5 stars.

 *  [  7 5-star reviews     ](https://wordpress.org/support/plugin/challonge/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/challonge/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/challonge/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/challonge/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/challonge/reviews/?filter=1)

[Añadir mi reseña](https://wordpress.org/support/plugin/challonge/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/challonge/reviews/)

## Colaboradores

 *   [ zavaboy ](https://profiles.wordpress.org/zavaboy/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/challonge/)

## Donar

¿Te gustaría apoyar el progreso de este plugin?

 [ Dona a este plugin ](https://zavaboy.org/challonge-wordpress-plugin/)