Aggiornamento documentazione

README.md

@@ -4,12 +4,14 @@
   </a>
 
   <p align="center">
-    Il gestionale open source per l'assistenza tecnica e la fatturazione.
+    Il software gestionale open source per l'assistenza tecnica e la fatturazione.
     <br>
     <br>
+    <a href="http://openstamanager.com">Sito web</a>
+    &middot;
     <a href="https://devcode-it.github.io/openstamanager">Documentazione tecnica</a>
     &middot;
-    <a href="http://openstamanager.com">Sito ufficiale</a>
+    <a href="http://openstamanager.com/forum">Forum</a>
   </p>
 </p>
 

couscous.yml

@@ -13,10 +13,10 @@ github:
     repo: openstamanager
 
 title: OpenSTAManager
-subTitle: Il gestionale open source per l'assistenza tecnica e la fatturazione
+subTitle: Il software gestionale open source per l'assistenza tecnica e la fatturazione
 fontAwesomeIcon: fa fa-cog
-footerText: 'Progettato e sviluppato da DevCode.'
+footerText: 'Progettato e sviluppato da <a href="http://devcode.it/">DevCode</a>.'
-##googleAnalyticsCode: GOOGLE-ANALYTICS-CODE
+googleAnalyticsCode: UA-42808312-1
 
 scripts:
     after:
@@ -26,24 +26,21 @@ scripts:
 menu:
     sections:
         main:
-            name: Documentazione di base
+            name: Introduzione
             items:
                 home:
-                    text: Home page
+                    text: Home
                     relativeUrl: index.html
                 installazione:
                     text: Installazione
                     relativeUrl: installazione.html
-                framework:
+                aggiornamento:
-                    text: Framework
+                    text: Aggiornamento
-                    relativeUrl: framework.html
+                    relativeUrl: aggiornamento.html
-                assets:
-                    text: Assets
-                    relativeUrl: assets.html
                 api:
                     text: API
                     relativeUrl: api.html
-        other:
+        structure:
             name: Approfondimenti
             items:
                 struttura:
@@ -52,9 +49,33 @@ menu:
                 moduli:
                     text: Moduli
                     relativeUrl: moduli.html
+                widget:
+                    text: Plugin
+                    relativeUrl: widget.html
+                stampe:
+                    text: Stampe
+                    relativeUrl: stampe.html
+                widget:
+                    text: Widget
+                    relativeUrl: widget.html
+        custom:
+            name: Personalizzazione
+            items:
+                framework:
+                    text: Framework
+                    relativeUrl: framework.html
+                assets:
+                    text: Assets
+                    relativeUrl: assets.html
+        more:
+            name: Link utili
+            items:
                 docs:
-                    text: Documentazione completa
+                    text: Documentazione
                     relativeUrl: docs/
                 osm:
-                    text: Sito ufficiale
+                    text: Sito web
-                    absoluteUrl: http://www.openstamanager.com/
+                    absoluteUrl: http://www.openstamanager.com
+                forum:
+                    text: Forum
+                    absoluteUrl: http://www.openstamanager.com/forum

docs/Aggiornamento.md

