 |
Zusammenfassung | Discourse Custom Post Button verwandelt Links in Discourse-Beiträgen in stilisierte Buttons. |
 |
Repository | github.com/koloki-co/discourse-custom-post-button |
 |
Installationsanleitung | Ein Theme oder Theme-Komponente installieren |
 |
Neu bei Discourse-Themes? | Einsteigerleitfaden zur Nutzung von Discourse-Themes |
Diese Theme-Komponente installieren
Dies ist eine Community-Theme-Komponente, die von Koloki Ltd gewartet wird. Es handelt sich nicht um eine offizielle Discourse-Komponente. Sie befindet sich im Alpha-Stadium, daher können Fehler auftreten. Bitte melden Sie Fehler und fordern Sie neue Funktionen im GitHub-Repository an.
Screenshots
Buttons
Ein spezifischer Anwendungsfall: Ein „Stellen Sie uns per PN eine Frage“-Button
Funktionen
- Verwandelt normale Links überall in einem Thema oder Beitrag in einen Button unter Verwendung von
[wrap]. - Bietet TC-einstellbare Standardwerte für Hintergrundfarbe, Eckenradius, Innenabstand, Schriftstärke, Textfarbe und Hover-Opazität; andernfalls werden die Standards Ihres Forums verwendet.
- Erlaubt es einem einzelnen Button, die Standard-Hintergrundfarbe zu überschreiben.
- Unterstützt erklärende Texte neben einem Button.
- Behält den zugrunde liegenden Inhalt als normalen Link bei, sodass Buttons externe Seiten oder interne Discourse-Routen wie
/new-messageöffnen können.
WICHTIG: Wenn diese TC installiert ist, kann jeder Benutzer auf Ihrem Forum diese Buttons erstellen. Die Beschränkung der Button-Funktion auf bestimmte Benutzer würde ein vollständiges Plugin erfordern. In der Praxis müssen Benutzer jedoch wissen, dass es installiert ist und wie man einen Button erstellt, daher vermute ich, dass nur wenige es tatsächlich tun werden. Sie können auch Watched Words verwenden, um Beiträge mit
[wrap=custom-button]zur Freigabe zu filtern, was die Funktion beschränken würde.
Installation
Öffnen Sie in Admin > Erscheinungsbild > Themes & Komponenten den Tab Komponenten, wählen Sie Installieren und dann Aus einer Git-Repository-URL installieren. Verwenden Sie:
https://github.com/koloki-co/discourse-custom-post-button
Fügen Sie die Komponente nach der Installation jedem aktiven Theme hinzu, in dem sie verfügbar sein soll.
Verwendung
Basis-Button
Die Standard-Button-Farbe aus den TC-Einstellungen wird verwendet.
[wrap=custom-button][Ihr Custom Button Text](https://example.com)[/wrap]
Farbeinstellung pro Button
[wrap=custom-button color=#7CC146][Ihr Custom Button Text](https://example.com)[/wrap]
Button gefolgt von erklärendem Text
[wrap=custom-button][Ihr Custom Button Text](https://example.com)[/wrap]
[wrap=text-after-button]Zusätzlicher erklärender Text[/wrap] (auf einer neuen Zeile)
Öffnen einer Privatnachricht an eine Gruppe
(Hinweis: Dies nutzt die eingebaute Discourse-Funktionalität, um den Composer mit vorbefülltem Text zu öffnen – dieser Teil der Funktionalität stammt nicht von der Theme-Komponente, ich nutze ihn nur, um einen möglichen Anwendungsfall zu demonstrieren. Erfordert, dass die Gruppeneinstellungen PNs an diese Gruppe erlauben.)
[wrap=custom-button][Stellen Sie uns eine Frage](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Verwenden Sie den slugifizierten name der Gruppe, nicht den „Vollständigen Namen“, und kodieren Sie die Parameterwerte URL-konform. Die Einstellung Wer kann dieser Gruppe Nachrichten senden? der Gruppe bestimmt weiterhin, wer einen adressierten Composer öffnen kann, und abgemeldete Besucher werden zur Anmeldung aufgefordert.
Einstellungen
| Einstellung | Zweck |
|---|---|
button_default_color |
Standard-Hintergrund- und Randfarbe des Buttons |
button_border_radius |
Eckenradius des Buttons |
button_padding |
Abstand um das Button-Label |
button_font_weight |
Schriftstärke des Button-Labels |
button_text_color |
Farbe des Button-Labels |
button_hover_opacity |
Opazität des Buttons bei Hover |
Die Komponente stellt auch eine svg_icons-Einstellung für verfügbare Theme-Icons bereit, fügt aber derzeit kein Icon in einen Beitrags-Button ein. Ich werde diese Funktion hinzufügen, wenn es Bedarf dafür gibt.
Hinweise
- Die Komponente ändert nur die Darstellung. Buttons bleiben Links und die Berechtigungen des Ziels bleiben unverändert.
- E-Mail-Clients und andere Kontexte, die das aktive Discourse-Theme nicht laden, können den zugrunde liegenden Link ohne Button-Stilierung anzeigen.
- Die Komponente ist unter der MIT-Lizenz lizenziert.
Die Komponente entstand aus demselben nützlichen [wrap]-Muster, das in So betten Sie einen Button in einen Themenbeitrag ein besprochen wurde.
