Résultats de club sur votre site web

Ce dont vous avez besoin

• Un club sur TargetAce Live et un organisateur de club pour activer sa clé de site web.
• Rien d’autre : les résultats sur votre site sont gratuits pour tous les clubs. Les widgets script et iframe portent une ligne « Scores via TargetAce », que les clubs sur Club Plus peuvent masquer.

Obtenir la clé du site web dans l’application

1. Ouvrez Clubs, puis votre club.
2. Ouvrez Outils de l’organisateur et trouvez Site web du club.
3. Touchez Obtenir une clé de site web. La clé commence par tas_ et seuls les organisateurs peuvent la voir.

Partager la clé vous permet de l’envoyer à la personne qui s’occupe de votre site web. Nouvelle clé la remplace, et Désactiver la désactive.

Obtenir la clé du site web dans la console organisateur

1. Allez sur targetace.app/console depuis un ordinateur. Connectez-vous avec un code de l’application : Profil, puis Se connecter sur le web.
2. Ouvrez Site web du club dans le menu de la console.
3. Choisissez Activer. La clé s’affiche sous Clé du site web.

La clé permet seulement à un site web d’afficher les résultats de votre club. Elle ne peut rien modifier. Elle apparaît toutefois dans le code de votre page web : si elle se retrouve là où vous ne le souhaitez pas, créez une nouvelle clé.

Démarrage rapide

La console organisateur génère le code pour vous et affiche un aperçu en direct.

1. Dans la console, ouvrez Site web du club et trouvez Affichez les résultats sur votre site web.
2. Sous Afficher, choisissez ce qu’il faut afficher. Sous Votre site web, choisissez Balise script, Shortcode WordPress ou Iframe. Sous Couleurs, choisissez Clair, Sombre ou Suivre l'appareil du visiteur. Choisissez ensuite Copier.
3. Sur votre site web, ajoutez un bloc HTML, Code d’intégration ou HTML personnalisé là où les résultats doivent apparaître. Collez-y le code et publiez la page.

Pour WordPress, le générateur fournit plutôt un shortcode. Pour Tout, qui n’a pas de shortcode, il fournit la version script à coller dans un bloc HTML personnalisé.

Le code ressemble à ceci, avec votre propre clé à la place de tas_… :

<div data-targetace="leaderboard" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

La première ligne indique où le widget apparaît. La deuxième ligne le charge. Une page n’a besoin de la deuxième ligne qu’une seule fois, quel que soit le nombre de widgets, mais la coller deux fois ne pose aucun problème.

Les widgets

Changez le mot après data-targetace pour choisir ce qu’affiche un widget. Chaque widget accepte les options qui le concernent.

Classement

Le classement d’une compétition : place, archer, type d’arc, score et 10, et X dès qu’un archer a tiré un X. Si la compétition compte des scores par équipe, un tableau des équipes suit. Les longues listes affichent les 10 premières lignes et un bouton pour tout afficher.

Sans data-competition, il affiche la compétition ouverte la plus récente. Si aucune n’est ouverte, il affiche la compétition la plus récente.

<div data-targetace="leaderboard" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Pour toujours afficher la même compétition, ajoutez son identifiant :

<div data-targetace="leaderboard" data-club="tas_…" data-competition="abc123def456ghi"></div>

Pour trouver un identifiant, ouvrez la compétition, l’échelle, le tableau à élimination directe ou le championnat dans la console organisateur. L’adresse de la page se termine par 15 lettres et chiffres après la dernière barre oblique. C’est l’identifiant.

Compétitions

Toutes les compétitions, de la plus récente à la plus ancienne, chacune avec son classement. Jusqu’aux 20 compétitions les plus récentes du club.

<div data-targetace="competitions" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Événements

Les événements publics du club : à venir, en direct et terminés au cours des 14 derniers jours, du plus proche au plus lointain. Chacun a un bouton vers sa page sur targetace.app : S'inscrire tant que les inscriptions sont ouvertes, Résultats dès qu’il commence, sinon Détails. Les brouillons et les événements annulés ne s’affichent pas.

Affiche 10 événements, sauf si vous définissez data-limit.

<div data-targetace="events" data-club="tas_…" data-limit="5"></div>
<script src="https://targetace.app/embed.js" async></script>

Actualités

Les annonces du club qu’un organisateur a marquées Afficher sur le site du club, les épinglées d’abord, puis les plus récentes. Les annonces dont la date de fin est passée disparaissent.

