# SuleCms - Installer

Questa cartella contiene lo script di installazione guidata per **SuleCms**.

## ⚠️ Regole di Utilizzo e Contributo (GitHub)

SuleCms è un progetto Open Source, ma per garantire la crescita sana del software e il rispetto del lavoro originale, chiunque lo utilizzi o lo cloni su GitHub è tenuto a rispettare le seguenti linee guida:

1. **Riferimenti al Codice Originale**:
   È obbligatorio lasciare intatti tutti i riferimenti, crediti e link al codice originale e al suo autore nei file, nel piè di pagina del pannello di amministrazione e nel sito pubblico (es. **CreaSito.cv di Pierluigi Covelli**).

2. **Condivisione di Modifiche, Temi e Plugin**:
   Ogni modifica apportata al codice principale, così come la creazione di nuove funzionalità, temi grafici personalizzati o plugin, deve essere comunicata e condivisa con il manutentore del progetto. Questo aiuta a prevenire la frammentazione del software e a permettere a tutti di beneficiare dei miglioramenti.

3. **🌍 Ricerca di Aiuto per il Multilingua (Multi-language Help)**:
   Stiamo attivamente cercando sviluppatori e collaboratori che possano aiutarci a integrare e testare il supporto multilingua (multilingua/I18n) all'interno del CMS. Se hai esperienza o vuoi dare una mano, apri una Issue o una Pull Request su GitHub!

---

## 🚀 Istruzioni per l'Installazione

1. Carica la cartella `installer` nella cartella root del tuo spazio web.
2. Assicurati che nella root del sito **non ci siano altri file o cartelle** prima dell'installazione per evitare sovrascritture o problemi di sicurezza. L'installer verificherà che la cartella sia vuota (eccetto la cartella `installer` stessa).
3. Apri il browser all'indirizzo `http://tuosito.com/installer/` e segui la procedura guidata.
4. Al termine dell'installazione, elimina la cartella `installer` come consigliato per motivi di sicurezza.

---

## 📦 Limiti di Caricamento di GitHub e File Grandi (.data)

Se provi a caricare il file `installer/sulecms.data` su GitHub tramite l'interfaccia web (browser), potresti riscontrare un errore perché il sito web di GitHub limita gli upload diretti a **25 MB**, mentre il pacchetto `sulecms.data` supera questa dimensione.

### Soluzione:
Per inviare con successo il file `sulecms.data` al tuo repository GitHub, devi utilizzare la **riga di comando Git (Git CLI)** dal tuo terminale. La riga di comando di Git supporta il caricamento di file singoli fino a **100 MB**:

```bash
git add installer/sulecms.data
git commit -m "Aggiunto pacchetto d'installazione di SuleCms"
git push origin main
```

### 💡 Consigli per ridurre la dimensione del file `.data`:
* **Esclusioni Automatiche**: Lo script `installer/packager.php` è ora configurato per escludere automaticamente le cartelle pesanti di log, cache locale e sviluppo (come `.git`, `.vscode`, `brain` e `.gemini`).
* **Svuotare Media/Uploads**: Prima di lanciare il comando `php installer/packager.php` per rigenerare il pacchetto, assicurati di aver ripulito o svuotato cartelle locali temporanee o media molto grandi (ad esempio all'interno di `uploads/`) per mantenere il pacchetto `.data` il più leggero possibile.
