Must Use (MU) Plugin

Das Kinsta MU (pflicht) plugin wurde für unsere WordPress-Hosting-Plattform entwickelt. Es behandelt Dinge wie unsere Full-Page-Caching -Technologie sowie die Integration von Kinsta’s CDN.

Standardmäßig ist das Kinsta MU-Plugin auf jeder Seite installiert, die von uns gehostet wird, und ist auf der linken Seite deines WordPress-Admin-Dashboards verfügbar. Das Plugin ist erforderlich, um sicherzustellen, dass deine Website in unserer Umgebung reibungslos läuft.

Kinsta MU Plugin Einstellungen

Wenn du deine Seite selbst migriert oder WordPress manuell installiert hast, hast du das Kinsta MU-Plugin vielleicht nicht installiert. Wir installieren und aktualisieren das Plugin regelmäßig für alle Seiten bei Kinsta, die nicht den Composer verwenden oder das gesamte wp-content– oder mu-plugins-Verzeichnis in Git verwalten. Wenn du das Kinsta MU-Plugin manuell installieren möchtest oder musst, kannst du eine der unten aufgeführten Methoden anwenden.

Installation über SFTP

Schritt 1: Erstelle den mu-plugins Ordner

Als erstes verbinde dich mit deiner Webseite per SFTP und erstelle einen Ordner namens mu-plugins in deinem wp-content Ordner, falls er noch nicht existiert (fertiger Pfad: /wp-content/mu-plugins/).

Schritt 2: Lade das Plugin herunter und entpacke es

Nachdem du sichergestellt hast, dass der Ordner mu-plugins erstellt wurde, lade das Kinsta MU-plugin herunter und entpacke es.

Schritt 3: Lade es auf deine Seite hoch

Dann musst du den Ordner kinsta-mu-plugins und die Datei kinsta-mu-plugins.php in das Verzeichnis /wp-content/mu-plugins/ hochladen.

Dadurch wird das Plugin installiert und du kannst es in deinem WordPress-Dashboard sehen, indem du dich einloggst und zu Plugins > Must-Use gehst.

Installation über den Composer

Wenn deine Seite mit Bedrock oder einem anderen Boilerplate oder Framework erstellt wurde, das Composer verwendet, musst du einige zusätzliche Schritte unternehmen, um das Kinsta Must Use Plugin auf deiner Seite zu installieren.

Schritt 1: Deklariere das Kinsta MU Plugin-Paket-Repository

Beginne damit, das Kinsta MU-Plugin als Paket-Repository im Array repositories in deiner composer.json-Datei zu deklarieren:

{
      "type": "package",
      "package": {
        "name": "kinsta/kinsta-mu-plugins",
        "type": "wordpress-muplugin",
        "version": "2.3.7",
        "dist": {
          "url": "https://kinsta.com/kinsta-tools/kinsta-mu-plugins.zip",
          "type": "zip"
        }
      }
    }

Hinweis: Obwohl du die Versionsnummer auf eine beliebige Zahl setzen kannst (weil du das Plugin aus einer bestimmten Zip-Datei installierst), muss diese jedes Mal geändert werden, wenn du das Plugin aktualisieren musst. Wir empfehlen daher, die Version im letzten Download des Kinsta MU-Plugins zu überprüfen.

Schritt 2: Das Kinsta MU-Plugin erforderlich machen

Als Nächstes führst du den folgenden Befehl im Bedrock-Verzeichnis deiner Seite aus (oder in dem Verzeichnis, in dem sich deine composer.json-Datei befindet).

composer require kinsta/kinsta-mu-plugins

Oder du fügst das Kinsta MU-Plugin zum require-Array in deiner composer.json-Datei hinzu. Hier ist ein Beispiel für ein require Array einer Bedrock Seite, nachdem das Kinsta MU Plugin hinzugefügt wurde:

