Vereinsergebnisse auf deiner Website

Was du brauchst

• Ein Verein auf TargetAce Live und ein Vereinsorganisator, der den Website-Schlüssel aktiviert.
• Sonst nichts: Ergebnisse auf deiner Website sind für jeden Verein kostenlos. Script- und iframe-Widgets tragen die Zeile „Ergebnisse von TargetAce“, die Vereine mit Club Plus ausblenden können.

Den Website-Schlüssel in der App holen

1. Öffne Clubs, dann deinen Verein.
2. Öffne Organisator-Tools und suche Vereinswebsite.
3. Tippe auf Website-Schlüssel abrufen. Der Schlüssel beginnt mit tas_ und nur Organisatoren können ihn sehen.

Mit Schlüssel teilen schickst du ihn an die Person, die deine Website betreut. Neuer Schlüssel ersetzt ihn, und Ausschalten schaltet ihn ab.

Den Website-Schlüssel in der Organisatoren-Konsole holen

1. Öffne targetace.app/console an einem Computer. Melde dich mit einem Code aus der App an: Profil, dann Im Web anmelden.
2. Öffne Website des Vereins im Menü der Konsole.
3. Wähle Aktivieren. Der Schlüssel erscheint unter Website-Schlüssel.

Mit dem Schlüssel kann eine Website nur die Ergebnisse deines Vereins anzeigen. Ändern lässt sich damit nichts. Er steht aber im Code deiner Webseite. Wenn er also irgendwo landet, wo du ihn nicht haben willst, erstelle einen neuen Schlüssel.

Schnellstart

Die Organisatoren-Konsole erstellt den Code für dich und zeigt eine Live-Vorschau.

1. Öffne in der Konsole Website des Vereins und suche nach Ergebnisse auf deiner Website anzeigen.
2. Wähle unter Anzeigen, was angezeigt werden soll. Wähle unter Deine Website Script-Tag, WordPress-Shortcode oder Iframe. Wähle unter Farben Hell, Dunkel oder Dem Gerät des Besuchers folgen. Wähle dann Kopieren.
3. Füge auf deiner Website dort, wo die Ergebnisse erscheinen sollen, einen Block für HTML, Einbettungscode oder Individuelles HTML hinzu. Füge den Code ein und veröffentliche die Seite.

Für WordPress liefert der Konfigurator stattdessen einen Shortcode. Für Alles, wofür es keinen Shortcode gibt, liefert er die Skript-Version zum Einfügen in einen Block „Individuelles HTML“.

Der Code sieht so aus, mit deinem eigenen Schlüssel statt tas_…:

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

Die erste Zeile ist die Stelle, an der das Widget erscheint. Die zweite Zeile lädt es. Eine Seite braucht die zweite Zeile nur einmal, egal wie viele Widgets sie hat, aber doppelt eingefügt schadet sie nicht.

Die Widgets

Ändere das Wort nach data-targetace, um festzulegen, was ein Widget zeigt. Jedes Widget nimmt die jeweils passenden Optionen an.

Rangliste

Die Rangliste eines Wettkampfs: Platz, Bogenschütze, Bogenart, Ergebnis und 10er, dazu Xs, sobald jemand ein X geschossen hat. Wertet der Wettkampf Mannschaftsergebnisse, folgt eine Mannschaftstabelle. Lange Listen zeigen die ersten 10 Zeilen und eine Schaltfläche, um alle anzuzeigen.

Ohne data-competition zeigt es den neuesten offenen Wettkampf. Ist keiner offen, zeigt es den neuesten Wettkampf.

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

Um immer denselben Wettkampf zu zeigen, füge seine ID hinzu:

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

Um eine ID zu finden, öffne den Wettkampf, die Ladder, das K.-o.-Turnier oder die Liga in der Organisatoren-Konsole. Die Seitenadresse endet nach dem letzten Schrägstrich mit 15 Buchstaben und Ziffern. Das ist die ID.

Wettkämpfe

Alle Wettkämpfe, neueste zuerst, jeweils mit Rangliste. Bis zu den 20 letzten Wettkämpfen des Vereins.

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

Veranstaltungen

Die öffentlichen Veranstaltungen des Vereins: demnächst, jetzt live und in den letzten 14 Tagen beendet, die nächste zuerst. Jede hat eine Schaltfläche zu ihrer Seite auf targetace.app: Melden, solange die Meldung offen ist, Ergebnisse, sobald sie beginnt, sonst Details. Entwürfe und abgesagte Veranstaltungen erscheinen nicht.

Zeigt 10 Veranstaltungen, sofern du data-limit nicht setzt.

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

Neuigkeiten