Affiche 5 éléments, sauf si vous définissez data-limit.

<div data-targetace="announcements" data-club="tas_…" data-limit="3"></div>
<script src="https://targetace.app/embed.js" async></script>

Échelles

Classement de l’échelle : place, archer, type d’arc, victoires et défaites, et cote pour les échelles classées par cote. Sans data-ladder, il affiche chaque échelle en cours ou terminée, de la plus récente à la plus ancienne. Les échelles qui n’ont pas encore commencé ne s’affichent pas.

<div data-targetace="ladder" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Tableaux à élimination directe et championnats

Les tableaux à élimination directe tour par tour, et les classements de championnat avec matchs joués, gagnés, nuls, perdus, différence de sets et points. Sans data-tournament, il affiche les 10 tableaux à élimination directe et championnats les plus récents du club. Ceux qui sont annulés ne s’affichent pas.

<div data-targetace="results" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Face-à-face

Les matchs entre membres du club sur la dernière année : un tableau victoires/défaites et les 10 résultats les plus récents. Il ne s’affiche qu’une fois qu’un organisateur a activé Afficher les résultats des face-à-face sous Site web du club. Les matchs amicaux des archers qui gardent leurs matchs privés sont exclus.

<div data-targetace="h2h" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Records du club

Les records confirmés du club, dans un tableau par épreuve : catégorie, archer, score et date. Pour les afficher, un organisateur ouvre Records du club dans l’application, puis Paramètres des records, et active Afficher les records publiquement. Ce widget est gratuit pour tous les clubs et continue de fonctionner sans Club Plus.

<div data-targetace="records" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Séries de la saison

Les séries de la saison du club : les meilleurs scores de chaque archer sur plusieurs classements, additionnés. Un organisateur d'un club Club Plus crée une série sur la page Classements de la console des organisateurs.

<div data-targetace="series" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Champions TargetAce

Les champions TargetAce en titre du club : pour chacun, le nom, le titre et le championnat, avec un lien vers sa page d’archer si elle est publique. Un champion dont la page n’est pas publique est présenté sans nom, comme membre de ce club. Quand le club a un champion, les mêmes lignes apparaissent aussi au-dessus des compétitions du club et dans le widget de la page entière.

<div data-targetace="champions" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Bureau

Affiche le bureau du club : la fonction et le nom de chaque membre. Un organisateur attribue les fonctions sur la page Membres de la console des organisateurs et active Afficher le bureau sur la page publique du club.

<div data-targetace="committee" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Nom et badge du club

Le badge, le nom et la région du club, et son nombre de membres sur TargetAce.

<div data-targetace="club" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Tout

Tout ce qui précède sur une seule page, dans cet ordre : nom et badge du club, les 3 dernières actualités, événements, compétitions, échelles, tableaux à élimination directe et championnats, face-à-face et records du club. Les parties vides sont omises.

<div data-targetace="all" data-club="tas_…"></div>
<script src="https://targetace.app/embed.js" async></script>

Options

Ajoutez-les à la première ligne du widget, comme dans les exemples ci-dessus.

Les identifiants des compétitions, échelles, tableaux à élimination directe et championnats se trouvent dans la console organisateur. Comment trouver un identifiant.

Couleurs et coins

Clair et sombre

Les widgets sont clairs, sauf si vous choisissez autrement. Pour un site web sombre, ajoutez data-theme="dark". Pour suivre le réglage de l’appareil de chaque visiteur, ajoutez data-theme="auto".

<div data-targetace="leaderboard" data-club="tas_…" data-theme="dark"></div>

Vos propres couleurs

Les widgets s’affichent dans leur propre espace, les styles de votre site ne peuvent donc pas les casser. Ils utilisent la police de votre site. Pour reprendre vos couleurs, ajoutez un CSS comme celui-ci au CSS personnalisé de votre site, ou dans une balise style sur la page :

[data-targetace] {
  --ta-accent: #1a5d1a;   /* links and buttons */
  --ta-surface: #ffffff;  /* card background */
  --ta-ink: #17202b;      /* text */
  --ta-radius: 4px;       /* corners */
}

Pour donner d’autres couleurs à un seul widget, ajoutez-lui une classe et utilisez cette classe dans le CSS à la place de [data-targetace]. Les couleurs que vous définissez s’appliquent en clair comme en sombre. Les iframes et le plugin WordPress n’utilisent pas ces réglages.

