DataFirefly Staging Pro: volledige handleiding
Een PrestaShop 8 en 9 staging maken, beveiligen en naar live publiceren: assistent in 4 stappen, controle van de schijfruimte, live voortgang, back-ups en ongedaan maken.
Staging Pro maakt een volledige kopie van uw winkel (bestanden en database), zodat u modules, thema’s en updates zonder risico kunt testen en uw wijzigingen daarna naar live kunt publiceren. Sinds versie 2.0.0 wordt de schijfruimte gecontroleerd vóór en tijdens het kopiëren: de kopie kan de schijf van uw hosting niet meer vullen. Deze handleiding behandelt de installatie, de aanmaakassistent, de beveiliging van de schijfruimte, de bescherming van de staging, de publicatie naar live, de back-ups en het oplossen van problemen.
Installatie en update
- Download
dfstagingpro-2.0.0.zipvanuit uw DataFirefly-account. - PrestaShop-back-office → Modules → Modulebeheer → Een module uploaden, en upload daarna het ZIP-bestand.
- Open Geavanceerde parameters → Staging Pro.
Om te updaten vanaf versie 1.x uploadt u gewoon het nieuwe ZIP-bestand. De update voegt de nieuwe kolommen, de nieuwe hooks en de standaardinstellingen toe en verwijdert uit de oude logs de HTTP-wachtwoorden die daar in leesbare tekst in stonden. Uw bestaande staging-omgevingen blijven in de lijst staan, met een badge “1.x”, en blijven beheerbaar: vernieuwen, naar live publiceren, ongedaan maken, verwijderen.
Compatibel met PrestaShop 8.0 tot 9.x. PHP moet in de map van de winkel kunnen schrijven en de MySQL-gebruiker moet de rechten CREATE, DROP, ALTER en INSERT hebben, wat bij een standaardinstallatie het geval is. Geen Composer-afhankelijkheden.
Het dashboard
Bovenaan de modulepagina staan vijf indicatoren: aantal omgevingen, door de stagings gebruikte ruimte, vrije schijfruimte, duur van de laatste kopie en publicatieback-ups. De tabbladen geven toegang tot de omgevingen, de aanmaakassistent, de back-ups en de instellingen.
Elke omgeving staat op een kaart: staging-adres, map, tabelprefix, grootte (bestanden en database), datum en duur van de laatste kopie, beveiligingsbadges, HTTP-login en -wachtwoord (verborgen, met de knoppen Tonen en Kopie) en privétoegangslink. De beschikbare acties zijn Openen, Vernieuwen, Naar live publiceren, Laatste publicatie ongedaan maken, Log en Verwijderen.

Een mislukte kopie blijft zichtbaar met de reden van de mislukking, bijvoorbeeld onvoldoende schijfruimte, en de bevestiging dat de gedeeltelijke kopie is verwijderd. De knop Opnieuw proberen start de voorafgaande controles en daarna het kopiëren opnieuw.
Een staging aanmaken: de assistent in 4 stappen
Stap 1: locatie
Voer een naam in (kleine letters, cijfers en streepjes, bijvoorbeeld v2). Het staging-adres wordt direct weergegeven. Kies daarna:
- Submap van uw winkel (aanbevolen): de staging wordt aangemaakt in
/staging-naam/, er hoeft niets te worden geconfigureerd. - Aangepaste map en adres (subdomein): voor een subdomein zoals
staging.example.com, dat u eerst in uw hostingpaneel aanmaakt en laat verwijzen naar een lege map. - Dezelfde database, eigen tabelprefix (
dfs1_,dfs2_…), of een Aparte database op dezelfde server, die u vooraf aanmaakt en toegankelijk maakt voor de MySQL-gebruiker van de winkel.

Stap 2: gegevens en beveiliging
- Statistiekgegevens overslaan (standaard aangevinkt): bezoeken, verbindingen en logs worden niet gekopieerd, de tabellen worden leeg aangemaakt.
- Klantgegevens overslaan (AVG): klanten, adressen, bestellingen, winkelwagens en berichten worden niet gekopieerd.
- Afbeeldingen delen met de live-winkel: de map
img/wordt gekoppeld in plaats van gekopieerd. Dit scheelt veel ruimte, maar een afbeelding die op de staging wordt gewijzigd, wordt ook in de winkel gewijzigd. - HTTP-wachtwoord (.htpasswd) (Apache, LiteSpeed), privétoegangslink (alle servers, ook nginx) en onderhoudsmodus.
- Betalingen: de online betaalmodules worden op de staging uitgeschakeld. Offline methoden (overschrijving, cheque, betaling bij levering) blijven beschikbaar om testbestellingen te plaatsen.
- Gevoelige modules: de actieve modules uit de lijst (cron-taken, ERP- of nieuwsbriefsynchronisaties, tracking, terugkerende facturatie) worden voorgesteld om uit te schakelen, alleen op de staging.
Drie beveiligingen zijn altijd actief: noindex, blokkering van alle e-mails en de STAGING-banner.

