Saltar para o conteúdo principal
Centro de Suporte

Como personalizar o painel Jumpseller com o Tampermonkey

O Tampermonkey é uma extensão que permite personalizar a forma como vê o painel da sua loja. Este guia explica como adicionar um contador de unidades por encomenda, sem programar. O script é o código que vai copiar desta página.

Antes de começar

Precisa do Google Chrome atualizado num computador e de acesso ao painel da sua loja. Este exemplo funciona no ecrã atual de Encomendas, num endereço como minha-loja.jumpseller.com/admin/. Se utiliza outro domínio para o painel ou um ecrã de encomendas diferente, contacte-nos antes de instalar.

O contador aparece apenas no perfil do Chrome onde o instala. Não altera as encomendas nem acrescenta o total aos emails ou às exportações. Não o utilize para preparar encomendas com packs ou bundles, porque os seus artigos podem ser contados mais de uma vez. Não foi concebido para o Chrome em telemóveis.

1. Instale o Tampermonkey

  1. Abra o Tampermonkey na Chrome Web Store. Confirme o nome Tampermonkey e o site tampermonkey.net.
  2. Selecione Adicionar ao Chrome / Add to Chrome.
  3. Reveja as permissões apresentadas pelo Chrome. O Tampermonkey pode ler e alterar dados de todos os sites que visita; utilize apenas scripts de confiança, como o deste guia.
  4. Se aceitar as permissões, selecione Adicionar extensão / Add extension.

O Chrome confirma que a extensão está instalada. Se aparecer Remover do Chrome / Remove from Chrome, já a tem e pode continuar.

2. Permita a execução do script

  1. Escreva chrome://extensions/ na barra de endereços do Chrome e prima Enter.
  2. Localize o Tampermonkey e selecione Detalhes / Details.
  3. Ative Allow User Scripts —permitir scripts de utilizador. Leia a confirmação apresentada pelo Chrome antes de aceitar.

O interruptor deve ficar ativo, como nesta imagem:

Interruptor Allow User Scripts ativo nos detalhes da extensão Tampermonkey

Se não encontrar esta definição, atualize o Chrome e tente novamente. Se o computador não permitir atualizações, envie-nos uma captura de ecrã para podermos ajudar. Consulte também a ajuda oficial do Tampermonkey.

3. Copie e guarde o contador

  1. Selecione Copiar script completo, abaixo destes passos.
  2. Abra Extensões —o botão em forma de peça de puzzle junto à barra de endereços— e selecione Tampermonkey.
  3. Abra Painel de controlo / Dashboard e selecione Criar um novo script / Create a new script.
  4. Apague o texto inicial do editor.
  5. Cole o código com ⌘V no Mac ou Ctrl+V no Windows.
  6. Guarde com ⌘S no Mac ou Ctrl+S no Windows.
  7. Regresse ao painel do Tampermonkey e confirme que Jumpseller — Order units (visual) está ativo. Deixe apenas uma cópia do contador ativa.

Não precisa de editar o código. É executado apenas nas páginas de encomendas do painel de lojas Jumpseller, não na loja pública nem noutros sites.

// ==UserScript==
// @name         Jumpseller — Order units (visual)
// @namespace    jumpseller.local.order-units
// @version      0.3.0
// @description  Suma las cantidades ya renderizadas del pedido. Solo visual; no guarda ni envía datos.
// @match        https://*.jumpseller.com/admin/*/orders/*
// @match        https://*.jumpseller.com/admin/orders/*
// @match        https://*.jumpseller.com/admin/*/orders-v2/*
// @match        https://*.jumpseller.com/admin/orders-v2/*
// @run-at       document-idle
// @grant        none
// @noframes
// ==/UserScript==
/* Local visual helper for Jumpseller admin order pages (orders and orders-v2) only.
 * No network calls, credentials, storage or order/theme writes.
 * Bundles/packs are unsupported: parent/component rows can be double-counted.
 * If the admin markup changes, disable the script and request a review.
 */
