O Kinsta MU (plugin obrigatório) foi projetado para funcionar na nossa plataforma de hospedagem WordPress. Ele faz o gerenciamento de coisas como a nossa tecnologia de cache de página inteira, e integração CDN da Kinsta.

Por definição, o plugin Kinsta MU é instalado em todos os sites por nós hospedados e está disponível no lado esquerdo do painel de controle do WordPress. O plugin é necessário para garantir que seu site é executado sem quaisquer problemas no nosso ambiente.

Instalando o Plugin Kinsta MU

Se você mesmo migrou seu site ou instalou o WordPress manualmente, talvez não tenha instalado o plugin Kinsta MU. Nós instalamos e atualizamos periodicamente o plugin para cada site em Kinsta que não usa o Composer ou gerencia todo o diretório de wp-content ou diretório mu-plugins em Git. Se você preferir ou precisar instalar o plugin Kinsta MU manualmente, você pode fazê-lo seguindo um dos métodos aplicáveis abaixo.

Instalando via SFTP

Passo 1: Crie uma pasta mu-plugins

Conecte-se ao seu site via SFTP e crie uma pasta chamada mu-plugins em sua pasta wp-content se ela ainda não existir (caminho acabado: /wp-content/mu-plugins/).

A pasta mu-plugins em FTP.
A pasta mu-plugins em FTP.

Passo 2: Baixe e descompacte o Plugin

Depois de garantir que a pasta mu-plugins foi criada, baixe o plugin Kinsta MU e descompacte-o.

Passo 3: Upload para o site

Carregar a pasta kinsta-mu-plugins e o arquivo kinsta-mu-plugins.php para o diretório /wp-content/mu-plugins/.

Pasta e arquivo Kinsta MU plugin em FTP.
Pasta e arquivo Kinsta MU plugin em FTP.

Isto instalará o plugin, e você poderá vê-lo em seu painel do WordPress fazendo login e indo para Plugins > Must-Use.

Instalando via Composer

Se seu site for construído com Bedrock ou qualquer boilerplate ou estrutura que utilize Composer, você precisará tomar algumas medidas extras para instalar o plugin Kinsta Must Use em seu site.

Passo 1: Declare o Plugin Kinsta MU Package Repository

Comece declarando o plugin Kinsta MU como um repositories de pacotes na matriz de repositórios em seu arquivo 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"
        }
      }
    }

Nota: Embora você possa tecnicamente definir o número da versão para qualquer coisa válida (porque você está instalando o plugin a partir de um arquivo zip específico) isto precisará ser alterado cada vez que você precisar atualizar o plugin, então recomendamos verificar a versão no último download do plugin Kinsta MU.

Etapa 2: Solicite o Plugin Kinsta MU

Em seguida, execute o seguinte comando no diretório bedrock do seu site (ou no diretório onde seu arquivo composer.json está localizado).

composer require kinsta/kinsta-mu-plugins

Ou, adicione o plugin Kinsta MU ao array require em seu arquivo composer.json. Aqui está um exemplo de array require de um site Bedrock após adicionar o plugin 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"
  },

Passo 3: Corrija o caminho para os ativos do Plugin Kinsta MU

