README.it.md

Mikesoft TeamVault

English · Italiano · Français · Español · Deutsch

Spazio di lavoro documentale privato per team, agenzie e reparti operativi WordPress che hanno bisogno di condividere file in modo controllato al di fuori della Libreria Media.

Versione attuale del plugin: 3.2.6.

Disponibile direttamente su WordPress.org e mantenuto per le versioni correnti di WordPress.

Se TeamVault ti è utile, valuta di sostenere il progetto su GitHub — è sviluppato e mantenuto gratuitamente, e le sponsorizzazioni aiutano a portarlo avanti.

Panoramica

Mikesoft TeamVault aggiunge uno spazio di lavoro documentale privato all'interno della bacheca di WordPress. È pensato per i team che hanno bisogno di organizzare, visualizzare in anteprima, esportare e condividere file sensibili senza esporli tramite i normali URL della Libreria Media.

I file sono archiviati in uno storage protetto e distribuiti tramite gestori WordPress autenticati anziché tramite URL pubblici dei media.

Permessi per cartella	Ricerca nel vault	Quote di storage
Gruppi	Registro attività	Impostazioni

Tra i casi d'uso tipici rientrano:

• documenti aziendali interni
• consegna di documenti dall'agenzia al cliente dalla bacheca WordPress
• scambi di file con partner o fornitori
• archivi di back-office che devono restare fuori dalla Libreria Media pubblica

Tra le funzionalità principali rientrano:

• storage privato al di fuori del normale flusso della Libreria Media
• accesso condiviso per gli utenti interni autorizzati
• operazioni di creazione, rinomina, spostamento ed eliminazione delle cartelle
• caricamenti drag-and-drop con validazione dei file
• anteprima inline per i tipi di file supportati, inclusi i PDF
• esportazione ZIP per le cartelle o per l'intera libreria documentale
• registro attività per la tracciabilità operativa
• strumenti di manutenzione per la pulizia degli orfani e la reindicizzazione dello storage

Funzionalità di governance (tutte gratuite, dalla versione 2.6):

• gruppi TeamVault per organizzare gli utenti in reparti o team, indipendentemente dai ruoli di WordPress
• permessi per cartella con azioni granulari (visualizzazione, caricamento, download, eliminazione, gestione) per utenti e gruppi, con ereditarietà e override espliciti sui figli
• accesso in sola anteprima che consente la visualizzazione senza download o esportazione ZIP
• quote di storage per utente e per gruppo applicate prima del caricamento
• report di accesso (chi ha visualizzato o scaricato cosa) con filtri ed esportazione CSV del registro attività
• notifiche email per gli eventi di caricamento, download, eliminazione e accesso negato

Ultima versione

La versione 3.2.6 rafforza il contenimento degli upload e l'affidabilità degli export ZIP, corregge casi limite nelle impostazioni di governance REST e nell'attivazione multisito, e mantiene accessibili le azioni della barra strumenti nei comuni layout desktop di WordPress. Migliora inoltre la presentazione e la governance del repository. Non sono richieste modifiche alla configurazione.

La versione 3.2.5 completa il lavoro di codifica dell'output iniziato con la 3.2.4: il pannello dei dettagli file applica ora l'escaping all'estensione memorizzata prima di visualizzarla. Il valore è già limitato a [a-z0-9] dalla validazione di upload e reindicizzazione, quindi si tratta di difesa in profondità e non della correzione di una vulnerabilità sfruttabile. Non sono richieste modifiche alla configurazione.

La versione 3.2.4 rafforza la distribuzione dei file privati mantenendo gli header no-cache ed evitando che i percorsi dello storage compaiano nei log diagnostici. Le destinazioni del browser sono limitate a URL HTTP(S) same-origin, l'impostazione della lingua usa una allowlist esplicita e i controlli ripetuti dei permessi riutilizzano, per la durata della richiesta, le query su cartelle, regole e gruppi. Sono stati inoltre migliorati CI, filtri di packaging, indicazioni di sicurezza e documentazione di sviluppo e rilascio. Non sono richieste modifiche alla configurazione.

