Plano de prefixos
Se usar dois dos nossos plugins num só site — por exemplo tosquia e passeio de cães, como duas empresas separadas — cada um precisa dos seus próprios nomes para o que guarda, caso contrário escreveriam nos registos um do outro. Este ecrã mostra o que implicaria dar a esta edição nomes próprios neste site: que tipos de registo, campos, definições e tabelas mudariam de nome, e quantas linhas existem por trás de cada um.
É um plano, não um botão. Nada aqui altera coisa alguma, e o plano é contado a partir da sua base de dados tal como está, e não deduzido a partir do código.
A última secção trata de funções e permissões, que têm uma forma diferente de tudo o que está acima: não são registos seus, são entradas na própria lista do WordPress de quem pode fazer o quê. Mesmo assim têm de mudar com o resto, e são a parte com menos margem para erro — uma permissão que mudou num sítio e não no outro significa que a pessoa que a tem é informada de que não pode entrar no seu próprio plugin. Desde a versão 2.688.0 mudam com o resto, e ambas as grafias funcionam em simultâneo enquanto a mudança decorre, por isso não há nenhum instante em que a sua equipa tenha algo que o plugin não esteja a pedir.
Exemplo
Já usa o plugin de tosquia e está prestes a adicionar o de passeios para a outra metade do negócio. Abre primeiro o Plano de prefixos, vê exatamente o que mudaria e o que não mudaria, e sabe antes de começar que nada vai mudar de nome por adivinhação. Assim que esta cópia tiver nomes próprios, a de passeios assume os seus automaticamente no momento em que a ativar — não tem mais nada a fazer.
Perguntas frequentes
Abrir isto vai alterar os meus dados?
Não. Apenas conta. Não há nenhum formulário no ecrã nem nada para submeter.
Duas cópias podem agora funcionar ambas offline?
Sim, desde a versão 2.701.0. A app da equipa tem um endereço próprio, por isso o seu auxiliar offline reclama apenas essa app e não o site inteiro — e um navegador permite um destes por app, não um por site. Antes dessa versão, só a app que abriu por último funcionava sem rede. Também já não precisa de criar uma página para a app: simplesmente existe, e o seu código QR no ecrã Definições funciona sempre.
Os meus clientes veem um endereço diferente para cada cópia?
Sim, desde a versão 2.699.0. Cada cópia tem o seu próprio portal do cliente, as suas próprias ligações de faturas e marcações, os seus próprios relatórios de passeio e o seu próprio formulário de opinião — por isso duas cópias num site são duas empresas, e um cliente de uma nunca vai parar ao início de sessão da outra. A app do cliente instalável segue a mesma lógica: cada cópia é uma app própria no telemóvel, com o seu próprio ícone e o seu próprio armazenamento offline. No Premium pode mudar o nome de qualquer um destes endereços para algo seu; o incorporado continua a funcionar a par do que escolher.
Se usar duas cópias, um botão num ecrã afeta a outra?
Não. Desde a versão 2.698.0, cada botão na administração verifica em que ecrã de cópia foi premido antes de agir, e as outras cópias ficam de parte. Antes dessa versão, a cópia que respondesse primeiro fazia o trabalho, o que num site com duas cópias nem sempre era aquela que estava a ver. Se o seu navegador estiver configurado para esconder de onde veio um pedido, uma cópia que não o consiga saber trata o pedido em vez de o recusar, por isso nenhum botão deixa de funcionar.
Porque é que diz que não está em execução?
Porque o plano está à frente do código. Os nomes só podem mudar quando todos os sítios que os leem tiverem aprendido os novos; até lá seria uma mudança de nome para o vazio. O ecrã existe já para que a imagem esteja lá antes da mudança, e não depois.
Porque é que as taxonomias são listadas separadamente dos campos?
Porque se comportam de forma oposta, e juntá-las induziria em erro. Um campo pertence a um dos seus registos — por isso, quando cada plugin tiver o seu próprio tipo de registo, dois plugins podem ter um campo com o mesmo nome sem nunca tocarem nos registos um do outro. Uma taxonomia é uma lista que pertence a todo o site e não a um registo, por isso ambos os plugins estariam mesmo a mexer na mesma. É por isso que muda juntamente com os seus tipos de registo em vez de ficar onde está.
O que são as chaves “sem prefixo para corresponder”?
Campos com nomes simples — raça, morada — que não têm nada que os identifique como nossos. São a razão pela qual o plano é construído percorrendo os nossos próprios tipos de registo e recolhendo todos os campos neles encontrados, em vez de comparar nomes: a comparação ignoraria estes discretamente, e um campo ignorado simplesmente volta vazio.
O que acontece se encontrar algo que não reconhece?
Di-lo e para. Uma migração que faz suposições sobre um nome desconhecido é pior do que uma que se recusa a começar, porque a suposição só é descoberta mais tarde, pelos dados errados.
Preciso disto se só usar um dos vossos plugins?
Não. Um plugin sozinho num site tem os nomes só para si e nada precisa de mudar.
Quero ter duas atividades. O que faço exatamente?
Nada. Instale o plugin da outra atividade e ative-o. Cada instalação é independente: começa com dados próprios, e os clientes e marcações que já tem ficam no plugin que já usa.
Porque é que a segunda cópia não se resolve sozinha?
Porque não consegue saber de quem são os registos que está a ver. Os registos com os nomes partilhados podem pertencer à outra atividade — ou a este mesmo plugin, de uma instalação anterior que foi desativada e reativada. Os dois casos parecem idênticos vistos de dentro da cópia que chega, e errar deixaria uma empresa em funcionamento com ecrãs simplesmente vazios: nada avariado, nada em nenhum registo de erros, e todos os registos ainda lá, com um nome que nada procura. Por isso recusa-se a adivinhar, e é a cópia que é dona dos registos que os muda.
Então, o que faz a segunda cópia?
Escreve uma linha a dizer como se chamam os seus próprios registos, enquanto está a ser ativada — antes de ter criado uma única definição, função ou tabela. A partir desse momento, tudo o que cria é seu e nunca toca em nada da primeira cópia. Não é uma migração e não há nada para desfazer: uma cópia sem registos não tem nada para mudar.
Isto é o mesmo que a mudança neste ecrã?
Não, e a diferença é precisamente a questão. Este ecrã MUDA registos que já existem, o que é um trabalho cuidadoso e lento, sem possibilidade de anular. Uma cópia nova RESERVA um nome antes de ter quaisquer registos, o que é uma linha e não pode perder nada. O mesmo estado final, um risco completamente diferente.
Porque é que as funções e permissões são listadas separadamente?
Porque são guardadas de forma diferente. As suas marcações e definições são registos com nomes nossos. Uma função é uma entrada na própria lista do WordPress de quem pode fazer o quê, e as nossas permissões estão dentro dela, por isso nada que procure nos seus registos as vai encontrar alguma vez. São contadas aqui exatamente por essa razão.
A minha equipa perderia o acesso durante a execução?
Não, e a migração é feita pelo caminho mais longo precisamente para que isso não aconteça. A nova função é criada ao lado da antiga e ambas funcionam, cada pessoa recebe as duas, e só quando a mudança termina é que a antiga é retirada. Não há nenhum momento em que alguém tenha uma função que não existe, e uma mudança interrompida a meio deixa toda a gente a poder trabalhar.
O que mudou nas funções na versão 2.688.0?
Duas coisas. As funções e permissões passam a ter um nome próprio quando um plugin muda, tal como os seus registos e definições — antes, dois dos nossos plugins no mesmo site partilhavam um único conjunto de funções da equipa. E o plugin passa a pedir o nome que o seu site realmente usa, em vez de pedir sempre o original. Sem essa segunda metade, mudar um plugin teria mudado o nome das funções da sua equipa e depois deixado o plugin a pedir os nomes antigos: um membro da equipa impedido de entrar na sua própria app, e o dono da empresa informado de que não podia abrir as suas próprias definições. Ninguém se deparou com isso — mudar um plugin para nomes próprios continua desativado — mas o problema existia.
Porque é que um administrador não teria reparado?
Porque ser administrador do WordPress permite passar quase todas as verificações de permissões do plugin. Os ecrãs abrem, a app funciona, tudo parece bem — e as únicas pessoas para quem está avariado são as que não têm uma conta de administrador, que são a maior parte de uma equipa. Foi por isso que isto foi descoberto por uma verificação que faz a pergunta em nome de um membro da equipa, e não por alguém a usar o software.
A ligação da agenda que guardei nos favoritos já não filtra por membro da equipa. Porquê?
O filtro de equipa na barra de endereço passou a ser pc_who. Antes era pc_staff, que era também o nome da função da equipa e o nome da coluna Equipa na lista de marcações — uma palavra a fazer três trabalhos, num plugin que agora tem de decidir qual delas muda quando uma cópia adota nomes próprios. Defina o filtro novamente e a nova ligação funciona exatamente como a antiga.
Lista algo que o meu código de funções não menciona — está errado?
Não. A função de cliente é criada pelo portal do cliente e não pelo ecrã de funções, por isso aparece aqui como encontrada no site e não como declarada no código. É apresentada abertamente em vez de em silêncio, porque o plano é sempre construído a partir do que o seu site tem realmente.
O que é “Partilhado de propósito” e porque é que nada é renomeado aí?
São os endereços web que os seus clientes já têm — a ligação numa fatura que enviou por email, uma página de conta guardada nos favoritos, uma app instalada num telemóvel. Não é possível dar a cada edição a sua própria grafia sem partir ligações que podem ter anos, por isso ambas as edições lhes respondem, deliberadamente. Aparece na lista para que a sua ausência no plano acima seja lida como uma decisão e não como um esquecimento.
Se duas edições respondem ao mesmo endereço, como é que a certa responde?
Pelo registo a que a ligação se refere. Cada uma dessas ligações identifica algo — uma fatura, uma marcação, uma conta — e cada edição já verifica se esse algo é seu. O que mudou foi o que acontece quando não é: em vez de dizer ao cliente que a ligação está partida, a edição afasta-se e deixa a outra responder. Uma ligação que não pertence a nenhuma continua a ter uma resposta clara, porque alguém tem de a dar.
Se uma cópia for convertida, a outra também muda?
Não, e esta foi a falha que o primeiro teste real de duas cópias no mesmo site encontrou. Quando uma cópia converte os seus registos para nomes próprios, escreve uma nota a dizê-lo, e essa nota era guardada uma única vez para todo o site. O lado da tosquia converteu, escreveu a nota, e o lado dos passeios leu-a e concluiu que os seus próprios registos também tinham mudado — teria começado a pedir os clientes e as marcações do lado da tosquia como se fossem seus. Agora cada cópia guarda a sua própria nota. A conversão de uma não diz rigorosamente nada sobre a outra, e a outra continua a ler os seus registos com os nomes antigos até ser a sua vez de converter.
Tenho duas cópias. Como distingo uma da outra no menu?
Pelo nome, pelo primeiro item por baixo e pela posição. Cada cópia inclui a sua atividade no nome do menu — ModuleFest Pet Groomer, ModuleFest Pet Walker — o primeiro item por baixo diz Painel de tosquia ou Painel de passeios com todas as letras, e cada uma ocupa um lugar fixo, por essa ordem. Até à versão 2.683.0 ambas diziam apenas “ModuleFest Pet Services”, uma por cima da outra, e uma entrada de menu do WordPress não tem texto ao passar o rato em que se possa apoiar. O nome é mostrado quer tenha duas cópias quer não, porque uma etiqueta que aparece quando chega um segundo plugin é uma etiqueta que muda sem avisar.
Porque é que ambas as cópias mostram a mesma pata?
Porque é o mesmo produto. Entre as versões 2.683.0 e 2.691.0 cada atividade tinha um ícone diferente — uma tesoura, um marcador de mapa, uma casa, um livro — o que distinguia duas cópias mas também fazia quatro plugins parecerem quatro produtos sem relação. Dar nome ao painel por baixo faz o mesmo trabalho em palavras simples, por isso o ícone voltou a ser a marca. Não há nada que possa fazer para que sejam diferentes; é intencional.
Como adiciono uma imagem a um pacote?
No ecrã Pacotes, ao editar um. Os pacotes são a única coisa que se edita inteiramente no nosso próprio ecrã e não no WordPress, por isso não têm a caixa Imagem de destaque nem o painel Mais imagens que os tratamentos e produtos têm — os mesmos controlos estão nesse ecrã. Escolha quantas quiser de uma vez; a primeira que escolher é a imagem principal.
Os dados de demonstração incluem categorias?
Sim, a partir da versão 2.695.0, e seguem a sua atividade. A demonstração de um tosquiador arquiva os tratamentos em Tosquias completas, Banhos & arranjos, Tratamentos de pelagem, Cachorros e Extras; a de um passeador em Passeios em grupo, Passeios individuais, Visitas ao domicílio e assim por diante. Há apenas algumas por atividade, de propósito — uma demonstração que chega com quinze categorias ensina um hábito que torna os ecrãs de marcação mais difíceis de usar, e não mais fáceis.
A demonstração também preenche a loja?
Sim, a partir da versão 2.695.0 — nove produtos para a sua atividade, com categorias e stock inicial. O stock é introduzido como uma entrega através do registo de stock, e não escrito como um número, que é como a loja funciona na realidade, e um ou dois produtos ficam propositadamente abaixo do nível de reposição para que possa ver o aviso de stock baixo a fazer o seu trabalho. Antes disto, a loja não criava nada.
Como adiciono imagens a um tratamento ou produto?
Abra-o e use Imagem de destaque à direita para a principal — é a imagem usada nos cartões e nas listagens. O painel Mais imagens por baixo guarda as restantes: Adicionar imagens permite escolher várias de uma vez, arrastar uma miniatura muda a ordem em que aparecem, e o × num canto remove uma. A imagem principal não se repete nesse painel, de propósito; se promover uma das outras a principal, ela sai do painel sozinha, para que nada seja mostrado duas vezes.
O que aconteceu à caixa Categoria onde eu escrevia?
Passou a ser uma lista a sério, partilhada por tratamentos, produtos e pacotes, para que a mesma categoria possa ser usada nos três e ter a sua própria imagem. O que tinha escrito foi transformado automaticamente em entradas dessa lista na primeira vez que abriu a administração depois de atualizar. Nada foi renomeado, movido ou removido — as palavras que escreveu continuam guardadas em cada tratamento, e é por isso que uma versão anterior do plugin ainda as lê corretamente se alguma vez voltar atrás.
Porque é que uma categoria precisa de uma imagem?
Para as páginas que mostram os seus tratamentos e produtos no seu próprio site: a imagem da categoria é o cabeçalho da página dessa categoria e aparece nos botões de categoria. Se nunca usar essas páginas, não faz mal deixá-la vazia.
Um registo aberto no WordPress mostra apenas o título. Para onde foram os painéis?
Estavam a ser oferecidos a um tipo de registo que a sua cópia já não usa, e isso foi corrigido na versão 2.693.0. Quando uma cópia adota nomes próprios, os seus registos são renomeados — mas os painéis que o plugin acrescenta aos ecrãs de edição do WordPress continuavam a pedir o nome original, por isso o WordPress nunca os desenhava. Nada se perdeu; os painéis simplesmente não estavam lá. A mesma falha fazia com que o que se escrevesse neles também não fosse guardado. Os seus ecrãs do ModuleFest Pet Services — a agenda, a lista de clientes, a app — nunca foram afetados, e é por isso que isto passou despercebido durante tanto tempo.
Cada uma de duas cópias tem a sua própria app da equipa?
Sim, a partir da versão 2.692.0. Antes disso partilhavam uma única descrição de app servida pela cópia que respondesse primeiro, por isso a página da app da segunda cópia oferecia uma app que abria as páginas da primeira — e num site com três cópias, duas delas não tinham qualquer descrição de app. Agora cada cópia tem a sua, com o seu próprio nome, ícone e página inicial, e guarda os seus ecrãs em memória com o seu próprio nome, para que nada do que uma cópia guarda possa ser lido ou substituído por outra.
As duas apps da equipa podem funcionar offline ao mesmo tempo?
Não, e isto não tem solução num único site. Trabalhar offline precisa de um processo em segundo plano, e um navegador só permite um para todo o site — por isso a app da equipa aberta mais recentemente é a que continua a funcionar sem rede. Ambas as apps funcionam normalmente quando há ligação. Se o modo offline for importante para as duas atividades, instale a segunda cópia num site próprio (um subdomínio chega).
A app do cliente perdeu a página offline. Porquê?
A app da equipa estava a apagá-la, e isso foi corrigido na versão 2.692.0. Quando a app da equipa se atualizava, limpava as cópias antigas guardadas, e ao mesmo tempo limpava tudo o resto que o site tinha guardado — incluindo o que a app de conta do cliente guarda. Agora só limpa o que é seu. Isto afetava qualquer pessoa com as duas apps instaladas, tivesse ou não duas cópias.
Porque é que o meu ecrã de início de sessão mostrava o logótipo mais de uma vez?
Porque cada cópia o estava a acrescentar. Corrigido na versão 2.691.0: a cópia que carrega primeiro apresenta o ecrã de início de sessão e as outras retiram-se, por isso vê um logótipo e um conjunto de cores, sejam quantas forem as cópias instaladas. Qual das cópias é não faz diferença no que vê — partilham as definições de marca num site com mais de uma.
Uma ligação “(Lista)” dizia “Tipo de conteúdo inválido”. O que era isso?
Uma ligação que não tinha acompanhado os seus registos. Numa cópia a funcionar com nomes próprios, ligações como Marcações (Lista) ainda pediam ao WordPress o nome original, e o WordPress dizia, com razão, que nunca tinha ouvido falar dele. Não havia nada de errado com os seus dados — as ligações apenas apontavam para o nome errado. Todas foram corrigidas na versão 2.691.0, e a compilação agora recusa publicar uma ligação com esta falha.
Isto foi útil?
Obrigado por nos dizer.
Lamentamos que isto não tenha respondido à sua dúvida. Obrigado por nos dizer: usamos isto para melhorar os guias.
Ainda precisa de ajuda? Inicie sessão na sua conta e abra um pedido de suporte. As pessoas que escreveram o código ajudam, e a maioria dos pedidos recebe resposta no mesmo dia útil.