Brackethive

Présentation

Brackethive a été développé pour Brackethive 2026, un tournoi à 16 équipes sur 8 postes de jeu. Il gère aujourd'hui plusieurs tournois par site, dans trois formats, avec ou sans inscriptions publiques.

L'extension fait trois choses : elle génère le tableau des matchs à partir du format et du nombre d'équipes, elle propage les résultats que vous saisissez, et elle publie tout cela sur une page que les joueurs et le public consultent depuis leur téléphone.

Ce dont vous avez besoin

Un site WordPress 5.6 ou plus récent, en PHP 7.0 ou plus récent.
Un compte administrateur sur ce site.
Rien d'autre : aucun service extérieur, aucune clé d'interface de programmation, aucun compte à créer.

Bon à savoir

Tout est modifiable après coup. Le format, le nombre d'équipes, les horaires et les manches se changent tant que les matchs ne sont pas joués, et le tableau se régénère automatiquement.

01 Installation

L'extension se livre sous forme d'une archive ZIP. Comptez deux minutes.

1

Téléverser l'archive

Dans l'administration WordPress : Extensions, puis Ajouter, puis Téléverser une extension. Choisissez le fichier brackethive-2.4.3.zip et installez.

Vous pouvez aussi décompresser l'archive et déposer le dossier brackethive dans wp-content/plugins/ par FTP.
2

Activer

L'activation crée les tables de la base de données et les permaliens des pages de tournoi. Un menu Tournois apparaît dans la colonne de gauche.
3

Vérifier l'envoi des e-mails

Si vous comptez ouvrir les inscriptions, allez dans Tournois › Extension et utilisez le bouton Envoyer un e-mail de test. Beaucoup d'hébergements n'expédient pas les e-mails sans configuration ; mieux vaut le savoir avant la soirée.

Si les pages de tournoi renvoient une erreur 404

Ouvrez Réglages › Permaliens et cliquez sur Enregistrer, sans rien changer. WordPress régénère ses règles de réécriture et les adresses fonctionnent.

02 Créer un tournoi

Le menu Tournois › Nouveau tournoi ouvre un assistant en quatre étapes. Chaque réglage est expliqué sous son champ, et un récapitulatif calcule le nombre de matchs et l'heure de fin estimée avant que vous ne validiez.

1

Le tournoi

Nom, jeu, lieu, date, heure du premier match, couleur d'accent. Seul le nom est obligatoire ; il devient aussi le titre et l'adresse de la page publique.
2

Le format

Trois cartes décrivent les formats avec leur nombre de matchs pour 16 équipes. Vous indiquez le nombre d'équipes, et selon le format, le nombre de poules ou l'option de seconde grande finale.
3

Matchs et horaires

Nombre de manches par tour, postes de jeu disponibles, matchs joués en même temps, durée d'une manche, temps d'accueil et pauses. Le planning en découle.
4

Inscriptions et publication

Vous ouvrez ou non le formulaire public, puis vous choisissez ce qu'il advient de la page du tournoi : publiée tout de suite, gardée en brouillon, ou pas de page dédiée si vous préférez composer vos propres pages avec les codes courts.

Une case permet de créer en même temps une page d'inscription dédiée, qui ne contient que le formulaire réduit et donne une adresse courte à partager.

Après la création, le tableau de bord affiche un panneau Prochaines étapes qui vous guide jusqu'au jour J, et coche les étapes à mesure qu'elles sont faites.

03 Choisir le format

Le format détermine la durée de la soirée bien plus que le nombre d'équipes. Les chiffres ci-dessous valent pour 16 équipes.

Élimination directe

Une défaite et l'équipe est éliminée. Le plus simple et le plus rapide.

Matchs: 15
Tours: 4
Matchs par équipe: 1 à 4

Double élimination

Une équipe n'est éliminée qu'après deux défaites, grâce à un tableau de repêchage. Plus long, plus juste.

Matchs: 30 ou 31
Tours: 4 + repêchage
Matchs par équipe: 2 à 8

Poules puis tableau

Chaque équipe joue toutes celles de sa poule, puis les meilleures s'affrontent en tableau. Le plus long, mais personne ne repart après un seul match.

