L’extension Kinsta MU (must use) a été conçue pour fonctionner sur notre plateforme d’hébergement WordPress. Elle gère des éléments tels que notre technologie de mise en cache de la page entière et l’intégration du CDN de Kinsta.

Par défaut, le plugin Kinsta MU est installé sur tous les sites que nous hébergeons et est disponible sur le côté gauche de votre tableau de bord d’administration WordPress. Le plugin est nécessaire pour assurer le bon fonctionnement de votre site dans notre environnement.

Installer le MU Plugin de Kinsta

Si vous avez migré votre site vous-même ou installé WordPress manuellement, vous n’avez peut-être pas installé l’extension MU de Kinsta. Nous installons et mettons à jour périodiquement l’extension pour chaque site de Kinsta qui n’utilise pas Composer ou qui ne gère pas l’intégralité du répertoire wp-content ou du répertoire mu-plugins dans Git. Si vous préférez ou devez installer l’extension MU de Kinsta manuellement, vous pouvez le faire en suivant l’une des méthodes applicables ci-dessous.

Installation via SFTP

Étape 1 : Créer un dossier mu-plugins

Tout d’abord, Connectez-vous à votre site via SFTP et créez un dossier appelé mu-plugins dans votre dossier wp-content s’il n’existe pas déjà (chemin terminé : /wp-content/mu-plugins/).

Le dossier mu-plugins en FTP.
Le dossier mu-plugins en FTP.

Étape 2 : Téléchargez et décompressez le plugin

Après vous être assuré que le dossier mu-plugins a été créé, téléchargez le MU-plugin Kinsta et décompressez-le.

Étape 3 : Envoyer sur le site

Vous devrez ensuite envoyer le dossier kinsta-mu-plugins et le fichier kinsta-mu-plugins.php dans le répertoire /wp-content/mu-plugins/.

Dossier et fichier du plugin Kinsta MU en FTP.
Dossier et fichier du plugin Kinsta MU en FTP.

Cela installera l’extension, et vous pourrez la voir dans votre tableau de bord WordPress en vous connectant et en allant dans Plugins > Must-Use.

Installation via Composer

Si votre site est construit avec Bedrock ou tout autre boilerplate ou framework qui utilise Composer, vous devrez prendre quelques mesures supplémentaires pour installer l’extension Kinsta Must Use sur votre site.

Étape 1 : Déclarer le dépôt de paquets d’extensions Kinsta MU

Commencez par déclarer l’extension Kinsta MU comme un dépôt de paquets dans le tableau des dépôts de votre fichier composer.json :


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

Note : Bien que vous puissiez techniquement configurer le numéro de version à tout ce qui est valide (parce que vous installez l’extension depuis un fichier zip spécifique), cela devra être changé chaque fois que vous devez mettre à jour l’extension, nous recommandons donc de vérifier la version dans le dernier téléchargement de l’extension Kinsta MU.

Étape 2 : Pré-requis pour l’extension Kinsta MU

Ensuite, exécutez la commande suivante dans le répertoire bedrock de votre site (ou le répertoire où se trouve votre fichier composer.json).

composer require kinsta/kinsta-mu-plugins

Ou, ajoutez l’extension Kinsta MU au tableau require dans votre fichier composer.json. Voici un exemple de require depuis un site Bedrock après avoir ajouté l’extension Kinsta MU :


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

Étape 3 : Fixer le chemin pour les ressources de l’extension Kinsta MU

Pour fixer le chemin des ressources utilisées par l’extension MU, ajoutez ce qui suit au fichier de configuration de votre site (bedrock/config/application.php dans les sites Bedrock) :

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

Installation via Git

Si vous utilisez Git avec votre site, l’installation de l’extension Kinsta MU dépend des parties du site que vous gérez avec Git.

Si vous gérez l’intégralité du répertoire wp-content ou du répertoire mu-plugins dans votre repo Git, vous devrez télécharger et installer l’extension dans votre repo local, valider cette modification, puis la déployer sur votre site. Vous pouvez installer l’extension localement en la téléchargeant et en plaçant les fichiers de l’extension dans le répertoire mu-plugins de votre site.

Si vous ne maintenez pas une copie de l’extension Kinsta MU dans votre repo Git, nous installerons automatiquement l’extension Kinsta MU pour vous ou vous pouvez utiliser SFTP pour l’installer manuellement.

Paramètres du MU Plugin Kinsta

Le MU plugin Kinsta est conçu pour fonctionner en harmonie avec WordPress et notre infrastructure, et ne nécessite aucune modification sur la plupart des sites. Ceci permet d’effacer automatiquement le cache sur les parties importantes de votre site lorsque vous faites des mises à jour de pages et que vous publiez du contenu.

Le plugin Kinsta Cache dans le tableau de bord de WordPress.
Le plugin Kinsta Cache dans le tableau de bord de WordPress.

Vidage manuel du cache

