Inhoudsopgave

Automatisch bijwerken

PrestaShop's automatische update-tool maakt het mogelijk voor webwinkeleigenaren zonder technische kennis om hun eigen site bij te werken in slechts een paar klikken.

De 1-Click Upgrade module zou standaard beschikbaar moeten zijn op de "Module"-pagina (onder de categorie: "Administratie"): klik op de "Installeer"-knop en PrestaShop wordt bijgewerkt.

Werk uw winkel nooit zomaar bij. De automatische tool waarmee PrestaShop bijgewerkt kan worden kan in sommige situaties falen en mogelijk kunt u dan ook nog eens niet meer herstellen naar een vorige versie.

Het veiligst is om een exacte kopie van u winkel beschikbaar te hebben. Dat kan lokaal op uw eigen computer zijn of ergens op de webserver. Het moet al uw producten, categoriën, thema's, modules, vertalingen, instellingen, etc. bevatten.

Probeer een proefupgrade uit te voeren op die kopie. Als het lukt om te upgraden, controleer dan uw front en back office om te kijken of alles nog werkt zoals verwacht. Als dat niet het geval is, dan heeft de upgradetool problemen met uw configuratie en heeft u de handmatige methode nodig, welke helaas niet meer ondersteund wordt en langer duurt, maar kan in uw situatie toch van pas komen.

Downloaden en installeren van de 1-Click Upgrade module

Als de 1-Click Upgrade module niet beschikbaar is in uw installatie van PrestaShop 1.4, 1.5 of 1.6, dan kunt u deze gratis downloaden vanaf the Addons website.

Zelfs als u al de "1-Click upgrade" module hebt geïnstalleerd, zorg er dan alsnog voor dat u beschikt over de meest recente versie:

  • PrestaShop 1.4: Controleer het versienummer in het "Modules"-tabblad, vergelijk deze met het versienummer op de Addons site. Als de versienummers verschillen, download dan de versie vanaf Addons en werk de module bij.
    • De module bijwerken gaat als volgt: deïnstalleer de oude versie en verwijder deze daarna, kopieer daarna de "/autoupgrade" map uit het zip-bestand van de module (deze wordt geleverd door de Addons website), kopieerd deze map naar de "/modules" map van uw PrestaShop-installatie. Als laatste installeert u de module weer in uw administratiepaneel.
  • PrestaShop 1.5: PrestaShop controleert automatisch via de Addons website of u over de meest recente versie beschikt. Als er een nieuwe versie beschikbaar is, dan verschijnt de tekst "Bijwerken" naast de knop "Installeren/Deïnstalleren" van de module. Als u op de bijwerkknop klikt, dan download PrestaShop zelf de meest recente versie en werkt het de module bij.
  • PrestaShop 1.6 en nieuwer: PrestaShop controleert automatisch via de Addons website of u over de meest recente versie beschikt. Als er een nieuwe versie beschikbaar is, dan verschijnt de tekst "Bijwerken" op de configuratieknop van de module. Als u op de bijwerkknop klikt, dan download PrestaShop zelf de meest recente versie en werkt het de module bij.

Volg simpelweg de normale manier om een module te installeren in PrestaShop:

  1. Download de 1-Click Upgrade module vanaf PrestaShop Addons: http://addons.prestashop.com/nl/administration-tools/5496-autoupgrade.html. Bewaar het zip-bestand op uw bureaublad of andere locatie naar keuze.
  2. Ga naar de "Modules" pagina in uw back office.
  3. Klik op "Nieuwe module toevoegen", deze knop is boven de modulelijst te vinden.

    Wanneer u update vanaf versie 1.4, klik dan op de link "Module toevoegen vanaf mijn computer", deze link is linksboven te vinden.

  4. Klik op de knop "Kies een bestand" in het formulier dat nu opent ga zoek het zip-bestand van de module die zojuist hebt gedownload.
  5. Klik op de knop "Upload deze module". PrestaShop pakt de module automatisch en voegt deze toe aan de /modules map.

