Como personalizar o painel Jumpseller com o Tampermonkey

O Tampermonkey é uma extensão de navegador de terceiros que executa scripts de utilizador: pequenos programas que podem alterar a apresentação ou o comportamento de uma página no seu navegador. Um script revisto pode destacar informação útil ou acrescentar um resumo visual ao painel de administração do Jumpseller.

Não precisa de escrever código para instalar um script preparado pela sua equipa técnica. Precisa de compreender o que faz, que permissões utiliza e em que loja deve funcionar. Este guia explica a configuração no Chrome e utiliza um contador visual de unidades de uma encomenda como exemplo.

O que muda e o que se mantém

Uma personalização visual altera o que vê nesse perfil do navegador. Não é uma funcionalidade nativa do Jumpseller nem aparece automaticamente para os seus colegas ou noutro computador.

O contador do exemplo apenas lê as quantidades já apresentadas numa encomenda e acrescenta uma faixa. Não guarda o total na encomenda, não altera a loja pública nem acrescenta o total aos emails ou às exportações. Outros scripts podem ter comportamentos diferentes: não assuma que todos os scripts do Tampermonkey são de apenas leitura.

Para partilhar a gestão da loja, utilize contas de administrador separadas, sem partilhar palavras-passe. Para conhecer as funcionalidades do painel, consulte Gestão de encomendas.

Antes de começar

• Utilize o Chrome num computador onde tenha autorização para instalar extensões.
• Tenha acesso ao painel da sua loja e um script revisto por alguém de confiança.
• Peça à sua equipa técnica que confirme que o script está limitado à sua loja e às páginas necessárias.
• Não utilize scripts de origem desconhecida, não introduza palavras-passe ou tokens API nos mesmos e não os utilize para contornar permissões, verificações de pagamento ou regras de processamento de encomendas.

O Tampermonkey não é desenvolvido pela Jumpseller. Uma alteração no painel pode fazer com que uma personalização deixe de funcionar; não se garante compatibilidade com todas as lojas, navegadores ou versões futuras do painel.

1. Instale a extensão oficial

1. Abra o Tampermonkey na Chrome Web Store.
2. Confirme o nome Tampermonkey e o site do programador tampermonkey.net.
3. Selecione Add to Chrome ou Adicionar ao Chrome.
4. Leia o diálogo de permissões. Na instalação utilizada para este guia, o Chrome pediu autorização para ler e alterar todos os dados em todos os sites, apresentar notificações e modificar os dados que copia e cola. São permissões amplas da extensão, mesmo quando um script específico tem um âmbito restrito.
5. Se aceitar essas permissões e a sua organização o permitir, selecione Add extension ou Adicionar extensão.
6. Aguarde a confirmação de que o Tampermonkey foi adicionado ao Chrome.

Se aparecer Remove from Chrome ou Remover do Chrome, a extensão já está instalada. Não instale outra cópia. Se a sua organização bloquear a instalação, peça ajuda ao administrador em vez de contornar a restrição.

2. Verifique as definições de scripts do Chrome

1. Escreva chrome://extensions/ na barra de endereços do Chrome e prima Enter.
2. Verifique Developer mode ou Modo de programador. No nosso exemplo já estava ativo. Se precisar de o ativar, consulte primeiro o administrador: também permite carregar extensões manualmente.
3. Localize o Tampermonkey e selecione Details ou Detalhes.
4. Procure Allow User Scripts. Na versão do Chrome testada era um interruptor separado do modo de programador. A tradução deste rótulo pode variar.
5. Leia o aviso sobre a execução de código não revisto pela Google. Ative-o apenas quando a sua organização o autorizar e confiar no script.

A imagem mostra as definições reais utilizadas neste exemplo, não uma recriação do diálogo de instalação. Os nomes e requisitos podem variar consoante a versão do Chrome; consulte a ajuda oficial do Tampermonkey se o seu ecrã for diferente. Este exemplo não precisa de acesso em navegação anónima, acesso a ficheiros locais nem permissões adicionais de transferência de ficheiros.

3. Adicione um script preparado para a sua loja