Stap 3: voorafgaande controles
De module analyseert uw winkel: de bestanden worden gemeten zonder ze te lezen, wat zelfs voor een grote winkel maar enkele seconden duurt, daarna wordt de grootte van de database uit information_schema gelezen. Het rapport toont:
- de benodigde en beschikbare schijfruimte, met een meter (grootte van de kopie, veiligheidsmarge, ruimte die vrij blijft voor de winkel);
- de ruimte op de schijf van de database, wanneer de MySQL-server lokaal en meetbaar is;
- de geschatte grootte (bestanden en database) en, als er op uw winkel al een kopie is gemeten, de geschatte duur;
- de controles: naam, schrijfrechten, MySQL-rechten, PHP-limieten, extensies, webserver;
- de grootste mappen, die u met één klik kunt uitsluiten, en suggesties om ruimte te besparen.

Stap 4: kopiëren
Klik op De staging aanmaken. Het kopiëren begint en de voortgang wordt weergegeven op de kaart van de omgeving (zie “De kopie live volgen”).
Schijfruimte: hoe de module uw winkel beschermt
De staging wordt op dezelfde schijf aangemaakt als uw winkel. Een volle schijf kan de live-winkel blokkeren: cache, sessies, bestandsuploads, facturen. Staging Pro past daarom drie beveiligingen toe.
- Vóór het kopiëren: de benodigde ruimte wordt als volgt berekend: grootte van de te kopiëren bestanden (zonder caches, logs, sessies, back-ups en andere stagings) + grootte van de database + veiligheidsmarge (10%, minimaal 50 MB) + ruimte die altijd vrij blijft voor de winkel (standaard 500 MB). Als de vrije ruimte niet volstaat, wordt het kopiëren geweigerd met drie cijfers: benodigd, beschikbaar, ontbrekend. De controle wordt bij de start van het kopiëren opnieuw uitgevoerd.
- Tijdens het kopiëren: de vrije ruimte wordt continu opnieuw gemeten. Het kopiëren stopt voordat het onder de voor de winkel gereserveerde ruimte komt. Elke schrijfbewerking wordt gecontroleerd: een volle schijf, aan bestands- of MySQL-zijde, stopt het kopiëren met een duidelijke melding.
- Na een mislukking of stop: de gedeeltelijke kopie (map en tabellen) wordt automatisch verwijderd. Er blijft niets achter op de schijf of in de database en de live-winkel wordt nooit gewijzigd.

Als er ruimte tekortkomt, stelt het rapport concrete oplossingen met cijfers voor: afbeeldingen delen, statistieken of klantgegevens overslaan, een grote map uitsluiten, de cache wissen (knop), oude logs in var/logs verwijderen, oude stagings of oude publicatieback-ups verwijderen.
Bij sommige shared hostings is de PHP-functie disk_free_space uitgeschakeld en kan de vrije ruimte niet worden gemeten. De module meldt dit duidelijk, toont de geschatte grootte van de kopie en vraagt u een bevestiging aan te vinken nadat u de ruimte in uw hostingpaneel hebt gecontroleerd. Schrijffouten worden nog steeds gedetecteerd en opgeruimd.
De kopie live volgen
Tijdens het kopiëren toont de kaart van de omgeving:
- de stappen: voorafgaande controles, voorbereiding, bestanden, database, URL’s, beveiliging, verificatie;
- een voortgangsbalk;
- het aantal gekopieerde bestanden en bytes;
- de gekloonde tabellen;
- de verstreken tijd en de geschatte resterende tijd, berekend op basis van de werkelijke voortgang;
- de laatste regels van de log.
De knop Stoppen onderbreekt het kopiëren en verwijdert de gedeeltelijke kopie.

