Clubuitslagen op je website

Wat je nodig hebt

• Een club op TargetAce Live en een cluborganisator die de website-sleutel kan inschakelen.
• Verder niets: uitslagen op je website zijn gratis voor elke club. Script- en iframe-widgets hebben een regel “Scores via TargetAce”, die clubs met Club Plus kunnen verbergen.

De website-sleutel ophalen in de app

1. Open Clubs en dan je club.
2. Open Organisatietools en zoek Clubwebsite.
3. Tik op Website-sleutel ophalen. De sleutel begint met tas_ en alleen organisatoren kunnen hem zien.

Met Sleutel delen stuur je hem naar wie je website beheert. Nieuwe sleutel vervangt hem, en Uitschakelen zet hem uit.

De website-sleutel ophalen in de organisatorconsole

1. Ga naar targetace.app/console op een computer. Log in met een code uit de app: Profiel, dan Inloggen op het web.
2. Open Website van de club in het menu van de console.
3. Kies Inschakelen. De sleutel verschijnt onder Website-sleutel.

Met de sleutel kan een website alleen de uitslagen van je club tonen. Er kan niets mee worden gewijzigd. Hij staat wel in de code van je webpagina, dus als hij ergens terechtkomt waar je hem niet wilt hebben, maak dan een nieuwe sleutel.

Snel aan de slag

De organisatorconsole maakt de code voor je en toont een live voorbeeld.

1. Open in de console Website van de club en zoek Resultaten op je website zetten.
2. Kies onder Weergeven wat je wilt tonen. Kies onder Je website Script-tag, WordPress-shortcode of Iframe. Kies onder Kleuren Licht, Donker of Volg het apparaat van de bezoeker. Kies dan Kopiëren.
3. Voeg op je website een blok HTML, Code insluiten of Aangepaste HTML toe op de plek waar de uitslagen moeten komen. Plak de code erin en publiceer de pagina.

Voor WordPress geeft de generator in plaats daarvan een shortcode. Voor Alles, dat geen shortcode heeft, geeft hij de scriptversie om in een blok Aangepaste HTML te plakken.

De code ziet er zo uit, met je eigen sleutel in plaats van tas_…:

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

De eerste regel is waar de widget verschijnt. De tweede regel laadt hem. Een pagina heeft de tweede regel één keer nodig, hoeveel widgets er ook op staan, maar twee keer plakken kan geen kwaad.

De widgets

Verander het woord na data-targetace om te kiezen wat een widget toont. Elke widget accepteert de opties die erop van toepassing zijn.

Klassement

Het klassement van één wedstrijd: plaats, schutter, boogtype, score en 10en, en X-en als iemand een X heeft geschoten. Als de wedstrijd teamscores telt, volgt er een teamtabel. Lange lijsten tonen de eerste 10 rijen en een knop om alles te tonen.

Zonder data-competition toont hij de nieuwste open wedstrijd. Als er geen open is, toont hij de nieuwste wedstrijd.

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

Voeg de id toe om altijd dezelfde wedstrijd te tonen:

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

Open de wedstrijd, ladder, knock-out of competitie in de organisatorconsole om een id te vinden. Het adres van de pagina eindigt na de laatste schuine streep op 15 letters en cijfers. Dat is de id.

Wedstrijden

Elke wedstrijd, nieuwste eerst, elk met zijn klassement. Tot de 20 meest recente wedstrijden van de club.

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

Evenementen

De openbare evenementen van de club: binnenkort, nu live en in de afgelopen 14 dagen afgelopen, eerstvolgende eerst. Elk evenement heeft een knop naar zijn pagina op targetace.app: Inschrijven zolang de inschrijving open is, Uitslagen zodra het begint, anders Details. Concepten en geannuleerde evenementen worden niet getoond.

Toont 10 evenementen, tenzij je data-limit instelt.

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

Nieuws