Matchs: 24 + 7
Poules: 4 de 4
Matchs par équipe: 3 à 5

Effectifs et exemptions

De 2 à 64 équipes. Quand l'effectif n'est pas une puissance de deux, les équipes les mieux placées sont exemptées du premier tour : elles passent sans jouer. Ces exemptions n'occupent ni créneau ni poste dans le planning et ne comptent pas comme des matchs.

Le placement des équipes

Le tableau suit l'algorithme classique de tête de série : la première rencontre la dernière, la deuxième l'avant-dernière, et ainsi de suite, réparties pour que les mieux classées ne se croisent que le plus tard possible. Pour 16 équipes, le premier tour est celui du dossier d'organisation d'origine.

M1 1 vs 16
M2 8 vs 9
M3 4 vs 13
M4 5 vs 12
M5 2 vs 15
M6 7 vs 10
M7 3 vs 14
M8 6 vs 11

Manches par tour

Chaque tour se règle indépendamment en BO1, BO3 ou BO5. En BO3, la première équipe à deux manches gagnées l'emporte, et les scores se saisissent manche par manche. Un BO3 occupe environ deux fois le créneau d'un BO1 dans le planning : c'est le principal levier sur la durée totale.

Options de fin de tournoi

Match pour la 3e place : oppose les deux perdants des demi-finales. Sans objet en double élimination, où le perdant de la finale du repêchage est troisième.
Seconde grande finale : en double élimination, si l'équipe venue du repêchage gagne la grande finale, une seconde est jouée, puisqu'elle avait déjà une défaite. Le match n'apparaît que s'il a lieu.

Composition des poules

En mode automatique, les équipes sont réparties en serpentin selon leur position. En mode manuel, la poule se choisit sur la fiche de chaque équipe. Dans les deux cas, les qualifiés sont croisés entre poules : deux équipes d'une même poule ne se rencontrent pas au premier tour de la phase finale, et les premiers de poule ne peuvent pas se croiser avant la finale.

04 Les équipes

Deux façons de constituer la liste, qui se combinent librement.

Saisie par l'organisation

Écran Tournois › Équipes. Le formulaire d'ajout est en haut de page : nom de l'équipe, tag, position, capitaine, e-mail, téléphone, joueurs et notes internes. Les notes ne sont jamais affichées publiquement.

Inscriptions publiques

Ouvrez le formulaire dans Réglages du tournoi › Inscriptions. Les demandes arrivent en attente de validation et n'apparaissent pas dans le tableau tant que vous ne les avez pas validées. Le bouton « Valider les inscriptions en attente » traite tout d'un coup.

Deux formulaires sont disponibles : le formulaire complet, avec la liste des joueurs, et un formulaire réduit à Team, Pseudo, Mail et Téléphone obtenu avec l'attribut simple="yes".

À chaque inscription, le capitaine reçoit un accusé de réception et l'organisation une alerte, envoyée à l'adresse de notification du tournoi ou, à défaut, à l'adresse d'administration du site.

Protections du formulaire

Le formulaire est limité à trois envois par heure et par adresse, comporte un piège à robots invisible et exige l'acceptation du règlement, vérifiée côté serveur. Le nombre maximum d'inscriptions est réglable ; une équipe refusée libère sa place.

Les positions

Chaque équipe validée reçoit une position de 1 à N, qui la place dans le tableau. Vous pouvez les attribuer à la main, selon un classement ou un tirage au sort papier, ou utiliser le bouton Tirage au sort des positions libres, qui ne touche pas aux positions déjà fixées.

Le tableau reste incomplet tant que toutes les positions ne sont pas attribuées : c'est normal, il se remplit à mesure.

05 Partager le tournoi

Le tableau de bord affiche un bloc Liens publics avec les adresses à diffuser, chacune accompagnée d'un bouton Copier et d'un QR code.

Les deux adresses

Page du tournoi : la page à onglets, avec le tableau, le planning, les résultats, les équipes et le classement.
Page d'inscription : si vous avez créé une page dédiée, son adresse courte. Sinon, le lien pointe vers l'onglet Inscription de la page du tournoi.

Les QR codes