De module is nu beschikbaar in uw modulelijst, maar u moet het nog wel installeren:

  1. Type "autoupgrade" in de zoekbox van de modulelijst (niet de globale zoekfunctie linksboven). 
  2. De module zou nu in de modulelijst moeten verschijnen.
  3. Klik op de knop "Installeren" van de module.

De module is nu gereed om te configureren en te gebruiken.

Het configuratiescherm van de module

Het configuratiescherm van de module is nu bereikbaar vanaf de modulelijst, door op de knop "Configureren" te klikken.

Het configuratiescherm is ook beschikbaar vanaf:

  • PrestaShop 1.4: onder de tab "Gereedschap", onder de "1-Click Upgrade" tab.
  • PrestaShop 1.5, 1.6 en nieuwer: onder "Geavanceerder instellingen/Geavanceerde parameters" en dan "1-Click Upgrade".

Het configuratiescherm toont een aantal onderdelen met informatie, tools en instelligen.

Welkom

Deze kleine sectie bevat een reminder om aan te geven dat een upgrade nooit 100% veilig kan zijn en dat het daarom verstandig is dat u een complete backup maakt van uw bestanden en data. Op deze manier, mocht de upgrade mislukken, kunt u alsnog de winkel herstellen - alhoewel er wel enig werk bij komt kijken.

Dit proces wordt in detail omschreven in hoofdstuk Backups aanmaken en terugzetten.

Noot: de 1-Click upgrade module maakt zelf ook een backup om ervoor te zorgen dat de gehele upgrade ongedaan gemaakt kan worden. Toch kunt u beter vertrouwen op uw eigen backups.

De checklist voor het bijwerken

De sectie "checklist voor het bijwerken" geeft u nuttige informatie over uw huidige PrestaShop-installatie en of het upgradeproces kan worden uitgevoerd.

U moet er zeker van zijn dat aan alle eisen op de lijst is voldaan voordat u verder kunt gaan met de upgrade.

Al deze indicatoren moeten groen zijn, anders verschijnt de knop "Werk PrestaShopo nu bij!" niet.

