Paneles de la comunidad

Los paneles de la comunidad los hacen personas fuera de Deska. Los recorres en la sección Paneles de la Tienda (el botón Tienda arriba a la derecha, o Descubrir en la Biblioteca de paneles, que la abre), cincuenta a la vez, con Ver más paneles debajo de la lista para los siguientes. La Biblioteca de paneles (Cmd/CtrlShiftE) guarda Instalados, los que agregaste, y Crear un panel, donde haces el tuyo; al abrir un panel desde la Tienda, su página se muestra ahí. La barra de búsqueda de la biblioteca también busca entre los paneles de la comunidad.

Abre un panel para leer su página: qué hace, qué puede hacer además de dibujar en su propio panel, a qué sitios se conecta, dónde aparece (en tu escritorio, y en Extras cuando tiene una fila ahí), su versión, su tamaño y cuántas personas lo instalaron. Instalar y agregar te muestra otra vez los permisos y los sitios antes de copiar nada, luego descarga el panel, lo compara con la copia que lista deska.dev y lo pone en tu escritorio. Para instalar necesitas haber iniciado sesión, en cualquier plan.

Lo que instalas sigue a tu cuenta. Inicia sesión en otra computadora y Deska instala ahí los mismos paneles, con los permisos que ya diste. Cada computadora guarda su propia copia y sus propios datos del panel, y un panel instalado sigue funcionando sin conexión. La sección Paneles instalados de tu página de cuenta muestra cada panel que instaló tu cuenta, con su versión y lo que le permitiste hacer.

Un panel de la comunidad es código web: páginas, scripts, estilos, imágenes y fuentes. Deska lo corre en un sandbox, dentro de su propio panel. Sin pedir nada, un panel puede dibujar en ese panel, guardar sus propios datos y archivos en esta computadora, seguir tu tema y saber si lo estás viendo. También puede ofrecerte guardar un archivo, y tú eliges dónde en el diálogo de guardar de tu sistema.

Todo lo demás es un permiso que el panel pide, y tú lo das al instalarlo:

• Enviar notificaciones: avisos en Deska, como el fin de un temporizador, con el nombre del panel, como máximo uno cada diez segundos.
• Abrir enlaces: enlaces https en tu navegador, solo mientras usas el panel. Deska te pregunta la primera vez para cada sitio.
• Copiar al portapapeles: texto o imágenes, solo mientras usas el panel. Sin este permiso un panel no puede copiar nada; copiar texto que seleccionas en él funciona como en cualquier otro lugar.

Sitios. Un panel lista los sitios a los que se conecta, y puede llegar a esos y a ningún otro. Un panel del clima lista su servicio del clima; un temporizador no lista ninguno y no puede llegar a internet. La página del panel lista todos sus sitios. La pregunta que hace Deska antes de instalarlo también los nombra, o los primeros cinco y cuántos más cuando son siete o más; una actualización que quiere sitios nuevos los nombra todos.

Un panel nunca puede leer tus archivos, tus otros paneles, tus agentes ni lo que hacen, tus sesiones ni tu cuenta de Deska. Solo ve un archivo cuando tú lo eliges, lo pegas o lo sueltas en el panel, y nunca sabe dónde guardaste uno. No puede ejecutar nada en tu computadora, y se detiene cuando ninguno de sus paneles está abierto.

Cada panel de la comunidad lo hace su autor, no Deska, y su página lo dice: Hecho por <autor>, no por Deska. Corre en un sandbox. El autor es el nombre que eligió quien lo hizo, y ningún nombre ni autor de un panel puede hacerse pasar por Deska ni por Dex.

Deska invita a los autores que publican, revisa cada versión con las reglas de esta página cuando llega, y puede retirar un panel o una sola versión. Un panel retirado deja de cargar en todas las computadoras que lo tienen, dice que Deska lo quitó y ya no se puede instalar. Deska busca paneles retirados al abrirse y cada seis horas. Si un autor borra su cuenta, sus paneles salen de Descubrir, y las computadoras que los tienen los conservan.

Cuando sale una versión más nueva, la tarjeta y la página del panel ofrecen Actualizar a esa versión. Si la versión nueva pide un permiso o un sitio que no diste, Deska vuelve a preguntar primero y te dice qué es nuevo. Actualizar recarga las copias abiertas del panel, y el panel conserva lo que guardó: eso vive en esta computadora, no en la versión.

Quitar quita el panel de esta computadora y de la lista de tu cuenta, así que la próxima computadora en la que inicies sesión no lo instala. Si el panel está abierto en tu escritorio, Deska te avisa antes, y la copia abierta dice después que no está instalado. Quitarlo borra lo que el panel guardó en esta computadora.

Quitar, en Paneles instalados de tu página de cuenta, saca un panel de la lista de tu cuenta sin tocar ninguna computadora: las computadoras en las que inicies sesión desde entonces no lo instalan, y las que ya lo tienen lo conservan hasta que lo quites en su Biblioteca de paneles. Actualizarlo en una de ellas lo vuelve a poner en la lista. La lista también te dice cuando sale una versión más nueva, y conserva los paneles que Deska retiró, marcados, hasta que los quites.

Una computadora conserva sus paneles sin importar quién inicie sesión, con los permisos con que se instalaron, y agrega los que instaló la otra cuenta.

Un panel que agrega una fila a Extras puede mantenerla o no: Ocultar de Extras está en su tarjeta en Instalados.

Un panel es una carpeta de archivos web con un panel.json en la raíz. No hay paso de compilación ni nada que alojar: Deska le sirve la carpeta al propio panel, dentro de un sandbox, y la página solo habla con Deska a través de window.deska, el SDK que Deska sirve en /__deska/sdk.js. Para probar uno, abre Crear un panel en la biblioteca, elige Cargar una carpeta y selecciona la carpeta donde está panel.json: Deska la revisa, te dice qué corregir y recarga el panel cada vez que cambia un archivo.

Todo lo que hace falta para crear uno ahora tiene su propia sección, Crear paneles:

deska-panels-examples en GitHub reúne catorce paneles de código abierto, con licencia MIT, cada uno escrito para enseñar una parte del SDK, junto a una carpeta inicial y una herramienta de vista previa. Empieza por Team Clocks, ten SDK Playground abierto mientras construyes, y míralos todos, con capturas, en Paneles de ejemplo.

Por ahora publicar está abierto a autores invitados. Haz tu solicitud en deska.dev/panels/apply (o pulsa Pedir permiso para publicar en Crear un panel). Cuando aprueben tu cuenta, abre la página de tu carpeta cargada en Crear un panel, pulsa Publicar, escribe qué cambió y confirma.

• La primera versión reserva el id del panel para tu cuenta, y una versión publicada nunca cambia: sube version para publicar otra vez.
• A quien instaló una versión anterior se le vuelve a preguntar antes de una actualización que pida un permiso o un sitio nuevo.
• La sección Paneles de la comunidad de tu cuenta muestra lo que publicaste; Ocultar saca un panel de Descubrir mientras las computadoras que lo tienen lo conservan.

Las versiones, los límites y cada rechazo están en Publicar. ¿Dudas? Escribe a [email protected].