Langues

Les widgets existent en anglais, néerlandais, allemand, français, italien et espagnol. Les titres, noms de colonnes, libellés et dates suivent la langue. Les noms des compétitions, événements et actualités restent tels que le club les a écrits.

Un widget utilise la langue de votre page lorsqu’il s’agit de l’une de ces langues, et l’anglais sinon. Pour choisir, ajoutez data-lang :

<div data-targetace="events" data-club="tas_…" data-lang="nl"></div>

Les messages concernant une clé désactivée ou des résultats suspendus sont uniquement en anglais.

Sites n'autorisant pas les scripts

Certains créateurs de sites n’exécutent pas les scripts que vous collez, ou placent votre code dans un cadre de taille fixe. Wix, Squarespace, Google Sites, Weebly et Jimdo peuvent tous fonctionner ainsi, selon la formule et l’élément utilisés. Si le premier fragment de code n’affiche rien ou est tronqué, utilisez plutôt la version iframe. Dans le générateur de la console, choisissez Iframe sous Votre site web.

<iframe data-targetace-frame src="https://targetace.app/embed/leaderboard?club=tas_…" style="width:100%;border:0;min-height:320px" title="Club results" loading="lazy"></iframe>
<script src="https://targetace.app/embed.js" async></script>

Utilisez les mêmes noms de widgets dans l’adresse, après /embed/. Ajoutez les options à la fin de l’adresse, chacune après un &, sans data- devant :

https://targetace.app/embed/events?club=tas_…&limit=5&theme=dark&lang=fr

Dans un iframe, vos propres couleurs ne s’appliquent pas.

Hauteur de l’iframe

Une iframe ne peut pas s’agrandir d’elle-même. Lorsque votre page exécute la ligne de script sous l’iframe, celle-ci ajuste la taille de l’iframe. Sinon, l’iframe garde sa hauteur de départ : définissez alors la hauteur dans votre créateur de site, ou remplacez min-height:320px dans le code par quelque chose comme height:800px.

WordPress

Le plugin TargetAce Live Leaderboards insère les résultats dans vos pages sur votre propre serveur : ils s’affichent sans scripts et les moteurs de recherche peuvent les lire. Il reprend les polices et les couleurs de votre thème. Il nécessite WordPress 5.8 ou plus récent et PHP 7.4 ou plus récent.

Vous pouvez aussi coller le fragment de code script dans un bloc HTML personnalisé si vous préférez des widgets qui se mettent à jour d’eux-mêmes, ou si vous avez besoin de Tout, que le plugin ne propose pas.

Installer le plugin

1. Téléchargez le plugin TargetAce Live Leaderboards (version 1.12.0, un fichier zip). Le générateur de la console propose le même lien.
2. Dans WordPress, allez dans Extensions, puis Ajouter une extension, puis Téléverser une extension. Choisissez le fichier zip, puis Installer maintenant, puis Activer.
3. Allez dans Réglages, puis TargetAce Live. Collez votre clé du site web et enregistrez. La page indique alors à quel club elle est connectée.

Réglages du plugin

Le bloc Résultats TargetAce

Dans l’éditeur de blocs, ajoutez le bloc Résultats TargetAce. Dans les réglages du bloc, choisissez ce qu’il faut afficher. L’éditeur affiche un aperçu.

• Pour Une compétition, saisissez le nom de la compétition. Pour une échelle, un tableau à élimination directe ou un championnat, saisissez son nom, ou laissez vide pour le plus récent.
• Pour les classements de compétition, les événements, les actualités du club et les face-à-face récents, Combien définit le nombre d’éléments affichés. 0 correspond au nombre habituel.
• Les records du club, la carte du club, les cours et séances découverte, et le bilan en face-à-face d’un archer figurent aussi dans la liste. Toutes les options des shortcodes sont dans les réglages du bloc.
• Tant qu’aucune clé de site n’est enregistrée, le bloc affiche une note avec un lien vers Réglages, puis TargetAce Live.

Shortcodes

Les shortcodes fonctionnent dans n’importe quelle page, n’importe quel article ou bloc Code court. Les noms dans name="…" doivent correspondre au nom dans TargetAce. Les majuscules n’ont pas d’importance.

Les résultats suivent la langue de votre site. L’anglais, le néerlandais, l’allemand, le français, l’italien et l’espagnol sont fournis avec l’extension : choisissez-en une dans Réglages, puis TargetAce Live, ou ajoutez lang="nl" à un seul shortcode.

