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

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.

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.

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/.

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