Zum Hauptinhalt springen

So wird das Joomla Content Plugin CCC External Video Preview benutzt

CCC External Video Preview zeigt YouTube- und Vimeo-Videos als Vorschau, die erst per Klick geladen wird. Diese Anleitung führt dich von der Installation bis zur Anbindung eines Cookie-Banners.

Schritt 1: Installation

Installiere das Plugin: Lade das Paket im Joomla-Backend unter System → Installieren → Erweiterungen hoch. Das Plugin ist danach sofort aktiviert, du findest es unter System → Plugins als „Inhalt - CCC External Video Preview“.

Voraussetzungen: Joomla 4.4 oder neuer (entwickelt und getestet mit Joomla 6) und PHP 8.1 oder neuer.

Schritt 2: Download-Key eintragen

Updates freischalten: Öffne System → Aktualisierungsquellen (Update Sites), wähle den Eintrag „plg_content_cccexternalvideopreview“ und trage dort deinen Download-Key ein. Ohne den Key zeigt Joomla neue Versionen zwar an, kann sie aber nicht herunterladen.

Schritt 3: Ein Video einfügen

Das Plugin arbeitet überall, wo Joomla Inhalts-Plugins ausführt: in Beiträgen, in Eigenes-HTML-Modulen mit aktivierter Option Inhalte vorbereiten und in Page Buildern. Schreibe einen der folgenden Shortcodes an die Stelle, an der das Video erscheinen soll:

  • {youtube}dQw4w9WgXcQ{/youtube} – YouTube-Video mit seiner ID
  • {youtube}https://youtu.be/dQw4w9WgXcQ?t=90{/youtube} – YouTube-Video mit kompletter Adresse; die Startzeit wird übernommen
  • {vimeo}76979871{/vimeo} – Vimeo-Video mit ID oder Adresse
  • {video}https://vimeo.com/76979871{/video} – erkennt YouTube und Vimeo selbst an der Adresse

Erlaubt sind die üblichen Adressen: Watch-, Teilen-, Embed- und Shorts-Links von YouTube sowie Video- und Player-Links von Vimeo. Was nicht als YouTube- oder Vimeo-Video erkannt wird, bleibt unverändert stehen.

Schritt 4: Einstellungen für ein einzelnes Video

Einstellungen für ein einzelnes Video stehen im öffnenden Tag und haben Vorrang vor den Plugin-Einstellungen:

{youtube start=30 width=640 title="Produktvorstellung"}dQw4w9WgXcQ{/youtube}

  • title – Titel des Videos, für Screenreader und als Titel des Players
  • start – Startzeit in Sekunden
  • width, height – Größe in Pixeln; width begrenzt die Breite
  • ratio – Seitenverhältnis, zum Beispiel 4:3 oder 9:16
  • autoplay, fullscreen – 1 oder 0
  • nocookie, related – nur YouTube, 1 oder 0
  • dnt, private-hash – nur Vimeo
  • image – eigenes Vorschaubild (Pfad oder Adresse)
  • text – eigener Text statt „Klicken, um das Video zu laden.“
  • play-button – eigener Play-Button
  • class – zusätzliche CSS-Klasse

Schritt 5: Vorhandene Einbettungen und Links umwandeln

Vorhandene Einbettungen umwandeln: Ist diese Einstellung aktiv, ersetzt das Plugin YouTube- und Vimeo-iframes, die bereits in deinen Inhalten stehen, durch die Vorschau. Du musst keinen Beitrag von Hand ändern. Andere iframes bleiben unverändert. Bei einer Neuinstallation ist die Einstellung eingeschaltet.

Video-Links umwandeln: Macht aus einer YouTube- oder Vimeo-Adresse eine Vorschau, wenn sie allein in einem Absatz steht. Links im Fließtext bleiben normale Links. Diese Einstellung ist zunächst ausgeschaltet.

Schritt 6: Player und Vorschau einstellen

Reiter „Player“: Hier legst du fest, ob das angeklickte Video sofort startet, ob Vollbild erlaubt ist, ob YouTube-Videos im erweiterten Datenschutzmodus (www.youtube-nocookie.com) geladen werden und ob Vimeo gebeten wird, die Wiedergabe nicht auszuwerten.

Reiter „Vorschau“: Das Plugin lädt das Vorschaubild jedes Videos einmalig auf deinen Server und liefert es von dort aus. Du bestimmst, nach wie vielen Tagen es erneuert wird, welches Ersatzbild erscheint, ob das Bild weichgezeichnet wird, wie der Play-Button aussieht und ob der Hinweis unter oder auf dem Vorschaubild steht. Hintergrundfarbe, Innenabstand und Rahmen des Hinweises stellst du ebenfalls hier ein.

Schritt 7: Datenschutz-Link und Einwilligung

Link zur Datenschutzerklärung: Im Reiter „Datenschutz“ wählst du einen Beitrag, einen Menüeintrag oder eine Adresse. Bei mehrsprachigen Websites genügt ein Beitrag oder Menüeintrag: Für die anderen Sprachen verwendet das Plugin dessen Sprachverknüpfungen.

Entscheidung des Besuchers merken: Hat ein Besucher ein Video geladen, laden weitere Videos derselben Plattform ohne erneute Nachfrage. Du wählst, ob das bis zum Schließen des Browser-Tabs gilt, dauerhaft oder gar nicht. Gespeichert wird nur im Browser des Besuchers, nicht auf dem Server und nicht in einem Cookie. Unter jedem geladenen Video steht ein Link, mit dem der Besucher die Verbindung wieder aufhebt.

Schritt 8: Texte und Aussehen anpassen

Texte: Alle Texte, die Besucher sehen, änderst du unter System → Sprach-Overrides. Die Schlüssel beginnen mit PLG_CONTENT_CCCEXTERNALVIDEOPREVIEW_, zum Beispiel PLG_CONTENT_CCCEXTERNALVIDEOPREVIEW_PRIVACY_TEXT für den Datenschutzhinweis.

Aussehen per CSS: Farben, Radius und Abstände sind CSS-Variablen. Du überschreibst sie im CSS deines Templates, ohne Regeln des Plugins zu ersetzen:

.cccyt-wrapper {
    --cccyt-radius: 12px;
    --cccyt-privacy-bg: #eef3f8;
    --cccyt-privacy-color: #1a1a1a;
    --cccyt-focus-color: #005fcc;
}

Eigenes Markup: Kopiere die Datei plugins/content/cccexternalvideopreview/tmpl/placeholder.php nach templates/DEIN_TEMPLATE/html/plg_content_cccexternalvideopreview/placeholder.php und passe sie dort an. Gestaltet dein Template die Vorschau komplett selbst, kannst du die Styles des Plugins im Reiter „Vorschau“ abschalten.

Schritt 9: Cookie-Banner oder Consent-Tool anbinden

Verwaltet ein Consent-Tool die Einwilligungen deiner Website, kann es dem Plugin mitteilen, wann Videos geladen werden dürfen. Dafür gibt es eine kleine JavaScript-API:

CccExternalVideoPreview.accept('youtube');   // alle YouTube-Videos laden
CccExternalVideoPreview.revoke('youtube');   // Einwilligung zurücknehmen
CccExternalVideoPreview.hasConsent('vimeo'); // true oder false
CccExternalVideoPreview.init(element);       // nachgeladene Inhalte einbeziehen

Zusätzlich löst das Plugin die Ereignisse cccevp:activated und cccevp:reset aus, jeweils mit Plattform und Video-ID.