Seite 1 von 6 BFV Widget Kurzdokumentation Mit Hilfe eines BFV-Widget lassen sich die neuesten Ergebnisse und die aktuellen Tabellen des BFV auf der eigenen nicht kommerziellen Webseite mit wenig Aufwand einbetten. Folgende Voraussetzungen müssen dafür gegeben sein: 1. Kein SSL. Das Widget kann derzeit nicht auf verschlüsselten Seiten (https://) verwendet werden. 2. JavaScript muss aktiviert sein, da die BFV-Widget mit JavaScript realisiert sind. 3. Keine Umlaute oder Sonderzeichen im Domainnamen. Diese werden von den BFV-Widget nicht unterstützt. Sie sollten die Seiten, auf denen die Widgets eingebaut wurden, gründlich testen. Es kann nicht 100% ausgeschlossenen werden, dass der Einbau zu Seiteneffekten mit anderen Seitenelementen führt. Bitte haben Sie dafür Verständnis, dass der BFV keinen technischen Support bei Problemen geben kann. Registrierung des Domänennamen Damit die BFV-Widgets verwendet werden können, muss der Domainname der Webseite registriert werden, in die die Widgets eingebettet werden sollten. Klicken Sie dazu den Link unterhalb der Tabelle oder der Spielvorschau einer Liga an.
Seite 2 von 6 Es erscheint folgender Dialog: Falls Sie bereits Ihre Webseite registriert haben, können Sie sich hier anmelden, andernfalls registrieren Sie Ihre Webseite mit dem Button Neuregistrierung. Nach der erfolgreichen Neuregistrierung erhalten Sie ein E-Mail, mit der Sie die Registrierung bestätigen können. Damit gelten auch die AGBs, welchen Sie bei der Registrierung zugestimmt haben. Jetzt können Sie Sich mit der registrierten URL und dem Passwort anmelden. Einbinden auf der eigenen Webseite Bestandteile/Funktion des Widget Im eingeloggten Bereich werden die beiden Codeteile, zur Anzeige des Widget, für die gewählte Liga zur Verfügung gestellt. Unter Verwendung dieser Codeteile kann zu einer Liga die jeweilige Tabelle bzw. die Ligadaten (Ergebnisse) der Liga auf der eigenen Homepage angezeigt werden. Einbau des BFV Widget Funktionen in die eigene Homepage. Kopieren Sie den Aufruf der BFV Widget Funktionen aus dem eingeloggten Bereich in das <BODY>- Tag ihrer Homepage. Dieser Aufruf enthält alle nötigen Funktionen zur Anzeige des Widget auf ihrer Webseite. Der Aufruf der BFV Widget Funktionen muss vor dem Liga-Widget-Code in der HTML-Seite erfolgen.
Seite 3 von 6 Beispiel BFV Widget-Funktionen einbinden: <!-- BFV Widget Bibliothek --> Anzeige des Widgets. Um nun die Ligadaten bzw. die Tabelle auf Ihrer Webseite anzeigen zu können müssen Sie noch den Widgetcode in Ihre HTML-Seite einbinden. Folgendes Beispiel zeigt die Einbindung des Widgetcodes in eine HTML-Seite. Beispiel Widgetcode zur Anzeige der Ergebnisse: <!-- BFV Widget Bibliothek --> <!-- Widgetcode zur Anzeige der Ligadaten --> <div id="meineliga">... lade Liga...</div> > var liga = new BFVLigaWidget(); liga.setzeliganr('310139'); liga.zeigeergebnisse('meineliga'); Die Ligadaten (Ergebnisse) würden bzgl. dieses Beispiels innerhalb des Div-Tags mit der ID meineliga angezeigt werden. Nach Aufruf der HTML-Seite (Ihrer Homepage) werden die Ligadaten der jeweiligen Liga (im Beispiel Bayernliga) wie folgt angezeigt:
Seite 4 von 6 Falls der Reiter Tabelle beim Aufruf aktiv sein soll, muss im Widgetcode anstatt der Zeile liga.zeigeergebnisse('meineliga'); folgende Zeile liga.zeigetabelle('meineliga'); eingefügt werden. Analog dazu stehen noch folgende Funktionen zur Verfügung. Liga.zeigeFairplay('meineLiga'); Liga.zeigeVorschau('meineLiga');
Seite 5 von 6 Anzeige mehrerer Ligen auf einer Seite. Pro Seite kann immer nur ein Widget der selben Liga verwendet werden. Es können z.b. nicht zwei Widgets der Bayernliga auf einer Seite verwendet werden. Widgets mit unterschiedlichen Ligen können beliebig viele auf einer Seite verwendet werden. Z.B kann ein Widget der Bayernliga und ein Widget der Bundesliga problemlos auf einer Seite angezeigt werden. Falls auf einer Seite mehrere Widgets angezeigt werden sollen, müssen die unterschiedlichen <DIV>-Tags (Bereich in denen die Ligadaten angezeigt werden) mit verschiedenen ID s versehen werden (siehe rot markierte Codestellen im folgenden Beispiel). <!-- BFV Widget Bibliothek--> <!-- 1. Widgetcode zur Anzeige einer Liga --> <div id="meineliga_1">... lade Liga...</div> > var liga1 = new BFVLigaWidget(); liga1.setzeliganr('310139'); liga1.zeigeergebnisse('meineliga_1'); <!-- 2. Widgetcode zur Anzeige einer weiteren Liga --> <div id="meineliga_2">... lade Liga 2...</div> > var liga2 = new BFVLigaWidget(); liga2.setzeliganr('310145'); liga2.zeigeergebnisse('meineliga_2');
Seite 6 von 6 Hervorheben des eigenen Vereins Um sowohl bei den Ergebnissen als auch bei der Tabellenansicht den eigenen Verein hervorzuheben kann der Parameter VereinNr wie folgt gesetzt werden. <!-- BFV Widget Bibliothek- <! Widgetcode zur Anzeige der Ligadaten - <div id="meineliga">... lade Liga...</div> > var liga = new BFVLigaWidget(); liga.setzeliganr('310139'); liga.setzevereinnr('31007463'); liga.zeigeergebnisse('meineliga'); In diesem Fall würde der Verein FC Schweinfurt 05 (bezogen auf das Beispiel Bayernliga) hervorgehoben dargestellt werden. Das Setzen des Parameters muss immer vor der Funktion zeigeergebnisse bzw. zeigetabelle erfolgen! BFV 2012