FAQ - TheBronx/shurscript GitHub Wiki
#general
#nofunciona
¿Por qué no me funciona el script?
TL;DR: Reinstala el script. Si no funciona tras reinstalar, reinstala la extensión e instala el script de nuevo. Si sigue sin funcionar, lee las últimas páginas del hilo oficial y si no encuentras la solución, reporta el problema detalladamente.
En primer lugar, queremos advertirte que shurscript es un script desarrollado en Javascript que utiliza una extensión para cargarse en ForoCoches. Esto hace que sea "cross-browser" y por tanto, puede dar lugar a incompatibilidades en algunos navegadores, versiones y/o extensiones, por lo que que shurscript no funcione por muchas causas.
La forma más frecuente de que shurscript no funcione suele ser un fallo en el desarrollo que posiblemente hayamos corregido ya o un problema con la extensión de tu navegador, por lo que lo más sencillo y generalmente efectivo, es reinstalar el script.
Para reinstalar el script, instálalo de nuevo pulsando en el enlace de la versión estable o desarrollo que encontrarás en la página principal, dependiendo de cual estuvieses utilizando anteriormente.
Si esta solución no funciona, prueba a realizar el mismo procedimiento pero esta vez, elimina de tu navegador la extensión (TamperMonkey, GreaseMonkey, Scriptish...), cierra y vuelve a abrir el navegador, reinstala la extensión e instala el script de nuevo.
Si tras reinstalar el script y/o la extensión el script continúa sin funcionar, prueba las siguientes soluciones frecuentes:
- Si estás utilizando Chrome, generalmente el script tarda en funcionar tras instalarlo, esto es, posiblemente tenga que descargar ciertas dependencias y hasta que este proceso no finalice, no aparecerá en ForoCoches. Si acabas de instalarlo, espera unos minutos.
¿No se ha podido contactar con el cloud de shurscript?
Algunas comunicaciones con el servidor cloud de Shurscript no están siendo permitidas
Parte de las funcionalidades de shurscript están respaldadas por un servidor cloud que nos ayuda a ciertas tareas como la sincronización de preferencias entre dispositivos y navegadores. Este servidor, debe ser accesible por el equipo y nada debe interferir en su tráfico, pues de lo contrario, el script podría no funcionar.
Si te ha aparecido un mensaje de error avisándote de que algo puede no funcionar en el servidor de shurscript una vez, haz caso omiso, habrá sido algo temporal.
Si el problema persiste y aparece el mensaje constantemente o con mucha frecuencia, comprueba que:
- No utilizas un software de VPN o un Proxy que pueda estar interceptando algunas peticiones PUT (si no sabes lo que es, probablemente no lo utilices). Desactiva cualquier software de este tipo y prueba si funciona el script.
- Si usas NoScript debes añadir
shurscript.orga la lista de dominios permitidos. De paso permite tambiénimgur.comsi no quieres que la subida de imágenes falle ;) - Comprueba si el puerto 8080 es accesible desde tu equipo visitando esta página web.
- Si no te funciona, tu router o firewall está bloqueando la conexión, y shurscript no puede contactar con el servidor. No hay motivos para bloquear este puerto, modifica la configuración de tu router/firewall.
- Si por el contrario has podido acceder a esa página, el puerto 8080 no está bloqueado, por tanto alguien está impidiendo el acceso a nuestro servidor por otros motivos, coméntalo en el hilo oficial de Shurscript.
Si no das con el problema deja constancia de lo que has probado y lo que te falla en el hilo oficial.
#como
¿Cómo personalizo las opciones de shurscript?
Puesto que shurscript es un conjunto de módulos con múltiples opciones de personalización y para facilitar en todo lo posible su utilización, hay disponible un panel de preferencias desde el que se centralizan todas las opciones.
Para abrir el panel de preferencias de shurscript, has de pulsar sobre el botón de shurscript situado en la parte superior derecha del foro, justo debajo del logo de ForoCoches.
¿Cómo activo o desactivo una funcionalidad del script?
Todos los módulos están agrupados y se activan, desactivan y configuran desde el panel de preferencias de shurscript.
Has de dirigirte a dicho panel de preferencias y desde allí, realizar las funciones tal como se indica en la imagen siguiente.
#reportar
¿Cómo enviar un reporte de error desde shurscript?
Hemos implementado una utilidad para el reporte de errores desde el propio script, pero únicamente servirá si este está en ejecución. Utiliza esta utilidad para hacernos llegar de una forma automatizada pequeños fallos o bugs que encuentres relacionados con algunos módulos o uso general del script.
Para enviar un reporte de error desde shurscript, has de desplegar las preferencias y acceder a la pestaña: "Reporte de error" desde la cual tendrás rellenos ciertos campos relativos a tu navegador, el registro del script y tu usuario. Debes añadir un reporte lo más claro y detallado posible y enviarnos haciendo uso del botón correspondiente, este reporte.
Si necesitamos más información, contactaremos contigo por MP.
¿Cómo mostrar la consola para ver errores?
Si el script aparece en GreaseMonkey/TamperMonkey indicando que está instalado y ejecutándose pero no ves la barra con el icono de 
shurscript, ni el contador de menciones... probablemente algo falle con el script. Con el fin de que podamos investigar este suceso, deberás enviarnos algo de información que aparece en la consola de Javascript de tu navegador:
- Abre la página de ForoCoches en la que esté fallando el script
- Pulsa la tecla F12 (si F12 no funciona, prueba con la combinación Ctrl+Shift+i)
- Selecciona la pestaña "Consola"
- Recarga la página
- Agranda la consola para que se vean todos los mensajes, haz una captura de pantalla y envíanosla
- No publiques la captura de pantalla ya que puede contener tu APIKey. En su lugar, envíala por MP a xus0, TheBronx o Fritanga
#colabora
¿Puedo sugerir una funcionalidad?
¡Claro! El desarrollo de shurscript se basa en las funcionalidades que sus usuarios sugieren y votan en el UserVoice que tenemos disponible.
Si te gustaría que implementásemos alguna funcionalidad, sugiérela y trata de promoverla a otros usuarios para que la voten. Si la funcionalidad está entre las más votadas y es viable de ejecutar, la tomaremos en cuenta y trataremos que esté disponible en futuras versiones.
¿Puedo hacer una contribución al shurscript?
Si te encanta el trabajo que realizamos y deseas contribuir económicamente al mantenimiento de la infraestructura cloud que utilizamos y, de paso, pagarnos una merecida cerveza, puedes aportar un par de euros a modo de donación desde nuestra página de colaboraciones y dejarnos si lo crees conveniente, un mensaje de agradecimiento que quedará para la posteridad.
¿Puedo desarrollar mis propios módulos para shurscript?
En este momento, shurscript está desarrollado siguiendo una estructura modular que permite que cualquier persona con conocimientos de Javascript/jQuery, CSS y HTML pueda desarrollar sus propios módulos. Tenemos disponible una plantilla y funciones helpers para que el desarrollo sea lo más fácil posible. Si estás interesado en colaborar en la programación, ¡ponte en contacto con nosotros y te diremos por donde empezar!
#otros
¿Es seguro shurscript? ¿Está en peligro mi contraseña, datos bancarios y mi ganado?
Si estás dudando de la seguridad de shurscript, deja que primero te contemos algo: shurscript es el resultado de invertir muchísimas horas por parte de mucha gente (desarrolladores, betatesters...), admitimos el apoyo de cualquier desarrollador que quiera sumarse al proyecto, betatesters para probar las funcionalidades y apoyo económico para mantener el servidor. Desarrollamos las funcionalidades que sus usuarios nos hacen llegar, todo con constancia, ganas e ilusión.
Publicamos el código fuente del script íntegro, de tal forma que cualquiera puede verlo, analizarlo y, si quiere, modificarlo y utilizar su propia versión. La mejor forma de comprobar la seguridad del script es acceder al código fuente que alojamos en GitHub, analizarlo y tomar tu propia decisión.
Diseñamos el script para que solo funcione en ForoCoches y además, solo si el usuario tiene iniciada sesión, es decir, nunca verás funcionar shurscript en una pantalla de login. Si esto no es suficiente para introducir tu contraseña estando tranquilo, puedes deshabilitar shurscript desde la extensión del navegador antes de iniciar sesión y habilitarla de nuevo tras ello.
Si aún tras leer esto no quedas convencido, te pedimos encarecidamente que, por favor, no utilices el script y trates de contactar con el administrador de ForoCoches para que implemente de forma nativa las funcionalidades que shurscript ofrece y, de paso, si tan interesado estás por la seguridad, que implemente SSL.
#modulos
#donde
¿Dónde está el modo noche?
El modo noche ha sido retirado de shurscript desde la versión 0.20.4 (estable) en adelante, motivado por su pobre funcionamiento. Debido a que el script ha de cargarse al final de toda la carga de la web, sufríamos un ticking por el cual el foro se veía en su color original medio segundo y de nuevo en modo noche, una acción muy molesta.
Para recuperar esta funcionalidad, no obstante, puedes instalar el complemento de navegador Stylish para Firefox o Chrome y añadir el skin de modo noche que utilizábamos en shurscript y así recuperar la funcionalidad óptima.
#como
¿Por qué se me notifica de citas que no son mías?
Por defecto, shurscript te notifica cuando se envía un mensajes que contiene tu nombre usuario, por ejemplo, si tu usuario de ForoCoches es "pole", shurscript te notificará cada vez que alguien diga la palabra "pole".
Puedes desactivar esta función y hacer que shurscript solo te notifique cuando alguien te cite en un mensaje. Para ello, debes:
- Abrir las preferencias de shurscript
- Desplegar las opciones del módulo "Notificador de citas o menciones"
- Desmarcar la casilla correspondiente.
¿Por qué no me oculta/resalta hilos por palabras clave?
Si el módulo "Filtrado de hilos" no funciona como debería pues a pesar de haber añadido palabras clave para ocultar o resaltar hilos no se están aplicando las reglas, comprueba lo siguiente:
- Que la casilla "Avanzado: Usar expresión regular en las palabras clave" está desmarcada
- Que estás separando las palabras clave con comas y no con otro signo de puntuación
- Que en la vista del subforo hay hilos que contienen dichas palabras claves en su título.
¿Cómo muestro un hilo que previamente he ocultado?
Si has ocultado un hilo manualmente y deseas que vuelva a aparecer en la lista de hilos de un subforo, has de desplegar el panel de hilos ocultos ubicado justo encima de la lista de hilos y chinchetas de dicho subforo. Una vez el panel esté desplegado, pulsamos en el icono de roto2 del hilo que sacará un botón para volver a mostrarlo.
