Cómo personalizar el administrador Jumpseller con Tampermonkey

Tampermonkey es una extensión de navegador de terceros que ejecuta scripts de usuario: pequeños programas que pueden cambiar cómo se ve o se comporta una página en tu navegador. Un script revisado podría destacar información útil o añadir un resumen visual al administrador de Jumpseller.

No necesitas escribir código para instalar un script preparado por tu equipo técnico. Sí necesitas entender qué hace, qué permisos utiliza y en qué tienda debe funcionar. Esta guía explica la configuración en Chrome y usa un contador visual de unidades de un pedido como ejemplo.

Qué cambia y qué se mantiene

Una personalización visual cambia lo que ves en ese perfil del navegador. No es una función nativa de Jumpseller ni aparece automáticamente para tus compañeros o en otro ordenador.

El contador del ejemplo solo lee las cantidades que ya aparecen en un pedido y añade una franja. No guarda el total en el pedido, no cambia la tienda pública y no añade el total a correos ni exportaciones. Otros scripts pueden comportarse de otra manera: no supongas que todos los scripts de Tampermonkey son de solo lectura.

Para compartir la gestión de la tienda, utiliza cuentas de administrador separadas, sin compartir contraseñas. Para conocer las funciones del panel, consulta Gestión de pedidos.

Antes de empezar

• Usa Chrome en un ordenador donde tengas autorización para instalar extensiones.
• Ten acceso al administrador de tu tienda y un script revisado por alguien de confianza.
• Pide a tu equipo técnico que confirme que el script se limita a tu tienda y a las páginas necesarias.
• No uses scripts de origen desconocido, no pegues contraseñas ni tokens API en ellos y no los utilices para saltarte permisos, comprobaciones de pago o reglas de procesamiento de pedidos.

Tampermonkey no está desarrollado por Jumpseller. Un cambio en el administrador puede hacer que una personalización deje de funcionar; no se garantiza compatibilidad con todas las tiendas, navegadores o versiones futuras del panel.

1. Instala la extensión oficial

1. Abre Tampermonkey en Chrome Web Store.
2. Comprueba el nombre Tampermonkey y la web del desarrollador tampermonkey.net.
3. Pulsa Add to Chrome o Añadir a Chrome.
4. Lee el diálogo de permisos. En la instalación utilizada para esta guía, Chrome pidió leer y modificar todos tus datos en todos los sitios web, mostrar notificaciones y modificar los datos que copias y pegas. Son permisos amplios de la extensión, aunque un script concreto tenga un alcance reducido.
5. Si aceptas esos permisos y tu organización lo permite, pulsa Add extension o Añadir extensión.
6. Espera la confirmación de que Tampermonkey se ha añadido a Chrome.

Si ves Remove from Chrome o Quitar de Chrome, ya está instalada. No instales otra copia. Si tu organización bloquea la instalación, pide ayuda al administrador en lugar de saltarte la restricción.

2. Revisa los ajustes de scripts de Chrome

1. Escribe chrome://extensions/ en la barra de direcciones de Chrome y pulsa Intro.
2. Comprueba Developer mode o Modo de desarrollador. En nuestro ejemplo ya estaba activado. Si necesitas activarlo, consulta antes al administrador: también permite cargar extensiones manualmente.
3. Busca Tampermonkey y pulsa Details o Detalles.
4. Busca Allow User Scripts o Permitir scripts de usuario. En la versión de Chrome probada era un interruptor separado del modo de desarrollador.
5. Lee su advertencia sobre ejecutar código no revisado por Google. Actívalo solo cuando tu organización lo autorice y confíes en el script.

La imagen muestra los ajustes reales usados en este ejemplo, no una recreación del diálogo de instalación. Los nombres y requisitos pueden variar según la versión de Chrome; consulta la ayuda oficial de Tampermonkey si tu pantalla es diferente. Este ejemplo no necesita acceso de incógnito, acceso a archivos locales ni permisos adicionales de descarga.

3. Añade un script preparado para tu tienda