Vereinsankündigungen, die ein Organisator mit „Auf der Club-Website anzeigen“ markiert hat, angepinnte zuerst, dann die neuesten zuerst. Ankündigungen nach ihrem Enddatum fallen weg.

Zeigt 5 Einträge, sofern du data-limit nicht setzt.

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

Ladders

Ladder-Rangliste: Platz, Bogenschütze, Bogenart, gewonnen und verloren, dazu das Rating bei Ladders, die nach Rating ranken. Ohne data-ladder zeigt es jede laufende und beendete Ladder, neueste zuerst. Ladders, die noch nicht begonnen haben, erscheinen nicht.

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

K.-o.-Turniere und Ligen

K.-o.-Turniere Runde für Runde und Ligatabellen mit Spielen, Siegen, Unentschieden, Niederlagen, Satzdifferenz und Punkten. Ohne data-tournament zeigt es die 10 neuesten K.-o.-Turniere und Ligen des Vereins. Abgesagte erscheinen nicht.

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

Direktvergleich

Begegnungen zwischen Vereinsmitgliedern im letzten Jahr: eine Sieg/Niederlage-Tabelle und die 10 letzten Ergebnisse. Erscheint erst, wenn ein Organisator unter Vereinswebsite „Direktvergleich-Ergebnisse anzeigen“ einschaltet. Freizeit-Matches von Bogenschützen, die ihre Matches privat halten, bleiben außen vor.

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

Vereinsrekorde

Die bestätigten Rekorde des Vereins, in einer Tabelle pro Runde: Klasse, Bogenschütze, Ergebnis und Datum. Damit sie erscheinen, öffnet ein Organisator in der App Vereinsrekorde, dann Rekordeinstellungen, und schaltet „Rekorde öffentlich zeigen“ ein. Dieses Widget ist für jeden Verein kostenlos und funktioniert auch ohne Club Plus.

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

Saisonserien

Die Saisonserien des Vereins: die besten Ergebnisse jedes Bogenschützen über mehrere Ranglisten, addiert. Ein Organisator eines Club Plus-Vereins legt eine Serie auf der Seite Ranglisten der Organisatoren-Konsole an.

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

TargetAce-Champions

Die amtierenden TargetAce-Champions des Vereins: jeweils Name, Titel und Meisterschaft, mit einem Link zur Schützenseite, wenn sie öffentlich ist. Ein Champion, dessen Seite nicht öffentlich ist, wird ohne Namen als Mitglied dieses Vereins gezeigt. Hat der Verein einen Champion, stehen dieselben Zeilen auch über den Wettbewerben des Vereins und im Widget mit der ganzen Seite.

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

Vorstand

Zeigt den Vorstand des Vereins: Funktion und Name jedes Mitglieds. Ein Organisator vergibt die Funktionen auf der Seite Mitglieder der Organisatoren-Konsole und schaltet Den Vorstand auf der öffentlichen Vereinsseite zeigen ein.

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

Vereinsname und Abzeichen

Abzeichen, Name und Region des Vereins und wie viele Mitglieder er auf TargetAce hat.

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

Alles

Alles oben Genannte auf einer Seite, in dieser Reihenfolge: Vereinsname und Abzeichen, die 3 neuesten Neuigkeiten, Veranstaltungen, Wettkämpfe, Ladders, K.-o.-Turniere und Ligen, Direktvergleich und Vereinsrekorde. Teile ohne Inhalt werden weggelassen.

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

Optionen

Füge sie in die erste Zeile des Widgets ein, wie in den Beispielen oben.

IDs für Wettkämpfe, Ladders, K.-o.-Turniere und Ligen findest du in der Organisatoren-Konsole. So findest du eine ID.

Farben und Eckenrundung

Hell und dunkel

Widgets sind hell, sofern du nichts anderes wählst. Für eine dunkle Website füge data-theme="dark" hinzu. Um der Geräteeinstellung jedes Besuchers zu folgen, füge data-theme="auto" hinzu.

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

Eigene Farben

Widgets werden in ihrem eigenen Bereich gezeichnet, daher können die Stile deiner Website sie nicht stören. Sie verwenden die Schriftart deiner Website. Um deine Farben zu übernehmen, füge CSS wie dieses in das eigene CSS deiner Website oder in ein style-Tag auf der Seite ein:

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

Um einem einzelnen Widget andere Farben zu geben, gib ihm eine Klasse und verwende diese Klasse im CSS statt [data-targetace]. Farben, die du setzt, gelten für hell und dunkel. Iframes und das WordPress-Plugin verwenden diese Einstellungen nicht.

Sprachen

Widgets gibt es auf Englisch, Niederländisch, Deutsch, Französisch, Italienisch und Spanisch. Überschriften, Spaltennamen, Beschriftungen und Daten folgen der Sprache. Namen von Wettkämpfen, Veranstaltungen und Neuigkeiten bleiben so, wie der Verein sie geschrieben hat.