Vous pouvez également vider manuellement le cache sur votre site WordPress avec les méthodes suivantes.

  1. Cliquez sur le bouton Clear Cache sur la page du plugin Kinsta Cache dans votre tableau de bord WordPress.
  2. Cliquez sur le bouton Clear cache dans la barre d’outils d’administration de WordPress.
  3. Videz le cache dans MyKinsta
  4. Exécutez la purge de wp kinsta cache en ligne de commande.
Vider le cache WordPress depuis le tableau de bord
Vider le cache WordPress depuis le tableau de bord

Ajout d’URL de mise en cache personnalisée

Nous purgeons déjà immédiatement les pages individuelles et les pages clés telles que la page d’accueil et imposons un temps de cache minimal aux pages d’archive. Ceci garantit une disponibilité élevée à tout moment. Cependant, selon la configuration de votre site, des règles de mise en cache supplémentaires peuvent être nécessaires. Vous pouvez ajouter des chemins personnalisés pour purger chaque fois que votre site est mis à jour.

1. Ajouter une URL personnalisée de chemin unique

Si vous avez besoin de vider le cache sur une URL exacte (article ou page), vous pouvez le saisir comme une règle de chemin unique sur la page du plugin Kinsta Cache dans votre tableau de bord WordPress. Exemple : https://votredomaine.com/page

Chemin unique d'URL personnalisé dans Kinsta Cache.
Chemin unique d’URL personnalisé dans Kinsta Cache.

2. Ajouter une URL personnalisée de groupe de chemin

La purge du groupe de chemin purge toutes les URLs qui commencent par cette URL spécifique. Cela peut être particulièrement utile, par exemple si vous avez un type de post personnalisé et que vous avez besoin que le cache soit effacé et que les articles en dessous soient effacés. Par exemple, si vous ajoutez https://votredomaine.com/custom-post-type/ en tant qu’URL de groupe de chemin, alors cela purgera le cache sur les éléments suivants :

https://votredomaine.com/custom-post-type/
https://votredomaine.com/custom-post-type/post-1
https://votredomaine.com/custom-post-type/post-2
https://votredomaine.com/custom-post-type/post-3
Chemin de groupe d'URL personnalisé dans Kinsta Cache.
Chemin de groupe d’URL personnalisé dans Kinsta Cache.

Notes additionnelles

Vous n’êtes pas autorisé à ajouter seulement « / » comme chemin d’accès, car cela déclencherait un effacement du cache du site complet lors d’une mise à jour de page ou article. La purge de toutes les pages pèserait lourdement sur les ressources du serveur, en particulier pendant les périodes de charge élevée et les fréquentes publications programmées. Cela pourrait également dégrader les performances de votre site pour les visiteurs, car il devrait tout mettre en cache à nouveau.

Si vous avez des clients et que vous préférez qu’ils ne voient aucune marque Kinsta, vous pouvez également mettre ce plugin en marque blanche.

Mise à jour de l’extension Kinsta MU

Si votre site n’utilise pas Composer ou Git, nous mettrons automatiquement et périodiquement à jour l’extension Kinsta MU pour vous. Vous n’avez rien de plus à faire pour maintenir l’extension à jour.

Mise à jour via SFTP

Si vous devez mettre à jour l’extension manuellement (peut-être avez-vous restauré une ancienne sauvegarde ou une mise à jour ne s’est pas déroulée comme prévu), vous pouvez utiliser SFTP pour mettre à jour manuellement l’extension Kinsta MU.

  1. Téléchargez l’extension Kinsta MU et décompressez-la.
  2. Téléversez le répertoire kinsta-mu-plugins et le fichier kinsta-mu-plugins.php dans le répertoire /wp-content/mu-plugins/ et écrasez les fichiers existants quand votre client SFTP vous le demande.
  3. Cela écrasera les anciens fichiers de l’extension avec les nouveaux pour mettre à jour l’extension à la dernière version.

Mise à jour via Composer

  1. Mettez à jour le numéro de version dans la déclaration du dépôt d’extensions de Kinsta MU dans votre fichier composer.json :
        {
          "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. Exécutez composer update kinsta/kinsta-mu-plugins dans le répertoire bedrock de votre site (ou le répertoire où se trouve votre fichier composer.json).

Mise à jour via Git

Si vous utilisez Git avec votre site, le processus de mise à jour de l’extension dépend des parties du site que vous gérez avec Git.

Si vous gérez l’intégralité du répertoire wp-content ou du répertoire mu-plugins dans votre repo Git, vous devrez mettre à jour l’extension dans votre repo local, valider cette modification, puis la déployer sur votre site. Vous pouvez effectuer la mise à jour localement en téléchargeant l’extension et en écrasant les fichiers d’extension existants dans votre repo.

Si vous ne maintenez pas une copie de l’extension Kinsta MU dans votre repo Git, nous mettrons automatiquement à jour l’extension Kinsta MU pour vous ; vous n’avez rien d’autre à faire.