### [Erstellen eines benutzerdefinierten Smart Tags](https://wpforms.com/developers/how-to-create-a-custom-smart-tag/) **Veröffentlicht:** 28. Juli 2020 **Autor:** Umair Majeed **Auszug:** Dieses Tutorial zeigt Ihnen, wie Sie einen benutzerdefinierten Smart Tag für die Verwendung in Ihren WPForms erstellen. **Inhalt:** Möchten Sie einen personalisierten Smart Tag erstellen, um die Funktionalität Ihrer Formulare zu erweitern? Wenn Sie einen benutzerdefinierten Smart Tag integrieren möchten, z. B. um einen Download-Link in eine E-Mail-Benachrichtigung oder eine Bestätigungsnachricht einzubetten, ist der Prozess mit einem benutzerdefinierten Code-Snippet unkompliziert. In dieser Anleitung führen wir Sie durch die Schritte zur Verwendung von PHP, um einen maßgeschneiderten Smart Tag zu erstellen. Smart Tags sind eine praktische Möglichkeit, bestimmte Daten dynamisch in Formularfelder oder Benachrichtigungs-E-Mails abzurufen. WPForms bietet eine Fülle von integrierten Smart Tags, die Informationen wie die URL der aktuellen Seite oder die E-Mail-Adresse eines angemeldeten Benutzers abrufen können. Für ein umfassendes Verständnis der vordefinierten Smart Tags in WPForms lesen Sie bitte [unsere Dokumentation](https://wpforms.com/docs/how-to-use-smart-tags-in-wpforms/ "How to Use Smart Tags in WPForms"). ## Erstellen des benutzerdefinierten Smart Tags Im folgenden Beispiel zeigen wir, wie Sie einen neuen benutzerdefinierten Smart Tag erstellen, der speziell dafür entwickelt wurde, eine URL für einen Download-Link anzuzeigen, sobald ein Formular ausgefüllt wurde. Der Prozess umfasst zwei PHP-Funktionen, die jeweils einen bestimmten Zweck erfüllen. Die erste Funktion ist für die Erstellung des Smart Tags verantwortlich. Sie ist so konzipiert, dass nur grundlegende Namensänderungen erforderlich sind, um sie für jeden anderen Smart Tag anzupassen. Die zweite Funktion ist der Ort, an dem der Großteil des Codes implementiert wird. Innerhalb der `if`-Anweisung müssen Sie den erforderlichen Code hinzufügen, um den/die Wert(e) abzurufen, die dieser Smart Tag anzeigen soll. Kopieren und fügen Sie einfach beide Funktionen auf Ihrer Website ein und passen Sie den Namen des Smart Tags nach Bedarf an. Wenn Sie nicht sicher sind, wo oder wie Sie Snippets zu Ihrer Website hinzufügen können, lesen Sie bitte [dieses Tutorial](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/ "How to Add Custom PHP or JavaScript for WPForms"). ``` /** * Registriert den Smart Tag, damit er im Formular-Builder ausgewählt werden kann. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_register_smarttag( $tags ) { // Key ist der Tag, item ist der Tag-Name. $tags[ 'download_link' ] = 'Download Link'; return $tags; } add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 ); /** * Verarbeitet den Smart Tag. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_process_smarttag( $content, $tag ) { // Nur ausführen, wenn es sich um unseren gewünschten Tag handelt. if ( 'download_link' === $tag ) { // Ersetzen Sie unseren Link in dieser Demo durch die URL, die Sie bereitstellen möchten $link = 'https://yoursite.com/file.pdf'; // Ersetzen Sie den Tag durch unseren Link. $content = str_replace( '{download_link}', $link, $content ); } return $content; } add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 ); ``` **Hinweis:** Smart Tag-Namen dürfen nur Kleinbuchstaben, Ziffern und einen Unterstrich enthalten. ## Erstellen des Formulars Als Nächstes erstellen wir ein einfaches Newsletter-Formular. Wenn sich Benutzer für unseren Newsletter anmelden, möchten wir ihnen einen kostenlosen Link zum Herunterladen eines eBooks anbieten. Dies ist eine hervorragende Veranschaulichung der Möglichkeiten von WPForms Smart Tags. Sobald dieser Smart Tag eingerichtet ist, können Sie ihn mühelos in zukünftige Formularerstellungen integrieren, ohne zusätzliche Codeanpassungen vornehmen zu müssen. Wenn Sie Hilfe beim Erstellen eines Formulars benötigen, lesen Sie bitte [diese Dokumentation](https://wpforms.com/docs/creating-first-form/ "How to Create Your First Form"). ## Verwenden des neuen benutzerdefinierten Smart Tags Nun wollen wir unseren neu erstellten benutzerdefinierten Smart Tag verwenden. In diesem Tutorial integrieren wir den Smart Tag für unseren Download-Link in unsere E-Mail-Benachrichtigungen. Navigieren Sie zum Formular-Builder und klicken Sie auf **Einstellungen**, dann wählen Sie **Benachrichtigungen**. Scrollen Sie in den **Benachrichtigungseinstellungen** nach unten zum Feld **E-Mail-Nachricht**. Klicken Sie auf den Link **Smart Tags anzeigen** und durchsuchen Sie die verfügbaren Smart Tags, bis Sie den Smart Tag **Download Link** finden. Wählen Sie ihn einfach aus, und er wird automatisch in die Benachrichtigungsvorlage eingefügt. ## FAQ #### Kann ich einen Smart Tag erstellen, um die aktuelle Locale der Website dynamisch hinzuzufügen? Ja, Sie können einen benutzerdefinierten Smart Tag erstellen, um die aktuelle Locale Ihrer Website abzurufen (z. B. „fr“, „de“, „en“). Hier ist, wie Sie dies implementieren können: ``` /** * Registriert den Smart Tag, damit er im Formular-Builder ausgewählt werden kann. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ */ function wpf_dev_register_smarttag( $tags ) { // Key ist der Tag, item ist der Tag-Name. $tags[ 'page_locale' ] = 'Get Locale'; return $tags; } add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 ); /** * Verarbeitet den Smart Tag. * * @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/ * * WordPress get_locale(): https://developer.wordpress.org/reference/functions/get_locale/ */ function wpf_dev_process_smarttag( $content, $tag ) { // Nur ausführen, wenn es sich um unseren gewünschten Tag handelt. if ( 'page_locale' === $tag ) { // Speichert die von der Funktion get_locale() zurückgegebene Locale in der Variablen $locale $locale = get_locale(); // Ersetzen Sie den Tag durch den Wert der Variablen $locale. $content = str_replace( '{page_locale}', $locale, $content ); } return $content; } add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 ); ``` Dieses Snippet erstellt einen neuen Smart Tag namens „Get Locale“ unter Verwendung der WordPress-Funktion `get_locale()`. Nachdem Sie das Snippet hinzugefügt haben, können Sie den `{page_locale}` Smart Tag in Ihren Formularen, E-Mail-Benachrichtigungen oder Bestätigungsnachrichten verwenden. Und das ist alles! Sie haben erfolgreich einen neuen benutzerdefinierten Smart Tag erstellt. Möchten Sie diesen benutzerdefinierten Smart Tag in einem **HTML**-Formularfeld verarbeiten können? Wenn ja, schauen Sie sich unseren Artikel über [Verarbeitung von Smart Tags in HTML-Feldern](https://wpforms.com/developers/how-to-process-smart-tags-in-html-fields/ "How to Process Smart Tags in HTML Fields") an. ## Referenzfilter - [wpforms\_smart\_tags](https://wpforms.com/developers/wpforms_smart_tags/ "Using the wpforms_smart_tags filter") - [wpforms\_smart\_tag\_process](https://wpforms.com/developers/wpforms_smart_tag_process/ "Using the wpforms_smart_tag_process filter") **Kategorien:** Tutorials **Tags:** PHP, Smart Tag ---