Go to start of metadata

Spis treści

 

 

Automatyczna aktualizacja

Narzędzie Automatycznej aktualizacji pozwala administratorowi sklepu na utworzenie kopii zapasowej i aktualizację PrestaShop za pomocą kilku kliknięć i nie wymaga wiedzy technicznej.

Moduł 1-Click Upgrade jest częścią standardowej instalacji PrestaShop i powienien być dostępny w zakładce "Moduły" panelu administracyjnego. Wystarczy nacisnąć przycisk "Instaluj" znajdujący się obok ikonki tego modułu, żeby zyskać możliwość zaktualizowania sklepu do najnowszej wersji.

 

 

Nigdy nie powinno się aktualizować sklepu bez przygotowania. Automatyczna aktualizacja może w pewnych sytuacjach ulec awarii, a przywrócenie poprzedniej wersji może w tej sytuacji się nie powieść.
Najbezpieczniejszą praktyką jest umieszczenie dokładnych kopii sklepu - jednej na Twoim komputerze lokalnym, a drugiej w osobnym folderze na Twoim serwerze WWW. Taka kopia powinna zawierać wszystkie produkty, kategorie, szablony, moduły, tłumaczenia, pliki konfiguracyjne itd.
Zalecamy przeprowadzenie próbnej aktualizacji na kopii sklepu. Kiedy proces zostanie zakończony, należy dokładnie przejrzeć sklep i jego funkcjonowanie zarówno od strony użytkownika, jak i od strony panelu administracyjnego, aby upewnić się, że wszystko działa i wygląda jak należy. Jeśli tak nie jest, prawdopodobnie zachodzi jakiś konflikt między narzędziem Automatycznej aktualizacji, a ustawieniami sklepu. W tej sytuacji powinieneś zastosować metodę ręcznej aktualizacji, która choć nie jest już rozwijana i jej zastosowanie zabiera więcej czasu, może okazać się jednak pomocna.

 

 

Pobieranie i instalacja modułu 1-Click Upgrade

Jeśli modułu 1-Click Upgrade nie ma w Twoim sklepie PrestaShop w wersji 1.4 lub 1.5, możesz pobrać go bezpłatnie ze strony Addons. 

 

Nawet jeśli moduł 1-Click Upgrade masz już zainstalowany, upewnij się, że jest to najnowsza wersja tego modułu.

  • Jeśli Twój sklep to PrestaShop 1.4: Sprawdź numer wersji w zakładce "Moduły", a następnie porównaj go z numerem  wersji gotowej do pobrania na stronie Addons (więcej informacji na ten temat znajduje się poniżej). Jeśli numery różnią się, pobierz moduł ze strony Addons i zaktualizuj go.
    • W celu zaktualizowania modułu: odinstaluj, a następnie usuń "stary" moduł w zakładce "Moduły" panelu administracyjnego. Dalej, rozpakuj folder skompresowany "nowego" modułu, który pobrałeś ze strony Addons. W utworzonym w ten sposób folderze odszukaj folder "/autoupgrade", a następnie (używając na przykład protokołu ftp) skopiuj go do folderu "/modules" znajdującego się na Twoim serwerze. Następnie zainstaluj moduł 1-Click Upgrade w panelu administracyjnym Twojego sklepu.
  • Jeśli Twój sklep to PrestaShop 1.5 lub nowszy: PrestaShop automatycznie sprawdzi, czy wersja modułu, którą posiadasz jest wersją najnowszą. Jeśli dostępna jest nowsza wersja, obok przycisku "Instaluj/Odinstaluj" pojawi się przycisk "Aktualizuj". Naciśnij ten przycisk, aby zaktualizować moduł.

Następnie postępuj tak, jak podczas instalacji typowego modułu: 

  1. Pobierz moduł 1-Click Upgrade ze strony PrestaShop Addons: http://addons.prestashop.com/en/administration-tools/5496-autoupgrade.html. Zapisz plik Zip na pulpicie Twojego komputera.
  2. W panelu administracyjnym sklepu najedź kursorem myszy na pozycję "Moduły" w menu głównym, a następnie przejdź do zakładki "Moduły". 
  3. Kliknij w przycisk "Dodaj nowy moduł"; znajdziesz go w prawym górnym rogu ekranu, powyżej listy modułów.

     

    Jeśli aktualizujesz sklep w wersji 1.4, kliknij w "Dodaj moduł z mojego komputera" umieszczony w w okolicach lewego górnego rogu ekranu, powyżej listy modułów.

  4. W okienku, które sie pojawi, w sekcji "Plik modułu" wciśnij przycisk "Przeglądaj", po czym odszukaj i zaznacz plik Zip modułu 1-Click Upgrade, który właśnie pobrałeś.
  5. Naciśnij przycisk "Prześlij moduł". PrestaShop prześle plik Zip na serwer, rozpakuje go i umieści pliki modułu w folderze /modules.

