Aggiornamento documentazione

This commit is contained in:
Thomas Zilio 2018-01-13 12:02:40 +01:00
parent 0c0c5c613a
commit ed11015d69
6 changed files with 118 additions and 17 deletions

View File

@ -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>

View File

@ -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.'
##googleAnalyticsCode: GOOGLE-ANALYTICS-CODE
footerText: 'Progettato e sviluppato da <a href="http://devcode.it/">DevCode</a>.'
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:
text: Framework
relativeUrl: framework.html
assets:
text: Assets
relativeUrl: assets.html
aggiornamento:
text: Aggiornamento
relativeUrl: aggiornamento.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
absoluteUrl: http://www.openstamanager.com/
text: Sito web
absoluteUrl: http://www.openstamanager.com
forum:
text: Forum
absoluteUrl: http://www.openstamanager.com/forum

72
docs/Aggiornamento.md Normal file
View File

@ -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 dellaggiornamento 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**.

View File

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

View File

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

View File

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