"require": {
    "php": ">=7.4",
    "composer/installers": "^2.1",
    "vlucas/phpdotenv": "^5.4",
    "oscarotero/env": "^2.1",
    "roots/bedrock-autoloader": "^1.0",
    "roots/bedrock-disallow-indexing": "^2.0",
    "roots/wordpress": "5.9.3",
    "roots/wp-config": "1.0.0",
    "roots/wp-password-bcrypt": "1.1.0",
    "kinsta/kinsta-mu-plugins": "^2.3"
  },

Schritt 3: Den Pfad für die Kinsta MU-Plugin-Assets festlegen

Um den Pfad zu den Assets festzulegen, die das MU-Plugin verwendet, füge Folgendes zur Konfigurationsdatei deiner Seite hinzu (bedrock/config/application.php in Bedrock-Seiten):

/**
 * Fix for Kinsta's CDN with Bedrock
 */
define('KINSTA_CDN_USERDIRS', 'app');

/**
 * Fix Kinsta MU Plugins URL path with Bedrock
 */
$mu_plugins_url = Config::get('WP_CONTENT_URL') . '/mu-plugins';
define('KINSTAMU_CUSTOM_MUPLUGIN_URL', "{$mu_plugins_url}/kinsta-mu-plugins");

Installieren über Git

Wenn du Git für deine Seite verwendest, hängt die Installation des Kinsta-MU-Plugins davon ab, welche Teile der Seite du mit Git verwaltest.

Wenn du das gesamte wp-content-Verzeichnis oder das mu-plugins-Verzeichnis in deinem Git-Repo verwaltest, musst du das Plugin in deinem lokalen Repo herunterladen und installieren, die Änderung committen und dann auf deiner Seite bereitstellen. Du kannst das Plugin lokal installieren, indem du es herunterlädst und die Plugin-Dateien in das mu-plugins-Verzeichnis deiner Seite legst.

Wenn du keine Kopie des Kinsta MU-Plugins in deinem Git-Repository hast, installieren wir das Kinsta MU-Plugin automatisch für dich oder du kannst es manuell per SFTP installieren.

Kinsta MU Plugin Einstellungen

Das Kinsta MU Plugin ist so eingestellt, dass es harmonisch mit WordPress und unserer Infrastruktur zusammenarbeitet. Auf den meisten Seiten muss es nicht angepasst werden. Das Plugin ermöglicht das automatische Leeren des Caches auf wichtigen Teilen deiner Seite, wenn du den Inhalt deiner Seiten und Beiträge aktualisierst.

Das Plugin wird als Kinsta Cache in der linken Seitenleiste deines WordPress Dashboards angezeigt. In der WordPress-Admin-Symbolleiste wird außerdem ein Link Caches löschen hinzugefügt.

Manuelles Löschen des Cache

Du kannst auf deiner WordPress-Seite mit den folgenden Methoden auch manuell den Cache löschen.

• Klicke auf der Seite des Kinsta Cache Plugins in deinem WordPress Dashboard auf die Schaltfläche Alle Caches löschen.
• Klicke auf den Link Caches löschen in der WordPress-Admin-Symbolleiste.
• Lösche den Cache der Seite und den CDN-Cache in MyKinsta. (Wenn Edge Caching aktiviert ist, wird durch das Löschen des Website-Caches in MyKinsta auch der Edge Cache gelöscht).
• Führe wp kinsta cache purge --all in der Kommandozeile aus..

Hinzufügen von benutzerdefinierten Caching-URLs

Wir löschen wichtige Seiten wie die Startseite sofort und setzen eine minimale Drosselzeit für Archivseiten fest. So ist eine hohe Verfügbarkeit zu jeder Zeit gewährleistet. Je nach Konfiguration deiner Seite müssen jedoch möglicherweise zusätzliche Caching-Regeln festgelegt werden. Du kannst benutzerdefinierte Pfade hinzufügen, die bei jeder Aktualisierung deiner Website gelöscht werden.

1. Hinzufügen einer benutzerdefinierten Einzelpfad-URL

Wenn du den Cache für eine bestimmte URL (Beitrag oder Seite) löschen musst, gibst du dies als einzelne Pfadregel auf der Seite des Kinsta-Cache-Plugins in deinem WordPress-Dashboard ein. Beispiele:

