Form Constructor

Questo repository serve per modificare, compilare e pubblicare la libreria che si occupa, su MyCity, di gestire il Form Constructor, ossia quel componente per creare le Istanze Online (da backoffice) e compilarle (lato cittadino).

Usare il Form Constructor

Clonare il repository Form-Constructor-PHP nella stessa cartella dove è clonato il repository MyCity-Laravel

Modificare il Form COnstructor

Nella cartella del repository Form-Constructor-PHP, installare le dipendenze con il comando

npm i

Per ricompilare in tempo reale il progetto, usare il comando

npm run dev

Testare il Form Constructor in locale su MyCity

Fuori dalla cartella Form-Constructor-PHP, lanciare il seguente comando

sudo mv MyCity-Laravel/node_modules/v-form-constructor MyCity-Laravel/node_modules/v-form-constructor-old && sudo mkdir MyCity-Laravel/node_modules/v-form-constructor && sudo mount --bind FormConstructor-PHP MyCity-Laravel/node_modules/v-form-constructor

Questo monterà la cartella del Form Constructor nella cartella node_modules/v-form-constructor di MyCity. Se si usano nomi diversi per le cartelle, vanno modificate nel comando!

Ogni volta che si fa una modifica al Form Constructor, bisogna ricompilare anche MyCity (npm run dev o make npm run dev, solito).

Una volta completate le modifiche, si può smontare la cartella e ritornare alla situazione originale con il comando

sudo umount MyCity-Laravel/node_modules/v-form-constructor && sudo rmdir MyCity-Laravel/node_modules/v-form-constructor && sudo mv MyCity-Laravel/node_modules/v-form-constructor-old MyCity-Laravel/node_modules/v-form-constructor

Sempre modificando i nomi delle cartelle con le proprie.

Questo rimuoverà da MyCity le modifiche fatte al Form Constructor, in modo da poterlo testare con le modifiche definitive.

Pubblicare e testare le modifiche

Ritorando al repository del Form Constructor, è importantissimo, prima di compilare e pubblicare le modifiche, cambiare la versione del progetto. Per farlo bisogna

• Andare sul file package.json
• Modificare il valore di "version" alle riga 4, aumentando l'ultimo numero (es. 4.1.2 -> 4.1.3)

A questo punto si può compilare la libreria con il comando

npm run build

e pubblicare, infine, le modifiche su npm con il comando

npm publish

La prima volta probabilmente chiederà di effettuare il login a npm per verificare se si hanno i permessi di modificare il repository su npm.

In questo momento si può anche fare il commit delle modifiche su GitHub.

Su MyCity

A questo punto, nel progetto locale di MyCity si può aggiornare il v-form-constructor all'ultima versione appena modificata usando il comando

npm install v-form-constructor

oppure

make npm install v-form-constructor

E verificare che il file package.json abbia la nuova versione del v-form-constructor.

Ricompilare MyCity (npm run dev o make npm run dev) e verificare se funziona tutto correttamente. Pubblicare le modifiche su GitHub.

Verificare le modifiche in staging e mettere in produzione

Per farlo, basta usare gli stessi comandi usati in locale, quindi andare sul server di staging o di produzione e usare i comandi

npm install v-form-constructor

e, infine

npm run prod