Het kopiëren verloopt in batches van enkele seconden: geen time-out, zelfs niet bij een lage max_execution_time. Als u de pagina sluit, wordt het kopiëren gepauzeerd en het gaat verder zodra u het dashboard opnieuw opent, precies waar het was gebleven.
Bescherming van de staging
- Noindex: de header
X-Robots-Tagwordt door PHP op alle pagina’s verstuurd (werkt zelfs zondermod_headersen onder nginx), plus de meta-tagnoindexenrobots.txt. - Er gaat geen enkele e-mail uit:
PS_MAIL_METHOD = 3en blokkering van elke verzending door de module, ook als iemand SMTP op de staging weer inschakelt. De banner in het back-office van de staging toont het aantal geblokkeerde e-mails. - HTTP-wachtwoord (gebruiker
staging), gegenereerd of zelf gekozen, in het APR1-formaat dat Apache en LiteSpeed lezen. Een zelfcontrole aan het einde van het kopiëren verifieert dat de server 401 antwoordt zonder inloggegevens. - Privétoegangslink: zonder de geheime link zien bezoekers een pagina “privé-staging”. De link plaatst een cookie dat 30 dagen geldig is.
- Online betalingen en gevoelige modules zijn uitgeschakeld, en de STAGING-banner staat op de front-office en het back-office.
Vernieuwen, opnieuw proberen, verwijderen
- Vernieuwen: bouwt de staging opnieuw op vanuit de huidige staat van de winkel. Een venster toont eerst de voorafgaande controles. De ruimte die vrijkomt door het verwijderen van de oude kopie wordt meegerekend. Als er ruimte tekortkomt, wordt het vernieuwen niet gestart en blijft de huidige kopie behouden.
- Opnieuw proberen: start een mislukte kopie opnieuw, na nieuwe voorafgaande controles.
- Verwijderen: verwijdert de map en de tabellen van de staging. Buiten de map van de winkel wordt alleen een map verwijderd die de markering van de omgeving bevat.
Naar live publiceren
De knop Naar live publiceren opent de lijst met tabellen van de staging, gegroepeerd per categorie: catalogus, inhoud en ontwerp, modules, klanten en bestellingen, overig. Bij elke tabel ziet u het aantal rijen op de staging en in de winkel. Een zoekveld en het filter “Alleen tabellen die verschillen” maken de selectie eenvoudiger.

De gekozen tabellen worden eerst apart gekopieerd, waarbij de URL’s van de staging worden herschreven naar die van de winkel. Daarna worden ze in één atomaire bewerking omgewisseld (RENAME TABLE): de winkel ziet nooit een lege of half gevulde tabel. De vervangen tabellen worden bewaard als back-up (dfbak…). Als de publicatie mislukt vóór het omwisselen, worden de tijdelijke tabellen verwijderd en blijft de winkel ongemoeid.
Publiceer de tabellen met klanten en bestellingen niet als de winkel sinds de kopie bestellingen is blijven ontvangen: ze zouden de recente bestellingen vervangen. De kritieke tabellen (shop_url, configuration, shop, sessies) kunnen nooit worden gepubliceerd.
Back-ups en ongedaan maken
Het tabblad Back-ups toont de back-ups die door de publicaties zijn aangemaakt, met datum, aantal tabellen, grootte en betreffende omgeving. De knop Laatste publicatie ongedaan maken op de kaart van de omgeving herstelt de oorspronkelijke tabellen. Verwijder de back-ups die u niet meer nodig hebt om ruimte in de database vrij te maken.

Log
Elke omgeving heeft een eigen log, in de taal van de medewerker: voorafgaande controles, stappen, waarschuwingen, fouten en opruimacties. Een filter toont alleen de waarschuwingen en fouten. De knop Downloaden (.txt) exporteert de volledige log met een voor de support nuttige header (versies, adressen, vrije ruimte). Wachtwoorden verschijnen nooit in de log.

Instellingen
- Vrije ruimte die altijd voor de live-winkel wordt bewaard (standaard 500 MB): het kopiëren wordt geweigerd of gestopt voordat de vrije ruimte onder deze waarde komt.
- Veiligheidsmarge op de schatting, opgeteld bij de schatting (10%, minimaal 50 MB).
- Duur van een batch (standaard 6 seconden, van 2 tot 25).
- Extra uit te sluiten mappen of bestanden, naast de automatische uitsluitingen (caches, logs, sessies, back-office-back-ups, andere stagings).
- Gevoelige modules die worden voorgesteld om op de staging uit te schakelen.