Ein Widget verwendet die Sprache deiner Seite, wenn es eine dieser Sprachen ist, sonst Englisch. Um selbst zu wählen, füge data-lang hinzu:

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

Die Meldungen für einen ausgeschalteten Schlüssel oder pausierte Ergebnisse gibt es nur auf Englisch.

Websites, die keine Skripte erlauben

Manche Website-Baukästen führen eingefügte Skripte nicht aus oder setzen deinen Code in ein Feld mit fester Größe. Wix, Squarespace, Google Sites, Weebly und Jimdo können sich alle so verhalten, je nach Tarif und verwendetem Element. Wenn das erste Snippet nichts zeigt oder abgeschnitten wird, verwende stattdessen die Iframe-Version. Wähle im Konfigurator der Konsole unter Deine Website die Option Iframe.

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

Verwende dieselben Widget-Namen in der Adresse, nach /embed/. Hänge Optionen ans Ende der Adresse an, jeweils nach einem &, ohne data- davor:

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

In einem Iframe gelten deine eigenen Farben nicht.

Iframe-Höhe

Ein Iframe kann nicht von selbst wachsen. Wenn deine Seite die Skriptzeile unter dem Iframe ausführt, passt sie die Größe des Iframes an. Wenn nicht, bleibt der Iframe bei seiner Anfangshöhe. Lege dann die Höhe in deinem Website-Baukasten fest oder ändere min-height:320px im Code in etwas wie height:800px.

WordPress

Das Plugin TargetAce Live Leaderboards fügt die Ergebnisse auf deinem eigenen Server in deine Seiten ein, sodass sie ohne Skripte erscheinen und Suchmaschinen sie lesen können. Es übernimmt die Schriftarten und Farben deines Themes. Es benötigt WordPress 5.8 oder neuer und PHP 7.4 oder neuer.

Du kannst das Skript-Snippet auch in einen Block „Individuelles HTML“ einfügen, wenn du lieber Widgets möchtest, die sich selbst aktualisieren, oder wenn du Alles brauchst, was das Plugin nicht bietet.

Das Plugin installieren

1. Lade das TargetAce Live Leaderboards-Plugin (Version 1.12.0, eine ZIP-Datei) herunter. Der Konfigurator in der Konsole hat denselben Link.
2. Gehe in WordPress zu Plugins, dann Neues Plugin hinzufügen, dann Plugin hochladen. Wähle die ZIP-Datei, dann Jetzt installieren, dann Aktivieren.
3. Gehe zu Einstellungen, dann TargetAce Live. Füge deinen Website-Schlüssel ein und speichere. Die Seite zeigt dann, mit welchem Verein sie verbunden ist.

Plugin-Einstellungen

Der TargetAce-Ergebnisblock

Füge im Block-Editor den TargetAce-Ergebnisblock hinzu. Wähle in den Block-Einstellungen, was angezeigt werden soll. Der Editor zeigt eine Vorschau.

• Bei „Ein Wettkampf“ tippst du den Namen des Wettkampfs ein. Bei einer Ladder, einem K.-o.-Turnier oder einer Liga tippst du den Namen ein oder lässt das Feld leer für die neueste.
• Bei Wettkampf-Ranglisten, Veranstaltungen, Vereinsneuigkeiten und letzten Direktvergleichen legt „Wie viele“ fest, wie viele aufgelistet werden. 0 bedeutet die übliche Anzahl.
• Vereinsrekorde, die Vereinskarte, Kurse und Schnuppertrainings sowie die Direktduell-Bilanz eines Schützen stehen ebenfalls in der Liste. Jede Shortcode-Option findest du in den Einstellungen des Blocks.
• Solange kein Website-Schlüssel gespeichert ist, zeigt der Block einen Hinweis mit einem Link zu Einstellungen, dann TargetAce Live.

Shortcodes

Shortcodes funktionieren in jeder Seite, jedem Beitrag und jedem Shortcode-Block. Namen in name="…" müssen mit dem Namen in TargetAce übereinstimmen. Groß- und Kleinschreibung spielt keine Rolle.

Die Ergebnisse folgen der Sprache deiner Website. Englisch, Niederländisch, Deutsch, Französisch, Italienisch und Spanisch sind im Plugin enthalten: Wähle eine unter Einstellungen, dann TargetAce Live, oder ergänze lang="nl" bei einem einzelnen Shortcode.

Zahlen in Klammern gelten, wenn du die Option weglässt. Direktvergleich-Shortcodes zeigen erst Ergebnisse, wenn ein Organisator sie einschaltet.

