Skip to content

Hilfe

Jump to bottom
Heiko Lübbe edited this page May 11, 2024 · 24 revisions

Zitat-Service WordPress Plugin Deutsche Fahne

Das WordPress Plugin Zufallszitat von Zitat-Service zeigt ein zufälliges Zitat aus der Sammlung der Benutzergemeinschaft zitat-service.de. Die Auswahl der Zitate kann eingeschränkt werden auf eine der fünf Sprachen, einen der über 500 Autoren, eine der über 500 Kategorien oder auf die selbst eingestellten Zitate. Wir sind seit 2007 kosten- und werbefrei online.

Note

Es gibt eine WordPress Demo-Seite mit dem Plugin: wp-demo.zitat-service.de

Installation

Das Plugin Random Quote from Zitat-Service direkt aus dem WordPress Plugin Directory installieren oder als Zip-Datei manuell hochladen. Im WordPress-Backend auf Neues Plugin hinzufügen klicken und dann:

Aktivieren Sie anschließend das Plugin:

plugin_de

Note

Wird für die Konfiguration unter Microsoft Windows der Firefox-Browser verwendet, werden in der Sprachauswahl auch die UTF-8 Länderflaggen angezeigt.

Nutzung

Sie können ein zufälliges Zitat in einen Beitrag, eine Seite oder Ihre anderen Website-Elemente einfügen, indem Sie den Block Zufalls-Zitat verwenden:

add_de

Sie können die Auswahl der Zitate nach Sprache, Kategorie, Autor des Zitats sowie nach dem Benutzer, der das Zitat eingegeben hat, konfigurieren. Ein Sternchen * repräsentiert alle verfügbaren Optionen. Bei der Sprachauswahl ist auch die Option Frontend möglich, wodurch die Spracheinstellung des WordPress-Benutzers übernommen wird. Sollte die Benutzersprache nicht unterstützt werden, wird automatisch auf Englisch umgestellt. Im folgenden Beispiel werden Zitate aus der Kategorie Blumen in deutscher Sprache ausgewählt: 305968529-7c87f285-0f4f-4d51-b361-f7e6ebdb0d3f

select_de

Design

Sie können das Zitat auf viele verschiedene Arten gestalten. Erstens können Sie die Standardfunktionen des Blockeditors für Stil wie Farbe, Typografie und Größe verwenden. Das folgende Beispiel verwendet die Hintergrundfarbe RGB AAFF0033 und Innenabstand 1:

styling_1

Zweitens können Sie auch die Formatierungen des WordPress Zitat-Blocks verwenden. Fügen Sie zuerst einen Zitat-Block ein und darin dann einen Zufalls-Zitat-Block. Mit dem Twenty Twenty-Four-Theme verwendet der äußere Zitat-Block kursiven Text und abgerundete Ecken. Das folgende Beispiel hat zusätzlich die Hintergrundfarbe RGB 00FFFF33 und Text zentrieren eingestellt:

styling_2

Drittens können Sie Cascading Style Sheets (CSS) verwenden. Das DIV-Element der Klasse quote umschließt die gesamte Zitatangabe, um beispielsweise einen Rand zu setzen. Es enthält die DIV-Elemente quotation für das eigentliche Zitat und source für Autor und Quelle. Im folgenden Beispiel wird die Standarddekoration des Links (blau und unterstrichen) entfernt und das Zitat in Schwarz dargestellt. Die Quelle (ob mit oder ohne Link) wird dann in Grau angezeigt. Insgesamt haben wir einen hellgrauen Hintergrund und einen 1 Pixel breiten Rand mit runden Ecken:

styling_3

Dazu im WordPress-Backend: Design | Editor | 🔍 | tippen Sie CSS | und wählen Sie CSS anpassen

Fügen Sie die folgenden Zeilen hinzu und speichern Sie sie:

div.quote {
  border: 1px solid black;
  border-radius: 1em;
  padding: 1em;
  background: #eee;
  text-align: justify;
}
div.quote * a {
  text-decoration: none;
  color: black;
}
div.quote div.source, div.quote div.source a {
  color: gray;
}

API zitat-service.de

Das WordPress-Plugin holt alle Daten von der API unter api.zitat-service.de ab. Nutzungsbedingungen und Datenschutzerklärung finden Sie im Impressum.

Das Abrufen der Zitate in einer WordPress-Website erfolgt durch PHP-Code, der auf dem WordPress-Server läuft. Dies bedeutet, dass der Prozess des Abrufens von Zitaten keine Verfolgung oder Aufzeichnung von benutzerspezifischen Daten im Frontend beinhaltet. Stattdessen findet er innerhalb der Serverumgebung statt, was die Privatsphäre der Benutzer schützt und die Einhaltung von Richtlinien gewährleistet, die das Verfolgen von Benutzern ohne deren Zustimmung verbieten.

Die angezeigten Zitate, zusammen mit ihren jeweiligen Autoren und Quellen, sind mit externen Websites wie zitat-service.de und Wikipedia verlinkt, um den Benutzern zusätzlichen Kontext und Informationen zu bieten. Alle externen Links werden nur nach manueller Überprüfung durch das Admin-Team von zitat-service.de aktiviert, um Missbrauch bei verlinkten Inhalten zu vermeiden.

Fehler Situationen

Error fetching quote

Wenn das Abrufen des Zitats von api.zitat-service.de ein Problem hat, wird dieser Fehler angezeigt. Zum Beispiel in der playground.wordpress.net Umgebung, wo der PHP-Server-Backend keine Netzwerkverbindungen unterstützt:

Error fetching quote

👉 Überprüfen Sie die Netzwerkverbindung auf der Serverseite.

404 – No quote found for given parameters

Die Parameter werden UND-verknüpft. Wenn Ihre Kombination zu keinem Zitat führt, gibt es einen Fehler.

Die Parameter werden so kombiniert, dass alle Bedingungen erfüllt sein müssen. Wenn Ihre Kombination von Parametern keine Zitate findet, wird dieser Fehler angezeigt. Zum Beispiel gibt es keine Zitate von Douglas Adams in der Kategorie Landwirtschaft:

Error: 404 – No quote found for given parameters: categoryId=151 (Agriculture), authorId=345 (Douglas Adams).

👉 Wählen Sie Asterix * für Kategorie, um Zitate von Douglas Adams anzuzeigen.

... (Es wird kein Zitat angezeigt)

Der Platzhalter ... mit den drei Punkten wird bei einem Problem nicht durch ein Zitat ersetzt:

...

👉 In der Entwickler Console des Browsers die api.zitat-service.de Netzwerk-Anfragen prüfen und das JavaScript Debugging einschalten.

This block has encountered an error and cannot be previewed.

Wenn es Probleme mit dem Block im Backend des Block-Editors gibt, dann zeigt der Block Zufalls-Zitat:

This block has encountered an error and cannot be previewed.

👉 Den Block löschen und neu anlegen. Oder den Quellcode im Code-Editor prüfen (an Stelle des Visueller Editro). Oder JavaScript Debugging einschalten.

JavaScript Debugging einschalten

In der JavaScript Console des Browsers das folgende Kommando ausführen:

> localStorage.setItem('debugMode', 'true');

👉 In der JavaScript Console können nun die console.log and console.error Ausgaben des Zufallszitat von Zitat-Service Plugins geprüft werden.

Die Ausgabe der JavaScript Console können wieder deaktiviert werden mit:

> localStorage.removeItem('debugMode');

Tickets

Gibt es einen Bug oder den Wunsch nach einer Erweiterung? Bitte erstelle ein GitHub Issue. 👍

Clone this wiki locally