La versione 3.2.3 rafforza la validazione dei caricamenti e delle anteprime inline, rende transazionali gli aggiornamenti di permessi e gruppi e mantiene coerenti le operazioni su file, cartelle, quote ed esportazioni quando una scrittura su storage o database non riesce. Le cartelle figlie condivise esplicitamente restano individuabili quando il genitore è nascosto, le esportazioni CSV del registro sono più sicure da aprire nei fogli di calcolo, le nuove installazioni tornano a usare la lingua Automatica e la schermata Plugin identifica ora l'autore semplicemente come Mikesoft.

La versione 3.2.2 rinnova le icone dei tipi di file in tutto il file manager: PDF, Word, Excel, PowerPoint, CSV, testo, archivi, audio, video e immagini mostrano ora badge colorati chiari e riconoscibili con l'etichetta del formato — nella griglia, nella vista elenco e nell'anteprima del pannello dettagli — al posto dei precedenti glifi monocromatici.

La versione 3.0.0 è una tappa importante per la sicurezza e l'affidabilità. I risultati di ricerca ora vengono filtrati attraverso il motore dei permessi per cartella, così gli utenti con restrizioni non possono più scoprire nomi di file o metadati provenienti da cartelle che non possono visualizzare. Il file .htaccess di storage generato nega l'accesso diretto su Apache 2.4 oltre che su Apache 2.2 e IIS, e le quote di storage vengono applicate con un blocco a livello di database in modo che i caricamenti concorrenti non possano superare congiuntamente un limite. I download e le anteprime inline acquisiscono il supporto HTTP Range (Accept-Ranges / 206 Partial Content) per trasferimenti riprendibili e visualizzatori PDF con ricerca per intervallo sui file di grandi dimensioni. La finestra di dialogo dei permessi delle cartelle ora avvisa quando esistono regole ma la radice non ne ha, l'icona del menu di amministrazione è coerente con lo stile nativo di WordPress e il JavaScript di amministrazione è stato suddiviso in moduli mirati senza alcuna variazione di comportamento.

La versione 2.6 ha introdotto la suite di governance documentale gratuita: gruppi TeamVault, permessi per cartella con ereditarietà e azioni granulari (visualizzazione, caricamento, download, eliminazione, gestione), accesso in sola anteprima, quote di storage per utente e per gruppo, report di accesso con esportazione CSV, notifiche email. Le installazioni esistenti non subiscono variazioni perché le cartelle senza regole mantengono il comportamento precedente.

Perché i team adottano TeamVault:

• crea un'area documentale privata dedicata invece di sovraccaricare la Libreria Media
• aggiunge un controllo degli accessi basato sulle capability con un livello di whitelist opzionale, oltre a permessi per cartella e gruppi per una governance più fine
• mantiene i flussi di esportazione, manutenzione e recupero focalizzati sui file operativi

Requisiti

• WordPress 6.0 o successivo
• PHP 8.0 o successivo
• Percorso di storage scrivibile per i documenti privati
• ZipArchive disponibile sul server per le funzionalità di esportazione

Installazione

Consigliata

Installa il plugin dalla Directory dei plugin di WordPress.org in modo che il sito riceva le normali notifiche di aggiornamento.

1. Nella bacheca di WordPress, vai su Plugins > Add New.
2. Cerca Mikesoft TeamVault.
3. Fai clic su Install Now e attiva il plugin.
4. Apri TeamVault > Settings per rivedere le regole di accesso, storage e file.

Manuale

1. Scarica il pacchetto della versione da WordPress.org.
2. Caricalo in wp-content/plugins/mikesoft-teamvault/.
3. Attiva il plugin dalla schermata Plugin.

Modello di accesso

