Plugin installation

Voraussetzungen

Prüfen Sie, ob Ihr Server die Anforderungen erfüllt. Polski for WooCommerce 1.3.2 erfordert:

Komponente	Mindestversion	Empfohlene Version
WordPress	6.4+	6.7+
WooCommerce	8.0+	9.x
PHP	8.1+	8.2+
MySQL	5.7+	8.0+
MariaDB	10.3+	10.11+

PHP-Version prüfen

Sie sind sich nicht sicher, welche PHP-Version Sie haben? Prüfen Sie es im WordPress-Dashboard:

1. Gehen Sie zu Werkzeuge > Website-Zustand
2. Klicken Sie auf den Tab Informationen
3. Klappen Sie den Abschnitt Server auf
4. Suchen Sie das Feld PHP-Version

Die PHP-Version finden Sie auch im Hosting-Panel (cPanel, DirectAdmin) unter den Domain-Einstellungen.

WooCommerce-Version prüfen

1. Gehen Sie zu Plugins > Installierte Plugins
2. Suchen Sie WooCommerce in der Liste
3. Die Version wird unter dem Plugin-Namen angezeigt

PHP 8.0 und älter

Das Plugin funktioniert nicht unter PHP 7.x oder PHP 8.0. Wenn Ihr Hosting kein PHP 8.1+ hat, ändern Sie die PHP-Version im Hosting-Panel oder wenden Sie sich an Ihren Anbieter.

---

Methode 1: Installation über das WordPress-Dashboard (empfohlen)

Dies ist die einfachste und empfohlene Installationsmethode.

Schritt 1 - das Plugin-Panel öffnen

Melden Sie sich im WordPress-Administrationsbereich an und gehen Sie zu Plugins > Neues Plugin hinzufügen.

Schritt 2 - das Plugin suchen

Geben Sie in das Suchfeld ein:

Polski for WooCommerce

Das Plugin sollte als erstes Ergebnis erscheinen. Der Autor ist wppoland.com.

Schritt 3 - das Plugin installieren

Klicken Sie auf die Schaltfläche Jetzt installieren neben dem Plugin “Polski for WooCommerce”. Warten Sie, bis WordPress die Dateien heruntergeladen und entpackt hat.

Schritt 4 - das Plugin aktivieren

Nach Abschluss der Installation ändert sich die Schaltfläche zu Aktivieren. Klicken Sie darauf, um das Plugin zu aktivieren.

Schritt 5 - zur Konfiguration übergehen

Nach der Aktivierung erscheint eine Benachrichtigung mit einem Link zum Konfigurationsassistenten. Klicken Sie auf Plugin konfigurieren oder navigieren Sie manuell zu WooCommerce > Polski.

---

Methode 2: Manuelle Installation aus einer ZIP-Datei

Verwenden Sie diese Methode, wenn Sie eine bestimmte Version installieren möchten oder der Server keine Verbindung zu WordPress.org herstellen kann.

Schritt 1 - das ZIP-Paket herunterladen

Laden Sie die neueste Version des Plugins aus einer der folgenden Quellen herunter:

• WordPress.org: https://wordpress.org/plugins/polski/
• GitHub Releases: https://github.com/wppoland/polski/releases

Schritt 2 - die ZIP-Datei hochladen

1. Gehen Sie zu Plugins > Neues Plugin hinzufügen
2. Klicken Sie oben auf der Seite auf die Schaltfläche Plugin hochladen
3. Klicken Sie auf Datei auswählen und wählen Sie die heruntergeladene ZIP-Datei aus
4. Klicken Sie auf Jetzt installieren

Schritt 3 - das Plugin aktivieren

Nach dem Hochladen und Entpacken der Dateien klicken Sie auf Plugin aktivieren.

---

Methode 3: Installation über FTP/SFTP

Verwenden Sie diese Methode, wenn das WordPress-Panel das Hochladen von Dateien nicht zulässt (z. B. wegen einer Größenbeschränkung).

Schritt 1 - das Archiv entpacken

Entpacken Sie die heruntergeladene ZIP-Datei auf Ihrem Computer. Sie erhalten einen Ordner namens polski.

Schritt 2 - auf den Server hochladen

Verbinden Sie sich per FTP/SFTP mit dem Server und laden Sie den gesamten Ordner polski in das Verzeichnis hoch:

/wp-content/plugins/

Die Struktur nach dem Hochladen sollte so aussehen:

wp-content/
  plugins/
    polski/
      polski.php
      includes/
      assets/
      ...

