Een PrestaShop-module bijwerken: Upload failed
Een module bijwerken. U uploadt de zip van de nieuwe versie over de reeds geïnstalleerde versie heen, vanuit de Module Manager: instellingen, inhoud en gegevens blijven allemaal behouden. Ziet u in plaats van de bevestiging de melding ‘Upload failed’, dan is de module mogelijk uitgeschakeld zonder dat iemand het u heeft gemeld. Hieronder leest u wat er gebeurt en hoe u de module weer draaiend krijgt.
1. Een module bijwerken
- Download de zip van de nieuwe versie op de pagina Mijn licenties van uw account.
- Ga in de back-office naar Modules → Module Manager → Upload a module en kies de zip.
- PrestaShop vervangt de bestanden en voert de upgrade zelf uit. Verwijder niets: verwijderen wist uw instellingen, bijwerken niet.
- Open na afloop van de upload Configure en controleer of het versienummer de nieuwe versie is.
2. Als de update ‘Upload failed’ meldt
Wanneer u de zip uploadt van een module die u al hebt geïnstalleerd, vervangt PrestaShop de bestanden en voert daarna de upgrade uit. Als er halverwege iets misgaat, schakelt PrestaShop de module uit om veilig te zijn en meldt dat helaas niet: u ziet alleen de melding ‘Upload failed’.
Er gaat niets verloren: de instellingen en gegevens van de module zijn er nog. U hoeft de module alleen weer in te schakelen, zodra de oorzaak is weggenomen.
Stap 1: controleer of de module is uitgeschakeld back-office
Ga naar Modules, Module Manager, zoek de module en kijk of de knop ‘Enable’ toont in plaats van ‘Configure’. Staat er ‘Enable’, dan is de module uitgeschakeld.
Stap 2: controleer bij meerdere webwinkels elke webwinkel afzonderlijk multistore
Kies linksboven telkens één webwinkel en bekijk de module in elk ervan. De module kan in de ene webwinkel aan staan en in een andere uit: dan ziet de lijst er goed uit, maar werkt de module in die webwinkel niet meer.
Stap 3: neem de oorzaak weg bestandsrechten
Bijna altijd is er één oorzaak: de bestanden van de module op de server kunnen niet worden beschreven door het programma waarmee de site draait. Vraag uw hostingprovider of uw technicus om de eigenaar en de rechten van de map modules/<module name> te herstellen: meestal dezelfde eigenaar als de overige bestanden van de site, mappen 755 en bestanden 644. Andere mogelijke oorzaken: de schijf is vol, of het geüploade bestand is groter dan de server accepteert.
Stap 4: upload de zip opnieuw laatste stap
Upload de zip opnieuw zodra de oorzaak is verholpen: nu wordt de upgrade wel uitgevoerd. Als u de module eerder weer nodig hebt, drukt u in de Module Manager op ‘Enable’, maar upload de zip hoe dan ook opnieuw, anders blijft u zitten met half vervangen bestanden.
3. Waarom dit gebeurt
Het is geen gebrek van de module die u bijwerkt. Als PrestaShop tijdens het uploaden van de zip een fout tegenkomt, schakelt het de module uit waaraan het werkte: dit gebeurt met elke module, van elke auteur, met multistore aan of uit. De keuze is voorzichtig, want als het vervangen van bestanden halverwege stopt, houdt de server een module over die uit een aantal nieuwe en een aantal oude bestanden bestaat, en zo laten draaien zou erger zijn. Het enige wat ontbreekt is de waarschuwing: PrestaShop schrijft ‘Upload failed’ en zegt niet dat de module is uitgeschakeld.
4. Hoe u voorkomt dat het opnieuw gebeurt
- Upload de bestanden van de site altijd met dezelfde gebruiker als waarmee PHP draait. Hebt u via FTP geüpload of via de opdrachtregel als beheerder geïnstalleerd, dan moeten de rechten worden hersteld.
- Controleer de vrije schijfruimte voordat u bijwerkt.
- Als de zip groot is, vraag uw hostingprovider dan naar de PHP-limieten
upload_max_filesizeenpost_max_size. - Werk één module tegelijk bij en controleer het resultaat voordat u naar de volgende gaat.
5. Veelgestelde vragen
Verlies ik de instellingen van de module als ik bijwerk?
Nee. Het uploaden van de zip vervangt alleen de bestanden: instellingen, inhoud en gegevens blijven in de database. Ze gaan verloren als u de module verwijdert, maar bijwerken vereist nooit verwijderen.
Moet ik de module verwijderen voordat ik hem bijwerk?
Nee, en u kunt het beter niet doen. Upload de nieuwe zip over de versie die u al hebt heen: PrestaShop ziet dat de module aanwezig is en voert de upgrade zelf uit.
Ik heb op ‘Enable’ gedrukt en de module werkt: moet ik de zip dan nog uploaden?
Ja. Als de upload halverwege is gestopt, bevat de server bestanden van twee verschillende versies. Met inschakelen draait de module meteen weer, maar de update moet worden voltooid door de zip opnieuw te uploaden.
Hoe weet ik of de module slechts in één van mijn webwinkels uit staat?
Gebruik de keuzelijst linksboven in de back-office om telkens één webwinkel te kiezen en open de Module Manager: de module moet in elke webwinkel worden gecontroleerd. In de weergave ‘alle webwinkels’ kan hij ingeschakeld lijken, ook als hij in één ervan niet aan staat.
Waar vind ik de zip van de nieuwe versie?
Op de pagina Mijn licenties van uw account, die altijd de nieuwste versie bevat waarop u recht hebt. 12 maanden updates inbegrepen, daarna is verlengen optioneel.