ERF Bibleserver für Webmaster
Die Entwickler-Tools von ERF Bibleserver unterstützen dich bei der manuellen und automatischen Verlinkung von Bibelstellen auf deiner Website. Im Folgenden ist die offizielle ERF Bibleserver API ausführlich erläutert.
Hinweis: ERF Bibleserver bietet keine API für die Inhalte von Bibelversen. Aus Lizenzgründen ist dies nicht möglich.
Bibelstellen und Suchanfragen manuell verlinken
Die Link-Struktur von ERF Bibleserver ist einfach und übersichtlich. Ohne große Vorkenntnisse lassen sich beliebige Bibelstellen oder Suchergebnisse mit ERF Bibleserver verlinken. Seit der Version 2019 von ERF Bibleserver hat sich die Verlinkung geändert. Ältere Links funktionieren jedoch weiterhin.
Bibelstellen verlinken
Der Link einer Bibelstelle hat folgenden Aufbau:
https://www.bibleserver.com/{Übersetzung}/{Bibelstelle}
Beispiel für Johannes 3,16 in der Lutherbibel:
https://www.bibleserver.com/LUT/Johannes3,16
Es ist auch möglich, einen Übersetzungsvergleich zu verlinken:
https://www.bibleserver.com/LUT.ELB.EU/Johannes3,16
Suchanfragen verlinken
Suchanfragen lassen sich wie folgt verlinken:
https://www.bibleserver.com/search/{Übersetzung}/{Suchbegriff}
Beispiel für "Tempel" in der Lutherbibel:
https://www.bibleserver.com/search/LUT/Tempel
Suchanfragen mit Übersetzungsvergleich lassen sich wie folgt verlinken:
https://www.bibleserver.com/search/LUT.ELB.EU/Tempel
Erläuterungen zur Angabe der Übersetzung
Bibelübersetzungen werden in als Abkürzung angegeben. Die folgende Tabelle gibt einen Überblick aller verfügbaren Übersetzungen.
Überblick verfügbarer Übersetzungen
Erläuterungen zur Angabe der Bibelstelle
ERF Bibleserver erkennt alle gängigen Schreibweisen einer Bibelstelle. Auch Versbereiche können verlinkt werden. Um Probleme zu vermeiden, sollte die Bibelstelle in der Sprache der jeweiligen Bibelübersetzung angegeben werden.
Bibelstellen serverseitig automatisch verlinken
ERF Bibleserver bietet eine serverseitige Schnittstelle, mit der sich Bibelstellen innerhalb eines Textes automatisch erkennen und verlinken lassen. Zur Nutzung der Schnittstelle ist ein API-Key erforderlich. Da die Anzahl der täglichen API-Abrufe je Key begrenzt ist, wird empfohlen die Bibelstellen beim Abspeichern des Textes anstatt bei der Darstellung auf der Website zu parsen.
Die API ist unter https://www.bibleserver.com/api/parser abrufbar.
Es können folgende Parameter per GET oder POST übergeben werden:
- key - Domain-spezifischer API-Key
- text - Inhalt, der geparst werden soll
- lang - Sprache: ar, bg, cs, da, de, en, es, fa, fr, hr, hu, it, nl, no, pl, pt, ro, ru, sk, sv, tr, uk, zh_CN (optional)
- trl - Abkürzung der Übersetzung, siehe Tabelle oben (optional)
- cssignore - Bibelstellen, die durch ein HTML-Tag mit dieser CSS-Klasse eingeschlossen sind, werden nicht ersetzt; default: nolink (Bsp. <span class="nolink">Joh 3,16</span>) (optional)
Das folgende PHP-Beispiel zeigt die Nutzung der serverseitigen API:
// POST-Daten definieren
$text = 'Lies Johannes 3,16 in der Bibel.';
$param = array(
'key' => 'DEIN_API_KEY',
'text' => $text,
'lang' => 'de',
'trl' => 'LUT'
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.bibleserver.com/api/parser');
curl_setopt($ch, CURLOPT_REFERER, 'http://'.$_SERVER['SERVER_NAME']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $param);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($httpcode === 200) {
$text = $result;
}
curl_close($ch);
Ergebnis des PHP-Beispiels:
Lies Johannes 3,16 in der Bibel.
Bibelstellen clientseitig automatisch verlinken
Die JavaScript-Implementierung der API ermöglicht das Erkennen und Verlinken von Bibelstellen im Browser. Für die Nutzung der JavaScript-API ist ein API-Key erforderlich.
Hinweis: Die JavaScript-Implementierung ist eine vereinfachte Version der serverseitigen API. Evtl. werden nicht alle Bibelstellen korrekt erkannt. Außerdem kann es durch die DOM-Manipulationen zu Problemen mit JavaScript-Events kommen.
Das folgende HTML/JavaScript-Beispiel zeigt die Nutzung der clientseitigen API:
<!doctype html>
<html>
<head>
<title>[...]</title>
<!-- Der folgende Skript-Block muss angepasst und auf deiner Website eingefügt werden. -->
<script type="text/javascript">
(function() {
var ga = document.createElement('script');
ga.src = 'https://www.bibleserver.com/api/parser.js?key=DEIN_API_KEY&lang=de';
ga.setAttribute('async', 'true');
document.documentElement.firstChild.appendChild(ga);
})();
var bsQuery = '.article'; // CSS-Selektor für Wrapper der Suche (optional)
var bsTrl = 'LUT'; // Verlinkte Übersetzung (optional)
</script>
</head>
<body>
[...]
<h1>Johannes 3</h1>
<div class="article">
<p>Lies Johannes 3,16 in der Bibel.</p>
</div>
[...]
</body>
</html>
Ergebnis des JavaScript-Beispiels:
Johannes 3
Lies Johannes 3,16 in der Bibel.
Parameter für den API-Aufruf:
- key - Domain-spezifischer API-Key
- lang - Sprache, Bibelstellen werden je nach Sprache erkannt: ar, bg, cs, da, de, en, es, fa, fr, hr, hu, it, nl, no, pl, pt, ro, ru, sk, sv, tr, uk, zh_CN; default: 'de' (optional)
Zusätzliche JavaScript-Optionen:
- bsQuery - jQuery-Selektor zur Einschränkung der Suche nach Bibelstellen. Standard ist "body" - eine Einschränkung wird empfohlen. (optional)
- bsTrl - Abkürzung der Übersetzung, siehe Tabelle oben (optional)
- cssIgnore - Bibelstellen, die durch ein HTML-Tag mit dieser CSS-Klasse eingeschlossen sind, werden nicht ersetzt; default: nolink (Bsp. <span class="nolink">Joh 3,16</span>) (optional)
Wordpress-Plugin
Für Wordpress gibt es das Plugin "Link To Bible", welches beim Abspeichern von Artikeln Bibelstellen automatisch mit ERF Bibleserver verlinkt. Weitere Informationen findest du auf der Plugin-Website.
API-Key erstellen
Um Bibelstellen clientseitig oder serverseitig automatisch verlinken zu können, ist ein API-Schlüssel erforderlich. Dieser ist domain-spezifisch und kann hier kostenlos angefordert werden.
Hinweis: ERF Bibleserver behält sich vor, die täglichen API-Zugriffe je Domain zu beschränken.
Datenschutzerklärung ERF Bibleserver API
Deine Privatsphäre ist uns wichtig!
Deshalb werden bei der Nutzung der ERF Bibleserver API zur automatischen Verlinkung von Bibelstellen keine personenbezogenen Daten gespeichert. Wir bieten jedoch eine Schnittstelle (API) an, welche es dir ermöglicht Bibelstellen in Texten mit ERF Bibleserver zu verlinken. Bei der clientseitigen automatischen Verlinkung, die auf dem Endgerät ausgeführt wird und mit unserem Server kommuniziert, werden keine Inhalte an ERF Bibleserver übertragen.
Bei der serverseitigen automatischen Verlinkung werden Inhalt jedoch an ERF Bibleserver übertragen. Für die Verlinkung von Bibelstellen werden diese auf dem Webserver durch Algorithmen analysiert, bearbeitet und an den Client ausgeliefert. Dabei werden jedoch keine übermittelten Inhalte gespeichert oder an Dritte weitergegeben. Für die Weiterentwicklung und zur Fehleranalyse werden lediglich statistische Werte, wie der Zeitpunkt oder die Dauer der API-Aufrufe, für einen Zeitraum von 120 Tagen gespeichert.
Rechtsgrundlage für die Nutzung bei der serverseitigen Verlinkung ist Art. 6 Abs. 1 S. 1 lit. f DSGVO.