Clubmededelingen die een organisator heeft gemarkeerd met Weergeven op de clubwebsite, vastgezette eerst, daarna nieuwste eerst. Mededelingen na hun einddatum verdwijnen.

Toont 5 berichten, tenzij je data-limit instelt.

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

Ladders

Ladderstand: plaats, schutter, boogtype, gewonnen en verloren, en rating bij ladders die op rating rangschikken. Zonder data-ladder toont hij elke lopende en afgelopen ladder, nieuwste eerst. Ladders die nog niet zijn begonnen, worden niet getoond.

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

Knock-outs en competities

Knock-outs ronde voor ronde, en competitiestanden met gespeeld, gewonnen, gelijk, verloren, setsaldo en punten. Zonder data-tournament toont hij de 10 nieuwste knock-outs en competities van de club. Geannuleerde worden niet getoond.

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

Directe duels

Wedstrijden tussen clubleden in het afgelopen jaar: een winst/verlies-tabel en de 10 meest recente uitslagen. Dit wordt pas getoond als een organisator onder Clubwebsite Resultaten van directe duels tonen inschakelt. Casual wedstrijden van schutters die hun wedstrijden privé houden, worden weggelaten.

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

Clubrecords

De bevestigde records van de club, in een tabel per ronde: klasse, schutter, score en datum. Om ze te tonen opent een organisator Clubrecords in de app, dan Recordinstellingen, en zet Records openbaar tonen aan. Deze widget is gratis voor elke club en blijft werken zonder Club Plus.

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

Seizoensreeksen

De seizoensreeksen van de club: de beste scores van elke schutter over meerdere klassementen, opgeteld. Een organisator van een Club Plus-club maakt een reeks op de pagina Klassementen van de organisatorenconsole.

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

TargetAce-kampioenen

De huidige TargetAce-kampioenen van de club: van elk de naam, de titel en het kampioenschap, met een link naar hun schutterspagina als die openbaar is. Een kampioen van wie de pagina niet openbaar is, wordt zonder naam getoond als lid van deze club. Heeft de club een kampioen, dan staan dezelfde regels ook boven de competities van de club en in de widget met de hele pagina.

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

Bestuur

Toont het bestuur van de club: de functie en naam van elk lid. Een organisator geeft leden hun functie op de pagina Leden van de organisatorenconsole en zet Toon het bestuur op de openbare pagina van de club aan.

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

Clubnaam en badge

Het embleem, de naam en de regio van de club, en hoeveel leden hij op TargetAce heeft.

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

Alles

Alles hierboven op één pagina, in deze volgorde: clubnaam en badge, de 3 laatste nieuwsberichten, evenementen, wedstrijden, ladders, knock-outs en competities, directe duels en clubrecords. Onderdelen zonder inhoud worden weggelaten.

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

Opties

Voeg deze toe aan de eerste regel van de widget, zoals in de voorbeelden hierboven.

Id's van wedstrijden, ladders, knock-outs en competities vind je in de organisatorconsole. Zo vind je een id.

Kleuren en hoekafronding

Licht en donker

Widgets zijn licht, tenzij je iets anders kiest. Voeg voor een donkere website data-theme="dark" toe. Voeg data-theme="auto" toe om de apparaatinstelling van elke bezoeker te volgen.

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

Je eigen kleuren

Widgets worden in hun eigen ruimte getekend, zodat de stijlen van je site ze niet kapot kunnen maken. Ze gebruiken het lettertype van je site. Voeg CSS zoals deze toe aan de aangepaste CSS van je site, of in een style-tag op de pagina, om je eigen kleuren te gebruiken:

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

Geef één widget andere kleuren door er een class op te zetten en die class in de CSS te gebruiken in plaats van [data-targetace]. Kleuren die je instelt, gelden in licht en donker. Iframes en de WordPress-plugin gebruiken deze instellingen niet.

Talen

Widgets zijn er in het Engels, Nederlands, Duits, Frans, Italiaans en Spaans. Koppen, kolomnamen, labels en datums volgen de taal. Namen van wedstrijden, evenementen en nieuws blijven zoals de club ze schreef.