(() => {
  'use strict';
  if (!/^([a-z0-9]+(?:-[a-z0-9]+)*)\.jumpseller\.com$/i.test(location.hostname) || window.top !== window.self) return;
  // Supports both order screens: /admin/<locale>/orders/edit/<ID> and /admin/<locale>/orders-v2/edit/<ID>.
  if (location.protocol !== 'https:' || !/^\/admin\/(?:[a-z]{2}(?:-[a-z]{2})?\/)?orders(?:-v2)?(?:\/|$)/i.test(location.pathname)) return;
  const ROUTE = /^\/admin\/(?:([a-z]{2})(?:-[a-z]{2})?\/)?orders(?:-v2)?\/edit\/(\d+)\/?$/i;
  const KEY = '__jumpsellerVisualOrderUnits';
  const ID = 'jumpseller-visual-order-units';
  window[KEY]?.stop?.();
  let scheduled = null;
  let stopped = false;
  const routeId = () => location.pathname.match(ROUTE)?.[2] || null;
  const SPANISH = ['es', 'cl', 'mx', 'ar', 'co', 'pe', 'uy', 'ec', 'bo', 'py', 've', 'cr', 'gt', 'do', 'pa', 'sv', 'hn', 'ni'];
  const loc = (location.pathname.match(ROUTE)?.[1] || document.documentElement?.lang || 'en').slice(0, 2).toLowerCase();
  const labels = ['pt', 'br'].includes(loc)
    ? ['Total de unidades', 'linhas de produto', 'Cálculo local; não é guardado. Bundles não suportados.']
    : SPANISH.includes(loc)
      ? ['Total de unidades', 'líneas de producto', 'Cálculo local; no se guarda. Bundles no soportados.']
      : ['Total units', 'product lines', 'Local calculation; not saved. Bundles unsupported.'];
  function remove() { document.getElementById(ID)?.remove(); }
  function directText(element) {
    return Array.from(element.childNodes).filter(n => n.nodeType === 3).map(n => n.textContent).join('');
  }
  function readTable(table) {
    let units = 0, lines = 0;
    for (const row of table.querySelectorAll('tbody > tr')) {
      // Product rows show "$price x qty" in a div; subtotal/shipping/total rows don't.
      // The product image is not required: it can be missing and its markup differs between screens.
      const price = row.querySelector('td > div.tabular-nums');
      if (!price) continue;
      const match = directText(price).trim().match(/\s[x×]\s*(\d+)\s*$/u);
      if (!match) throw Error('Unrecognized quantity');
      const qty = Number(match[1]);
      if (!Number.isSafeInteger(qty) || qty < 0 || !Number.isSafeInteger(units + qty)) throw Error('Invalid quantity');
      units += qty; lines++;
    }
    if (!lines) throw Error('No product rows');
    return { units, lines };
  }
  function update() {
    scheduled = null;
    if (stopped) return;
    const id = routeId();
    if (!id) { remove(); return; }
    // Show a total only when the displayed order matches the current page.
    const headings = Array.from(document.querySelectorAll('.text-xl.font-normal'))
      .filter(e => new RegExp('#\\s*' + id + '\\s*$').test(e.textContent.trim()));
    if (headings.length !== 1) { remove(); return; }
    const heading = headings[0];
    const root = heading.parentElement;
    const tables = Array.from(root.querySelectorAll('table.w-full.border-collapse'))
      .filter(t => t.querySelector('tbody > tr > td > div.tabular-nums'));
    if (tables.length !== 1) { remove(); return; }
    let count;
    try { count = readTable(tables[0]); }
    catch (_) { remove(); return; } // Fail closed: no misleading partial count.
    let badge = document.getElementById(ID);
    if (!badge) {
      badge = document.createElement('div');
      badge.id = ID;
      badge.setAttribute('role', 'status');
      badge.setAttribute('aria-live', 'polite');
      badge.style.cssText = 'margin:8px 0;padding:10px 14px;border:1px solid #d1d5db;border-radius:6px;background:#f8fafc;color:#111827;font-size:15px;font-weight:600';
      heading.insertAdjacentElement('afterend', badge);
    } else if (badge.previousElementSibling !== heading) {
      heading.insertAdjacentElement('afterend', badge);
    }
    const label = `${labels[0]}: ${count.units}`;
    if (badge.textContent !== label) badge.textContent = label;
    const title = `#${id} · ${count.lines} ${labels[1]} · ${labels[2]}`;
    if (badge.title !== title) badge.title = title;
  }
  function schedule() {
    if (!stopped && scheduled === null) scheduled = setTimeout(update, 80);
  }
  const observer = new MutationObserver(schedule);
  observer.observe(document.body, { childList: true, subtree: true, characterData: true });
  const interval = setInterval(schedule, 1000); // URL changes with no DOM event.
  const handle = {
    stop() {
      stopped = true;
      observer.disconnect();
      clearTimeout(scheduled);
      clearInterval(interval);
      remove();
      if (window[KEY] === handle) delete window[KEY];
    }
  };
  window[KEY] = handle;
  update();
})();

Se o botão não conseguir copiar, o código fica selecionado: prima ⌘C ou Ctrl+C. Também pode transferir o script.

4. Verifique o total de uma encomenda

  1. Abra Encomendas no painel da sua loja e escolha uma encomenda sem packs ou bundles.
  2. Recarregue o separador e aguarde até os produtos aparecerem.
  3. Procure Total de unidades —ou Total units se o painel estiver em inglês— por baixo do número da encomenda.
  4. Some as quantidades e confirme que coincidem. Depois, abra outra encomenda e verifique o total.

Exemplo: encomenda com 10 unidades. Três sacos de farinha, duas embalagens de fermento em pó e cinco embalagens de manteiga somam 3 + 2 + 5 = 10.

Exemplo de encomenda com quantidades 3, 2 e 5 e um contador de 10 unidades

5. Desative ou remova o contador

  1. Abra Tampermonkey → Painel de controlo / Dashboard.
  2. Desative Jumpseller — Order units (visual).
  3. Recarregue a encomenda. O contador desaparece sem alterar os seus dados.

Para eliminar o script, utilize o ícone do caixote do lixo junto ao nome. Para remover o Tampermonkey por completo, abra chrome://extensions/ e selecione Remover na extensão; isto afeta também outros scripts que tenha instalado.

Precisa de ajuda?

O que acontece O que fazer
O contador não aparece Confirme que o Tampermonkey, o script e Allow User Scripts estão ativos. Abra uma encomenda e recarregue.
Aparecem dois contadores Desative as cópias anteriores e deixe apenas uma ativa. Depois recarregue.
O total não coincide Se a encomenda contém packs ou bundles, não utilize este total para a preparar. Se não contém, desative o contador e avise-nos.
Deixou de aparecer após uma alteração no painel Desative-o e envie-nos uma captura de ecrã para podermos ajudar.
O Chrome indica que a empresa bloqueia a instalação Peça ajuda à pessoa que configura ou mantém esse computador.

Se não conseguir concluir um passo, envie-nos uma captura ou fotografia do ecrã e explique o que pretendia fazer. Assim poderemos ajudar a continuar.

Comece a vender connosco!

Comece o seu período experimental gratuito de 7 dias. Sem necessidade de cartão de crédito.