Changes at "[Workshop 1] Hacking Decidim: I have installed Decidim, now what?"

• Iván Vergés (Platoniq)

Instalar Decidim és un repte, aplicar el seu ús amb èxit en una comunitat un altre. La capacitat d’adaptar el software a les persones que l’han de fer servir és clau. Una de les parts més demandades un cop instal·lat el software inclou personalizar en major o menor mesura l’estètica o la lògica de funcionament. Això inclou des de canviar elements gràfics, textos, colors o comportaments predefinits dels components interns. No obstant no hi ha molts elements de la documentació que indiquin com aconseguir-ho.

La intenció és desenvolupar una xerrada/taller que dongui eines als programadors nouvinguts a Decidim per poder manipular i personalitzar el comportament de l’eina un cop ja s’ha instal·lat amb èxit.

La sessió està dirigida a persones amb un mínim coneixement de programació, no es requereix conèixer ruby o rails, pero si nocions de CSS i algun llenguatge de programació. El taller consistirà en una primera part explicativa amb diapositives i exemples reals i d’una segona on els assistents tindran l’oportunitat de treballar sobre màquines virtuals amb Decidim pre-instal·lat i aplicar les seves pròpies idees. Es requerirà que els assistents portin un ordenador portàtil on poder executar una màquina virtual (vagrant o docker) ja preparada per fer les proves.

Depenent del temps disponible i la capacitat dels assistents es tractaran els temes següents:

1. Introducció a la configuració Rails de Decidim per serveis externs.

2. Personalizació bàsica de la interfície d’usuari, modificacions CSS i Javascript.

3. Modificació html per canvis més profunds en les vistes. Afegir/configurar mòduls externs.

4. Manipular i canviar el comportament intern d’algunes funcions del core de Decidim (per exemple funcions de validació de formularis).

És possible fer el taller en català/castellà o anglès en funció dels assistents.

• Iván Vergés (Platoniq)

Instalar Decidim es un reto, aplicar su uso con éxito en una comunidad otro. La capacidad de adaptar el software a las personas que lo han de utilizar es clave. Una de las partes más demandadas una vez instalado el software incluye personalizar en mayor o menor medida la estética o la lógica de funcionamiento. Esto incluye desde cambiar elementos gráficos, textos, colores o comportamientos predefinidos de los componentes internos. Sin embargo no hay muchos elementos de la documentación que indiquen cómo conseguirlo. 

La intención es desarrollar una charla/taller que dé herramientas a los programadores recientemente llegados a Decidim para poder manipular y personalizar el comportamiento de la herramienta una vez ya se ha instalado con éxito.

La sesión estaría dirigida a personas con un mínimo conocimiento de programación, no se requiere conocer ruby o rails, pero sí nociones de CSS y algún lenguaje de programación. El taller consistiría en una primera parte explicativa con diapositivas y ejemplos reales y de una segunda donde los asistentes tendrán la oportunidad de trabajar sobre máquinas virtuales con Decidimos pre-instalado y aplicar sus propias ideas. Se requerirá que los asistentes lleven un ordenador portátil donde poder ejecutar una máquina virtual (Vagrant o docker) ya preparada para hacer las pruebas.

En función del tiempo disponible y de la capacidad de los asistentes, se tratarán los siguientes temas:

1. Introducción a la configuración Rails de Decidimos para servicios externos.

2. Personalización básica de la interfaz de usuario, modificaciones CSS y Javascript.

3. Modificación html para cambios más profundos en las vistas. Añadir / configurar módulos externos.

4. Manipular y cambiar el comportamiento interno de algunas funciones del core de Decidim (por ejemplo funciones de validación de formularios).

Es posible hacer el taller en catalán / castellano o inglés en función de los asistentes.

• Iván Vergés (Platoniq)

To install Decidim is a challenge, to apply its use successfully in a community a different one. To have the ability to adapt the software to the people who use it is key. One of the most requested parts once the software is installed includes customizing the aesthetics or operating logic, to a greater or lesser degree. This includes changing the graphic elements, texts, colors or predefined behaviors of the internal components. However, there are still not many elements of the documentation that indicate how to achieve it. 

Our intention is to develop a talk/workshop that provides new tools to newly arrived programmers at Decidim so that they can manipulate and customize the behavior of the tool once it has been successfully installed. The session would be aimed at people with a minimum knowledge of programming, it is not necessary to know ruby or rails, but notions of CSS and some programming language are necessary. The workshop will consist of a first explanatory part with slides and real examples and a second one where attendees will have the opportunity to work on virtual machines with Decidim preinstalled and apply their own ideas. It will be required that the assistants take a laptop where you can run a virtual machine (roaming or docker) already ready to do the tests.

Depending on the available time and the capability of the attendees, the following topics will be discussed:

1. Introduction to the Rails of Decidim for external services.

2. Basic customization of the user interface, modifications CSS and Javascript.

3. HTML modification for deeper changes in views. Add / configure external modules.

4. Manipulate and change the internal behavior of some of the functions of the Decide core (for example, validation of forms).

It is possible to do the workshop in Catalan / Spanish or English depending on the attendees.