DF Download Center: volledige gids
Installatie, configuratie en gebruik van het downloadcentrum voor producten: producttabblad, indexeerbare centrale pagina, documenttypes en beveiliging van de bestanden.
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
- Ga in de backoffice naar Modules en daarna Modulebeheer.
- Klik op Een module installeren en plaats het bestand
dfdownloadcenter-1.0.0.zip. - 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
downloadsofdocumenten. 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
- Klik op Toevoegen.
- Vul de titel in elke taal in. De titel is verplicht in de standaardtaal.
- Voeg een optionele beschrijving toe, eveneens per taal. Die verschijnt onder de titel in het producttabblad en op de centrale pagina.
- Kies het type van het document.
- Selecteer het bestand dat u wilt uploaden.
- 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.
- Bepaal de positie van het document binnen zijn type en de status actief.
- 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