ARCHIVIO DELLA MEMORIA — GUIDA D’INSTALLAZIONE

1. REQUISITI

- PHP 8.1 o successivo.
- Estensioni mbstring e fileinfo.
- PharData per esportare e ripristinare i backup TAR.
- HTTPS attivo.
- Permesso di scrittura PHP sulla cartella privata.
- Limite di caricamento consigliato: almeno 20 MB.

2. SCEGLIERE IL PROFILO DELL’ARCHIVIO

Il medesimo template può essere usato da Comune, Associazione, Scuola,
Parrocchia o come Archivio libero. La scelta si effettua nell’Admin, alla voce
«Tipo di archivio». Le sezioni suggerite possono essere aggiunte senza
cancellare i contenuti già esistenti e restano modificabili da «Struttura».

3. INSTALLAZIONE RACCOMANDATA

La cartella contiene:

  archivio/
  ├── public/     file raggiungibili dal web
  └── private/    configurazione, password, foto, documenti e backup

Configurare il DocumentRoot del dominio o sottodominio sulla cartella public.
La cartella private deve rimanere allo stesso livello di public, senza essere
pubblicata. Rendere private scrivibile dall’utente con cui viene eseguito PHP.

4. INSTALLAZIONE SU HOSTING CON SOLA CARTELLA PUBBLICA

Se il provider non consente di cambiare DocumentRoot, collocare i file pubblici
nella cartella del sito e la cartella privata nell’area protetta indicata dal
provider, per esempio App_Data. In questo caso utilizzare il pacchetto FTP già
predisposto per quel server: i file inc/private_root.php, inc/content_store.php
e admin/lib.php contengono il percorso corretto. Non sostituirli con quelli del
template neutro.

5. PRIMO ACCESSO

Per sicurezza la prima password può essere creata soltanto in locale.

1. Avviare il template sul computer con PHP o XAMPP.
2. Aprire /admin/index.php.
3. Creare una password di almeno 12 caratteri.
4. Caricare l’installazione sul server.
5. Aprire l’Admin online e accedere con la password appena creata.

L’hash si trova in private/admin_accesso.php. Non riutilizzare lo stesso file
per enti differenti.

6. CONFIGURAZIONE INIZIALE

Nell’Admin completare nell’ordine:

1. Tipo di archivio.
2. Home e aspetto: nome, sottotitolo, logo, immagine, grafica e caratteri.
3. Dati per la rete: ente, località, provincia, regione e indirizzo pubblico.
4. Struttura e menu.
5. Gallerie, fotografie, storie e documenti.
6. Accesso: sostituzione periodica della password.

7. CONTROLLO PRIMA DELLA PUBBLICAZIONE

Aprire Admin → Sistema e verificare:

- PHP ed estensioni disponibili;
- cartella privata protetta e leggibile da PHP;
- contenuti, uploads e backups scrivibili;
- HTTPS attivo;
- errori PHP nascosti al pubblico;
- limite di caricamento sufficiente.

Provare inoltre Home, menu, ricerca, galleria, fotografia grande, storia,
documento e visualizzazione da smartphone.

8. BACKUP E AGGIORNAMENTI

Prima di ogni aggiornamento aprire Admin → Backup e scaricare il TAR.
Conservarlo anche fuori dal server. Per aggiornare il programma sostituire
soltanto i file pubblici indicati nel pacchetto di aggiornamento. Non
sovrascrivere contenuti.php, admin_accesso.php, uploads o backups.

Il ripristino controlla struttura, dimensioni, integrità e tipo dei file e
crea automaticamente una copia dello stato precedente.

9. COLLEGAMENTO AL PORTALE CENTRALE

Il catalogo pubblico dell’installazione è disponibile in /catalogo.php. I dati
compilati in «Collegamento alla rete Archivio della Memoria» permetteranno al
futuro portale archiviodellamemoria.net di presentare l’ente e rimandare al suo
archivio. Foto, documenti e password restano nell’installazione dell’ente.

10. CHECKLIST FINALE

[ ] Logo e testi corretti
[ ] Sezioni visibili nell’ordine desiderato
[ ] Ricerca funzionante
[ ] Foto, storie e documenti accessibili
[ ] Admin protetto da password
[ ] HTTPS attivo
[ ] Cartella privata non raggiungibile dal browser
[ ] Backup TAR conservato fuori dal server
[ ] Controllo da smartphone completato
[ ] Dati del catalogo centrale compilati