Tools für deine Vereinshomepage
Der Bayerische Volleyball-Verband stellt seinen Vereinen eine Schnittstelle und ein Skript zur Verfügung mit der ihr auf eurer Homepage die Tabellen und Ergebnisse eurer Mannschaften ausgeben könnt. Außerdem besteht über die Schnittstelle die Möglichkeit einen Spielterminplan aller eurer Teams auf einer Seite auszugeben. Wie das funktioniert, erklären wir euch hier auf dieser Seite.
Grundsätzliche Informationen zur Schnittstelle
Hier bekommst du die grundsätzlichen Information, wie du mit deiner Vereinshomepage auf die Ergebnisschnittstelle des BVV zugreifen kannst.
Wo finde ich den API-Key?
Um die Schnittstelle nutzen zu können, benötigt ihr einen API-KEY. Diesen kann euer Abteilungsleiter im BVV-Portal mit eurer Vereins-Homepage verknüpfen. Gehe dazu in der Vereinsverwaltung auf den Menüpunkt Vereinshomepage und kleicke dann auf den Untermenüpunkt API-Key (Siehe Bild).
Bitte achtet darauf, dass der Domain-Name exakt gleich ist, mit dem der bei euch im Browser angezeigt wird. Solltet ihr mehre Domain-Namen haben, dann bitte alle URLs im Portal hinterlegen:
Beispiel: vco-muenchen.de und www.vco-muenchen.de
Wo finde ich die Wettbewerbs- und die Team-Id meiner Mannschaften?
In der Vereinsverwaltung unter dem Menüpunkt Vereinshomepage findet ihr im Untermenüpunkt Hallenergebnisse die Wettbewerb Id und die Team Id für eure Mannschaften. Diese benötigt ihr, um das Skript für euren Verein anzupassen.
Grundsätzlicher Aufbau der Schnittstelle
Um auf deiner Website auf die Ergebnisschnittstelle zugreifen zu können musst du folgendes einfügen:
<script src=api.volleyball-bayern.de/jsi/volley.js.php?key=API-KEY EINFUEGEN></script>
Damit meldest du deine Website bei der Schnittstelle an. Danach kannst du mit Hilfe der nachfolgenden Code-Snippets die Daten der Schnittstelle auf deine Homepage einbauen.
Class-Attribute und Parameter
Class-Attribut bei den Inhalten
| Name | Beschreibung |
|---|---|
| vapi | Das Javaskript fügt in alle div-Element mit class "vapi" Inhalte des Ergebnisdienstes ein |
| vapiclass | Diese Klasse wird automatisch gesetzt wenn die Default-CSS-Datei verwendet wird. Es kann auch eine eigener Klassenname gesetzt werden. Siehe Parameter skipcss |
Allgemeine Parameter bei den Inhalten
| Name | Beschreibung |
|---|---|
| data-typ | Typ der abzurufenden Datei |
| data-callback | (optional) Name einer Javascriptfunktion, die nach dem Seitenaufbau aufgerufen werden soll. Damit können z.B. Click-Handler registriert werden. |
Parameter für das Javaskript
| Name | Default | Bedeutung |
|---|---|---|
| key | leer | API-Key des Vereins (Pflichtfeld) |
| skipcss | false | Verhindert die Abholung der default CSS-Datei |
| proxyurldata | leer | URL zum Abruf der Daten |
| proxyurlcss | leer | URL zum Abruf des CSS |