Chaque adresse a son QR code, téléchargeable en PNG d'environ 600 pixels de côté pour une affiche, ou en SVG vectoriel pour une impression grand format. Ils sont calculés par votre propre serveur : aucune adresse n'est transmise à un service extérieur.

Un usage courant : un QR code vers l'inscription sur les affiches avant l'événement, un QR code vers la page du tournoi sur les tables le soir même.

La page du tournoi

Elle est créée automatiquement et se trouve dans Tournois › Tous les tournois, et non dans le menu Pages de WordPress. Le bouton Modifier la page de la barre du tournoi l'ouvre dans l'éditeur, où vous pouvez ajouter du texte avant ou après le tournoi, ou la publier si elle est en brouillon.

Sans page dédiée

Si vous avez choisi cette option, la page du tournoi répond « introuvable » aux visiteurs et le tournoi n'apparaît pas dans la liste publique. Vous composez alors vos propres pages avec les codes courts, que le tableau de bord vous fournit déjà renseignés. L'option se change à tout moment dans les réglages du tournoi.

06 Le jour J

Saisir les scores

Écran Tournois › Matchs & scores. Chaque match a son formulaire : statut, score, arbitre, postes et horaires. En BO3 ou BO5, les manches se saisissent une par une. Le statut passe automatiquement à « En cours » dès qu'un score est saisi.

Dès qu'un match est validé, le vainqueur est placé au tour suivant, et en double élimination le perdant part au repêchage. Si vous corrigez un résultat, tous les matchs qui en dépendaient sont remis à zéro : l'extension ne laisse jamais un tour suivant reposer sur un résultat périmé.

Ce que l'extension refuse

Un match nul, un match validé avant que les deux équipes soient connues, une manche à égalité, ou des manches en trop après que le vainqueur a atteint son total. Le message indique à chaque fois quoi corriger.

L'affichage public

La page du tournoi se rafraîchit toute seule, par défaut toutes les 30 secondes, sans que le visiteur ait à recharger. Le rafraîchissement se met en pause quand l'onglet est en arrière-plan, et espace ses tentatives en cas de coupure réseau.

Le tableau s'adapte seul à l'écran, en largeur comme en hauteur. Sur un écran de régie, le code court [brackethive_tableau header="no"] affiche le tableau seul, sans en-tête.

Le planning

Écran Tournois › Planning. Les horaires sont calculés par tour, en tenant compte des matchs joués en même temps, des manches et des pauses. Vous pouvez ajuster chaque horaire à la main : vos ajustements ne sont pas écrasés, sauf si vous utilisez le bouton Recalculer le planning.

Imprimer

La feuille de résultats et le planning sont mis en forme pour l'impression : fond blanc, texte noir, tableau non rogné. Utilisez simplement l'impression du navigateur depuis la page publique.

Codes courts

Les codes courts servent à placer le contenu du tournoi sur vos propres pages. La marche à suivre est toujours la même : créez une page dans Pages › Ajouter, collez-y le code court, puis cliquez sur Publier. Tant que la page n'est pas publiée, les visiteurs ne la voient pas.

Code court	Affichage
`[brackethive_tournoi]`	Page complète à onglets. C'est celui de la page du tournoi.
`[brackethive_tableau]`	Le tableau des matchs seul.
`[brackethive_planning]`	Le planning horaire.
`[brackethive_resultats]`	La feuille de résultats.
`[brackethive_classement]`	Le classement général, de la première à la dernière place.
`[brackethive_poules]`	Les classements de la phase de poules.
`[brackethive_equipes]`	Les équipes engagées.
`[brackethive_inscription]`	Le formulaire d'inscription.
`[brackethive_reglement]`	Le règlement du tournoi.
`[brackethive_organisation]`	Le personnel nécessaire.
`[brackethive_checklist]`	La checklist avant ouverture.
`[brackethive_tournois]`	La liste de tous les tournois publiés du site.

Attributs

