1. Update Vorbereitungen

1.1. Lizenz:

Überprüfen Sie ob Ihre Lizenz für Version 4.2.00 freigegeben ist!

Um das Update von 4.1.10 auf 4.2.00 durchzuführen muss Ihre Lizenz für 4.2.00 freigegeben sein.
Für Welche Version Ihre Lizenz gültig ist, finden Sie in der lic/license.txt Datei auf Ihrem Webserver.

Beispiel:

company: xt:Commerce GmbH
created: 2009-10-09 01:18:15
key: b108799745bdb247a128f5842fae50d5
license: VEYTON - Ultimate
mailaddress: max_mustermann@xtcommerce.com
maxproducts: 0
name: Max Mustermann
project: xt:Commerce Veyton
maxversion: 4200

Der Parameter maxversion gibt hierbei die maximal mögliche Version an.

Wichtig: Starten Sie das Update erst wenn die aktualisierte Lizenz (mit mindestens "maxversion: 4200") in den Ordner /lic/ in Ihren Shop eingespielt wurde!

Sollten Sie eine Lizenz ohne "maxversion"-Parameter haben oder innerhalb des Update-Zeitraums sein und nur eine neue Lizenz benötigen, können Sie unter folgender URL eine aktualisierte Lizenz anfordern:

http://addons.xt-commerce.com/index.php?page=send_license

Über diesen Link erhalten Sie immer eine Lizenz die über den maximal für Sie möglichen "maxversion"-Parameter verfügt. Sollten Ihre Lizenz nicht mehr innerhalb des Update-Zeitraums sein, wird Ihnen außerdem das benötigte Update angezeigt.

1.2. Plugin-Updates:

 Kontaktieren Sie die Hersteller der von Ihnen verwendeten Plugins. Erfragen Sie, ob:

• Die von Ihnen verwendete Plugin-Version kompatibel mit der neuen Shopversion ist.
• Ob/Welche Anpassungen notwendig sind.
• Ob der Updatezeitraum Ihrer Plugin-Lizenz verlängert werden muss.

2. Starten des Updates

2.1. Backup:

Sichern Sie vor dem Updateprozess Ihre Shopdatenbank mit PhpMyAdmin oder MySqlDumper und das komplette Shopverzeichnis per FTP um eventuelle Datenverluste zu vermeiden!

2.1. Cache Leeren:

Leeren Sie zunächst den Cache des Shops, indem Sie sich per FTP verbinden und alle Dateien mit kryptischen Namen in den Ordnern "/cache/" und "/templates_c/" löschen.

Sollten Sie das Plugin xt_clean_cache installiert haben, können Sie dieses ebenfalls unmittelbar vor starten des Update-Scripts nutzen.

2.3. php-Version / Ioncube loader:

• Ändern Sie die php-Version des Webservers auf min. 5.3.
• Passen Sie im Zuge dessen auch die Ioncube-Version entsprechend an. ( Kontaktieren Sie hier ggf. den Support Ihres Hosters falls Sie dabei Probleme haben.)

2.4. System Patch für xtWizard:

Spielen Sie folgenden Patch von folgender URL in Ihren xt:Commerce 4.1.10 Shop ein:

http://helpdesk.xt-commerce.com/index.php?/Knowledgebase/Article/View/1193/0/4110-update-patch

2.2. Checkliste: Updatevorbereitungen:

• Datenbank Backup wurde erstellt (und geprüft)
• Die Shop-Lizenz ist für Version 4.2.00 freigegeben und wurde in den Shop eingespielt
• Die Plugin-Lizenzen wurden (ggf. erneuert und) in den Shop eingespielt
• Der Shop-Cache wurde geleert
• mindestens php 5.3 ist aktiv und der entsprechende Ioncube-Loader wurde eingebunden
• Der "System Patch für xtWizard" wurde in das System eingespielt.

3.0. xtWizard: Durchführen des Datenbank-Update

Wichtig: Ab der Version 4.2 (bzw. ab dem Update von 4.1.10 auf 4.X.XX) wird der xtUpdater durch das xtWizard Tool abgelöst. Sollten Sie mehrere Updates auf ein mal durchführen, führen Sie ein vollständiges Update (inkl. Dateiupload) auf die Version 4.1.10 durch und nutzen Sie danach den Wizard und diese Anleitung um weitere Updates durchzuführen.

Den xtWizard finden Sie im Download-Paket der Software ab Version 4.2.00. D.h. laden Sie die Version 4.2.00 (hier) herunter und laden Sie das Verzeichnis /xtWizard/ aus diesem auf Ihren Server. Erstellen Sie danach das Verzeichnis "/media/lang_downloads/" und geben Sie dem verzeichnis die Berechtigung "777".