• L'accesso allo spazio di lavoro dei file utilizza la capability manage_private_documents.
• Le nuove attivazioni assegnano tale capability ai soli Amministratori.
• La capability manage_private_documents concede l'accesso completo allo spazio di lavoro TeamVault, incluse le azioni di caricamento, rinomina, spostamento, download, esportazione ed eliminazione.
• La modalità whitelist opzionale aggiunge un secondo livello di autorizzazione per gli utenti selezionati.
• I permessi per cartella (dalla versione 2.6) aggiungono un controllo granulare sopra la capability: quando una cartella ha regole esplicite, l'accesso è limitato agli utenti/gruppi e alle azioni concessi, con ereditarietà dalle cartelle padre; le cartelle senza regole mantengono il comportamento basato sulla capability. Gli Amministratori conservano sempre l'accesso completo.
• Impostazioni, gruppi, quote, notifiche, report, registri attività, gestione della whitelist, strumenti di manutenzione e controlli sui dati alla disinstallazione richiedono manage_options.

Quando la modalità whitelist è abilitata, mantieni l'account amministratore corrente nell'elenco degli utenti consentiti prima di salvare le impostazioni. Sui siti aggiornati da versioni precedenti, rivedi le capability dei ruoli esistenti e le impostazioni della whitelist se in passato gli Editor avevano accesso a TeamVault.

Storage

• Percorso di storage predefinito: wp-content/uploads/private-documents/
• Il plugin può utilizzare un percorso scrivibile personalizzato configurato nelle impostazioni.
• Lo storage è protetto con file di deny a livello di server dove supportati.
• Apache/LiteSpeed possono applicare il file .htaccess generato; IIS può applicare web.config; Nginx richiede una regola server equivalente che neghi le richieste dirette a /wp-content/uploads/private-documents/.
• Per i deployment ad alta sensibilità, preferisci un percorso di storage personalizzato all'esterno della webroot pubblica.
• Il widget di storage nella barra laterale mostra solo lo spazio utilizzato dai file di TeamVault, per evitare di esporre valori di quota dell'hosting fuorvianti negli ambienti condivisi.

Se un sito viene migrato senza copiare la cartella di storage privato, i record di TeamVault possono rimanere nel database mentre i binari originali risultano mancanti. La schermata delle impostazioni include strumenti di pulizia e reindicizzazione per questi scenari.

Supporto

• Supporto per gli utenti finali: Forum di supporto di WordPress.org
• Email: teamvault@mikesoft.it
• Sito web: mikesoft.it
• Segnalazioni di sicurezza: vedi SECURITY.md
• Sostieni la manutenzione open-source continua: GitHub Sponsors

Verifica rapida per lo sviluppo

Installa le dipendenze di sviluppo con Composer, poi esegui i comandi di validazione standard:

composer install
composer lint
composer test
composer ci

composer lint controlla tutti i file PHP del repository al di fuori delle dipendenze generate. composer test esegue la suite PHPUnit leggera con il bootstrap del repository. GitHub Actions esegue inoltre il WordPress Plugin Check su una build runtime pulita del plugin.

Guida al repository

Questo repository è il mirror pubblico del codice sorgente del plugin.

• Le informazioni sul prodotto e sull'installazione per gli utenti di WordPress.org si trovano in readme.txt.
• La cronologia completa delle versioni si trova in changelog.txt.
• Le policy del repository si trovano in CONTRIBUTING.md, CODE_OF_CONDUCT.md e SECURITY.md.
• Le note per manutentori e sviluppatori si trovano in docs/.

Risorse di branding

• .wordpress-org/assets/icon-256x256.png è l'icona principale a colori pieni per la scheda su WordPress.org.
• .wordpress-org/assets/icon.svg è la risorsa scalabile complementare per la scheda su WordPress.org.
• .wordpress-org/assets/screenshot-1.jpg è lo screenshot principale del file manager utilizzato dalla scheda su WordPress.org e da questo README.
• assets/logo-teamvault.svg è il logo di amministrazione interno al plugin, utilizzato all'interno dell'interfaccia di TeamVault.

Queste risorse servono superfici diverse e dovrebbero restare allineate allo stesso brand senza obbligare l'interfaccia runtime del plugin ad adeguarsi ai vincoli di packaging di WordPress.org.

Mappa della documentazione

• docs/developer/hooks.md - hook e filtri per sviluppatori
• docs/maintainer/local-development.md - flusso di sviluppo locale
• docs/maintainer/release.md - processo di rilascio su WordPress.org

Licenza

GPL v2 o successiva. Vedi LICENSE.