Kinsta Must Use (MU) plugin

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 door ons gehoste site en is beschikbaar via 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 installeren, 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/).

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/ .

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 maakt het automatisch wissen van de cache op belangrijke delen van je site mogelijk wanneer je updates uitvoert voor de content van je pagina’s en berichten.

Kinsta Cache plugin in het WordPress dashboard.

Cache handmatig wissen

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

Druk op de Clear All Caches knop op de Kinsta Cache plugin pagina in je WordPress dashboard.
Druk op de Clear Caches link op de WordPress admin toolbar.
Wis de cache in MijnKinsta.
Voer wp kinsta cache purge uit in de opdrachtregel.

Cache wissen in het dashboard van WordPress.

Aangepaste caching URL’s toevoegen

We legen afzonderlijke pagina’s en belangrijke pagina’s zoals de homepage al onmiddellijk en leggen een minimale throttletijd op aan archiefpagina’s. Dit zorgt te allen tijde voor een hoge beschikbaarheid. Echter, afhankelijk van de configuratie van je site kunnen aanvullende cachingregels nodig zijn. Je kunt aangepaste paden toevoegen om te worden geleegd wanneer je site wordt bijgewerkt.

1. Aangepast pad toevoegen

Als je cache gewist moet worden op een exacte URL (bericht of pagina), kun je dit invoeren als een enkel pad regel op de Kinsta Cache plugin pagina in je WordPress dashboard. Voorbeeld https://jouwdomein.com/belangrijke-pagina

Aangepaste URL enkel pad in Kinsta Cache.

2. Groepspad aangepaste URL toevoegen

Het groepspad zuivert 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://jouwdomein.com/aangepast-berichttype/ toevoegt als groepspad URL, dan zal het de cache legen op het volgende:

https://jouwdomein.com/aangepast-berichttype/
https://jouwdomein.com/aangepast-berichttype/post-1
https://jouwdomein.com/aangepast-berichttype/post-2
https://jouwdomein.com/aangepast-berichttype/post-3

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 volledige cache van de site bij een update van een bericht/pagina. Het wissen van alle pagina’s zou een aanzienlijke tol eisen van de systeemresources, vooral tijdens hoge laadtijden en frequente publicaties. 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.

Download de Kinsta MU plugin en pak hem uit.
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.
Dit zal de oude pluginbestanden overschrijven met de nieuwe om de plugin bij te werken naar de nieuwste versie.

Bijwerken via Composer

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

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.

Oplossingen

Voordelen