Attribut	Sur	Effet
`tournoi="identifiant"`	tous sauf `[brackethive_tournois]`	Cible un tournoi précis. Sans cet attribut, le code court affiche le tournoi de la page courante, sinon le tournoi par défaut du site. `tournament` est accepté comme synonyme, et un identifiant numérique fonctionne aussi.
`simple="yes"`	`[brackethive_inscription]`	Formulaire réduit à Team, Pseudo, Mail et Téléphone.
`header="no"`	`[brackethive_tableau]`	Masque le bandeau de titre. Utile sur un écran de régie.
`fit="width"`	`[brackethive_tableau]`, `[brackethive_tournoi]`	Ajuste le tableau à la largeur seulement, avec défilement vertical, au lieu de le faire tenir entièrement à l'écran.
`players="yes"`	`[brackethive_equipes]`	Affiche la composition des équipes.

Exemple

[brackethive_tableau tournoi="spring-esports-cup" header="no" fit="width"]

Les écrans

Tous les écrans portent sur le tournoi choisi dans la barre Tournoi en haut de page. Ce choix est mémorisé pour chaque utilisateur.

Tableau de bordChiffres clés, liens publics et QR codes, prochaines étapes, aperçu du tableau, outils, sauvegarde et codes courts.
Nouveau tournoiL'assistant de création en quatre étapes.
Tous les tournoisLa liste WordPress des tournois, pour publier, renommer ou modifier une page.
ÉquipesAjout et modification des équipes, validation des inscriptions, positions, tirage au sort.
Matchs & scoresSaisie des résultats, manche par manche en BO3 et BO5.
PlanningHoraires et postes, ajustables à la main, avec recalcul complet possible.
Réglages du tournoiIdentité, format, manches, planning, affichage, inscriptions, et la zone sensible pour réinitialiser ou supprimer.
Aperçu publicLe rendu réel de chaque vue, en largeur bureau, tablette ou mobile.
ExtensionRéglages communs à tout le site : tournoi par défaut, rafraîchissement, titre de page, mises à jour, e-mail de test, désinstallation.

Réglages de l'extension

Menu Tournois › Extension. Ces réglages valent pour tout le site, contrairement à ceux du tournoi.

Réglage	Par défaut	Rôle
Tournoi par défaut	le plus récent	Celui qu'affichent les codes courts sans attribut `tournoi`.
Rafraîchissement auto	30 secondes	Intervalle de mise à jour des pages publiques. 0 désactive.
Masquer le titre de page	activé	Masque le bandeau de titre du thème sur les pages de tournoi, qui ferait doublon avec l'en-tête du tournoi.
Sélecteurs supplémentaires	vide	Pour un thème dont le bandeau résiste, on peut ajouter ses propres sélecteurs CSS.
URL du manifeste	vide	Active les mises à jour automatiques. Voir ci-dessous.
Données à la désinstallation	conservées	Décoché, supprimer l'extension ne détruit aucune donnée.

Sauvegarde

Tableau de bord › Sauvegarde exporte un fichier JSON contenant les équipes, les matchs, les scores et les manches du tournoi affiché. Faites-le avant toute manipulation délicate : changement de format en cours de tournoi, import, réinitialisation.

La restauration remplace les données du tournoi choisi par celles du fichier. Elle est transactionnelle : en cas d'erreur, rien n'est modifié et le message indique la cause. Une case permet de restaurer aussi les réglages.

Désinstallation

Par défaut, désinstaller l'extension ne supprime aucune donnée : les tables et les tournois sont conservés, et tout revient si vous réinstallez. La suppression complète n'a lieu que si vous cochez l'option correspondante au préalable.

Mises à jour

L'extension n'étant pas publiée sur l'annuaire WordPress.org, les mises à jour passent par un manifeste auto-hébergé : un fichier JSON décrivant la dernière version, dont vous indiquez l'adresse dans les réglages de l'extension. WordPress propose alors la mise à jour dans la page Extensions, comme pour n'importe quelle autre.

{
  "name": "Brackethive",
  "slug": "brackethive",
  "version": "2.4.3",
  "requires": "5.6",
  "requires_php": "7.0",
  "download_url": "https://exemple.fr/maj/brackethive-2.4.3.zip",
  "sha256": "empreinte hexadécimale du fichier ZIP"
}

HTTPS obligatoire