1. Abre el botón Extensiones, con forma de pieza de puzle, junto a la barra de direcciones.
2. Selecciona Tampermonkey.
3. Abre Dashboard o Panel de control.
4. Selecciona Create a new script o Crear un nuevo script.
5. Borra todo el texto de ejemplo del editor.
6. Pega el script completo que te entregó tu equipo técnico. Pégalo en este editor, no en un campo del pedido ni en la barra de direcciones.
7. Comprueba su nombre y la tienda prevista. Antes de guardar, pide a tu equipo técnico que te explique cualquier sitio web o permiso inesperado.
8. Guarda con ⌘S en Mac o Ctrl+S en Windows.
9. Confirma que en el panel haya una sola copia habilitada del script.

Sobre el ejemplo descargable: el código del contador de alejandrotest es una referencia técnica, no un script listo para tu propia tienda. Se limita deliberadamente a https://alejandrotest.jumpseller.com/admin/* y también comprueba ese dominio dentro del código. No necesita credenciales ni hace peticiones de red. Alguien técnico debe adaptar y validar el dominio, la ruta del pedido y los selectores de la página antes de entregarte una versión para otra tienda. No sustituyas el alcance por «todos los sitios web».

4. Ejemplo práctico de un contador de unidades

Imagina que vendes ingredientes de panadería. Un pedido tiene tres líneas: 3 bolsas de harina, 2 paquetes de polvos de hornear y 5 paquetes de mantequilla. Son 10 unidades, no tres unidades.

La captura siguiente es del administrador real de alejandrotest, con datos ficticios. El pedido 2416 contiene tres líneas de productos físicos sin relaciones de bundle. El script de ejemplo muestra Total de unidades: 10.

Para comprobar un contador revisado en tu propia tienda:

1. Inicia sesión en tu administrador como lo haces habitualmente.
2. Abre Pedidos y elige un pedido existente con productos normales, sin bundles.
3. Recarga la pestaña y espera a que terminen de cargar los productos.
4. Busca un único contador debajo del número del pedido.
5. Suma las cantidades de los productos y compara el resultado.
6. Abre otro pedido desde el listado. Comprueba que el total cambie para corresponder a ese pedido.
7. Vuelve al listado. El contador del ejemplo no debe permanecer allí.

Los bundles no están soportados por este ejemplo. El script suma las líneas mostradas, por lo que puede contar a la vez la línea padre del bundle y las de sus componentes. No lo uses para determinar cuántos artículos físicos debes embalar en un pedido con bundles. Tu equipo debe acordar e implementar esa regla por separado. Consulta Productos en conjunto o bundles.

El ejemplo se observó en escritorio y en vistas responsive del navegador. Instalar una extensión en Chrome de escritorio no la instala en un teléfono.

5. Desactiva o elimina una personalización

Para dejar de verla, abre Tampermonkey, busca su script, desactívalo y recarga la página del administrador. El contador del ejemplo desaparece sin cambiar el pedido.

Para borrar el script, abre Dashboard, identifica el correcto y usa su papelera. No borres otros scripts que necesites. Para eliminar la extensión completa, abre chrome://extensions/, busca Tampermonkey y pulsa Quitar. Esto también afecta a los demás scripts que gestione la extensión.

Solución de problemas

Qué ves	Qué comprobar
No cambia nada	Confirma que el script es para esa tienda y página. Revisa que Tampermonkey, el script y Allow User Scripts estén habilitados; después recarga.
Solo funciona en un ordenador	Es lo esperado en este ejemplo. Es local al perfil de Chrome donde lo instalaste.
El contador aparece dos veces	Busca copias duplicadas del mismo script. Deja una sola habilitada y recarga.
El total difiere de la cantidad para embalar	Comprueba si hay bundles. Este ejemplo no los soporta. Deja de usar ese total para despacho y consulta a tu equipo técnico.
Dejó de funcionar tras actualizar el panel	Desactívalo y pide a quien lo mantiene que revise los selectores de la página. El ejemplo oculta el total si no reconoce la tabla de productos.
Chrome pide otro permiso	Lee la solicitud exacta y consulta al administrador antes de aceptarla. No cambies otros ajustes de seguridad.

Mantén cada personalización pequeña, reversible y limitada a las páginas previstas. Si un cambio debe guardarse, compartirse entre usuarios o integrarse con el procesamiento de pedidos, utiliza una función apropiada de Jumpseller o consulta una integración con tu equipo técnico, en lugar de convertir un script visual en un proceso crítico.