Een widget gebruikt de taal van je pagina als dat een van deze talen is, en anders Engels. Voeg data-lang toe om zelf te kiezen:

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

De meldingen voor een uitgeschakelde sleutel of gepauzeerde uitslagen zijn alleen in het Engels.

Sites die geen scripts toestaan

Sommige websitebouwers voeren scripts die je plakt niet uit, of zetten je code in een vak met een vaste grootte. Wix, Squarespace, Google Sites, Weebly en Jimdo kunnen allemaal zo werken, afhankelijk van het abonnement en het element dat je gebruikt. Als het eerste fragment niets toont of wordt afgekapt, gebruik dan de iframe-versie. Kies in de generator in de console Iframe onder Je website.

<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>

Gebruik dezelfde widgetnamen in het adres, na /embed/. Zet opties aan het eind van het adres, elk na een &, zonder data- ervoor:

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

In een iframe gelden je eigen kleuren niet.

Iframe-hoogte

Een iframe kan niet vanzelf groeien. Als je pagina de scriptregel onder de iframe uitvoert, past die de iframe op maat aan. Doet hij dat niet, dan blijft de iframe op zijn beginhoogte. Stel dan de hoogte in je websitebouwer in, of verander min-height:320px in de code in iets als height:800px.

WordPress

De plugin TargetAce Live Leaderboards zet uitslagen op je eigen server in je pagina's, zodat ze zonder scripts worden getoond en zoekmachines ze kunnen lezen. Hij neemt de lettertypen en kleuren van je thema over. Hij heeft WordPress 5.8 of nieuwer en PHP 7.4 of nieuwer nodig.

Je kunt het scriptfragment ook in een blok Aangepaste HTML plakken als je liever widgets hebt die vanzelf bijwerken, of als je Alles nodig hebt, dat de plugin niet heeft.

De plugin installeren

1. Download de TargetAce Live Leaderboards plugin (versie 1.12.0, een zipbestand). De generator in de console heeft dezelfde link.
2. Ga in WordPress naar Plugins, dan Nieuwe plugin toevoegen, dan Plugin uploaden. Kies het zipbestand, dan Nu installeren, dan Activeren.
3. Ga naar Instellingen, dan TargetAce Live. Plak je website-sleutel en sla op. De pagina vertelt dan met welke club hij verbonden is.

Plugin-instellingen

Het blok TargetAce-resultaten

Voeg in de blokeditor het blok TargetAce-resultaten toe. Kies in de instellingen van het blok wat je wilt tonen. De editor toont een voorbeeld.

• Typ bij Eén wedstrijd de naam van de wedstrijd. Typ bij een ladder, knock-out of competitie de naam, of laat het leeg voor de nieuwste.
• Bij wedstrijdklassementen, evenementen, clubnieuws en recente directe duels bepaalt Hoeveel hoeveel er getoond worden. 0 betekent het gebruikelijke aantal.
• Clubrecords, de clubkaart, cursussen en proeflessen, en het onderlinge record van één schutter staan ook in de lijst. Elke shortcode-optie staat in de instellingen van het blok.
• Zolang er geen websitesleutel is opgeslagen, toont het blok een melding met een link naar Instellingen, dan TargetAce Live.

Shortcodes

Shortcodes werken in elke pagina, elk bericht en elk Shortcode-blok. Namen in name="…" moeten overeenkomen met de naam in TargetAce. Hoofdletters maken niet uit.

Uitslagen volgen de taal van je site. Engels, Nederlands, Duits, Frans, Italiaans en Spaans zitten in de plugin: kies er een onder Instellingen, dan TargetAce Live, of voeg lang="nl" toe aan één shortcode.

Getallen tussen haakjes krijg je als je de optie weglaat. Shortcodes voor directe duels tonen pas uitslagen als een organisator ze inschakelt.