@@ -0,0 +1,72 @@
+---
+currentMenu: aggiornamento
+---
+
+# Aggiornamento
+
+**Attenzione**: Questa documentazione è esclusivamente relativa all'aggiornamento del software. Per maggiori informazioni sull'installazione consultare la documentazione relativa nella sezione [Installazione](Installazione.md).
+
+Esistono due procedure ufficiale per effettuare l'aggiornamento di OpenSTAManager in modo corretto: una semplificata (_consigliata_) e una manuale.
+
+In ogni caso, il corretto procedimento prevede di [scaricare una release ufficiale del progetto](https://github.com/devcode-it/openstamanager/releases) ed **effettuare un backup della versione corrente** (comprensivo di file e database).
+
+- [Aggiornamento semplificato](#aggiornamento-semplificato)
+- [Aggiornamento manuale](#aggiornamento-manuale)
+- [Migrazione dalla versione 1.x](#migrazione-dalla-versione-1x)
+- [Reimpostare la password di admin](#reimpostare-la-password-di-admin)
+
+## Aggiornamento semplificato
+
+La procedura di aggiornamento semplificato ha l'obiettivo di fornire un sistema di facile utilizzo per favorire l'aggiornamento, e migliorare in questo modo l'interazione con l'utente finale.
+
+L'utilizzo di questa procedura è però sottoposto alla seguenti condizioni nelle impostazioni PHP:
+- upload_max_filesize >= 16MB
+- post_max_size >= 16MB
+
+Di seguito la procedura:
+1. Accedere con un account amministrativo
+2. Entrare nel modulo **Aggiornamenti** (disponibile nel menu principale a sinistra, eventualmente sotto la dicitura **Strumenti**)
+3. Selezionare il file _.zip_ della release attraverso l'apposita sezione "Carica un aggiornamento" e cliccare sul pulsante "Carica"
+
+Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.
+
+## Aggiornamento manuale
+
+La procedura di aggiornamento manuale è resa disponibile per ovviare ai problemi relativi al caricamento del file _.zip_ (in alcuni casi il file non viene correttamente rilevato, non sono disponibili i permessi per caricare file oppure la dimensione del file eccede il limite di upload sul server).
+
+Di seguito la procedura:
+1. De-comprimere il contenuto del file _.zip_ in una cartella temporanea
+2. Rinominare il file VERSION dell'installazione corrente in VERSION.old (rispettando minuscole e maiuscole) [facoltativo a partire dalla versione 2.3]
+3. Copiare i file della nuova versione dalla cartella temporanea alla cartella del server, in modo che le cartelle principali (`files`, `modules`, `templates`, ...) vengano sovrascritte
+
+Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.
+
+## Migrazione dalla versione 1.x
+
+E' possibile effettuare la migrazione da una qualsiasi versione 1.x alla nuova 2.0,  seguendo una procedura un po’ diversa dalle precedenti:
+
+1. Scaricare la versione 2.0 per la migrazione da SourceForge ([openstamanager-2.0-migrazione.zip](https://sourceforge.net/projects/openstamanager/files/openstamanager/openstamanager-2.x/))
+2. Creare un backup completo della versione in uso
+1. De-comprimere il contenuto del file _.zip_ in una cartella temporanea
+4. Effettuare le seguenti operazioni dal backup della precedente versione alla cartella della versione 2.0:
+    - Copiare il file `VERSION`, rinominandolo in `VERSION.old`
+    - Copiare il file `config.inc.php`
+    - Copiare la cartella `files/`
+    - Copiare i contenuti della cartella `/modules/magazzino/articoli/images/` in `/files/articoli/`
+    - Copiare la cartella `templates/` (mantenendo però i file `pdfgen.php` e `pdfgen_variables.php` di della versione 2.0)
+
+Dopo l'esecuzione di queste azioni, il gestionale renderà disponibile l'interfaccia di aggiornamento.
+
+**Attenzione**: le stampe di _Interventi_, _Riepilogo interventi_, _Contratti_ e _Preventivi_ potrebbero non essere compatibili per via dell’aggiornamento degli orari di lavoro, perciò è possibile riscrivere solo la parte di calcolo ore o partire dal template nuovo e apportare le dovute modifiche.
+
+## Reimpostare la password di admin
+
+Non esiste una procedura semplificata per permettere la reimpostazione o il recupero della password dell'account di amministrazione di default (_admin_).
+
+Può però essere necessario procedere alla sua reimpostazione, sia perché l'account _admin_ viene utilizzato da più persone o perché è stata dimenticata.
+In questi casi, per procedere è necessario accedere al database ed eseguire la seguente query:
+```sql
+UPDATE `zz_utenti` SET password = MD5('nuova_password') WHERE username = 'admin';
+```
+
+Si ricorda che è comunque possibile cambiare la password in ogni momento, se è stato effettuato l'accesso, attraverso l'utilizzo del modulo **Utenti e permessi**.

docs/Plugin.md

@@ -8,3 +8,5 @@ currentMenu: plugin
 
 
 <!-- /TOC -->
+
+Pagina in costruzione.

docs/Stampe.md

@@ -4,6 +4,8 @@ currentMenu: stampe
 
 # Stampe
 
+Pagina in costruzione.
+
 - [MPDF](#mpdf)
 - [HTML2PDF](#html2pdf)
     - [Struttura](#struttura)

docs/Widget.md

@@ -8,3 +8,5 @@ currentMenu: widget
 
 
 <!-- /TOC -->
+
+Pagina in costruzione.