WSC 6.2 WSC CKEditor Button BBCode Branding Free

WSC CKEditor Button BBCode Branding Free Version

Der WSC CKEditor Button BBCode erweitert den aktuellen WoltLab-Editor um einen komfortablen Button-Generator.
Mit wenigen Klicks lassen sich Standard- oder Primary-Buttons inklusive Beschriftung, Tooltip, Link sowie Font-Awesome-Icons und Marken direkt über den CKEditor einfügen – vollständig im Stil der WoltLab Suite.
Diese Version hat die gleichen Funktionen wie die kostenfreie Variante, aber das Branding (also der sichtbare Hinweis auf https://www.wsc-support.de) ist in dieser Version entfernt. Ihre Nutzer sehen also nicht mehr unsere Werbung. Mit dem Kauf einer Branding Free-Lizenz unterstützen Sie unsere Weiterentwicklung von kostenfreien Produkten.

Das Plugin ergänzt die Editor-Werkzeugleiste um ein eigenes Symbol. Ein Klick öffnet einen übersichtlichen Dialog, in dem sich Aussehen, Beschriftung, Icon und Verlinkung konfigurieren lassen. Anschließend wird der passende BBCode automatisch in den Beitrag oder Inhalt eingefügt.

Die Darstellung orientiert sich an den vorhandenen WoltLab-Komponenten. Neben Standard-Buttons und Primary-Buttons steht ein Farbwähler mit 44 aufeinander abgestimmten Farben zur Verfügung.

Die wichtigsten Funktionen

• Auswahl zwischen Standard, Primary und 44 vordefinierten Farben
• optionale Beschriftung und optionaler Tooltip
• optionale interne oder externe Verlinkung
• Auswahl von Font-Awesome-Icons und Font-Awesome-Brands
• getrennte Auswahlbereiche für Icons und Marken mit Suchfunktion
• Verwendung der tatsächlich in der WoltLab-Installation vorhandenen Icons und Brands
• Buttons auch ausschließlich mit Icon möglich
• verpflichtender Tooltip bei Buttons ohne Beschriftung
• direkte Prüfung fehlerhafter oder unvollständiger Eingaben im Dialog
• per Tastatur bedienbarer Farbwähler
• Unterstützung im Frontend und in CKEditor-Instanzen des ACP
• deutsche und englische Sprachunterstützung

Kontrolle über erlaubte Linkziele

Der Administrator legt im ACP fest, welche Ziele über die erzeugten Buttons erreichbar sein dürfen:

• Nur eigene Domain: Beschränkung auf die eigene Website; dies ist die Standardeinstellung.
• Eigene Domain und freigegebene Domains: Externe Ziele sind nur für ausdrücklich freigegebene Domains erlaubt.
• Beliebige HTTPS-Ziele: Externe Verlinkungen sind ohne Domain-Freigabeliste möglich.

Als intern gelten Ziele mit derselben Domain, demselben Protokoll und demselben Port wie die WCF-Installation. Externe Subdomains müssen bei Verwendung der Freigabeliste einzeln eingetragen werden.

Diese Regeln gelten auch für manuell eingegebene und bereits gespeicherte BBCodes. Nicht erlaubte Linkziele werden nicht als anklickbare Links ausgegeben.

Externe Links mit Bestätigung

Bei erlaubten externen Zielen erscheint immer eine Bestätigungsseite. Sie zeigt den Namen der verlassenen Website, die tatsächliche Zieldomain und die vollständige Zieladresse an. Erst nach ausdrücklicher Bestätigung wird das externe Ziel geöffnet.

Die Bestätigungsseite funktioniert auch ohne JavaScript und beim Öffnen eines Buttons in einem neuen Tab. Eine automatische Weiterleitung findet nicht statt.

Einfache Adresseingabe – ausschließlich HTTPS

Im Dialog ist https:// bereits vorangestellt. Benutzer müssen daher nur eine Adresse wie www.example.com eingeben. Wird eine vollständige Adresse mit https:// eingefügt, erkennt das Plugin dies und vermeidet ein doppeltes Protokoll.

HTTP, FTP und andere URL-Schemata werden abgewiesen. Interne Pfade, die mit /, ? oder # beginnen, bleiben in einer HTTPS-Installation möglich.

Automatisch erzeugter BBCode

Das Plugin verwendet einen eigenen BBCode, beispielsweise:

[wscbutton='primary','https://www.example.com/','brand:github','GitHub','']GitHub[/wscbutton]

Benutzer müssen diesen Aufbau nicht kennen oder manuell eingeben. Der gesamte BBCode wird über den Dialog erzeugt.

Integration und Validierung

Für Editor, Dialoge, Font Awesome und Rendering verwendet das Plugin die von WoltLab bereitgestellten Mechanismen.

Sämtliche BBCode-Werte werden beim Rendern erneut serverseitig geprüft. Dazu gehören Button-Typen, Farbwerte, URLs, Icon-Namen, Brands und Textlängen. Für externe Ziele wird die aktuell geltende Linkfreigabe auch beim Aufruf der Bestätigungsseite erneut geprüft.

Am Fuß des Generator-Dialogs befindet sich ein fester Anbieterhinweis auf WSC-Support.

Kompatibilität

• WoltLab Suite Core 6.2.x
• PHP 8.1 oder neuer
• Eine ggf. installierte Version mit Branding muss nicht deinstalliert werden, einfach dieses Paket wie gewohnt installieren und das Branding verschwindet

Typische Einsatzmöglichkeiten

• Download-Buttons
• Links zu Produktseiten und Dokumentationen
• Support- und Kontaktseiten
• externe Projektseiten
• GitHub-, Discord- oder Social-Media-Links
• hervorgehobene Verweise in Artikeln und Beiträgen

So lassen sich häufig benötigte Links ansprechend darstellen, ohne HTML oder eigene CSS-Anpassungen verwenden zu müssen.

Schon gesehen? Das 3D-Board
(Das ist übrigens ein Beispiel eines mit dem Plugin erzeugten Buttons.)