Le manifeste et l'archive doivent être servis en HTTPS ; l'extension refuse toute autre adresse. Il s'agit de code PHP installé automatiquement sur votre site : une adresse en HTTP pourrait être détournée pour y faire installer autre chose.

La clé sha256 est facultative. Lorsqu'elle est renseignée, l'archive téléchargée est vérifiée avant installation et rejetée si son empreinte ne correspond pas.

API REST

Deux routes publiques en lecture seule, utiles pour un affichage sur écran, une régie ou un tableau de bord externe.

Route	Renvoie
`GET /wp-json/brackethive/v1/state`	L'état complet du tournoi en JSON : équipes, matchs, scores, statuts.
`GET /wp-json/brackethive/v1/render?view=bracket`	Le HTML d'une vue. C'est ce que consulte le rafraîchissement automatique.

Les deux acceptent un paramètre tournament pour cibler un tournoi par son identifiant ou son slug. Les tournois en brouillon, privés ou sans page dédiée ne sont pas exposés aux visiteurs.

Dépannage

Je ne trouve pas la page du tournoi dans le menu Pages

C'est normal : les tournois sont un type de contenu à part. Ils sont listés dans Tournois › Tous les tournois. Le bouton Voir de la barre du tournoi ouvre la page publique, et le tableau de bord affiche son adresse dans le bloc Liens publics.

Les pages de tournoi renvoient une erreur 404

Les règles de réécriture de WordPress n'ont pas été régénérées. Ouvrez Réglages › Permaliens et cliquez sur Enregistrer sans rien modifier.

Les e-mails d'inscription n'arrivent pas

Utilisez le bouton Envoyer un e-mail de test dans Tournois › Extension. S'il annonce un succès mais que rien n'arrive, c'est que l'hébergement n'expédie pas les messages : installez une extension SMTP et configurez-la avec les identifiants de votre messagerie. S'il annonce une erreur, elle est affichée telle quelle.

Le titre de ma page s'affiche en double

L'option « Masquer le titre de page » est active par défaut et couvre les thèmes courants. Si votre thème résiste, ajoutez son sélecteur CSS dans le champ prévu à cet effet dans les réglages de l'extension.

Le tableau déborde ou le texte est minuscule

Le tableau se met à l'échelle pour tenir à l'écran, ce qui peut réduire le texte quand les équipes sont nombreuses. L'attribut fit="width" ajuste seulement la largeur et laisse défiler verticalement, ce qui est souvent plus lisible sur un ordinateur. Sous 640 pixels de large, les tours s'empilent automatiquement.

J'ai changé le format et les résultats ont disparu

Changer le format, le nombre d'équipes ou les manches régénère le tableau : les matchs qui n'existent plus dans le nouveau format sont supprimés avec leurs scores. Exportez une sauvegarde avant toute modification de format en cours de tournoi.

Une poule n'a pas de qualifié

Les qualifiés ne sont désignés que lorsque tous les matchs de la poule sont validés. En composition manuelle, vérifiez aussi qu'aucune poule ne compte moins de deux équipes validées : le tableau de bord signale les poules incomplètes.

Comment supprimer un tournoi

Bouton Supprimer dans la barre du tournoi, qui mène à la zone sensible des réglages. Il faut saisir le mot SUPPRIMER puis confirmer. Le tournoi, sa page, sa page d'inscription et toutes ses données sont effacés. Les autres tournois ne sont pas touchés.

Données et vie privée

Le formulaire d'inscription collecte le nom de l'équipe, celui du capitaine, une adresse e-mail, un téléphone et éventuellement les pseudonymes des joueurs. Trois points méritent votre attention.

Le nom du capitaine est affiché publiquement sur la page des équipes, ainsi que les joueurs si vous activez l'option. L'e-mail et le téléphone ne le sont jamais.
L'acceptation du règlement est exigée à l'inscription, mais sa date n'est pas conservée.
Les données restent sur votre serveur. L'extension ne contacte aucun service extérieur, hormis l'adresse du manifeste de mise à jour si vous en renseignez une.

Pensez à indiquer aux participants la finalité de la collecte et la durée de conservation, et à purger les tournois passés quand ils ne vous servent plus.