# DF Download Center: volledige gids

> Overzicht DF Download Center koppelt uw handleidingen, gebruiksaanwijzingen, technische fiches en CE-certificaten rechtstreeks aan uw producten. Elke productfiche krijgt een tabblad « Documenten & downloads » dat de bestanden per…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfdownloadcenter/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [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), [it](https://www.datafirefly.com/it/documentation/dfdownloadcenter/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdownloadcenter/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdownloadcenter/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

DF Download Center koppelt uw handleidingen, gebruiksaanwijzingen, technische fiches en CE-certificaten rechtstreeks aan uw producten. Elke productfiche krijgt een tabblad « Documenten & downloads » dat de bestanden per type gegroepeerd toont. Daarnaast bundelt een indexeerbare centrale pagina de volledige documentcatalogus, met zoekfunctie, filters per type en gestructureerde JSON-LD-gegevens.

De module is compatibel met PrestaShop 8.0 tot 9.x, werkt in multistore, is in vijf talen beschikbaar en hangt noch van Composer noch van enig extern framework af.

## Installatie

1. Ga in de backoffice naar **Modules** en daarna **Modulebeheer**.
2. Klik op **Een module installeren** en plaats het bestand `dfdownloadcenter-1.0.0.zip`.
3. Klik op **Installeren**.

De installatie maakt de tabellen van de module aan, vier standaard documenttypes en een beheertabblad onder het menu **Catalogus**, en registreert de nodige hooks.

**Leeg na de installatie de cache** via Geavanceerde parameters en daarna Prestaties. De route van de centrale pagina wordt door de routinghook aangemeld en werkt pas na het opnieuw opbouwen van de cache.

### Rechten

De map `modules/dfdownloadcenter/uploads/` moet beschrijfbaar zijn voor de webserver. Die bevat een htaccess-bestand dat elke rechtstreekse HTTP-toegang blokkeert: de bestanden komen alleen via de downloadcontroller naar buiten.

## Configuratie

Open de module via **Modules** en daarna **Modulebeheer**, en klik op **Configureren**.

### Centrale pagina

- **De centrale pagina inschakelen**: staat die uit, dan geeft de pagina een 404 en verdwijnt de link vanuit het producttabblad.
- **URL-slug**: het URL-segment van de pagina, bijvoorbeeld `downloads` of `documenten`. Leeg de cache na elke wijziging.
- **Documenten per pagina**: standaard 20.
- **Metatitel** en **Metabeschrijving**: per taal instelbaar, gebruikt in de title-tag en de metabeschrijving van de pagina.

### Documenttypes

Vier types worden standaard geïnstalleerd, vertaald in de vijf talen van de catalogus:

- Handleidingen
- Technische fiches
- CE-certificaten
- Overige documenten

Vanuit het configuratiescherm kunt u types aanmaken, hernoemen en herschikken. De **positie** bepaalt de volgorde waarin de groepen in het producttabblad en op de centrale pagina verschijnen.

Een type dat door minstens één document wordt gebruikt, kan niet worden verwijderd. De module toont hoeveel documenten het betreft en vraagt u die eerst aan een ander type toe te wijzen.

## Documenten beheren

Documenten beheert u via **Catalogus** en daarna **Downloadcentrum**. De lijst toont per document de titel, het type, de bestandsnaam, de grootte, het aantal downloads en de activeringsstatus.

### Een document aanmaken

1. Klik op **Toevoegen**.
2. Vul de **titel** in elke taal in. De titel is verplicht in de standaardtaal.
3. Voeg een optionele **beschrijving** toe, eveneens per taal. Die verschijnt onder de titel in het producttabblad en op de centrale pagina.
4. Kies het **type** van het document.
5. Selecteer het **bestand** dat u wilt uploaden.
6. Koppel de **gerelateerde producten** door hun naam of referentie in het zoekveld te typen: de suggesties verschijnen na twee tekens, en elk gekozen product wordt een label dat u met één klik weer verwijdert.
7. Bepaal de **positie** van het document binnen zijn type en de status **actief**.
8. Sla op.

### Bestandsformaten en -grootte

De aanvaarde extensies zijn: PDF, DOC, DOCX, ODT, XLS, XLSX, ODS, CSV, TXT, RTF, ZIP, PNG, JPG, JPEG, WEBP, SVG, DWG, DXF, STEP en STP. De maximale grootte per bestand bedraagt 50 MB.

Wordt een bestand van minder dan 50 MB geweigerd, controleer dan de directieven `upload_max_filesize` en `post_max_size` van uw PHP-configuratie: de module kan geen bestand ontvangen dat PHP eerder al weigert.

### Een bestand vervangen

Open het document in bewerkmodus en kies een nieuw bestand. Het oude bestand wordt automatisch van de server gewist zodra de update slaagt. De downloadteller blijft behouden.

### Eén document, meerdere producten

De koppeling tussen document en producten is meervoudig. Een CE-certificaat dat drie referenties dekt, koppelt u in één keer aan alle drie, en verschijnt dan in het tabblad van elk ervan. Omgekeerd kan een product zoveel documenten dragen als nodig.

Een document zonder enig gekoppeld product blijft geldig: het verschijnt in geen enkel producttabblad, maar blijft zichtbaar op de centrale pagina. Dat is de aangewezen werkwijze voor een kwaliteitscharter, een algemene catalogus of elk bedrijfsdocument.

## Het producttabblad

Op de productfiche verschijnt het tabblad « Documenten & downloads » naast de beschrijving, via de native extra-contenthook van PrestaShop. Er wordt geen enkel themabestand overschreven.

De documenten staan er per type gegroepeerd, in de volgorde die door de positie van de types is bepaald. Elke regel toont een gekleurd extensielabel, de titel, de optionele beschrijving, de bestandsgrootte en een downloadknop. Een link naar de centrale pagina sluit het tabblad af zodra die pagina is ingeschakeld.

Heeft een product geen enkel actief document gekoppeld, dan verschijnt het tabblad helemaal niet.

## De centrale pagina

De centrale pagina wordt geserveerd op de URL die door de slug wordt bepaald, bijvoorbeeld `/downloads` in de hoofdtaal, of `/nl/downloads` in de andere talen, afhankelijk van de meertalige configuratie van uw winkel.

### Zoeken en filteren

Het zoekveld doorzoekt tegelijk de titel van het document, de beschrijving, de oorspronkelijke bestandsnaam en de naam en referentie van de gekoppelde producten. Een klant die een productreferentie intypt, vindt dus de bijbehorende handleiding terug.

De filters per type verschijnen als labels, elk met het aantal actieve documenten. De paginering stelt u in bij de instellingen.

### SEO

De pagina is gemaakt om geïndexeerd te worden:

- metatitel en metabeschrijving per taal instelbaar;
- robots-directief op index follow;
- schone canonieke URL: alleen het paginanummer blijft behouden, filters en zoekopdracht worden uitgesloten om duplicatie te vermijden;
- kruimelpad;
- blok met gestructureerde JSON-LD-gegevens van het type ItemList, dat elk bestand als een DigitalDocument beschrijft;
- interne links naar de betrokken producten, onder elk document.

## Downloaden en beveiliging

De bestanden zijn nooit rechtstreeks bereikbaar. Ze worden onder een gehashte naam weggeschreven in de map `uploads/` van de module, die met een htaccess-bestand is vergrendeld.

Het downloaden verloopt verplicht via een frontcontroller die, vóór hij het bestand levert:

- controleert of het document bestaat en actief is;
- controleert of het aan de huidige winkel is gekoppeld;
- de downloadteller verhoogt;
- het bestand onder zijn oorspronkelijke naam teruggeeft.

PDF's en afbeeldingen openen in de browser; de andere formaten starten een download. Elke ongeldige aanvraag wordt naar de 404-pagina van de winkel doorgestuurd.

## Multistore

De documenten zijn van nature aan de winkels gekoppeld, via de standaard tabelkoppeling van PrestaShop. In een multistore-omgeving verschijnt een document dat in één winkel is aangemaakt alleen daar, en weigert de downloadcontroller een bestand te leveren dat aan een andere winkel hangt.

De instellingen van de centrale pagina (slug, meta, paginering) worden eveneens per winkel beheerd.

## Verwijderen

Bij het verwijderen worden de tabellen van de module, zijn configuratievariabelen en zijn beheertabblad gewist, en worden alle bestanden in de map `uploads/` verwijderd.

Maak een back-up van uw bestanden voordat u de module verwijdert: geüploade documenten zijn na verwijdering niet meer terug te halen.

## Problemen oplossen

### De URL van de centrale pagina geeft een 404

Leeg de cache via Geavanceerde parameters en daarna Prestaties. Routes die door de routinghook worden aangemeld, worden door PrestaShop in cache gezet en tellen pas mee na het opnieuw opbouwen daarvan.

Controleer ook of de vereenvoudigde URL's zijn ingeschakeld bij Winkelinstellingen en daarna Verkeer & SEO, en of de centrale pagina in de configuratie van de module is ingeschakeld.

### Het tabblad verschijnt niet op de productfiche

Controleer of het product minstens één **actief** document gekoppeld heeft, en of de extra-contenthook wel voor de module is geregistreerd op de pagina Posities in de backoffice. Ga bij een sterk aangepast thema na of de producttemplate de extra-contentblokken wel toont.

### De download geeft een 404

Drie mogelijke oorzaken: het document staat uit, het is niet aan de huidige winkel gekoppeld, of het fysieke bestand ontbreekt in de map `uploads/`. Bewerk het document opnieuw en upload het bestand nogmaals.

### De upload mislukt zonder duidelijke melding

Controleer de schrijfrechten op `modules/dfdownloadcenter/uploads/` en daarna de PHP-directieven `upload_max_filesize`, `post_max_size` en `max_file_uploads`.

## Technische compatibiliteit

- PrestaShop 8.0 tot 9.x
- PHP 7.4 tot 8.3
- Gebruikte hooks: displayProductExtraContent, moduleRoutes, displayHeader, actionObjectProductDeleteAfter
- Geen enkele override van de kern, geen Composer-afhankelijkheid
- Autocomplete-interface in pure JavaScript, zonder jQuery
- Multistore en meertalig: FR, EN, ES, DE, IT
