Was ist ein Shortcode?
Shortcodes sind kleine Platzhalter, die Sie fast überall in den Inhalt Ihrer WordPress-Seiten und -Beiträge einfügen können. Wenn die Seite von einem Besucher aufgerufen wird, werden diese Platzhalter verarbeitet und stattdessen durch dynamisch generierte Inhalte ersetzt. Sie könnten zum Beispiel einen Shortcode haben, der dem aktuell angemeldeten Benutzer seinen Vornamen anzeigt. Ein Shortcode könnte wie folgt aussehen:
[mepr-account-info field="first_name"]
Wenn die Seite, auf der sich der Shortcode befindet, von einem eingeloggten Benutzer namens John Doe aufgerufen wird. Die Seite würde zeigen John in dem Inhalt, in dem der Shortcode platziert wurde.
Video-Übersicht über Shortcodes und deren Verwendung in MemberPress
Derzeit verfügbare Shortcodes
Kontobezogen
[mepr-account-link]
Zeigt einen Link zur Kontoseite in MemberPress an. Er kann auf jeder Seite oder jedem Beitrag verwendet werden.
[mepr-account-form]
Zeigt das Formular für Benutzerkontoinformationen an. Dies wird in der Regel nicht verwendet, es sei denn, Sie möchten Kontoinformationen irgendwo anders als auf der standardmäßig vorhandenen MemberPress-Kontoseite anzeigen. Dies kann auch für Leute nützlich sein, die WPML verwenden und separate Kontoseiten für jede Sprache erstellen.
Denken Sie auch daran, dass MemberPress benutzerdefiniertes Feld Daten können nur auf den Seiten zur Konto- oder Mitgliederregistrierung erfasst werden. Der zu Ihren benutzerdefinierten Seiten hinzugefügte Shortcode zeigt keine benutzerdefinierten Felder an, die Sie zu Ihren Formularen hinzugefügt haben.
[mepr-list-subscriptions status="all"]
Zeigt eine Liste der aktiven und inaktiven Abonnements des aktuellen Benutzers an.
Seit der Version MemberPress 1.9.28 haben wir ein optionales Status-Attribut eingeführt. Wenn Sie den Status auf "all" setzen oder ihn wie folgt entfernen:
[mepr-list-subscriptions]
Wie Sie oben sehen können, werden die aktiven und inaktiven Abonnements des Standardstroms angezeigt. Wenn Sie den Status auf "aktiv" setzen:
[mepr-list-subscriptions status="active"]
und Sie werden die aktiven Abonnements des aktuellen Benutzers sehen. Sie können auch die inaktiven Abonnements des aktuellen Benutzers anzeigen, indem Sie den Status "abgelaufen" verwenden:
[mepr-list-subscriptions status="expired"]
Die Abonnementliste kann nach Datum sortiert werden:
[mepr-list-subscriptions orderby="date"]
oder Titel:
[mepr-list-subscriptions orderby="title"]
Sie können in aufsteigender Reihenfolge sortiert werden:
[mepr-list-subscriptions orderby="title" order="asc"]
oder absteigender Reihenfolge:
[mepr-list-subscriptions orderby="title" order="desc"]
[mepr-logout-link]
[mepr-login-link]
Die beiden obigen Shortcodes sind beide identisch. Sie zeigen Anmelde- oder Abmeldelinks an, die auf dem aktuellen Anmeldestatus des Benutzers basieren. Der Login-Link leitet den Benutzer zur MemberPress-Login-Seite, wo er sich anmelden kann. Der Logout-Link meldet den Benutzer ab und leitet ihn zu der Logout-Redirect-URL weiter, die Sie auf Ihrer MemberPress-Einstellungsseite festgelegt haben.
[mepr-login-form use_redirect="true"]
Zeigt ein Anmeldeformular auf einer Seite oder einem Beitrag an. Es kann überall verwendet werden. Wenn use_redirect = "true", leitet MemberPress den Benutzer zu der in den MemberPress-Einstellungen eingestellten Umleitungs-URL für die Anmeldung weiter.
[mepr-user-file slug="mepr_slug" user_id=""]Link Text[/mepr-user-file]
Zeigt einen Link zum Anzeigen/Download der von einem Benutzer hochgeladenen Datei an. Ersetzen Sie mepr_slug durch den Slug des benutzerdefinierten Feldes aus Ihrem MemberPress > Einstellungen > Registerkarte Felder. Wenn Sie user_id weglassen, wird die Datei für den aktuell angemeldeten Benutzer angezeigt; andernfalls wird die Datei für den Benutzer angezeigt, den Sie mit Benutzer_id.
Sie müssen den abschließenden Shortcode-Tag nicht einfügen, aber wenn Sie es tun, wird der Text dazwischen als Linktext für die Datei verwendet.
[mepr-user-active-membership-titles userid="" message=""]
Zeigt die derzeit aktiven Mitgliedsnamen der Mitglieder an. Wenn keine Benutzerkennung vorhanden ist, wird standardmäßig das aktuelle Mitglied verwendet. Wenn das Mitglied mehr als eine aktive Mitgliedschaft hat, werden die Namen durch ein Komma getrennt. Seit der Version MemberPress 1.9.38 haben wir eine optionale Nachricht Attribut. Es kann verwendet werden, wenn Sie eine benutzerdefinierte Nachricht anzeigen möchten, wenn ein Benutzer keine aktiven Abonnements hat. Wenn Sie es leer lassen, wird der Shortcode keine Nachricht anzeigen.
[mepr-account-info field="slug"]
Zeigt das Benutzer-Meta-Feld an, das durch "slug" ausgewählt wird
Schnecke | Ergebnis |
voller_name | Unbekannter |
voll_name_letzter_vorname | Unbekannter, John |
vorname_nachname_initial | John D. |
nachname_vorname_einmalig | Doe, J. |
vor_name | John |
letzter_name | Doe |
benutzer_anmeldung | johndoe |
benutzer_email | johndoe@email.com |
Spitzname | johndoe |
Beschreibung | (alias Biografische Informationen) |
mepr-address-one | 123 Fake Street |
mepr-adress-zwei | Apt. 123 |
mepr-adresse-stadt | Vidor |
mepr-address-state | Texas |
mepr-address-zip | 77662 |
mepr-adresse-land | USA |
mepr_user_message | Die "Benutzerdefinierte MemberPress-Kontonachricht", die Sie für das Mitglied in seinem Profil definiert haben |
benutzer_registriert | Datum/Uhrzeit des ersten Besuchs des Nutzers auf Ihrer Website |
anzeige_name | johndoe |
ID | Die eindeutige ID, die dem Benutzer bei der Registrierung zugewiesen wurde. Muss als ID eingegeben werden, nicht als id. |
"Deine eigene Schnecke" | Einer der benutzerdefinierten Kontofeld-Slugs in den MemberPress-Einstellungen. |
Unbefugter Zugriff
[mepr-unauthorized-message]
Zeigt die unautorisierte Nachricht an, wo immer dieser Shortcode platziert wird. Wenn Sie MemberPress so eingerichtet haben, dass unautorisierte Besucher auf eine bestimmte URL umgeleitet werden, dann empfehlen wir, diesen Shortcode auf dieser unautorisierten Seite zu verwenden.
[mepr-show]Inhalte, die hier angezeigt werden sollen[/mepr-show]
[mepr-hide]Hier zu verbergende Inhalte[/mepr-hide]
Beide oben genannten Shortcodes unterstützen das if="X"-Attribut, wobei "X" für "angemeldet" oder "abgemeldet" stehen kann. Beide Shortcodes arbeiten damit, ob der Benutzer ein- oder ausgeloggt ist, und kümmern sich nicht darum, ob und welche Mitgliedschaften der Benutzer erworben hat. Beispiele hierfür könnten sein:
[mepr-show if="loggedin"]Sie sind eingeloggt, herzlichen Glückwunsch![/mepr-show]
[mepr-show if="loggedout"]Sie sind jetzt abgemeldet![/mepr-show]
[mepr-active {Parameter gehören hierher - siehe unten}]Zu schützender Inhalt hier[/mepr-active]
Wird verwendet, um Inhalte auf Seiten in Ihrer Website ein- oder auszublenden. Dieser Shortcode unterstützt die folgenden Parameter (mit * gekennzeichnete Parameter sind erforderlich. Nur eine Parameter in rot unten kann pro Shortcode angewendet werden):
Shortcode-Parameter | Beschreibung |
Regel(n) * | Wenn Sie eine einzelne Regel-ID verwenden möchten, setzen Sie diese auf rule="X". Wenn Sie mehrere Regel-IDs verwenden möchten, setzen Sie dies auf rules="X, XX, XXX". Dabei sind X = die IDs der Regel(n). Wo finde ich den Ausweis für eine Regel? |
Mitgliedschaft(en) * | Wenn Sie eine einzige Mitgliedschafts-ID verwenden möchten, setzen Sie dies auf membership="X". Wenn Sie mehrere Mitgliedschafts-IDs verwenden wollen, setzen Sie dies auf memberships="X, XX, XXX". Wobei X = die IDs der Mitgliedschaft(en) sind. Wo finde ich den Ausweis einer Mitgliedschaft? |
wenn erlaubt* | Bei ifallowed="show" wird der dazwischen liegende Inhalt nur autorisierten Mitgliedern angezeigt. Bei ifallowed="hide" wird der Inhalt vor autorisierten Mitgliedern verborgen. |
unauth | Wenn Sie eine einzige Mitgliedschafts-ID verwenden möchten, setzen Sie dies auf membership="X". Wenn Sie mehrere Mitgliedschafts-IDs verwenden wollen, setzen Sie dies auf memberships="X, XX, XXX". Wobei X = die IDs der Mitgliedschaft(en) sind. Wo finde ich den Ausweis einer Mitgliedschaft? |
unauth_message | Verwenden Sie diese Option, um die standardmäßige unauth-Meldung zu überschreiben. Dies gilt nur, wenn das obige Attribut "unauth" gleich "message" oder "both" gesetzt ist. |
Ein Beispiel-Shortcode, der alle oben genannten Attribute verwendet, könnte wie folgt aussehen:
[mepr-active rules="1, 2, 3" ifallowed="show" unauth="message" unauth_message="Download link hidden, please login or purchase a membership to view."]<a href="#">Link hier herunterladen</a>[/mepr-aktiv]
Registrierung
[mepr-group-price-boxes group_id="123"]
Hilfreich, wenn Sie Inhalte über und unter den Gruppenpreisfeldern platzieren möchten. Wenn Sie dies auf der Gruppenseite selbst verwenden, müssen Sie keine group_id angeben. Wenn Sie es an anderer Stelle auf Ihrer Website verwenden möchten, benötigen Sie das Attribut group_id.
[mepr-membership-link id="0"]Linktext hier rein[/mepr-membership-link]
Zeigt einen Link zu der durch "id" identifizierten Mitgliedschaft.
[mepr-membership-access-url id="123"]Linktext hier[/mepr-membership-access-url]
Verwendet die URL für den Zugang zur Mitgliedschaft, die in der Einstellung "URL für den Zugang zur Mitgliedschaft" im Abschnitt Mitgliedschaftsoptionen festgelegt wurde. Verwenden Sie dies an beliebiger Stelle auf Ihrer Website, um dem Mitglied einen Link zur URL für den Zugang zur Mitgliedschaft zu geben. Membership. id = 123 sollte durch die ID Ihrer Mitgliedschaft ersetzt werden. Wo finde ich eine Mitgliedschafts-ID?
[mepr-membership-registration-form]
Hilfreich, wenn Sie Inhalte über und unter dem Anmeldeformular für die Mitgliedschaft platzieren möchten. Es kann NUR auf der Seite "Mitgliedschaft" verwendet werden.
[mepr-membership-registration-form id="123"]
Sie können diesen Shortcode auf einer beliebigen WordPress-Seite, einem Beitrag oder einem benutzerdefinierten Beitragstyp verwenden, um das Mitgliedschaftsregistrierungsformular für eine bestimmte Mitgliedschaft anzuzeigen. Ersetzen Sie einfach 123 mit der eindeutigen ID Ihrer eigenen Mitgliedschaft. Wo finde ich eine Mitgliedschafts-ID?
[mepr-offline-instructions gateway_id="abc-123"]Benutzerdefinierte Nachricht hier.[/mepr-offline-instructions]
Dieser Shortcode kann auf Ihren "Danke"-Seiten verwendet werden, um jede Art von Nachricht für Nutzer anzuzeigen, die sich über Ihre Offline-Gateway-Option registriert haben. Geben Sie für gateway_id="abc-123″ die ID Ihres Gateways ein. Sie kann verwendet werden, um zusätzliche Anweisungen für Benutzer bereitzustellen, wenn sie Ihre Mitgliedschaft über Ihr Offline-Gateway erwerben. Hinweis: Obwohl wir diese Funktion speziell für Offline-Gateways entwickelt haben, kann sie erfolgreich mit der Gateway-ID jedes anderen von MemberPress unterstützten Gateways verwendet werden.
[mepr-ecommerce-tracking]Nachricht mit %%variablen%% hier rein[/mepr-ecommerce-tracking]
Dieser Shortcode kann NUR auf der Dankesseite oder in benutzerdefinierten Dankesseiten-Nachrichten verwendet werden. Er funktioniert nirgendwo anders.
Es unterstützt die folgenden %%-Variablen%%, die automatisch durch Werte aus dem Einkauf ersetzt werden.
Variabel | Beschreibung |
%%subtotal%% | Gibt die Zwischensumme der ersten Zahlung aus. Handelt es sich bei der ersten Zahlung um eine kostenlose Probezeit, ist dies 0,00. Handelt es sich bei der ersten Zahlung um eine bezahlte Probezeit, ist dies die Zwischensumme der Zahlung für die Probezeit. |
%%total%% | Gibt die Zwischensumme + Steuer der ersten Zahlung aus. Handelt es sich bei der ersten Zahlung um eine kostenlose Probezeit, ist dies 0,00. Handelt es sich bei der ersten Zahlung um eine bezahlte Probezeit, ist dies die Gesamtsumme der Probezeitzahlung. |
%%tax_amount%% | Gibt den Steuerbetrag der ersten Zahlung aus. Handelt es sich bei der ersten Zahlung um eine kostenlose Testphase, ist dies 0,00. Handelt es sich bei der ersten Zahlung um eine bezahlte Probezeit, ist dies der Steuerbetrag der bezahlten Probezeit. |
%%tax_rate%% | Gibt den Steuersatz des Benutzers für diesen Kauf aus. |
%%txn_num%% | Gibt die Transaktionsnummer der ersten Zahlung aus. Bei wiederkehrenden Zahlungen wird diese Transaktionsnummer höchstwahrscheinlich eine temporäre Nummer sein, die von MemberPress generiert wird, da es einige Zeit dauert, bis das Zahlungsgateway die erste Zahlung verarbeitet. |
%%sub_id%% | Gibt die ID des wiederkehrenden Abonnements aus. Wenn der getätigte Kauf nicht wiederkehrend ist, wird diese Variable nicht ersetzt. |
%%txn_id%% | Gibt die ID der ersten Transaktion aus. Bei wiederkehrenden Abonnements wird diese ID in den meisten Fällen die ID der versteckten Kulanzperiode sein |
%%sub_num%% | Gibt die Abonnementnummer des wiederkehrenden Abonnements aus. Wenn der getätigte Kauf nicht wiederkehrend ist, wird diese Variable nicht ersetzt. Bei PayPal Standard kann dies eine temporäre Nummer sein, die von MemberPress generiert wird, da es einige Zeit dauern kann, bis das Gateway den Datensatz mit einer gültigen Abonnementnummer aktualisiert. |
%%Mitgliedschaft_Betrag%% | Gibt die regelmäßig wiederkehrenden Kosten für ein wiederkehrendes Abonnement aus. Wenn es sich nicht um einen wiederkehrenden Kauf handelt, wird diese Variable nicht ersetzt. |
%%trial_days%% | Gibt die Anzahl der Tage im bezahlten oder kostenlosen Testzeitraum für ein wiederkehrendes Abonnement aus. Wenn es sich nicht um einen wiederkehrenden Kauf handelt, wird diese Variable nicht ersetzt. |
%%estbetrag%% | Gibt die Kosten der Probezeit für ein wiederkehrendes Abonnement aus. Wenn es sich nicht um einen wiederkehrenden Kauf handelt, wird diese Variable nicht ersetzt. |
%1TP6Benutzername%% | Gibt den Benutzernamen des Mitglieds aus. Wenn Sie die MemberPress-Einstellungsseite so konfiguriert haben, dass die E-Mail-Adresse des Benutzers als Benutzername verwendet wird, dann wird hier die E-Mail-Adresse ausgegeben. |
%%user_email%% | Gibt die E-Mail-Adresse des Mitglieds aus. |
%%user_id%% | Gibt die WordPress-Benutzer-ID des Mitglieds aus. |
%%Mitgliedschaft_Name%% | Gibt den Namen (Titel) der erworbenen Mitgliedschaft aus. |
%%Mitgliedschaft_id%% | Gibt die ID der Zugehörigkeit aus. |