De Kinsta MU (Must-Use) plugin is ontworpen om te werken op ons WordPress hostingplatform. Hij regelt zaken als onze volledige paginacaching technologie en Kinsta’s CDN integratie.

De Kinsta MU plugin is standaard geïnstalleerd op elke site die we hosten en is beschikbaar aan de linkerkant van je WordPress admindashboard. De plugin is vereist om ervoor te zorgen dat je site soepel draait in onze omgeving.

De Kinsta MU plugin installeren

Als je je site zelf hebt gemigreerd of WordPress handmatig hebt geïnstalleerd, is het mogelijk dat je de Kinsta MU plugin niet hebt geïnstalleerd. We installeren en updaten de plugin periodiek voor elke site bij Kinsta die geen Composer gebruikt of de hele wp-content directory of mu-plugins directory in Git beheert. Als je de Kinsta MU plugin liever handmatig installeert (of moet), kun je dat doen door een van de onderstaande methoden te volgen.

Installeren via SFTP

Stap 1: Map mu-plugins aanmaken

Maak verbinding met je site via SFTP en maak een map genaamd mu-plugins in je wp-content map als die nog niet bestaat (volledig pad: /wp-content/mu-plugins/).

De map mu-plugins in FTP.
De map mu-plugins in FTP.

Stap 2: De plugin downloaden en uitpakken

Nadat je er zeker van bent dat de mu-plugins map is aangemaakt, download je de Kinsta MU plugin en pak je hem uit.

Stap 3: Uploaden naar de site

Upload de map kinsta-mu-plugins en het bestand kinsta-mu-plugins.php naar de map /wp-content/mu-plugins/ .

Kinsta MU plugin map en bestand in FTP.
Kinsta MU plugin map en bestand in FTP.

Dit zal de plugin installeren, en je kunt hem zien in je WordPress dashboard door in te loggen en naar Plugins > Must-Use te gaan.

Installeren via Composer

Als je site gebouwd is met Bedrock of een ander boilerplate of framework dat Composer gebruikt, moet je wat extra stappen nemen om de Kinsta Must Use plugin op je site te installeren.

Stap 1: Declare de repository van het Kinsta MU plugin pakket

Begin met het declareren van de Kinsta MU plugin als pakketrepository in de repositories array in je composer.json bestand:


    {
      "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"
        }
      }
    }

Opmerking: Hoewel je technisch gezien het versienummer op alles kunt instellen (omdat je de plugin installeert vanuit een specifiek zip-bestand) zal dit elke keer dat je de plugin moet bijwerken veranderd moeten worden, dus we raden aan om de versie in de laatste download van de Kinsta MU plugin te controleren.

Stap 2: Gebruik require op de Kinsta MU plugin

Voer vervolgens het volgende commando uit in de bedrock directory van je site (of de directory waar je composer.json bestand staat).

composer require kinsta/kinsta-mu-plugins

Of voeg de Kinsta MU plugin toe aan de require array in je composer.json bestand. Hier is een voorbeeld require array van een Bedrock site na toevoeging van de Kinsta MU plugin:


"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"
  },

Stap 3: Bevestig het pad voor de assets van de Kinsta MU plugin

Voeg het volgende toe aan het configuratiebestand van je site (bedrock/config/application.php in Bedrock sites) om het pad naar assets die door de MU plugin worden gebruikt vast te leggen:

