← Casos Plugins 15–16 out 2026 · PageBrick 1.6.0, 1.7.0 e 1.7.1
Do pedido de um cliente à versão publicada
A equipe de um site de cliente abria a mesma tela todo dia, e ela ficava escondida atrás do ícone de Plugins. Pedido em 15 de outubro, publicado em 16 de outubro, de um jeito que não mudou nada para nenhum outro site.
- 27 / 27conferências na atualização da 1.6.0 para a 1.7.0 num navegador de verdade, com o voltar atrás
- 2argumentos opcionais acrescentados a uma função; todo plugin escrito antes funciona como funcionava
- 0coisas removidas ou alteradas na API pública
- 6versões publicadas em 16 de outubro por causa disso: três do PageBrick e três de plugins
O problema
O site de um cliente usava um plugin que uma agência fez para os avisos do dia a dia. A equipe usava todo dia, mas ele ficava atrás do ícone de Plugins, numa lista com configurações e atualizações. Eles também queriam saber quando alguém mandava uma mensagem pelo formulário de contato, sem abrir o painel para descobrir.
A decisão
O pedido era de um cliente, e nada específico de um cliente entra no PageBrick. A forma geral foi esta: a tela de um plugin pode pedir para ficar na lista de Conteúdo do menu, com um ícone próprio (pb_add_admin_page() ganhou dois argumentos opcionais no fim), e os plugins podem pôr um número ao lado do item do menu e uma linha no sino (dois filtros novos).
A promessa de compatibilidade decidiu o formato. Uma função pode ganhar argumentos opcionais, mas nunca perder nem mudar um, então todo plugin escrito antes continua no seu lugar; e um plugin que passa os argumentos novos a um PageBrick mais antigo simplesmente aparece onde sempre apareceu, porque o PHP ignora argumentos a mais. Saiu como versão menor, anunciada no painel e nunca instalada sozinha. O Blog e o formulário de contato, os plugins oficiais, foram atualizados para usar isso, e chegam aos sites pelo catálogo, não pela atualização do núcleo.
A prova
A atualização da 1.6.0 para a 1.7.0 rodou num navegador de verdade, num site feito a partir da 1.6.0 publicada: o anúncio, nenhuma instalação automática, a atualização com os passos ao vivo, todas as páginas públicas e telas do painel, o voltar atrás e a atualização de novo, 27 de 27 conferências. Uma cópia congelada da API pública é comparada a cada rodada de testes, então a promessa é cumprida por um teste e não por boa vontade.
O resultado
A equipe do cliente agora encontra as telas que usa todo dia na lista de Conteúdo; um número aparece ao lado de Mensagens quando algo chega, e o sino avisa. Os sites que não usam nada disso não mudaram. Em 16 de outubro o mesmo trabalho saiu como PageBrick 1.6.0, 1.7.0 e 1.7.1, Blog 1.1.0 e 1.2.0 e Formulário de contato 1.2.0.
O que ficou
Diga sim ao cliente transformando o pedido num recurso geral, e deixe a promessa feita a todos os outros sites decidir o formato.