Preguntas frecuentes
¿Cómo instalo un widget en mi sitio?
Copia el snippet que ves en la página del widget y pégalo justo antes de </body> o donde quieras que aparezca. El script es async, no bloquea la carga. En WordPress puedes pegarlo en un bloque HTML o en el área de Widgets/HTML personalizado.
¿El widget afecta el rendimiento o el SEO?
No. El script se sirve comprimido y en CDN; es asíncrono y se renderiza en el cliente. Google ve el contenido resultante como parte de la página, y el enlace de atribución es discreto. Si usas LCP/CLS, no debería moverse porque reservamos espacio desde el inicio.
¿Es obligatorio mostrar la atribución “i”?
Sí en el plan gratuito. Es pequeña (icono “i”) y accesible. Si necesitas quitarla, contáctanos para un plan sin atribución.
¿Puedo personalizar colores, tema y qué métricas mostrar?
Sí. En la página del widget tienes un configurador visual: tema (claro/oscuro/auto), superficie (con fondo/transparente), colores (texto, fondo, borde, “píldoras”) y qué métricas mostrar (sensación, humedad, viento, máx/mín, lluvia, UV). El snippet se actualiza automáticamente.
¿Cómo eligen las provincias/ciudades y con qué frecuencia se actualiza el clima?
Usamos coordenadas por provincia y actualizamos los datos cada hora en nuestro servidor. Si alguna actualización falla, servimos el último valor válido hasta la siguiente.
¿De dónde salen los datos del clima?
De Open-Meteo y fuentes públicas equivalentes. Nosotros los normalizamos, cacheamos y servimos desde nuestra API para asegurar estabilidad y velocidad.
¿Necesito un token o clave?
Por ahora no es obligatorio. Más adelante podremos habilitar tokens para controlar abusos y ofrecer cuotas mayores. Cuando pase, mantendremos compatibilidad con los snippets existentes.
¿Qué pasa si veo “No se pudo cargar el clima ahora mismo”?
Suele ser un bloqueo de red, un cortafuegos/CSP, o una caída puntual de la API. Comprueba:
Que el dominio permita cargar https://widgets.directoriocubano.info/*.
Que tu CSP permita script-src y connect-src hacia nuestro dominio.
Vuelve a cargar: tenemos fallback y reintentos.
¿Funciona en WordPress, Blogger u otros CMS?
Sí. Basta con pegar el snippet como HTML. En WordPress evita editores que “limpian” etiquetas <script> (pega en HTML personalizado o en el footer del tema).
¿Puedo usarlo en sitios con HTTPS/HTTP?
Recomendamos HTTPS. Sirve en HTTP, pero algunos navegadores bloquean contenido mixto si tu web es HTTPS y la solicitud del widget no lo es (nuestro script siempre es HTTPS).
¿Puedo poner varios widgets en la misma página?
Sí. Puedes repetir el snippet con distintas opciones (por ejemplo, varias provincias). El script detecta y renderiza cada instancia.
¿Hay límites de uso?
No actualmente. En el futuro podemos poner límites razonables para evitar abuso. Para medios con mucho tráfico, contáctanos y ajustamos la cuota o habilitamos token dedicado.
¿Recogen analíticas o datos de mis usuarios?
Solo métricas de uso anónimas (cargas del widget, clics en la atribución) para estadísticas y mejora del servicio. No recopilamos datos personales ni rastreamos entre sitios.
¿Puedo precargar/auto-hostear el script?
Mejor no: publicamos versiones con parches y mejoras. Si necesitas pinnear una versión concreta, indícanos y te damos una URL versionada (por ejemplo widget.clima.v1.js?v=1.0.3).
¿Cómo reporto un error o solicito un widget nuevo?
Escríbenos con la URL de tu página, el snippet exacto y una captura de consola (F12 → Console). También puedes proponer widgets (TV cubana, radio, tarifa eléctrica, etc.). Priorizamos por demanda.
¿Se puede usar modo “transparente” para que el fondo sea del sitio?
Sí: usa data-surface="transparent". En el configurador puedes verlo al instante y copiar el snippet generado.
¿El widget respeta el modo oscuro del sitio?
Si defines data-theme="auto", el widget se adapta a la preferencia del usuario/sistema. También puedes forzar light u dark.
¿Qué compatibilidad de navegador tienen?
Soportamos los principales navegadores modernos (Chromium, Firefox, Safari, Edge). Para IE no damos soporte.
¿Se puede internacionalizar el idioma?
Por defecto el contenido sale en español. Si necesitas otros idiomas, contáctanos; la plataforma soporta i18n y podemos habilitar data-locale.
¿Cómo me aseguro de que el snippet no se corta en mi CMS?
Si tu CMS escapa <script>, muéstralo en tu web como código usando htmlspecialchars (para verlo) y, para copiar, usa un botón que reconstruya el snippet (como hacemos en nuestro home).