1. Abra o botão Extensões, com a forma de uma peça de puzzle, junto à barra de endereços do Chrome.
2. Selecione Tampermonkey.
3. Abra Dashboard ou Painel de controlo.
4. Selecione Create a new script ou Criar um novo script.
5. Apague todo o texto de exemplo do editor.
6. Cole o script completo fornecido pela sua equipa técnica. Cole-o neste editor, não num campo da encomenda nem na barra de endereços.
7. Confirme o nome e a loja prevista. Antes de guardar, peça à sua equipa técnica que explique qualquer site ou permissão inesperados.
8. Guarde com ⌘S no Mac ou Ctrl+S no Windows.
9. Confirme que o painel apresenta apenas uma cópia ativa do script.

Sobre o exemplo transferível: o código do contador da alejandrotest é uma referência técnica, não um script pronto a utilizar na sua própria loja. Está deliberadamente limitado a https://alejandrotest.jumpseller.com/admin/* e também verifica esse domínio no código. Não precisa de credenciais nem faz pedidos de rede. Um técnico tem de adaptar e validar o domínio, a rota da encomenda e os seletores da página antes de lhe entregar uma versão para outra loja. Não substitua o âmbito por «todos os sites».

4. Exemplo prático de um contador de unidades

Imagine que vende ingredientes de padaria. Uma encomenda tem três linhas: 3 sacos de farinha, 2 embalagens de fermento em pó e 5 embalagens de manteiga. São 10 unidades, não três unidades.

A captura seguinte foi obtida no painel real da alejandrotest, com dados fictícios. A encomenda 2416 contém três linhas de produtos físicos sem relações de bundle. O script do exemplo apresenta o rótulo em espanhol: Total de unidades: 10.

Para verificar um contador revisto na sua própria loja:

1. Inicie sessão no painel como habitualmente.
2. Abra Encomendas e escolha uma encomenda existente com produtos normais, sem bundles.
3. Recarregue o separador e aguarde até os produtos terminarem de carregar.
4. Procure um único contador por baixo do número da encomenda.
5. Some as quantidades dos produtos e compare o resultado.
6. Abra outra encomenda a partir da lista. Confirme que o total muda para corresponder a essa encomenda.
7. Regresse à lista. O contador do exemplo não deve permanecer aí.

Os bundles não são suportados por este exemplo. O script soma as linhas apresentadas, pelo que pode contar em simultâneo a linha principal do bundle e as linhas dos seus componentes. Não o utilize para determinar quantos artigos físicos deve embalar numa encomenda com bundles. A sua equipa tem de acordar e implementar essa regra separadamente. Consulte Conjuntos de produtos ou bundles.

O exemplo foi observado na apresentação de computador e em vistas adaptáveis do navegador. Instalar uma extensão no Chrome de computador não a instala num telemóvel.

5. Desative ou remova uma personalização

Para deixar de a ver, abra o Tampermonkey, localize o respetivo script, desative-o e recarregue a página do painel. O contador do exemplo desaparece sem alterar a encomenda.

Para eliminar o script, abra Dashboard, identifique o correto e utilize o respetivo ícone do caixote do lixo. Não elimine outros scripts de que precise. Para remover a extensão completa, abra chrome://extensions/, localize o Tampermonkey e selecione Remover. Esta ação afeta também os restantes scripts geridos pela extensão.

Resolução de problemas

O que vê	O que verificar
Não há alteração visual	Confirme que o script se destina a essa loja e página. Verifique se o Tampermonkey, o script e Allow User Scripts estão ativos e recarregue.
Só funciona num computador	É o comportamento esperado neste exemplo. É local ao perfil do Chrome onde foi instalado.
O contador aparece duas vezes	Procure cópias duplicadas do mesmo script. Deixe apenas uma ativa e recarregue.
O total difere da quantidade a embalar	Verifique se existem bundles. Este exemplo não os suporta. Deixe de utilizar esse total para expedição e consulte a sua equipa técnica.
Deixou de funcionar após uma atualização do painel	Desative-o e peça a quem o mantém que reveja os seletores da página. O exemplo oculta o total se não reconhecer a tabela de produtos.
O Chrome pede outra permissão	Leia o pedido exato e consulte o administrador antes de o aceitar. Não altere outras definições de segurança.

Mantenha cada personalização pequena, reversível e limitada às páginas previstas. Se uma alteração tiver de ser guardada, partilhada entre utilizadores ou integrada no processamento de encomendas, utilize uma funcionalidade adequada do Jumpseller ou consulte a sua equipa técnica sobre uma integração, em vez de transformar um script visual num processo crítico.