Wanneer de winkel is gehost op uw eigen lokale server (http://localhost of http://127.0.0.1), dan begrijpt de auto-upgrade module dat onderhoudsmodus niet is vereist, omdat niemand anders, behalve u, de site kan bereiken. Daarom, zelfs als de winkel zich niet in onderhoudsmodus bevindt, kan het zijn dat dit item alsnog wordt goedgekeurd.

De upgrade starten

Dit gedeelte vergelijkt uw huidige versie van PrestaShop met de meeste recente stabiele versie. U kunt in een ogenblik zien of u moet updaten of niet. Als u weet dat er een nieuwere versie is dan hetgeen wordt getoond, dan kunt u een versiecontrole laten uitvoeren door te klikken op "Kijk na of er een nieuwe versie is".

Standaard is de updatetool ingesteld om uw winkel bij te werken naar de volgende kleine release. Dit betekend dat als u een versie van de 1.4.x branch gebruikt, het niet meteen de meest recente 1.6.x. versie zal tonen, maar eerder de laatste versie van 1.4.x. Als u wilt upgraden naar de meest recente versie van 1.6.x. vanuit 1.4.x. dan moet u klikken op de knop "Meer opties (Expert mode)", waar u het kanaal kunt aanpassen.
Dit is ook erg handig als u wilt controleren op een andere versie dan de stabiele (bijvoorbeeld beta, RC of een andere onstabiele versie).

Voordat u de upgrade start, moet u zeker zijn dat u begrijpt wat er is ingesteld. De secties "Reservekopie opties" en "Upgrade opties" zijn beschikbaar aan de onderkant van de pagina (en worden verder in dit hoofdstuk omschreven). Zorg ervoor dat u ze allemaal begrijpt.

Expert mode

Deze sectie zorgt ervoor dat u precies kunt aangeven naar welke versie u PrestaShop wilt bijwerken.

De opties zijn:

Versievergelijking

Voor de nieuwsgierige gebruiker: het aantal verschillen tussen de huidige en meest recente versie worden hier aangegeven.

Als u direct wijzigingen hebt aangebracht aan de hoofdbestanden in plaats van de override-mogelijkheden toe te passen binnen PrestaShop, dan kunt u met deze lijst erachter komen of uw wijzigingen veilig zijn of niet.
U kunt hoe dan ook de levensduur van uw wijzigingen verlengen door de veranderde bestanden om te zetten in override-bestanden. Bekijk de ontwikkelaarshandleiding hoe u dit kunt doen.

Terugzetten van reservekopie

Deze sectie verschijnt alleen wanneer er op zijn minst één upgrade is uitgevoerd.

Kijk hieronder voor meer informatie.

Reservekopie opties

Deze opties geven u meer controle over het reservekopieproces:

Upgrade opties

Deze opties zorgen ervoor dat u meer controle hebt over het upgradeproces:

Het bijwerkproces

Wanneer alle indicatoren van de lijst "De checklist voor het bijwerken" groen zijn, dan verschijnt de knop "PrestaShop nu bijwerken!" in het gedeelte "Start het bijwerken", samen met de URL waar de nieuwe versie vandaag zal worden gedownload.

Wanneer u klikt op "PrestaShop nu bijwerken!" wordt het gehele proces gestart.

Zodra het bijwerkproces is gelanceerd, wordt de gehele configuratiepagina vervangen door twee secties: "Activiteitenlog" en "Terugzetten".

De activiteitenlog geeft u een uitgebreid overzicht van wat de updater op dit moment aan het doen is. U kunt door dit venster scrollen:

Er worden veel bestanden genoemd tijdens het gehele prcoces. U hoeft niet alle notificaties te lezen, ze zijn er slechts om gelezen te worden wanneer er fouten optreden.

U ontvangt de melding "Upgrade compleet. Kijk na of het front office thema volledig werkt (probeer een account aan te maken, een bestelling te plaatsen...)" in het groen, samen met de laatste melding in de log: "Einde van het proces".
De upgrader geeft ook aan dat u uw winkel uit onderhoudsmodus moet halen, maar voordat u dat doet, controleert u eerst even of alles werkt in uw back office: er mogen geen fouten voorkomen, alle producten en categoriën zijn nog steeds juist, samen met de afbeeldingen en bijlagen, etc. Totdat u heeft gecontroleerd of alles in uw winkel nog werkt, kunt u beter de winkel verbergen voor het publiek. 

Bij de eerste keer laden van pagina's zien ze er wellicht vreemd uit: omdat uw browser bestanden in de cache plaatst, is het mogelijk dat oude CSS-bestanden worden gebruikt in plaats van de nieuwe. Wanneer dit gebeurt kunt u de pagina meerdere keren proberen te herladen of de browser cache legen om zo de goede interface te krijgen.

Wanneer u upgrade van versie 1.4 naar versie 1.6, dan zullen uw menu's anders gerangschikt zijn dan wanneer u een versie installatie van versie 1.6 zou gebruiken.

Dat is omdat de tabs van PrestaShop 1.4 opnieuw zijn onderverdeel in de menu's van versie 1.6. Veel pagina's moesten hierom verplaatst worden om consistente menu's te krijgen. Ook gat de module er vanuit dat uw 1.4 tabs mogelijk zijn aangepast of verplaatst, door een module of door eigen aanpassingen. In dat geval blijft de upgrader voorzichtig en laat de tabs voor wat ze zijn en probeert ze niet op de 1.6 manier te rangschikken.

Asl u de posities van de paginas wilt wijzigen, zodra uw winkel is bijgewerkt naar versie 1.6, dan gaat u naar "Menu's" onder het menu "Administratie" en kunt u de posities daar wijzigen.

Zodra u er zeker van bent dat uw PrestaShop-installatie goed werkt, kunt u de shop weer inschakelen door naar de optie "Onderhoud" onder het menu "Instellingen" te gaan, korte tests uit te voeren op uw front office: zoeken naar producten, proefbestelling plaatsen, etc. In het kort: doorloop het gehele bestelproces om ervoor te zorgen dat u geen bestelling mist.

Werkt alles naar behoren? Gefeliciteerd, u heeft nu succesvol uw PrestaShop-winkel bijgewerkt!

Met sommige serverconfiguraties verschijnt er een foutmelding met de tekst "Javascript error (parseJSON) detected for action "upgradeNow". Starting restoration...".

Volg onderstaande stappen om het probleem op te lossen:

  • Open uw php.ini bestand en schakel de MySQLi en MySQL PDO extensies in (door de comment weg te halen). Als u geen toegang hebt tot uw php.ini bestand neem, dan contact op met uw hostingprovider.
  • Open het bestand /modules/autoupgrade/db/Db.php en zoek naar onderstaande regels (rond regel 210):

    public static function getClass()
    {
        $class = 'MySQL';
        /*if (PHP_VERSION_ID >= 50200 && extension_loaded('pdo_mysql'))
            $class = 'DbPDO';
        else if (extension_loaded('mysqli'))
            $class = 'DbMySQLi';*/
        return $class;
    }

    Verwijder simpelweg de comments van deze regels (verwijder /* en */). De regels zouden er nu als volgt uit moeten zien:

    public static function getClass()
    {
        $class = 'MySQL';
        if (PHP_VERSION_ID >= 50200 && extension_loaded('pdo_mysql'))
            $class = 'DbPDO';
        else if (extension_loaded('mysqli'))
            $class = 'DbMySQLi';
        return $class;
    }

Als u dit hebt gedaan, wordt het bijwerkproces opnieuw gestart.

Terug naar de vorige versie: terugzetten

Helaas zijn niet alle upgrades een even groot succes – wat de reden is om altijd een reservekopie te maken van uw bestanden en data, en waarom PrestaShop zelf een extra backup van de genoemde bestanden en data aanmaakt, waar u niet altijd vanuit mag gaan dat deze goed zijn. Maak altijd eerst uw eigen backup. Bekijk het hoofdstuk Backups aanmaken en terugzetten van deze handleiding voor meer informatie.

PrestaShop's eigen reservekopiebestanden worden bewaard op uw server, en als blijkt dat de update niet is gegaan zoals had gemoeten, dan kunt u de backups vinden onder "Terugzetten" op de configuratiepagina van de 1-Click Upgrade module.
Backupbestanden worden aangemaakt zodra het updateproces is gestart en zijn meteen beschikbaar in de dropdown die verschijnt naast "Kies uw backup".
Kies de meest recente. De datum en tijdstip van aan het aanmaken van het bestand bevinden zicht vlak naast de naam: Vversie-datum-uur-willekeurig, bijvoorbeeld: "V1.4.9.0_20120907-114024-f85f41a" voor een backup van een vorige PrestaShop 1.4.9 installatie, gemaakt op 7 september 2012 om 11:40:24.

De "Terugzetten"-knop doet twee dingen:

Selecteer het backuparchief die u wilt gebruiken en klik op de "Terugzetten" knop. Net zoals bij het updateproces verdwijnt de gehele interface en blijven alleen de activieitenlog en terugzetten-secties over. U kunt de vooruitgang van het terugzetten volgen in de log en zodra het proces is voltooid, kunt u de winkel opnieuw bekijken om te controleren of alles goed is teruggezet.

Terugzetten van de vorige versie: herstellen door middel van uw eigen reservekopie

Dit wordt in detail uitgelegd in hoofdstuk Handmatig bijwerken.