• important-page
• important-page/

2. Hinzufügen einer benutzerdefinierten Gruppenpfad-URL

Der Gruppenpfad löscht alle URLs, die mit dieser bestimmten URL beginnen. Dies kann besonders nützlich sein, wenn du über einen benutzerdefinierten Beitragstyp verfügst und der Cache und die darauf befindlichen Beiträge gelöscht werden müssen. Wenn du beispielsweise https://yourdomain.com/custom-post-type/ als Gruppenpfad-URL hinzufügst, wird der Cache folgendermaßen gelöscht:

https://yourdomain.com/custom-post-type/
https://yourdomain.com/custom-post-type/post-1
https://yourdomain.com/custom-post-type/post-2
https://yourdomain.com/custom-post-type/post-3

Zusätzliche Notiz

Du darfst nicht nur „/“ als Pfad hinzufügen, da sonst bei jeder Aktualisierung eines Beitrags oder einer Seite der gesamte Cache der Seite gelöscht wird. Das Leeren des gesamten Caches würde die Serverressourcen stark beanspruchen, vor allem bei hohen Ladezeiten und häufigen Veröffentlichungen. Dies kann auch die Leistung deiner Website für Besucher beeinträchtigen, da alles neu zwischengespeichert werden muss.

Wenn du Kunden hast und es vorziehst, dass sie kein Kinsta-Branding sehen, kannst du das Plugin auch mit weißer Beschriftung versehen.

Das Kinsta MU-Plugin aktualisieren

Wenn deine Seite weder Composer noch Git nutzt, aktualisieren wir das Kinsta MU-Plugin automatisch und regelmäßig für dich. Du musst nichts weiter tun, um das Plugin auf dem neuesten Stand zu halten.

Aktualisierung über SFTP

Wenn du das Plugin manuell aktualisieren musst (z.B. weil du ein älteres Backup wiederhergestellt hast oder ein Update nicht wie geplant verlaufen ist), kannst du das Kinsta MU Plugin per SFTP aktualisieren.

1. Lade das Kinsta MU-Plugin herunter und entpacke es.
2. Lade den Ordner kinsta-mu-plugins und die Datei kinsta-mu-plugins.php in das Verzeichnis /wp-content/mu-plugins/ hoch und überschreibe die vorhandenen Dateien, wenn du von deinem SFTP-Kunden dazu aufgefordert wirst.
3. Dadurch werden die alten Plugin-Dateien mit den neuen überschrieben und das Plugin auf die neueste Version aktualisiert.

Aktualisierung über den Composer

1. Aktualisiere die Versionsnummer in der Deklaration des Kinsta MU-Plugins in deiner composer.json-Datei:
   Copy

   {
         "type": "package",
         "package": {
           "name": "kinsta/kinsta-mu-plugins",
           "type": "wordpress-muplugin",
           "version": "2.3.7",
           "dist": {
             "url": "https://kinsta.com/kinsta-tools/kinsta-mu-plugins.zip",
             "type": "zip"
           }
         }
       }

2. Führe composer update kinsta/kinsta-mu-plugins im Bedrock-Verzeichnis deiner Seite aus (oder in dem Verzeichnis, in dem sich deine composer.json-Datei befindet).

Aktualisieren über Git

Wenn du Git für deine Seite verwendest, hängt der Prozess der Aktualisierung des Plugins davon ab, welche Teile der Seite du mit Git verwaltest.

Wenn du das gesamte wp-content-Verzeichnis oder das mu-plugins-Verzeichnis in deinem Git-Repo verwaltest, musst du das Plugin in deinem lokalen Repo aktualisieren, die Änderung committen und sie dann auf deiner Seite bereitstellen. Du kannst das Plugin lokal aktualisieren, indem du es herunterlädst und die vorhandenen Plugin-Dateien in deinem Repo überschreibst.

Wenn du keine Kopie des Kinsta MU-Plugins in deinem Git-Repository hast, aktualisieren wir das Kinsta MU-Plugin automatisch für dich; du musst nichts weiter tun.

White Label und Anpassung des Kinsta MU Plugins

