Documentar Galerías

[tomas]

Una galería (Gallery) es básicamente un conjunto de GalleryItem, iterable, y que al igual que un Menu posee un handle (slug) y un nombre.

Un GalleryItem es la unión entre un link y un asset. Tiene los siguientes métodos:

• url
• image (devuelve un asset, por lo que se pueden llamar todos los métodos de un asset)
• title (alias de image.title)
• description (alias de image.description)

Ejemplo en código:

{% for item in galleries.bienvenida.items %}
  <a href="{{ item.url }}" title="{{ item.description }}">
    <img src="{{ item.image.medium }}" alt="{{ item.title }}" />
  </a>
{% endfor %}

Esto debería ir dentro de sintaxis / variables, independiente de que pongamos ejemplos en otros lados de la documentación.

[tomas]

Voy a agregar acá los comentarios que se hicieron sobre la nueva documentación de galerías.

---

• Podría empezar con una foto de una galería hecha y diseñada. Donde empieza con foto del admin no queda muy claro qué son las galerías ni para qué sirven. Como que entra al admin altiro, con poco contexto.
• galeria-footer.js requiere jquery, pero la mayoría de las tiendas ya tienen jquery.
• Lo otro es que encuentro que no queda muy claro quién es el público de esto. Por un lado muestra cómo administrar galerías en el admin (público: locatario), pero luego una serie de pasos cortar y pegar sin explicación de lo que hace el código. Lo más probable es que si un locatario trata de hacer eso por su cuenta romperá algo, o querrá arreglar el CSS.

De repente quedaría más claro dividido en 2, con públicos distintos: un artículo sobre cómo administrar galerías (la primera parte de este), con un link a otro artículo orientado a diseñadores que explique el detalle del código.

Básicamente la división que creo que es útil es separar las cosas que necesitan interacción frecuente de parte del locatario (administrar datos), de las cosas que necesitan sólo intervención inicial de parte de especialistas (plantillas)

Ah, y por último hay que modificar este: http://wiki.bootic.net/es/diseno/recetas/galeria-de-productos

De repente ese puede ser el artículo orientado a diseñadores. De hecho sólo habría que cambiar el primer ejemplo de código, y poner un link al artículo para locatarios para complementar cómo se administran las galerías en el panel

---

a primera vista se ve bien la documentación, con imágenes y todo, pero como que le habla a dos personas distintas. la sección "administración" del wiki es como para el locatario. todo lo que sea código debería ir en la parte de plantillas.

y además debería incluirse la documentación del elemento gallery y gallery_item dentro de variables: http://wiki.bootic.net/es/diseno/sintaxis/variables