/**
 * 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");

Installeren via Git

Als je Git gebruikt voor je site, hangt het installeren van de Kinsta MU plugin af van welke delen van de site je beheert met Git.

Als je de hele wp-content directory of mu-plugins directory in je Git repo beheert, zul je de plugin in je lokale repo moeten downloaden en installeren, die wijziging vastleggen en dan naar je site deployen. Je kunt de plugin lokaal installeren door hem te downloaden en de plugin bestanden in de mu-plugins map van je site te plaatsen.

Als je geen kopie van de Kinsta MU plugin in je Git repo onderhoudt, zullen we de Kinsta MU plugin automatisch voor je installeren, of je kunt SFTP gebruiken om hem handmatig te installeren.

Instellingen Kinsta MU plugin

De Kinsta MU plugin is ingesteld om harmonieus samen te werken met WordPress en onze infrastructuur. Op de meeste sites zal het geen aanpassingen nodig hebben. De plugin zorgt ervoor dat de cache van belangrijke delen van je site automatisch wordt gewist wanneer je de content van je pagina’s en berichten bijwerkt.

De plugin verschijnt als Kinsta Cache in de linkerzijbalk van je WordPress dashboard. Er wordt ook een Clear Caches link toegevoegd aan de WordPress admin toolbar.

Kinsta Cache plugin (Kinsta MU plugin) in het WordPress dashboard.
Kinsta Cache plugin (Kinsta MU plugin) in het WordPress dashboard.

Cache handmatig wissen

Je kunt de cache op je WordPress site ook handmatig wissen met een van de volgende methoden.

  • Klik op de Clear All Caches knop op de Kinsta Cache plugin pagina in je WordPress dashboard.
  • Klik op de link Clear Caches op de admin toolbar van WordPress.
  • Wis de Site cache en CDN cache in MyKinsta. (Als Edge Caching is ingeschakeld, wordt door het wissen van de Site cache in MyKinsta ook de Edge Cache gewist).
  • Voer wp kinsta cache purge --all uit in de command line.
Wis de cache met de Clear Caches link in het WordPress dashboard.
Wis de cache met de Clear Caches link in het WordPress dashboard.

Aangepaste caching URL’s toevoegen

We wissen onmiddellijk belangrijke pagina’s, zoals de homepage, en leggen een minimale throttle tijd op aan archiefpagina’s. Dit zorgt te allen tijde voor een hoge beschikbaarheid. Afhankelijk van de configuratie van je site kunnen er echter extra cachingregels nodig zijn. Je kunt aangepaste paden toevoegen om te worden geleegd wanneer je site wordt bijgewerkt.

1. Aangepast pad toevoegen

Als je de cache wilt wissen voor een exacte URL (bericht of pagina), voer dit dan in als een enkele padregel op de Kinsta Cache plugin pagina in je WordPress dashboard. Voorbeelden:

  • important-page
  • important-page/
Aangepaste URL enkel pad in Kinsta Cache.
Aangepaste URL enkel pad in Kinsta Cache.

2. Groepspad aangepaste URL toevoegen

Het groepspad wist alle URL’s die beginnen met die specifieke URL. Dit kan vooral handig zijn als je een aangepast berichttype hebt en de cache daarvan en van de berichten eronder moet worden gewist. Bijvoorbeeld, als je https://yourdomain.com/custom-post-type/ toevoegt als groepspad URL, dan zal het de cache legen op het volgende:

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
Aangepaste URL groepspad in Kinsta Cache.
Aangepaste URL groepspad in Kinsta Cache.

Extra opmerkingen

Het is niet toegestaan om alleen “/” als pad toe te voegen, omdat dit zou leiden tot het wissen van de hele cache van de site bij elke update van een bericht of pagina. Het wissen van alle cache op deze manier zou een aanzienlijke tol eisen van de serverresources, vooral bij hoge laadtijden en frequente publicatieschema’s. Dit zou ook de prestaties van je site voor bezoekers kunnen verslechteren, omdat hij alles opnieuw zou moeten cachen.

Als je klanten hebt en liever geen Kinsta branding ziet, kun je de plugin ook whitelabelen.

De Kinsta MU plugin bijwerken

Als je site geen Composer of Git gebruikt, zullen we de Kinsta MU plugin met regelmaat automatisch voor je bijwerken. Je hoeft niets meer te doen om de plugin bijgewerkt te houden.

Updaten via SFTP

Als je de plugin handmatig moet bijwerken (misschien heb je een oudere backup teruggezet of ging een update niet zoals gepland), dan kun je SFTP gebruiken om de Kinsta MU plugin handmatig bij te werken.

  1. Download de Kinsta MU plugin en pak hem uit.
  2. Upload de map kinsta-mu-plugins en het bestand kinsta-mu-plugins.php naar de map /wp-content/mu-plugins/ en overschrijf de bestaande bestanden als je SFTP-client daarom vraagt.
  3. Dit zal de oude pluginbestanden overschrijven met de nieuwe om de plugin bij te werken naar de nieuwste versie.

Bijwerken via Composer

  1. Werk het versienummer bij in de Kinsta MU plugin repository declaration in je composer.json bestand: 
        {
      "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. Voer composer update kinsta/kinsta-mu-plugins uit in de bedrock map van je site (of de map waar je composer.json bestand staat).

Bijwerken via Git

Als je Git gebruikt met je site, hangt het proces van het bijwerken van de plugin af van welke delen van de site je beheert met Git.

Als je de hele wp-content directory of mu-plugins directory in je Git repo beheert, zul je de plugin in je lokale repo moeten bijwerken, die wijziging vastleggen en dan naar je site deployen. Je kunt lokaal bijwerken door de plugin te downloaden en de bestaande plugin-bestanden in je repo te overschrijven.

Als je geen kopie van de Kinsta MU plugin in je Git repo onderhoudt, zullen we de Kinsta MU plugin automatisch voor je bijwerken; je hoeft dan niets meer te doen.