Mit der Einführung des Kinsta MU-Plugins haben wir etwas Kinsta-Branding hinzugefügt, um dir die Navigation im WordPress-Admin-Dashboard zu erleichtern. Zum Beispiel ist der Kinsta Cache-Reiter in der Sidebar des Admin-Dashboards mit einem Kinsta-Logo versehen, so dass du schnell die richtige Stelle findest, um den Cache deiner Webseite zu leeren, wenn es nötig ist.

Für Agenturen und andere Kinsta-Kunden, die das Kinsta-Branding aus dem WordPress-Admin-Dashboard entfernen möchten, bieten wir eine eingebaute White Labeling-Option. Diese Funktion ist besonders nützlich, wenn du Hosting für deine eigenen Kunden nutzt oder an sie weiterverkaufst.

Das Aktivieren des White Labeling wird drei Elemente im WordPress Dashboard verändern.

1. Der gebrandete Kinsta Cache-Sidebar-Link wird in einen ungebrandeten Cache-Einstellungen-Link geändert.
2. Die Meldung Danke für die Erstellung mit WordPress und das Hosting bei Kinsta am unteren Rand des Dashboards wird durch Danke für die Erstellung mit WordPress ersetzt.
3. Das Kinsta-Logo auf der Cache Control-Seite wird entfernt oder durch ein Bild deiner Wahl ersetzt.
4. Die Links zur Kinsta Dokumentation und zum Support werden entfernt.

Wie man eine Kinsta Seite whitelabeled

Um deinen Admin mit einem White Label zu versehen, musst du eine Konstante definieren, am besten in der Datei wp-config.php, vor dem * That's all, stop editing! Happy publishing. */ Zeile. Wenn du KINSTAMU_WHITELABEL auf true setzt, wird das Kinsta-Branding wie oben beschrieben entfernt.

Hier ist ein Beispiel für eine White Label-Konfiguration in der wp-config.php.

/* Kinsta MU Plugin White Labeling */ define ('KINSTAMU_WHITELABEL', true);

/* That's all, stop editing ! Happy  publishing . */

Einen eigenen Pfad zum MU-Plugin-Verzeichnis definieren

Das Plugin verwendet die Variable WPMU_PLUGIN_URL WP, um Pfade zu den Assets des Plugins zu definieren. Das funktioniert in der Regel auf allen Seiten, aber falls nicht, kannst du den Pfad zu deinem MU-Plugin-Ordner mit der Konstante KINSTAMU_CUSTOM_MUPLUGIN_URL festlegen.

Hier ist ein Beispiel für einen benutzerdefinierten MU-Plugin-Pfad in der wp-config.php.

/* Custom MU plugin path */ define ( 'KINSTAMU_CUSTOM_MUPLUGIN_ URL ', 'http://kinstaexample.com/custom-wp-content/mu-plugins')

/* That's all, stop editing ! Happy  publishing . */

Definiere eine Fähigkeit für den Zugang

Die Konstante KINSTAMU_CAPABILITY legt fest, welche Fähigkeit ein Benutzer haben muss, um die Plugin-Administrationsfunktionen zu nutzen. Sie akzeptiert jede der standardmäßigen WordPress-Rollen und -Fähigkeiten, wie activate_plugins oder publish_pages. Hier ist ein Beispiel, in dem die Konstante KINSTAMU_CAPABILITY hinzugefügt wurde:

/* Capability to use the caching  plugin */ define ('KINSTAMU_CAPABILITY',' publish _ pages ');

/* That's all, stop editing ! Happy  publishing . */

White Labeling deaktivieren

Um das White Labeling zu deaktivieren, entfernst du einfach alle Konstanten aus der wp-config.php. White Labeling ist nur ein Beispiel für die umfangreichen Funktionen von Kinsta, die sowohl für WordPress-Agenturen als auch für Einzelanwender geeignet sind. Wenn du dich für andere Funktionen zur Verwaltung von Seiten in Kinsta interessierst, dann sieh dir unsere Tools für das Labeling und die Umbenennung von Seiten an!