Seiten-Caching

Mit LiteSpeed Cache sorgt das Plugin dafür, dass Seiten mit Ergebnissen nicht länger als seine Aktualisierungszeit im Cache bleiben. Bei anderen Caching-Plugins nimm die Seiten mit Ergebnissen vom Cache aus oder gib ihnen eine kurze Cache-Zeit. Sonst sehen Besucher womöglich alte Ergebnisse.

Gut zu wissen

Wie aktuell die Ergebnisse sind

• Skript- und Iframe-Widgets rufen alle 60 Sekunden neue Ergebnisse ab, solange sie auf dem Bildschirm sind. Ergebnisse können also etwa eine Minute hinterherhinken. Ändere das mit data-refresh.
• Das WordPress-Plugin ruft alle 5 Minuten Ergebnisse ab, sofern du „Aktualisieren alle“ in seinen Einstellungen nicht änderst. Ist TargetAce nicht erreichbar, zeigt es die letzten Ergebnisse, die es hatte.

Club Plus und die Zeile „Ergebnisse von TargetAce“

• Script- und iframe-Widgets zeigen die Zeile „Ergebnisse von TargetAce“. Vereine mit Club Plus können sie mit data-credit auf off ausblenden.
• Das WordPress-Plugin zeigt die Zeile nur, wenn unter Einstellungen, dann TargetAce Live, der Haken bei Scores by TargetAce gesetzt ist. Das ist für jeden Verein freiwillig: Ergebnisse erscheinen so oder so.
• Läuft Club Plus aus, erscheint die Zeile wieder und die Ergebnisse bleiben sichtbar. Verlängert ein Organisator, verschwindet sie innerhalb von etwa fünf Minuten wieder. Du musst an deiner Website nichts ändern.

Der Vereinsheim-Bildschirm

• Der Vereinsheim-Bildschirm ist eine Vollbildseite für einen Fernseher oder Beamer an Schießabenden. Er wechselt zwischen deinen offenen Ranglisten, Ladders, K.-o.-Turnieren, Ligen und Veranstaltungen und aktualisiert sich jede Minute. Jeder mit dem Link kann ihn sehen.
• Er ist Teil von Club Plus. Ein Organisator öffnet ihn in der Organisatoren-Konsole über Website des Vereins und kann dort auch die Vereinsfarbe festlegen.
• Klicke auf die Seite oder drücke F für Vollbild. Mit den Pfeiltasten blätterst du von Hand.

Datenschutz

• Widgets zeigen Namen, Bogenarten und Ergebnisse der Bogenschützen, wie die Vereinsseite. Kontaktdaten zeigen sie nie.
• Bogenschützen in einer Jugendaltersklasse (U21 oder jünger) erscheinen mit Vornamen und dem Anfangsbuchstaben des Nachnamens, etwa „Sam A.“, in Wettkampf-Ranglisten, Mannschaftstabellen und Vereinsrekorden.
• Ladders, K.-o.-Turniere, Ligen und Direktvergleich-Ergebnisse zeigen den Namen, den jeder Bogenschütze in TargetAce verwendet. Das WordPress-Plugin kann jeden Namen kürzen: siehe „Namen der Bogenschützen“ in seinen Einstellungen.
• Direktvergleich-Ergebnisse erscheinen erst, wenn ein Organisator sie einschaltet, und Bogenschützen können ihre Freizeit-Matches privat halten.
• Widgets setzen keine Cookies. Die Browser deiner Besucher laden sie von targetace.app, wie bei allen eingebetteten Inhalten. Du solltest TargetAce daher eventuell in der Datenschutzerklärung deiner Website erwähnen. Mit dem WordPress-Plugin ruft dein eigener Server die Ergebnisse ab. Besucher laden dann nur das Vereinsabzeichen von TargetAce, falls du es zeigst.

Ein neuer Schlüssel oder kein Schlüssel

Ein neuer Website-Schlüssel macht den alten sofort ungültig, und das Ausschalten des Schlüssels ebenso. Aktualisiere deine Snippets oder die Plugin-Einstellungen mit dem neuen Schlüssel.

Sicherheitseinstellungen und Blocker

Wenn deine Website eine Content Security Policy setzt, erlaube Folgendes:

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)

Manche Werbe- und Datenschutzblocker stoppen Skripte von anderen Websites. Wenn ein Widget für einen Besucher leer bleibt, für andere aber funktioniert, ist wahrscheinlich ein Blocker die Ursache. Das WordPress-Plugin ist nicht betroffen, weil dein eigener Server die Ergebnisse abruft.

Wenn etwas nicht funktioniert

Kommst du immer noch nicht weiter? Schreib an [email protected] mit der Adresse deiner Website.