AgentNice Client-Plugin Setup

Voraussetzungen prüfen

WordPress und PHP

Stelle sicher, dass deine Installation mindestens WordPress 6.5 und PHP 8.3 nutzt. Du siehst die Versionen unter Werkzeuge → Website-Zustand → Bericht.

Konfliktierende SMTP-Plugins

Wenn du WP Mail SMTP, Easy WP SMTP, Fluent SMTP oder Post SMTP installiert und aktiv hast, deaktiviere sie. AgentNice übernimmt SMTP zentral — parallele Plugins führen zu Konflikten beim Mail-Versand.

Zugriff auf wp-config.php

Du brauchst Zugriff auf deine wp-config.php — entweder per FTP/SFTP, per SSH oder über den Datei-Manager deines Hosters (z.B. Plesk, KAS, hPanel).

SMTP-Postfach

Du brauchst ein eingerichtetes Mail-Postfach bei deinem Hoster oder einem externen Mail-Provider, plus die zugehörigen Login-Daten.

1. Client-Plugin installieren und Lizenzkey eintragen

1. Logge dich in dein Kunden-Dashboard auf danpardella.de/mein-konto ein und lade dort die ZIP-Datei agentnice-client-latest.zip aus dem Download-Bereich herunter.
2. Logge dich in deiner WordPress-Site als Administrator ein.
3. Gehe zu Plugins → Installieren → Plugin hochladen.
4. Wähle die heruntergeladene ZIP-Datei aus und klicke auf Jetzt installieren.
5. Nach der Installation: Plugin aktivieren.

Lizenzkey eintragen

Nach der Aktivierung findest du im WordPress-Admin links den Menüpunkt AgentNice → Widget. Trage dort deinen Lizenzkey aus der Welcome-Mail ein.

Die Felder Server-URL und Domain werden automatisch befüllt und sind in der Regel korrekt. Wenn die Server-URL als „überschrieben durch Konstante“ markiert ist, ist das richtig — die wp-config.php hat Vorrang.

2. wp-config.php konfigurieren

Wo finde ich wp-config.php?

• FTP/SFTP: Verbinde dich mit deinem Webspace per FileZilla, Cyberduck o.ä. wp-config.php liegt im Root-Verzeichnis deiner WordPress-Installation (dort, wo auch wp-admin/, wp-content/, wp-includes/ liegen).
• SSH: Verbinde dich per SSH und öffne die Datei mit nano oder vim, z.B. nano /var/www/deine-site/wp-config.php.
• Hoster-Datei-Manager: Plesk, KAS, hPanel und ähnliche Tools haben einen eingebauten Datei-Manager. Suche dort nach wp-config.php.

Wo einfügen?

Füge den folgenden Code ein, bevor die Zeile /* Das war's, Schluss mit dem Bearbeiten! */ (auf Englisch: /* That's all, stop editing! */) erscheint.

Code zum Einfügen

// AgentNice Client-Konfiguration
define( 'AN_CLIENT_SERVER_URL', 'https://www.danpardella.de' );
define( 'AN_SECRET_ENCRYPTION_KEY', 'aus_welcome_mail' );
define( 'AN_CLIENT_SECRET', 'an_sec_xxx' );

// SMTP-Konfiguration (Werte je nach Hoster, siehe Sektion 3)
define( 'AN_SMTP_HOST', 'smtp.dein-provider.de' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );
define( 'AN_SMTP_PASS', 'dein-passwort' );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_FROM', 'deine-mail@deine-domain.de' );

// Optional: Anzeigename des Absenders
define( 'AN_SMTP_FROM_NAME', 'Dein Firmenname' );

Was bedeuten die Konstanten?

3. SMTP-Werte für deinen Hoster

Wähle deinen Hoster aus der Liste unten. Die Werte sind im Mai 2026 geprüft. Wenn etwas nicht passt, prüfe im Hoster-Backend deines Anbieters die aktuellen Werte — Hoster ändern Ports und Server-Hostnamen gelegentlich.

