Gast-Gate-Themenkomponente

[Don]

	Repository	GitHub - VaperinaDEV/discourse-guest-gate-theme-component: Forced login / registration popup insired by Quora · GitHub
	War es hilfreich?	> ./support --coffee
	Installationsanleitung	So installierst du ein Theme oder Theme-Component
	Neu bei Discourse Themes?	Einsteigerführer für die Verwendung von Discourse Themes

Guest Gate v1.0

Hallo Dieses Theme-Component wurde aus Guest Gate (Sign Up Popup Plugin) erstellt. Es kann Themen für anonyme Besucher mit einem Modal sperren und sie zwingen, sich anzumelden oder einzuloggen. Das Component kann auch für ein Warnungs-Modal verwendet werden, das Besucher ermutigt, sich anzumelden, es ihnen aber erlaubt, das Modal zu schließen (dafür die Einstellung dismissable false nicht anhaken). Zu den Optionen gehört auch die Änderung der Anzahl der Themen, die angezeigt werden können, bevor das Modal erscheint.

Tipp: Wenn du die Option „Custom Gate“ verwendest und den Modal-Header ausblenden möchtest (wie auf dem Bild oben), musst du das Feld guest_gate.title löschen und die Leertaste drücken. Dadurch wird der Modal-Titel entfernt, sodass du stattdessen einen Titel unter dem Bild verwenden kannst.

Du hast zwei Haupt-Gate-Optionen:

1. Generisches Gate (Standard: Es wird der Discourse Signup CTA-Text im Modal verwendet). Es verwendet diese Texte: js.signup_cta.intro und js.signup_cta.value_prop

2. Custom Gate (du kannst das Modal anpassen: Bild hinzufügen, eigenen Text und Farben).

---

Und es gibt viele andere Einstellungen

Globale Einstellungen für das Guest Gate Modal

1. max guest topic views
   Anzahl der Themenansichten, bis das Gate angezeigt wird. Nach dem ersten Erscheinen des Gates erscheint es zufällig zwischen 1 und dieser Zahl.
2. dismissable false
   Entfernt den Schließen-Button, was verhindert, dass Besucher es schließen.
3. use gate buttons
   Verwendet Buttons im Modal-Footer anstelle von Links.
4. custom url enabled
   Aktiviert die Optionen für benutzerdefinierte Login-URL und benutzerdefinierte Signup-URL. Das normale Verhalten (wenn du diese Option nicht anhakst) ist, dass das Login- oder Signup-Modal auf der aktuellen Themen-Seite erscheint.
5. custom login url
   Zum Beispiel ist /login die Startseite mit dem angezeigten „Login“-Modal.
6. custom signup url
   Zum Beispiel ist /signup die Startseite mit dem angezeigten „Sign Up“-Modal.
7. gate footer position
   Position der Footer-Buttons/Links.
8. gate show only once
   Guest Gate Modal wird nur einmal pro Sitzung angezeigt.

---

Custom Gate Einstellungen

1. custom gate enabled
   Aktiviere es, wenn du das Modal anpassen möchtest.
2. custom gate image
   Lade ein Bild hoch, das oben im Modal angezeigt werden soll.
3. custom gate image width
   Die Breite des hochgeladenen Bildes. Du kannst px, % usw. verwenden, z. B. fügt 100% ein Bild mit voller Modal-Breite (abzüglich Padding) hinzu.
4. custom gate big text color
   Der „große Text“ erscheint unter dem Bild. Du kannst die Textfarbe festlegen.
5. custom gate little text color
   Der „kleine Text“ erscheint unter dem großen Text. Du kannst die Textfarbe festlegen.
6. custom gate background color
   Ändert die Hintergrundfarbe des Modals.
7. custom gate footer text color
   Ändert die Footer-Textfarbe. Dies gilt, wenn die Einstellung use gate buttons deaktiviert ist und du ein Custom Gate eingerichtet hast.
8. custom gate link color
   Ändert die Footer-Linkfarbe. Dies gilt, wenn die Einstellung use gate buttons deaktiviert ist und du ein Custom Gate eingerichtet hast.

---

Credit Riesiger Dank an die Plugin-Autoren, Maintainer und Mitwirkende: @vinothkannans, @jgujgu und @michaeld

Guest Gate v2.0

Hallo