Staging zonder klantgegevens
Met de optie Klantgegevens overslaan (AVG) worden de tabellen met klanten, bestellingen, winkelwagens, berichten, gasten, nieuwsbrief en AVG-logs leeg aangemaakt. De adressen van leveranciers, fabrikanten en magazijnen blijven behouden, evenals de configuratietabellen van bestellingen (statussen, berichtsjablonen, retourstatussen) en de volledige catalogus. Dit is de aanbevolen keuze als u een staging aan een externe partij toevertrouwt. Op zo’n staging worden de tabellen met klanten en bestellingen uit de publicatielijst gehaald en door de server geweigerd: een lege tabel kan de live-omgeving nooit overschrijven.
Rechten en beveiliging
- De acties volgen de rechten van het tabblad Geavanceerde parameters → Staging Pro: weergeven, toevoegen (aanmaken), wijzigen (kopiëren, publiceren, ongedaan maken, instellingen) en verwijderen. Een medewerker met alleen leesrechten ziet noch de wachtwoorden, noch de actieknoppen.
- Alle acties worden geblokkeerd als de huidige winkel zelf een staging is.
- De bestanden
parameters.php,.enven.htpasswdvan de staging zijn niet toegankelijk via het web.
FAQ en probleemoplossing
Wat gebeurt er als mijn schijf te weinig ruimte heeft? Het kopiëren wordt geweigerd voordat het begint, met de benodigde, beschikbare en ontbrekende ruimte, en oplossingen om ruimte te winnen. Als de ruimte tijdens het kopiëren verdwijnt, stopt het kopiëren voordat de schijf vol is en wordt de gedeeltelijke kopie automatisch verwijderd.
Mijn hoster schakelt disk_free_space uit, kan ik de module toch gebruiken? Ja. De module toont de geschatte grootte van de kopie en vraagt om een bevestiging. Schrijffouten worden nog steeds gedetecteerd en opgeruimd.
Het kopiëren is onderbroken (pagina gesloten, netwerkstoring). Open het dashboard opnieuw: het kopiëren gaat verder waar het was gebleven.
Mijn server draait op nginx: het HTTP-wachtwoord werkt niet. nginx negeert .htaccess-bestanden. Gebruik de privétoegangslink, die op alle servers werkt. De zelfcontrole meldt dit geval in de log.
Kan de staging e-mails naar mijn klanten sturen? Nee. E-mails worden op de staging altijd geblokkeerd, ook als iemand SMTP weer inschakelt.
Kan ik een bestelling testen op de staging? Ja: online betalingen zijn uitgeschakeld, maar overschrijving en cheque blijven beschikbaar.
Hoe maak ik een publicatie naar live ongedaan? Gebruik Laatste publicatie ongedaan maken op de kaart van de omgeving en verwijder daarna de oude back-ups op het tabblad Back-ups.
Blijven mijn in 1.x aangemaakte stagings behouden? Ja. Ze blijven na de update in de lijst staan en kunnen worden vernieuwd, naar live gepubliceerd of verwijderd.
De staging geeft overal 404 op een cPanel- / LiteSpeed-hosting. Werk de module bij en vernieuw daarna de omgeving: het wachtwoord wordt gegenereerd in het APR1-formaat, dat compatibel is met LiteSpeed, en de 401-pagina wordt in de .htaccess geïntegreerd.
Versiegeschiedenis
2.0.0 (1 november 2026)
- Controle van de schijfruimte vóór het kopiëren (bestanden, database, marge, voor de winkel gereserveerde ruimte), bewaking tijdens het kopiëren, detectie van een volle schijf aan bestands- en MySQL-zijde, automatische opruiming van de gedeeltelijke kopie.
- Assistent in 4 stappen met rapport van de voorafgaande controles, uitsluiting van de grootste mappen en suggesties.
- Live voortgang per stap, handmatig stoppen, hervatten na onderbreking, vertaalde en downloadbare log.
- Atomaire publicatie naar live, tabblad Back-ups.
- Subdomein (aangepaste map en adres) en aparte database.
- Privétoegangslink, door PHP verstuurde
noindex, e-mails altijd geblokkeerd, gevoelige modules uitgeschakeld, offline betaalmethoden behouden. - Rechten per actie gecontroleerd, wachtwoorden uit de log verwijderd, multistore, vertalingen in 8 talen.
1.1.0 (4 september 2026)
- Optie “Zonder klantgegevens”.
1.0.1 (3 september 2026)
- HTTP-wachtwoord in het APR1-MD5-formaat, geïntegreerde 401-pagina, herschreven
ErrorDocument, zelfcontrole aan het einde van het kopiëren.
1.0.0 (11 juni 2026)
Eerste openbare versie.