Les nombres entre parenthèses sont les valeurs obtenues si vous omettez l’option. Les shortcodes de face-à-face n’affichent des résultats qu’une fois activés par un organisateur.

Mise en cache des pages

Avec LiteSpeed Cache, le plugin empêche que les pages contenant des résultats restent en cache plus longtemps que sa durée d’actualisation. Avec d’autres plugins de cache, excluez du cache les pages contenant des résultats, ou donnez-leur une courte durée de cache. Sinon, les visiteurs risquent de voir d’anciens résultats.

Bon à savoir

Fraîcheur des résultats

• Les widgets script et iframe récupèrent de nouveaux résultats toutes les 60 secondes tant qu’ils sont à l’écran : les résultats peuvent donc avoir environ une minute de retard. Modifiez cela avec data-refresh.
• Le plugin WordPress récupère les résultats toutes les 5 minutes, sauf si vous modifiez Actualiser toutes les dans ses réglages. Si TargetAce est injoignable, il affiche les derniers résultats dont il dispose.

Club Plus et la ligne « Scores via TargetAce »

• Les widgets script et iframe affichent une ligne « Scores via TargetAce ». Les clubs sur Club Plus peuvent la masquer avec data-credit réglé sur off.
• L’extension WordPress n’affiche la ligne que lorsque Scores by TargetAce est coché dans Réglages, puis TargetAce Live. C’est facultatif pour tous les clubs : les résultats s’affichent dans les deux cas.
• Si Club Plus expire, la ligne réapparaît et les résultats restent affichés. Quand un organisateur renouvelle, elle disparaît de nouveau en cinq minutes environ. Vous n’avez rien à changer sur votre site.

L’écran du club-house

• L’écran du club-house est une page plein écran pour un téléviseur ou un projecteur les soirs de tir. Il fait défiler vos classements ouverts, échelles, tableaux à élimination directe, ligues et événements, et se met à jour chaque minute. Toute personne ayant le lien peut le voir.
• Il fait partie de Club Plus. Un organisateur l’ouvre depuis Site web du club, dans la console des organisateurs, et peut aussi y définir la couleur du club.
• Cliquez sur la page ou appuyez sur F pour le plein écran. Les flèches du clavier changent de page à la main.

Confidentialité

• Les widgets affichent les noms, types d’arc et scores des archers, comme la page du club. Ils n’affichent jamais de coordonnées.
• Les archers d’une catégorie d’âge jeunes (moins de 21 ans ou plus jeunes) apparaissent avec leur prénom et l’initiale de leur nom, par exemple "Sam A.", dans les classements de compétition, les tableaux par équipe et les records du club.
• Les échelles, tableaux à élimination directe, championnats et résultats de face-à-face affichent le nom que chaque archer utilise dans TargetAce. Le plugin WordPress peut raccourcir tous les noms : voir Noms des archers dans ses réglages.
• Les résultats des face-à-face n’apparaissent qu’une fois activés par un organisateur, et les archers peuvent garder leurs matchs amicaux privés.
• Les widgets ne déposent aucun cookie. Les navigateurs de vos visiteurs les chargent depuis targetace.app, comme tout contenu intégré : vous voudrez peut-être mentionner TargetAce dans la politique de confidentialité de votre site. Avec le plugin WordPress, c’est votre propre serveur qui récupère les résultats. Les visiteurs ne chargent depuis TargetAce que le badge du club, si vous l’affichez.

Une nouvelle clé ou pas de clé

Créer une nouvelle clé du site web désactive immédiatement l’ancienne, tout comme désactiver la clé. Mettez à jour vos fragments de code ou les réglages du plugin avec la nouvelle clé.

Paramètres de sécurité et bloqueurs

Si votre site définit une Content Security Policy, autorisez ceci :

script-src  https://targetace.app
style-src   https://targetace.app
connect-src https://targetace.app
img-src     https://clubs.targetace.app
frame-src   https://targetace.app   (iframe version only)

Certains bloqueurs de publicité et de pistage bloquent les scripts d’autres sites web. Si un widget reste vide pour un visiteur mais fonctionne pour les autres, un bloqueur en est probablement la cause. Le plugin WordPress n’est pas concerné, car c’est votre propre serveur qui récupère les résultats.

Si quelque chose ne fonctionne pas

Toujours bloqué ? Écrivez à [email protected] en indiquant l’adresse de votre site.