Guest Gate v2.0 ist ein modernes, konfigurierbares Gate für anonyme Besucher auf Discourse.

Es kann ein Modal anzeigen, um Besucher zu ermutigen, sich anzumelden oder einzuloggen, entweder als weiches Conversion-Prompt oder als Gate, das Besucher nicht schließen können.

Guest Gate begann mit dem ursprünglichen Guest Gate Sign Up Popup Plugin und hat sich seitdem erheblich weiterentwickelt.

Auslösen des Guest Gate

Version 2.0 unterstützt mehrere Möglichkeiten, das Gate auszulösen:

1. Seitenaufrufe
   Zeige das Gate nach einer konfigurierbaren Anzahl qualifizierter Seitenaufrufe an.

2. Zeit
   Zeige das Gate an, nachdem ein Besucher eine konfigurierbare Zeit auf einer qualifizierten Seite verbracht hat.

3. Scrollen
   Zeige das Gate an, nachdem ein Besucher einen konfigurierbaren Prozentsatz der Seite gescrollt hat.

4. Lightbox
   Zeige das Gate an, wenn ein anonymer Besucher ein Bild in der Discourse-Lightbox öffnet.

5. Beliebig
   Aktiviere mehrere Auslösetypen und zeige das Gate an, wenn der erste konfigurierte Auslöser erreicht wird.

Du kannst auch eine Verzögerung zwischen dem Auslöser und dem Erscheinen des Modals konfigurieren.

---

Wiederholungsverhalten

Nachdem das Guest Gate angezeigt wurde, kannst du steuern, wann es erneut erscheinen darf.

Verfügbare Modi:

• Repeat trigger: Zeige das Gate immer dann an, wenn der konfigurierte Auslöser ausgelöst wird.

• Random page views: Zeige das Gate nach einer zufälligen Anzahl von Seitenaufrufen an.

• Once per session: Zeige das Gate höchstens einmal während der Browser-Sitzung an.

Die Legacy-Einstellung Show only once wird auch aus Gründen der Abwärtskompatibilität unterstützt.

---

URL-Sichtbarkeit

Zwei Einstellungen steuern, wo Guest Gate erscheinen darf:

url_for_show

Definiere die Pfade, an denen Guest Gate ausgelöst werden kann.

Beispiele:

• * alle Seiten

• / Startseite

• /latest Neueste