Wenn Sie nun die URL www.ihr-shop.tld/xtWizard/ in Ihrem Shop aufrufen sehen Sie die Startpage des Wizard, welcher Sie durch das Update der Datenbank führt.

Eine bebilderte Anleitung zum Wizard-Update auf Version 4.2.00 finden Sie hier:

https://xtcommerce.atlassian.net/wiki/display/MANUAL/xtWizard+4.1.10+%3D%3E+4.2.00

Nachdem Sie den xtWizard ausgeführt haben, fahren Sie an dieser Stelle mit der Update der Templates (Schritt "4.0. Templateupdate") fort.

4.0. Templateupdate:

4.1. xt_grid:

Folgende Anpassungen müssen Sie an Ihrem Template vornehmen, damit xt:Commerce 4.2.00 kompatibel ist:

4.1.1.: /templates/xt_grid/xtCore/pages/login.html

QA-158: Diese Anpassung bewirkt das der Datepicker auf der Login-Seite Multilingual angezeigt wird.

Suchen Sie die Zeile:

format: 'DD.MM.YYYY'

Ersetzen Sie diese Zeile mit folgendem Code:

format: 'DD.MM.YYYY',
i18n: {
{/literal}
    previousMonth : '{$smarty.const.TEXT_PREVIOUS_MONTH}',
    nextMonth     : '{$smarty.const.TEXT_NEXT_MONTH}',
    months        : [
                     '{$smarty.const.TEXT_MONTH_JANUARY}',
                     '{$smarty.const.TEXT_MONTH_FEBRUARY}',
                     '{$smarty.const.TEXT_MONTH_MARCH}',
                     '{$smarty.const.TEXT_MONTH_APRIL}',
                     '{$smarty.const.TEXT_MONTH_MAY}',
                     '{$smarty.const.TEXT_MONTH_JUNE}',
                     '{$smarty.const.TEXT_MONTH_JULY}',
                     '{$smarty.const.TEXT_MONTH_AUGUST}',
                     '{$smarty.const.TEXT_MONTH_SEPTEMBER}',
                     '{$smarty.const.TEXT_MONTH_OCTOBER}',
                     '{$smarty.const.TEXT_MONTH_NOVEMBER}',
                     '{$smarty.const.TEXT_MONTH_DECEMBER}'
                     ],
    weekdays      : [
                     '{$smarty.const.TEXT_DAY_SUNDAY}',
                     '{$smarty.const.TEXT_DAY_MONDAY}',
                     '{$smarty.const.TEXT_DAY_TUESDAY}',
                     '{$smarty.const.TEXT_DAY_WEDNESDAY}',
                     '{$smarty.const.TEXT_DAY_THURSDAY}',
                     '{$smarty.const.TEXT_DAY_FRIDAY}',
                     '{$smarty.const.TEXT_DAY_SATURDAY}'
                     ],
    weekdaysShort : [
'{$smarty.const.TEXT_SHORT_DAY_SUNDAY}',
'{$smarty.const.TEXT_SHORT_DAY_MONDAY}',
'{$smarty.const.TEXT_SHORT_DAY_TUESDAY}',
'{$smarty.const.TEXT_SHORT_DAY_WEDNESDAY}',
'{$smarty.const.TEXT_SHORT_DAY_THURSDAY}',
'{$smarty.const.TEXT_SHORT_DAY_FRIDAY}',
'{$smarty.const.TEXT_SHORT_DAY_SATURDAY}'
                     ]
{literal}
}

CORE-757: Im Backend des Shops lassen sich nun Mindestlängen für die Felder  Firma, Handy & Fax konfigurieren. Diese Anpassung bewirkt, dass das die Felder ggf. als "Pflichtfelder" mit einem Stern gekennzeichnet werden.

Suchen Sie die Zeile:

 <label for="default_address_customers_company">{txt key=TEXT_COMPANY_NAME}</label>

Ersetzen Sie die Zeile mit folgenden Code:

 <label for="default_address_customers_company">{txt key=TEXT_COMPANY_NAME}{if _STORE_COMPANY_MIN_LENGTH > 0}*{/if}</label>

Suchen Sie die Zeile:

 <label for="default_address_customers_fax">{txt key=TEXT_FAX}</label>

Ersetzen Sie die Zeile mit folgenden Code:

 <label for="default_address_customers_fax">{txt key=TEXT_FAX}{if _STORE_FAX_MIN_LENGTH > 0}*{/if}</label>

CORE-787: Diese Anpassung bewirkt, dass nach einem Reload der Seite (z.B. weil das Validieren eines Feld gescheitert ist) der zuvor ausgewählte Wert erhalten bleibt:

Suchen Sie die Zeile:

{form params='id="default_address_customers_federal_state_code"' type=select name=default_address[customers_federal_state_code] value=$federal_states.federal_states}

Ersetzen Sie die Zeile mit folgenden Code:

 {form params='id="default