# DF Download Center — Documentazione
> Presentazione DF Download Center associa i vostri manuali, istruzioni, schede tecniche e certificati CE direttamente ai vostri prodotti. Ogni pagina prodotto guadagna una scheda «Documenti e download» che elenca i…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-07-12
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfdownloadcenter/index.md), [en](https://www.datafirefly.com/en/documentation/dfdownloadcenter/index.md), [es](https://www.datafirefly.com/es/documentation/dfdownloadcenter/index.md), [de](https://www.datafirefly.com/de/documentation/dfdownloadcenter/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdownloadcenter/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdownloadcenter/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdownloadcenter/index.md)
- Indice:
## Presentazione
DF Download Center associa i vostri manuali, istruzioni, schede tecniche e certificati CE direttamente ai vostri prodotti. Ogni pagina prodotto guadagna una scheda «Documenti e download» che elenca i file raggruppati per tipo. In parallelo, una pagina centrale indicizzabile raccoglie l'intero catalogo documentale, con ricerca, filtri per tipo e dati strutturati JSON-LD.
Il modulo è compatibile con PrestaShop dalla 8.0 alla 9.x, multinegozio, disponibile in cinque lingue, e non dipende né da Composer né da alcun framework esterno.
## Installazione
1. Dal back office, andate su **Moduli** e poi **Gestore dei moduli**.
2. Cliccate su **Carica un modulo** e rilasciate il file `dfdownloadcenter-1.0.0.zip`.
3. Cliccate su **Installa**.
L'installazione crea le tabelle del modulo, quattro tipi di documento predefiniti, una scheda di amministrazione sotto il menù **Catalogo** e registra gli hook necessari.
**Dopo l'installazione, svuotate la cache** da Parametri avanzati e poi Prestazioni. La rotta della pagina centrale è dichiarata tramite l'hook di routing e diventa attiva solo dopo la rigenerazione della cache.
### Permessi
La cartella `modules/dfdownloadcenter/uploads/` deve essere scrivibile dal server web. Contiene un file htaccess che blocca ogni accesso HTTP diretto: i file escono solo tramite il controller di download.
## Configurazione
Aprite il modulo da **Moduli** e poi **Gestore dei moduli**, e cliccate su **Configura**.
### Pagina centrale
- **Attivare la pagina centrale** — quando è disattivata, la pagina restituisce un 404 e il link dalla scheda prodotto scompare.
- **Slug dell'URL** — il segmento di URL della pagina, per esempio `download` o `telechargements`. Svuotate la cache dopo ogni modifica.
- **Documenti per pagina** — 20 per impostazione predefinita.
- **Meta titolo** e **Meta descrizione** — configurabili lingua per lingua, utilizzati nel tag title e nella meta descrizione della pagina.
### Tipi di documento
Quattro tipi sono installati per impostazione predefinita, tradotti nelle cinque lingue del catalogo:
- Manuali d'uso
- Schede tecniche
- Certificati CE
- Altri documenti
Dalla schermata di configurazione potete creare, rinominare e riordinare i tipi. La **posizione** determina l'ordine di visualizzazione dei gruppi nella scheda prodotto e sulla pagina centrale.
Un tipo utilizzato da almeno un documento non può essere eliminato. Il modulo mostra il numero di documenti interessati e chiede di riassegnarli prima a un altro tipo.
## Gestire i documenti
I documenti si gestiscono da **Catalogo** e poi **Centro download**. L'elenco mostra per ogni documento il titolo, il tipo, il nome del file, la dimensione, il numero di download e lo stato di attivazione.
### Creare un documento
1. Cliccate su **Aggiungi**.
2. Inserite il **titolo** in ogni lingua. Il titolo è obbligatorio nella lingua predefinita.
3. Aggiungete una **descrizione** facoltativa, anch'essa per lingua. Viene mostrata sotto il titolo nella scheda prodotto e sulla pagina centrale.
4. Scegliete il **tipo** del documento.
5. Selezionate il **file** da caricare.
6. Associate i **prodotti collegati** digitando il loro nome o codice nel campo di ricerca: i suggerimenti appaiono dopo due caratteri, e ogni prodotto selezionato diventa un'etichetta rimovibile con un clic.
7. Definite la **posizione** del documento all'interno del suo tipo e il suo stato **attivo**.
8. Salvate.
### Formati e dimensione dei file
Le estensioni accettate sono: PDF, DOC, DOCX, ODT, XLS, XLSX, ODS, CSV, TXT, RTF, ZIP, PNG, JPG, JPEG, WEBP, SVG, DWG, DXF, STEP e STP. La dimensione massima per file è di 50 MB.
Se un file inferiore a 50 MB viene rifiutato, verificate le direttive `upload_max_filesize` e `post_max_size` della vostra configurazione PHP: il modulo non può ricevere un file che PHP rifiuta a monte.
### Sostituire un file
Aprite il documento in modifica e selezionate un nuovo file. Il file precedente viene rimosso automaticamente dal server una volta riuscito l'aggiornamento. Il contatore di download viene conservato.
### Un documento, più prodotti
L'associazione documento-prodotti è multipla. Un certificato CE che copre tre codici si associa a tutti e tre in una sola volta, e appare quindi nella scheda di ciascuno. Al contrario, un prodotto può portare tutti i documenti necessari.
Un documento senza alcun prodotto associato resta valido: non appare in nessuna scheda prodotto, ma resta visibile sulla pagina centrale. È l'uso indicato per una carta della qualità, un catalogo generale o qualsiasi documento aziendale.
## La scheda prodotto
Nella pagina prodotto, la scheda «Documenti e download» appare accanto alla descrizione, tramite l'hook nativo di contenuto aggiuntivo di PrestaShop. Nessun file del tema viene sovrascritto.
I documenti sono raggruppati per tipo, nell'ordine definito dalla posizione dei tipi. Ogni riga mostra un'etichetta di estensione colorata, il titolo, la descrizione facoltativa, la dimensione del file e un pulsante di download. Un link alla pagina centrale chiude la scheda quando questa è attivata.
Se un prodotto non ha alcun documento attivo associato, la scheda non appare affatto.
## La pagina centrale
La pagina centrale è servita all'URL definito dallo slug, per esempio `/download`, oppure `/fr/download` nelle altre lingue secondo la configurazione multilingue del vostro negozio.
### Ricerca e filtri
Il campo di ricerca interroga simultaneamente il titolo del documento, la sua descrizione, il nome del file originale, nonché il nome e il codice dei prodotti associati. Un cliente che digita un codice prodotto ritrova quindi il manuale corrispondente.
I filtri per tipo si presentano come pillole, ciascuna con il numero di documenti attivi. La paginazione è configurabile dalle impostazioni.
### SEO
La pagina è progettata per essere indicizzata:
- meta titolo e meta descrizione configurabili per lingua;
- direttiva robots su index follow;
- URL canonico pulito — viene conservato solo il numero di pagina, i filtri e la ricerca sono esclusi per evitare la duplicazione;
- percorso di navigazione;
- blocco di dati strutturati JSON-LD di tipo ItemList, che descrive ogni file come un DigitalDocument;
- link interni verso i prodotti interessati, sotto ogni documento.
## Download e sicurezza
I file non sono mai accessibili direttamente. Vengono scritti con un nome cifrato nella cartella `uploads/` del modulo, bloccata da un file htaccess.
Il download passa obbligatoriamente da un controller che, prima di servire il file:
- verifica che il documento esista e sia attivo;
- verifica che sia associato al negozio corrente;
- incrementa il contatore di download;
- restituisce il file con il suo nome originale.
I PDF e le immagini si aprono nel browser; gli altri formati avviano un download. Ogni richiesta non valida viene reindirizzata alla pagina 404 del negozio.
## Multinegozio
I documenti sono associati ai negozi in modo nativo, tramite l'associazione di tabelle standard di PrestaShop. In contesto multinegozio, un documento creato in un negozio appare solo in quello, e il controller di download rifiuta di servire un file associato a un altro negozio.
Anche le impostazioni della pagina centrale — slug, meta, paginazione — sono gestite per negozio.
## Disinstallazione
La disinstallazione elimina le tabelle del modulo, le sue variabili di configurazione, la sua scheda di amministrazione, e cancella tutti i file presenti nella cartella `uploads/`.
Fate una copia di backup dei vostri file prima di disinstallare il modulo: i documenti caricati non sono recuperabili dopo la disinstallazione.
## Risoluzione dei problemi
### L'URL della pagina centrale restituisce un 404
Svuotate la cache da Parametri avanzati e poi Prestazioni. Le rotte dichiarate tramite l'hook di routing sono memorizzate nella cache di PrestaShop e vengono prese in considerazione solo dopo la rigenerazione.
Verificate inoltre che gli URL semplificati siano attivati in Parametri del negozio e poi Traffico e SEO, e che la pagina centrale sia attivata nella configurazione del modulo.
### La scheda non appare nella pagina prodotto
Verificate che il prodotto abbia almeno un documento **attivo** associato, e che l'hook di contenuto aggiuntivo sia correttamente registrato per il modulo nella pagina Posizioni del back office. Su un tema molto personalizzato, assicuratevi che il template della pagina prodotto mostri i blocchi di contenuto aggiuntivo.
### Il download restituisce un 404
Tre possibili cause: il documento è disattivato, non è associato al negozio corrente, oppure il file fisico manca dalla cartella `uploads/`. Rimodificate il documento e ricaricate il file.
### Il caricamento fallisce senza messaggio chiaro
Verificate i permessi di scrittura su `modules/dfdownloadcenter/uploads/`, poi le direttive PHP `upload_max_filesize`, `post_max_size` e `max_file_uploads`.
## Compatibilità tecnica
- PrestaShop dalla 8.0 alla 9.x
- PHP dalla 7.4 alla 8.3
- Hook utilizzati: displayProductExtraContent, moduleRoutes, displayHeader, actionObjectProductDeleteAfter
- Nessuna sovrascrittura del core, nessuna dipendenza Composer
- Interfaccia di completamento automatico in JavaScript nativo, senza jQuery
- Multinegozio e multilingue: IT, FR, EN, ES, DE