Schritt 3 - im Dashboard aktivieren

Gehen Sie im WordPress-Dashboard zu Plugins > Installierte Plugins und klicken Sie neben “Polski for WooCommerce” auf Aktivieren.

---

Installation über WP-CLI

Wenn Sie Terminal-Zugriff auf den Server haben, können Sie das Plugin mit einem einzigen Befehl installieren:

wp plugin install polski --activate

Um das Plugin auf die neueste Version zu aktualisieren:

wp plugin update polski

Aktuelle Version prüfen:

wp plugin get polski --fields=name,version,status

---

Installation überprüfen

Prüfen Sie nach der Aktivierung des Plugins, ob alles korrekt funktioniert:

1. Neuer Menüpunkt - im WooCommerce-Menü sollte ein Eintrag Polski erscheinen
2. Compliance-Dashboard - gehen Sie zu WooCommerce > Polski, um das Haupt-Dashboard zu sehen
3. Keine Fehler - prüfen Sie, ob auf der Seite keine PHP-Fehlermeldungen erschienen sind

Überprüfung mit einem Shortcode

Um zu überprüfen, ob das Plugin aktiv ist, fügen Sie diesen Shortcode auf einer beliebigen Seite ein:

[polski_version]

Der Shortcode zeigt die Plugin-Version an (z. B. “1.3.2”) - das bedeutet, dass die Installation funktioniert.

---

Fehlerbehebung

Das Plugin erscheint nicht in der Suche

• Prüfen Sie, ob Ihr WordPress eine Verbindung zum WordPress.org-Repository hat
• Stellen Sie sicher, dass Sie genau nach “Polski for WooCommerce” suchen
• Versuchen Sie die manuelle Installation aus einer ZIP-Datei

Fehler “Plugin requires a newer PHP version”

Ihr Server verwendet eine nicht unterstützte PHP-Version. Lösung:

1. Melden Sie sich in Ihrem Hosting-Panel an
2. Suchen Sie die PHP-Einstellungen (üblicherweise im Abschnitt “Domains” oder “Hosting”)
3. Ändern Sie die PHP-Version auf 8.1 oder neuer
4. Warten Sie einige Minuten, bis die Änderungen wirksam werden
5. Versuchen Sie erneut, das Plugin zu aktivieren

Fehler “WooCommerce is required”

Das Plugin erfordert ein aktives WooCommerce in Version 8.0 oder neuer:

1. Stellen Sie sicher, dass WooCommerce installiert und aktiv ist
2. Aktualisieren Sie WooCommerce auf die neueste Version
3. Aktivieren Sie das Plugin Polski for WooCommerce erneut

Weißer Bildschirm nach der Aktivierung

Wenn Sie nach der Aktivierung einen weißen Bildschirm sehen:

1. Aktivieren Sie den WordPress-Debug-Modus - fügen Sie zu wp-config.php hinzu:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

2. Prüfen Sie die Protokolldatei: wp-content/debug.log
3. Wenn das Problem ein Konflikt mit einem anderen Plugin ist, deaktivieren Sie die anderen Plugins und aktivieren Sie sie nacheinander

Probleme mit Dateiberechtigungen

Wenn die manuelle Installation nicht funktioniert, prüfen Sie die Berechtigungen:

# Empfohlene Berechtigungen für Verzeichnisse
chmod 755 wp-content/plugins/polski/

# Empfohlene Berechtigungen für Dateien
chmod 644 wp-content/plugins/polski/*.php

---

Plugin aktualisieren

Das Plugin wird über den Standard-Mechanismus von WordPress aktualisiert. Wenn eine neue Version verfügbar ist:

1. Sie sehen eine Benachrichtigung unter Plugins > Installierte Plugins
2. Klicken Sie auf Jetzt aktualisieren oder verwenden Sie die Massenaktualisierung
3. Prüfen Sie nach der Aktualisierung, ob der Shop korrekt funktioniert

Backup

Erstellen Sie vor der Aktualisierung ein Backup Ihrer Datenbank und Dateien. Das Hosting erledigt dies oft automatisch, aber ein manuelles Backup gibt Ihnen Gewissheit.

---

Nächste Schritte

Gehen Sie nach der Installation zur Plugin-Konfiguration, um Module zu aktivieren und die Einstellungen anzupassen.

Haben Sie ein Problem, das hier nicht aufgeführt ist? Melden Sie es auf GitHub Issues oder fragen Sie auf GitHub Discussions.

Diese Seite dient ausschließlich zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2) und wird ohne Gewährleistung bereitgestellt.