Para corrigir o caminho para os ativos utilizados pelo plugin MU, adicione o seguinte ao arquivo de configuração do seu site (bedrock/config/application.php em 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");

Instalando a Via Git

Se você usa Git com seu site, a instalação do plugin Kinsta MU depende de quais partes do site você administra com Git.

Se você gerenciar todo o diretório wp-content ou diretório mu-plugins em seu repo Git, você precisará baixar e instalar o plugin em seu repositório local, comprometer essa mudança e depois implantá-lo em seu site. Você pode instalar o plugin localmente baixando-o e colocando os arquivos de plugins no diretório de mu-plugins de seu site.

Se você não mantiver uma cópia do plugin Kinsta MU em seu repositório Git, nós instalaremos automaticamente o plugin Kinsta MU para você ou você pode usar SFTP para instalá-lo manualmente.

Configurações do Plugin Kinsta MU

O plugin Kinsta MU está preparado para trabalhar em harmonia com o WordPress e nossa infraestrutura. Na maioria dos sites, ele não precisará de nenhuma modificação. O plugin permite a limpeza automática do cache em partes importantes do seu site quando você faz atualizações na sua página e publicar conteúdo.

Kinsta Cache plugin no painel de controle do WordPress.
Kinsta Cache plugin no painel de controle do WordPress.

Limpeza manual do Cache

Pode também limpar manualmente o cache no seu site WordPress com os seguintes métodos.

  1. Pressione o botão Limpar todos os caches na página do plugin Kinsta Cache em seu painel do WordPress.
  2. Pressione o link Limpar Caches na barra de ferramentas de administração do WordPress.
  3. Limpar o cache no MyKinsta.
  4. Correndo wp kinsta cache purge na linha de comando.
Limpar o cache no painel WordPress.
Limpar o cache no painel WordPress.

Adicionando URLs Personalizados de Cache

Já fizemos a limpeza de páginas únicas e chaves, como a página principal, e estabelecemos um tempo mínimo de aceleração nas páginas de arquivo. Isso garante uma elevada disponibilidade em todos os momentos. Contudo, dependendo da configuração do seu site, podem ser necessárias regras adicionais de cache. Pode adicionar caminhos personalizados para limpar sempre que seu site for atualizado.

1. Adicionar URL Personalizado de Caminho Único

Se você precisar limpar o cache em um URL exato (artigo ou página), você pode inserir esta regra como uma regra de caminho único na página do plugin Kinsta Cache em seu painel de controle do WordPress. Exemplo: https://yourdomain.com/important-page

URL personalizada de um único caminho no Kinsta Cache.
URL personalizada de um único caminho no Kinsta Cache.

2. Adicionar URL Personalizado de Caminho de Grupo

O caminho do grupo remove todos os URLs que começam com esse URL específico. Isso pode ser particularmente útil se tiver um tipo personalizado de publicação e precisar que o cache seja limpo e o mesmo para o cache das postagens abaixo dele. Por exemplo, se adicionar https://yourdomain.com/custom-post-type/ como um URL de caminho de grupo, ele limpará o cache nos seguintes:

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
Caminho personalizado de grupo de URLs na página Kinsta Cache.
Caminho personalizado de grupo de URLs na página Kinsta Cache.

Notas Adicionais

Você não tem permissão para adicionar somente “/” como caminho, já que isso acionaria uma limpeza de todo o cache do site aquando de uma atualização de publicação/página. Limpar todas as páginas teria um impacto considerável nos recursos do servidor, especialmente durante períodos de carga elevada e horários de publicação frequentes. Isso também poderia diminuir o desempenho do seu site para os visitantes, já que teria de recarregar tudo novamente.

Se você tem clientes e prefere que eles não vejam qualquer marca da Kinsta, também pode tornar o plugin em uma marca branca.

Atualização do Plugin Kinsta MU

Caso seu site não utilize Composer ou Git, atualizaremos automaticamente o plugin Kinsta MU para você periodicamente. Não há mais nada que você precise fazer para manter o plugin atualizado.

Atualizando via SFTP

Se você precisar atualizar o plugin manualmente (talvez tenha restaurado um backup antigo ou uma atualização não foi como planejado), você pode usar o SFTP para atualizar manualmente o plugin Kinsta MU.

  1. Baixe o plugin Kinsta MU e descompacte-o.
  2. Faça o upload da pasta kinsta-mu-plugins e do arquivo kinsta-mu-plugins.php para o diretório /wp-content/mu-plugins/ e sobrescreva os arquivos existentes quando solicitado por seu cliente SFTP.
  3. Isto irá sobrescrever os arquivos de plugins antigos com os novos para atualizar o plugin para a versão mais recente.

Atualização via Composer

  1. Atualize o número da versão na declaração do repositório de plugins Kinsta MU em seu arquivo 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. Execute composer update kinsta/kinsta-mu-plugins no diretório bedrock do seu site (ou no diretório onde seu arquivo composer.json está localizado).

Atualização via Git

Se você usa Git com seu site, o processo de atualização do plugin depende de quais partes do site você administra com Git.

Se você gerenciar todo o diretório de wp-content ou mu-plugins em seu repo Git, você precisará atualizar o plugin em seu repositório local, comprometer essa mudança e depois implantá-lo em seu site. Você pode atualizar localmente baixando o plugin e sobrescrevendo os arquivos de plugins existentes em seu repo.

Se você não mantiver uma cópia do plugin Kinsta MU em seu repositório Git, nós atualizaremos automaticamente o plugin Kinsta MU para você; não há mais nada que você precise fazer.