Paginacaching

Met LiteSpeed Cache zorgt de plugin ervoor dat pagina's met uitslagen niet langer worden gecachet dan zijn vernieuwingstijd. Laat bij andere cachingplugins de pagina's met uitslagen buiten de cache, of geef ze een korte cachetijd. Anders zien bezoekers misschien oude uitslagen.

Goed om te weten

Hoe actueel de uitslagen zijn

• Script- en iframe-widgets halen elke 60 seconden nieuwe uitslagen op zolang ze in beeld zijn, dus uitslagen kunnen ongeveer een minuut achterlopen. Verander dit met data-refresh.
• De WordPress-plugin haalt elke 5 minuten uitslagen op, tenzij je Vernieuwen elke in de instellingen verandert. Als TargetAce niet bereikbaar is, toont hij de laatste uitslagen die hij had.

Club Plus en de regel “Scores via TargetAce”

• Script- en iframe-widgets tonen een regel “Scores via TargetAce”. Clubs met Club Plus kunnen die verbergen met data-credit op off.
• De WordPress-plugin toont de regel alleen als Scores by TargetAce is aangevinkt onder Instellingen, dan TargetAce Live. Dat is voor elke club optioneel: uitslagen worden hoe dan ook getoond.
• Als Club Plus verloopt, verschijnt de regel weer en blijven de uitslagen zichtbaar. Als een organisator verlengt, verdwijnt hij binnen ongeveer vijf minuten weer. Je hoeft niets aan je website te veranderen.

Het clubhuisscherm

• Het clubhuisscherm is een schermvullende pagina voor een tv of beamer tijdens schietavonden. Het wisselt tussen je open klassementen, ladders, knock-outs, competities en evenementen en werkt zichzelf elke minuut bij. Iedereen met de link kan het zien.
• Het is onderdeel van Club Plus. Een organisator opent het via Website van de club in de organisatorenconsole, en kan daar ook de clubkleur instellen.
• Klik op de pagina of druk op F voor volledig scherm. Met de pijltjestoetsen blader je zelf.

Privacy

• Widgets tonen namen, boogtypes en scores van schutters, net als de clubpagina. Ze tonen nooit contactgegevens.
• Schutters in een jeugdleeftijdsklasse (onder de 21 of jonger) worden getoond met voornaam en de eerste letter van hun achternaam, zoals "Sam A.", in wedstrijdklassementen, teamtabellen en clubrecords.
• Ladders, knock-outs, competities en uitslagen van directe duels tonen de naam die elke schutter in TargetAce gebruikt. De WordPress-plugin kan elke naam inkorten: zie Namen van schutters in de instellingen.
• Uitslagen van directe duels verschijnen pas als een organisator ze inschakelt, en schutters kunnen hun casual wedstrijden privé houden.
• Widgets plaatsen geen cookies. De browsers van je bezoekers laden ze van targetace.app, zoals bij alle ingesloten inhoud, dus misschien wil je TargetAce vermelden in de privacyverklaring van je site. Met de WordPress-plugin haalt je eigen server de uitslagen op. Bezoekers laden dan alleen het clubembleem van TargetAce, als je dat toont.

Een nieuwe sleutel of geen sleutel

Een nieuwe website-sleutel maken zet de oude meteen buiten werking, en de sleutel uitschakelen ook. Werk je fragmenten of de instellingen van de plugin bij met de nieuwe sleutel.

Beveiligingsinstellingen en blockers

Als je site een Content Security Policy instelt, sta dan deze toe:

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)

Sommige advertentie- en privacyblockers houden scripts van andere websites tegen. Als een widget voor één bezoeker leeg is maar voor anderen werkt, is een blocker waarschijnlijk de oorzaak. De WordPress-plugin heeft hier geen last van, omdat je eigen server de uitslagen ophaalt.

Als iets niet werkt

Kom je er nog steeds niet uit? Mail naar [email protected] met het adres van je website.