Moduł został dodany do listy dostępnych modułów. Teraz należy go zainstalować.

  1. W zakładce "Moduły" znajdź moduł 1-Click Upgrade: wpisz do pola wyszukiwania w modułach (uwaga: nie do pola wyszukiwania w całym sklepie, znajdującego się u samej góry strony) "1-click upgrade" lub "autoupgrade". Moduł powinien zostać wyszukany jeszcze w momencie pisania. W PrestaShop w wersji 1.4 pojawi sie link do modułu, w który należy kliknąć.
  2. Następnie wyświetlona zostanie miniatura modułu na liscie modułów.
  3. Teraz wystarczy nacisnąć przycisk "Instaluj".

Moduł jest juz gotowy do konfiguracji i użycia.

Panel konfiguracyjny

Panel konfiguracyjny modułu dostępny jest z pozimu listy modułów po naciśnieciu linku "Konfiguruj".

 

Dostęp do panelu konfiguracyjnego modułu uzyskać można również:

  • Jeśli Twój sklep to PrestaShop 1.4: po kliknięciu w zakładkę "Narzędzia"  w menu głównym, w pod-zakładce "1-Click Upgrade".
  • Jeśli Twój sklep to PrestaShop  1.5 lub nowszy: po najechaniu kursorem na pozycję "Zaawansowane" w menu głównym i rozwinięciu podmenu, należy wybrać pozycję "1-Click Upgrade".

Panel konfiguracyjny składa się z kilku sekcji, zawierających informacje, narzędzia i ustawienia.

Witaj

To niewielkie pole zawiera przypomnienie, że aktualizacja nigdy nie jest procesem w stu procentach bezpiecznym, w związku z czym należy utworzyć kopię bezpieczeństwa wszystkich plików i danych składających sie na sklep. W przypadku niepowodzenia aktualizacji, kopia umozliwia przywrócenie Twojego sklepu do stanu początkowego - będzie to wymagało jedynie umieszczenia plików w odpowiednim katalogu na serwerze i wczytania kopii bazy danych.

Procedura przywrócenia sklepu z kopii bezpieczeństwa jest szczegółowo opisana w rozdziale "Tworzenie i przywracanie kopii bezpieczeństwa"  niniejszego przewodnika: http://doc.prestashop.com/display/PS16/Making+and+restoring+your+own+backup.

Należy odnotować, że moduł 1-Click Upgrade tworzy własny zestaw kopii bezpieczeństwa na wypadek konieczności zaniechania lub cofnięcia procesu aktualizacji. Niemnniej jednak zawsze powinno sie polegać przede wszystkim na własnej kopiii bezpieczeństwa.

Lista punktów do sprawdzenia przed dokonaniem aktualizacji

Pole "Lista punktów do sprawdzenia przed dokonaniem aktualizacji" ("The pre-Upgrade checklist") zapewnia rzetelne informacje o Twojej bieżącej instalacji PrestaShop, oraz o możliwych interakcjach między Twoim sklepem, a procedurą automatycznej aktualizacji.

Przed rozpoczęciem procesu aktualizacji należy upewnić się, że przy każdej pozycji na liście widnieje zielony "ptaszek".

Wszystkie powyższe pozycje listy kontrolnej musza być zaznaczone na zielono. W przeciwnym wypadku przycisk aktualizacji nie wyświetli się.

 