• /t/* Themen

• /c/* Kategorien

url_for_hide

Definiere Pfade, an denen Guest Gate niemals erscheinen darf.

Muster zum Ausblenden haben immer Vorrang vor der Anzeigeliste.

---

Modal-Einstellungen

dismissable

Erlaube Besuchern, das Guest Gate Modal zu schließen.

Deaktiviere diese Option, um ein nicht schließbares Gate zu erstellen.

gate_modal_size

Wähle die Modal-Breite:

• compact

• standard

• wide

gate_body_alignment

Wähle die horizontale Ausrichtung des Hauptinhalts des Modals:

• left

• center

• right

gate_footer_position

Wähle die Ausrichtung der Login-/Sign-Up-Links oder -Buttons:

• left

• center

• right

gate_title_visibility

Zeige oder blende den Modal-Titel aus.

gate_title_position

Steuere die Margin-Positionierung des Titels.

---

Login und Sign Up

Guest Gate unterstützt den normalen Discourse-Authentifizierungsflow sowie benutzerdefinierte URLs.

use_gate_buttons

Verwende Buttons im Modal-Footer anstelle von Textlinks.

custom_url_enabled

Verwende benutzerdefinierte Login- und Sign-Up-URLs anstelle der nativen Authentifizierungsaktionen von Discourse.

custom_login_url

Ziel, das für Login verwendet wird, wenn benutzerdefinierte URLs aktiviert sind.

custom_signup_url

Ziel, das für Sign Up verwendet wird, wenn benutzerdefinierte URLs aktiviert sind.

Du kannst auch die Button-Stile und Font Awesome-Icons unabhängig voneinander konfigurieren.

---

Discourse Connect

Guest Gate unterstützt Discourse Connect.

Wenn Discourse Connect aktiviert ist, kannst du optional eine separate Sign-Up-URL bereitstellen, indem du verwendest:

• enable_discourse_connect_signup

• discourse_connect_signup_url

---

Custom Gate

Das Custom Gate ermöglicht es dir, den Inhalt und das Aussehen des Modals vollständig anzupassen.

Aktiviere es mit:

custom_gate_enabled

Aktiviert das Custom Gate Design.

custom_gate_image

Optionales Bild, das über dem benutzerdefinierten Text angezeigt wird.

custom_gate_image_alt

Alternativtext für das benutzerdefinierte Bild.

custom_gate_image_width

Setze die Bildbreite mit Werten wie:

• 150px

• 50%

• 100%

custom_gate_image_position

Richte das Bild aus:

• left

• center

• right

custom_gate_big_text_position

Richte die benutzerdefinierte Überschrift aus:

• left

• center

• right

custom_gate_little_text_position

Richte den benutzerdefinierten Text aus:

• left

• center

• right

Das Custom Gate bietet auch Einstellungen für die Farben von Überschrift, Text, Hintergrund, Footer und Links.

---

Analytics

Guest Gate v2.0 enthält optionale, datenschutzfreundliche Analytics.

Aktiviere es mit:

enable_analytics

Wenn aktiviert, erfasst Guest Gate:

• Gate-Eindrücke

• Auslösergrund

• Seitenpfad

• Login-Klicks

• Sign-Up-Klicks

• SSO-Aktionen

• Schließen-Aktionen

Ereignisse werden über window.dataLayer bereitgestellt und auch als Browser-Ereignis ausgelöst:

discourse-guest-gate:analytics

Dies ermöglicht es Guest Gate, mit Analytics- und Tag-Management-Plattformen wie Google Analytics, Google Tag Manager, Matomo oder benutzerdefinierten Analytics-Implementierungen integriert zu werden.

Es werden keine persönlichen Daten durch Guest Gate gesammelt.

Analytics sind standardmäßig deaktiviert.

analytics_debug_logging

Aktiviere dies während der Konfiguration von Analytics, um Guest Gate-Ereignisse in der Browser-Konsole anzuzeigen.

Es wird empfohlen, dies in der Produktion zu deaktivieren.

---

Migration von v1

Guest Gate v2.0 enthält eine Einstellungen-Migration für bestehende Installationen.

Die folgenden Legacy-Einstellungen werden automatisch migriert:

• max_guest_topic_views

• dismissable_false

• gate_show_when_thumbnail_clicked

Bestehende Konfigurationen müssen daher nach dem Upgrade nicht manuell neu erstellt werden.

---

Anforderungen

Guest Gate v2.0 erfordert Discourse 3.2.0 oder neuer.

---

Credit
Riesiger Dank an die ursprünglichen Plugin-Autoren, Maintainer und Mitwirkende: @vinothkannans, @jgujgu und @michaeld

[markersocial]

Danke! Das ist großartig

Mir gefällt sehr gut, dass die Anmelde-/Registrierungslinks durch Schaltflächen ersetzt werden können.

Ich würde vorschlagen, dass die Registrierungsschaltfläche vielleicht die hervorgehobene (blaue) Farbe haben sollte und die Schaltfläche „Ich habe bereits ein Konto“ grau sein sollte. Das scheint zumindest nach meinen Beobachtungen beliebter Websites üblicher zu sein. Wahrscheinlich haben die meisten Leute, die das Modal sehen, kein Konto, daher ist das wahrscheinlich sinnvoll.

[Don]

Hallo @markersocial,

Danke für den Vorschlag!

Ich habe diese beiden Einstellungen hinzugefügt. Jetzt können Sie den Stil der Anmelde- und Registrierungsbuttons im Gast-Gate-Modal ändern.

btn-primary oder btn-default

Feature: ability to change login and signup button style

[markersocial]

Fantastisch, vielen Dank @Don! Habe es jetzt aktualisiert und es funktioniert super

Mein einziger weiterer Vorschlag wäre, die Häufigkeit von wiederkehrenden Aufforderungen anpassen zu können.

Einstellung: max guest topic views
„Anzahl der Themenaufrufe, bis das Gate angezeigt wird. Nachdem das Gate zum ersten Mal erscheint, erscheint es zufällig zwischen 1 und dieser Zahl.“

Wenn die maximale Anzahl von Themenaufrufen für Gäste auf 1 oder 2 eingestellt ist, ist das schön und ermutigt zur frühen Anmeldung – aber wenn der Benutzer ablehnt (und „einmal pro Sitzung anzeigen“ nicht aktiviert ist), wäre es schön, das Modal mit einer geringeren Häufigkeit erneut anzeigen zu können, damit es für Lurker nicht zu aggressiv ist. Zum Beispiel alle 5 oder mehr Themenaufrufe.

[davidkingham]

Hallo Don, tolle Komponente! Könntest du vielleicht den Anmeldebutton anpassbar machen, sodass eine URL eingefügt werden kann? Ich benutze Memberful für SSL, daher funktioniert der normale Anmeldelink nicht, er leitet dich nur zur Anmeldeseite weiter. Danke!

[Don]

Hallo David,

Danke, das ist ein toller Vorschlag!

Ich habe das hinzugefügt. Ich habe die Einstellung redirect_to_home durch custom_url_enabled und zwei Optionen ersetzt.

1. custom_login_url: /login
   (standardmäßig wird hier zur Homepage weitergeleitet und das Login-Modal geöffnet)
2. custom_signup_url: /singup
   (standardmäßig wird hier zur Homepage weitergeleitet und das Signup-Modal geöffnet)

Feature: abality to change guest gate buttons url

[davidkingham]

Fantastisch! Nur ein Problem, jetzt funktionieren die benutzerdefinierten Gate-Textoptionen nicht mehr

[Don]

Ich habe Ihre Website überprüft und sie funktioniert für mich. Versuchen Sie es vielleicht mit einem Hard Refresh oder öffnen Sie den Browser erneut. Ich denke, Sie sehen eine zwischengespeicherte Version.

[davidkingham]

Das habe ich auch gedacht, habe meinen Cache geleert, 4 verschiedene Browser ausprobiert und alle waren gleich, sehr seltsam! Wenn es Ihnen nichts ausmacht, es noch einmal zu versuchen, ich habe gerade guest_gate.title in ‘Test’ geändert, sehen Sie dieses Update?

[Don]

Ja, das sehe ich jetzt auch.

Ich werde versuchen, andere Browser und Geräte zu überprüfen.

[davidkingham]

Gleiche Ergebnisse über VPN, auf meinem Handy, anderes Netzwerk. Das ist das Seltsamste überhaupt! Ich schätze, solange alle anderen den richtigen Text sehen können, ist es in Ordnung!

[Don]

Hallo David,

Ich glaube, das ist nicht normal. Vielleicht gibt es einen Locale-Bug. Mein bester Tipp ist die Einstellung set locale from accept language header.
Wie ich sehe, verwendest du das auf deiner Website, und vielleicht siehst du deshalb die Standardtexte im Modal, weil deine Browsersprache anders ist und Discourse sie auf den Standardtext zurücksetzt.

Kannst du diese Einstellung ausschalten und es erneut versuchen?

---

Jetzt kann ich das reproduzieren. Ich habe die Chrome-Sprache von Englisch (Vereinigtes Königreich) auf Englisch (Vereinigte Staaten) geändert und das ist passiert.

und zurück zu Englisch (Vereinigtes Königreich)

[davidkingham]

Danke Don, du bist unglaublich hilfreich! Ich glaube, es gibt einen Fehler in meiner Installation mit den Sprachen. Da dies anscheinend nicht durch deine Komponente verursacht wird, werde ich ein neues Thema eröffnen. Ich weiß es zu schätzen, dass du dich darum gekümmert hast.

EDIT: Ich habe herausgefunden, dass meine Admin-Locale irgendwie von US auf UK geändert worden war, sehr seltsam! Ich habe sie zurückgestellt und die Felder erneut ausgefüllt, jetzt ist alles wieder in Ordnung.

[Jonathan5]

Das funktioniert sehr gut. Danke schön.

Ich habe einige kleinere Änderungen vorgenommen, um den ersten Beitrag leichter lesbar zu machen. Es gab jedoch einen Satz, den ich überhaupt nicht verstehen konnte:

Benutzerdefinierte URL aktiviert
Fügen Sie benutzerdefinierte URLs zu den Anmelde- und Registrierungsbuttons/-links hinzu. Standardmäßig wird der Besucher nach dem Klicken auf den Anmelde- oder Registrierungsbutton zur Homepage weitergeleitet und das Anmelde- oder Registrierungsmodal geöffnet. Hinweis: Wenn Sie dies nicht ankreuzen, bleibt der Besucher auf der Themenseite, nachdem er auf die Buttons geklickt hat, und das Gastportal-Modal ändert sich zum Anmelde- oder Registrierungsmodal, das geschlossen werden kann, sodass der Besucher es schließen und das Thema lesen kann.

[Don]

Vielen Dank, Jonathan Ich weiß das wirklich zu schätzen Leider ist mein Englisch nicht das Beste Entschuldigung dafür! Ich werde diese im Theme Component ändern oder natürlich könnten Sie auch einen PR senden.

Die Website-Einstellung custom url enabled bedeutet.
Sie können benutzerdefinierte URLs zu den Schaltflächen/Links für Gast-Login und Registrierung hinzufügen, die standardmäßig diese benutzerdefinierten URLs /login und /signup verwenden. Diese leiten den Besucher zur Homepage weiter und öffnen das Login- oder Registrierungsmodal. Wenn Sie es also aktivieren, werden die beiden Einstellungen darunter aktiviert. Die custom login url und custom signup url.

Wenn Sie diese Einstellung nicht aktivieren, bleibt der Besucher nach dem Klicken auf die Schaltflächen/Links für Gast-Login oder Registrierung auf der Thema-Seite und das Login- oder Registrierungsmodal wird auf derselben Thema-Seite geöffnet. Danach kann der Besucher das Modal schließen.

Ich hoffe, das hilft beim Verständnis und nochmals vielen Dank für Ihre Zeit, um es verständlicher zu machen

[Jonathan5]

Dein Englisch ist in Ordnung, und an deinem JavaScript ist nichts auszusetzen, was die Hauptsache ist Was ist mit dem hier?

4. Benutzerdefinierte URL aktiviert – Aktiviert die Optionen Benutzerdefinierte Anmelde-URL und Benutzerdefinierte Registrierungs-URL. Das normale Verhalten (wenn du diese Option nicht aktivierst) ist, dass das Anmelde- oder Registrierungsmodal auf der aktuellen Themen-Seite erscheint.
5. Benutzerdefinierte Anmelde-URL – Zum Beispiel: /login ist die Startseite mit dem angezeigten Modal "Anmelden".
6. Benutzerdefinierte Registrierungs-URL – Zum Beispiel: /signup ist die Startseite mit dem angezeigten Modal "Registrieren".

[Don]

@Jonathan5

und es ist nichts falsch an Ihrem JavaScript

Das ist größtenteils auch den Plugin-Autoren und Mitwirkenden zu verdanken. Aber ich gebe mein Bestes, dies zu entwickeln und weitere Funktionen, Korrekturen usw. hinzuzufügen.

---

Danke für die Korrektur das scheint viel besser zu sein. Ich werde dies auch in der Theme-Komponente korrigieren.

[Himanshu_Singh]

Hallo zusammen,

ich habe diese Komponente kürzlich installiert und sie funktioniert einwandfrei, aber ich bin mir nicht sicher, ob der Gating-Mechanismus den Google-Bot beim Crawlen der Themen verlangsamt.

Weiß jemand, welche Auswirkungen dies auf Crawler hat?

[Himanshu_Singh]

Ich habe einige Konfigurationsprobleme mit Guest Gate, wenn ich SSO mit Discourse Connect verwende.

Der Benutzer kann sich auf der Hauptseite anmelden und scheint dann in Discourse angemeldet zu sein, aber nach dem Klicken auf einige Themen erscheint das Guest Gate Modal. Das ist ungewöhnlich, da der Benutzer angemeldet ist.

Ich habe benutzerdefinierte URLs für die Anmeldung, sodass der Benutzer, wenn er auf „Ich bin bereits angemeldet“ klickt, auf die benutzerdefinierte Anmeldeseite weitergeleitet wird und sich der Zyklus wiederholt.

Der einzige Ausweg ist, wenn der Benutzer auf die native Anmeldeschaltfläche in Discourse klickt und automatisch angemeldet wird.

Es scheint, dass Guest Gate aus irgendeinem Grund die Anmeldung von SSO nicht berücksichtigt und eine native Anmeldung zur Aktivierung erfordert.

Sind andere Leute auf diese Probleme gestoßen? Irgendwelche Vorschläge für eine Lösung oder einen Workaround?