define( 'AN_SMTP_HOST', 'webXXX.alfahosting-server.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'wXXXXXX.kasserver.com' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'mail.your-server.de' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'smtp.hostinger.com' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'smtp.ionos.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'mail.agenturserver.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'mxXXXX.netcup.net' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'smtp.strato.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'sXX.goserver.host' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'deine-domain.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'deine-domain.de' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'stardust.uberspace.de' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'smtp.qboxmail.com' );
define( 'AN_SMTP_PORT', 587 );
define( 'AN_SMTP_SECURE', 'tls' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

define( 'AN_SMTP_HOST', 'smtp.mailbox.org' );
define( 'AN_SMTP_PORT', 465 );
define( 'AN_SMTP_SECURE', 'ssl' );
define( 'AN_SMTP_USER', 'deine-mail@deine-domain.de' );

4. Verbindungsstatus prüfen

Nach allen Konfigurations-Schritten kannst du im AgentNice-Admin prüfen, ob die Verbindung zum Server steht und der Mail-Versand funktioniert. Gehe dazu im WordPress-Admin auf AgentNice → Status.

Verbindungsstatus

Im oberen Bereich siehst du drei Statuszeilen:

• Lizenz: Bei aktiver Lizenz steht hier active mit Ablaufdatum und der hinterlegten Domain. Bei roten Status liegt entweder ein falscher Lizenzkey, ein falsches Client-Secret oder eine abgelaufene Lizenz vor.
• SMTP: Bei korrekt konfigurierten SMTP-Konstanten zeigt diese Zeile konfiguriert mit Host und Port. Wenn rot: prüfe, ob alle SMTP-Konstanten in wp-config.php gesetzt sind, inklusive AN_SMTP_FROM.
• Agent-Config: Diese Zeile zeigt den Cache-Status der Agent-Konfiguration. kein Cache ist normal kurz nach dem Setup. Über den Button Jetzt neu laden ziehst du die aktuelle Konfiguration vom Server. Tust du das, sobald du im AgentNice-Admin auf danpardella.de Änderungen am Agent vorgenommen hast.

Konfigurations-Tabelle

Darunter siehst du alle gesetzten Werte mit Quellangabe (Datenbank oder wp-config.php). Diese Tabelle ist hilfreich für die Fehlersuche — du erkennst auf einen Blick, ob alle erwarteten Werte richtig hinterlegt sind. Sensitive Werte wie Lizenzkey, Client-Secret und SMTP-Passwort werden maskiert dargestellt.

Plugin-Konflikt-Hinweis

Wenn ein konkurrierendes SMTP-Plugin (WP Mail SMTP, Easy WP SMTP, Fluent SMTP, Post SMTP) aktiv ist, zeigt das Status-Panel oben einen gelben Konflikt-Banner und unterhalb der Konfigurations-Tabelle einen Plugin-Konflikte-Bereich mit dem Plugin-Slug.

Lösung: Das angezeigte Plugin im WordPress-Plugin-Bereich deaktivieren. AgentNice übernimmt das SMTP-Routing zentral — parallele Plugins führen zu unkontrolliertem Mail-Versand.

5. Test-Mail senden

Im Status-Panel findest du den Bereich Test-Versand. Trage hier eine Empfänger-Adresse ein und klicke auf Test-Mail senden.

Was du erwartest

• Eine grüne Erfolgsmeldung im Admin direkt nach dem Klick.
• Die Test-Mail kommt innerhalb von Sekunden im Postfach des Empfängers an.
• Im Mail-Header siehst du als Absender (From:) deine AN_SMTP_FROM-Adresse — nicht den WordPress-Standard wordpress@deine-domain.de.

Wenn nichts ankommt

Prüfe in dieser Reihenfolge:

1. Spam-Ordner des Empfängers.
2. Status-Panel: Sind Lizenz und SMTP wirklich grün?
3. SPF/DKIM: Siehe nächste Sektion — fehlende Mail-Authentifizierung ist die häufigste Ursache für ankommende, aber als Spam markierte Mails.
4. Wenn die Erfolgsmeldung im Admin schon rot war: weiter zur Troubleshooting-Sektion.

6. SPF, DKIM, DMARC — Mail-Authentifizierung

Damit deine versendeten Mails bei Empfängern wie Gmail, Outlook oder GMX zuverlässig im Posteingang landen — und nicht im Spam — brauchst du drei DNS-Einträge: SPF, DKIM und DMARC. Diese sagen den Empfänger-Mailservern, dass dein Server berechtigt ist, in deinem Namen Mails zu verschicken.

Was die drei Einträge bedeuten

• SPF (Sender Policy Framework) legt fest, welche Server für deine Domain Mails versenden dürfen. Ein TXT-Eintrag im DNS deiner Domain.
• DKIM (DomainKeys Identified Mail) signiert ausgehende Mails kryptografisch. Empfänger können prüfen, dass die Mail tatsächlich von deinem Server stammt und unterwegs nicht verändert wurde.
• DMARC (Domain-based Message Authentication, Reporting & Conformance) definiert, was passiert, wenn SPF oder DKIM scheitern — Mail ablehnen, in Spam verschieben, oder nur reporten.

Wer richtet das ein?

Diese Einträge gehören in deine DNS-Verwaltung — nicht in AgentNice. Bei vielen DACH-Hostern (Hetzner, IONOS, Strato, Mittwald, All-Inkl) lassen sich SPF und DKIM mit ein bis zwei Klicks im Hoster-Backend aktivieren. DMARC trägst du als zusätzlichen TXT-Eintrag selbst ein.

Bei externen Mail-Providern wie qboxmail oder mailbox.org bekommst du nach Einrichtung deines Mail-Hostings eine Liste mit DNS-Einträgen, die du in deiner DNS-Verwaltung hinterlegen musst. Ohne DKIM-Eintrag landen deine Mails häufig im Spam.

Schnell-Check

Mit mail-tester.com kannst du in 30 Sekunden prüfen, wie deine Mail-Authentifizierung aussieht. Sende eine Test-Mail an die dort angezeigte Adresse — du bekommst einen Score von 0 bis 10 mit konkreten Verbesserungs-Hinweisen.

Alternativ: mxtoolbox.com liefert detailliertere DNS-Diagnostik.

7. Wenn etwas nicht funktioniert

Klick die jeweilige Frage auf, um Lösungsschritte zu sehen.

AN_SMTP_HOST, AN_SMTP_PORT, AN_SMTP_USER, AN_SMTP_PASS, AN_SMTP_SECURE, AN_SMTP_FROM

Wie geht’s weiter?

Dein AgentNice Client-Plugin ist eingerichtet, die Verbindung steht und der Mail-Versand funktioniert. Was als nächstes?

• Forms im Agent konfigurieren — Forms erstellst du im AgentNice-Admin auf danpardella.de. Sobald du sie speicherst, ziehen sie automatisch in den Agent auf deiner Site (ggf. einmal Agent-Config neu laden).
• Theming pro Lizenz — Farben, Schriften und Tonalität deines Agents passt du im AgentNice-Admin an. Änderungen werden bei der nächsten Agent-Config-Aktualisierung wirksam.

Support

Wenn nach allen Schritten in der Troubleshooting-Sektion noch etwas nicht funktioniert, melde dich bei hej@danpardella.de mit:

• Deinem Lizenzkey (die ersten 8 Zeichen reichen, z.B. AN-K4CR-...)
• Eine kurze Beschreibung des Problems
• Screenshot des Status-Panels

Antwort meist innerhalb eines Werktags.

← Zurück zur Doku-Übersicht