Jeśli przeprowadzasz aktualizacje sklepu zainstalowanego na Twoim komputerze (http://localhost lub http://127.0.0.1), a nie na serwerze WWW, moduł 1-Click Upgrade wykrywa, że tryb Przerwy technicznej nie musi być wprowadzany, ponieważ nikt poza Tobą i tak nie ma dostępu do sklepu. Z tego względu, nawet jeśli nie włączyłeś w sklepie Przerwy technicznej, moduł oznaczą ten warunek na liście kontrolnej jako spełniony.

Rozpocznij aktualizację

W tej sekcji odbywa się porównanie bieżącej wersji Twojego sklepu z wersją najnowszą. Możesz dzięki temu szybko ocenić, czy aktualizacja jest naprawdę potrzebna. Jeśli wiesz, że opublikowano już wersję nowszą niż tę, którą moduł wyświetla jako najnowszą (obok pola "Latest official version for major channel"), możesz sprawdzić czy ta najnowsza wersja jest dostępna do wykorzystania dla modułu 1-Click Upgrade naciskając przycisk "Sprawdź czy jest dostępna nowa wersja".

Moduł jest domyślnie ustawiony tak, aby jako docelową wskazywał wersję następną w ramach bieżącej "gałęzi" ("Gałęzie" to fundamentalne wersje PrestaShop: 0.9, 1.0, 1.1, 1.2, 1.3, 1.4 itd). Oznacza to, że jeśli używasz na przykład wersji 1.4.x, to moduł nie zasugeruje Ci aktualizacji do wersji 1.6.x, ale do najnowszej wersji gałęzi 1.4, czyli do 1.4.11.1. Dlatego też jeśli chcesz w tej sytuacji zaktualizować sklep do wersji 1.6.x, powinieneś wcisnąć przycisk "Więcej opcji (Tryb eksperta)", co zapewni Ci dostęp do wyższych gałęzi oprogramowania.
Ta opcja jest szczególnie użyteczna, jeśli chciałbyś wypróbować wersję inną niż stabilną (czyli na przykład wersję beta czy RC).

Przed uruchomieniem aktualizacji należy dobrze zrozumieć jej parametry. Sekcje "Opcje kopii zapasowej"  i "Opcje aktualizacji" wyświetlane są u dołu strony konfiguracji modułu 1-Click Upgrade i opisane w dalszej części niniejszego przewodnika. Upewnij się, że wszystkie one są dla Ciebie zrozumiałe.

Więcej opcji (Tryb eksperta) 

This section enables you to pinpoint exactly to which version you want to upgrade your current PrestaShop installation.

The options are:

Version comparison

For the curious, the numbered differences between your current version and the latest version in the chosen channel.

In case you have make changes directly to the core files instead of using the overriding possibilities of PrestaShop, these lists can help you know if your changes are safe or not.
Nevertheless, you can improve the lifespan of your custom code by turning it into overriding files. See the developer documentation for more information.

Rollback

This section only appears when at least one upgrade has been performed.

See below for more information.

Backup options

These options enable you to have some control on the backup process:

Upgrade Options

These options enable you to have some control on the upgrade process:

The Upgrade process

Once all the indicators in the "pre-Upgrade checklist" section are green, the update button appears in the "Start your Upgrade" section, along with the URL from which the new version will be downloaded.

Clicking the "Upgrade PrestaShop now !" button triggers the whole process.

Once the upgrade process is launched, the whole configuration page is replaced by two sections: "Activity Log" and "Rollback".

The activity log gives you a detailed journal of what the updater is doing, in a screen you can scroll through:

A lot of files are mentioned during the whole process. You do not need to read all the notifications, it's only there for you to peruse in case of error.

You'll know the upgrade is over when the following message "upgrade complete. Please check your front office theme is functional (try to make an order, check theme)" appears in green, along with the following final log entry: "End of process". 
The upgrader also indicates that you should re-enable your shop, but before you do that, you should first check that everything is working in your back office: no errors, all products and categories are in place with their images and attached files, etc. Until you have checked that everything is okay in your shop, it is better to keep it from the public eye.

 

On first load, pages might look wonky: because your web browser caches files, it is probably using the old CSS files instead of the new ones. Do not hesitate to reload the page several times, or even empty your browser's cache, in order to get the correct interface.

 

When you upgrade from version 1.4 to version 1.6, your menus will not be arranged the way they would be if you made a fresh installation of version 1.6.

That is because PrestaShop 1.4 tabs got reorganized into 1.6 menus, and a lot of pages were moved around in order to create consistent menus. Additionally, the upgrader assumes that your 1.4 tabs may have been customized or moved around, either by a module or by your own action. Therefore, rather than breaking the existing settings, the upgrader takes the tabs as-is, and does not re-arrange them into the default 1.6 menu order.

If you want to change the position of pages within a menu once you have updated to version 1.6, go the to "Menus" page under the "Administration" menu, and start fiddling with positions.

Once you have made sure your PrestaShop installation is up and running, you can re-enable your shop using the option in the "Maintenance" page of the "Preferences" menu, then make tests on your front office: browse products, sort them, try to order one, etc. In short, go through the entire buying process in order to make sure that you won't miss a sale.

Is everything working fine? Congratulations, you know have successfully upgraded your PrestaShop installation!

JavaScript error

 

In some server configurations, an error message might be displayed, saying "Javascript error (parseJSON) detected for action "upgradeNow". Starting restoration...".

Follow these steps to solve the error, :

  • Open your php.ini file and enable (uncomment) the MySQLi and MySQL PDO extensions. If you cannot access the php.ini file, contact your web host about this.
  • Open the /modules/autoupgrade/db/Db.php and find these lines (around line 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;
    }

     

    Simply uncomment these lines (remove /* and */). They should now look like this:

     

    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;
    }

After you have done all this, start the autoupgrade process again.

Going back to the previous version: rollbacks

Sadly, not all upgrades are successful – which is the very reason why you should always back-up all your files and data, and why PrestaShop performs an additional backup of said files and data by itself, which you should not always count on. Make your own backup first. See the "Making and restoring your own backup" chapter of this guide for more information.

PrestaShop's own backup files are saved on your server, and if it turns out your update has gone badly, you can find them in the "Rollback" section of the configuration page for the 1-Click Upgrade module.
Backup files are created as soon as the upgrade process is started, and are available immediately in the "Choose your backup" drop-down list.
Choose the most recent one. The date and hour of the creation of the backup file are right within the name: Vversion-date-hour-random, for instance "V1.4.9.0_20120907-114024-f85f41a" for a backup of a previous PrestaShop 1.4.9 installation, made September 7th 2012, at 11:40:24 AM.

The "Rollback" button triggers two actions:

Select the backup archive to which you want to roll back to, and click the "Rollback" button. As with the upgrade process, the whole interface disappears to only leave the "Activity Log" section and the "Rollback" section. You can follow the rollback process in the scrolling journal, and once it is finished, reload the page in order to check that everything is indeed back in place.

Going back to the previous version: restoring your own backup

This is explained in details in the "Making and restoring your own backup" of this guide:http://doc.prestashop.com/display/PS16/Making+and+restoring+your+own+backup.