Quick search:eBay DataTransfer JTL-Worker PayPal

JTL-Links

Thank you for using the English version of the JTL-Guide!
We are currently still building up the English documentation; not all sections have been translated yet. Please note that there may still be German screenshots or links to German pages even on pages that have already been translated. This guide mostly addresses English speaking users in Germany.

Note: On 1 September 2024, JTL introduced new editions that bundle most of the previous individual services into different packages. In order for you to continue working as smoothly as possible, existing customers were automatically switched to the package configuration that best matched their existing contract. The individual packages differ in terms of limitations and/or range of functions. Therefore, some of the features described in the JTL-Guide may not be available to you as part of your booked JTL edition. You can change your package configuration in your JTL customer account. Find out more about the new editions and packages here. Check our FAQ for frequently asked questions about the product editions.

Contents

Shop update FAQ (Hosting)

When and how will a shop update be carried out?

Please note: This description is only valid for JTL shops in the JTL-Shop hosting. If you host JTL-Shop yourself, please read the following update instructions: Updating JTL-Shop.

If you use JTL-Shop hosting, you must not update JTL-Shop yourself. Instead, follow the steps below to initiate updates.

Attention: Before requesting the update, make sure that you have a template that is also compatible with the new version of JTL-Shop. Please also check whether your plugins are compatible with the new version. Otherwise, your shop may become unreachable. If you have made changes outside your template, please save them, because the files can be overwritten during the update. You can request a free test shop and test the necessary individual adjustments there first. For help with template updates, please visit http://docs.jtl-shop.de/de/latest/shop_templates/index.html. If you have further questions, please contact our Support team via the JTL-Customer Centre.

Version update

During a version update, the version number of JTL-Shop changes, e.g. from 5.00 to 5.1. Changing the main version, e.g. JTL-Shop version 4.X to version 5.X, also requires a version update.

JTL-Shop will be updated to the latest available version at your request. Log in to the Customer Centre and open your Hosting overview using the following link: Go to hosting overview. Finally, click on Update vormerken (Request update) for your shop domain. The update will then be carried out as soon as possible on the next possible date on weekdays between 9 AM and 5 PM. You will be notified by email as soon as your shop has been updated. The actual update process usually only takes a few moments.

Please note: Refer to the notes on the necessary revisions after a version update: Further steps after the update of JTL-Shop.

Build update

In a build update, only the build number of JTL-Shop changes, e.g. from 5.1.2 to 5.1.5.

JTL-Shop will be updated to the latest available version at your request. Log in to the Customer Centre and open your Hosting overview using the following link: Go to hosting overview. Finally, click Auf X.X.X updaten (Update to X.X.X) for your shop domain. The update is usually carried out automatically within a few minutes. You will be notified by email as soon as your shop has been updated. Please note that the build update process is automated and thus unmonitored. Therefore, we highly recommend using build updates only during JTL business hours, as it is not possible to support update errors outside of these hours.

Please note: Refer to the notes on the necessary rework during a build update: Further steps after the update of JTL-Shop.

Preparations for an upgrade to JTL-Shop 5

Before upgrading, you need to make some preparations to ensure a smooth process.

Just before the upgrade, no more synchronisations with JTL-Wawi may be carried out. Please consider this when scheduling the upgrade. If you use JTL-Worker, you have the following options:

Exit JTL-Worker and only restart it after the upgrade has been successfully completed.
Exit JTL-Worker. Then, in the background service settings of JTL-Worker, specify that no online shop synchronisation should be carried out. Then restart JTL-Worker to continue synchronisations with other platforms.
Block the affected JTL-Shop for the synchronisation in the respective online shop connection settings.

If you use the object cache, deactivate it completely under System > Wartung > Cache (System > Maintenance > Cache).
Check your plug-ins:

Uninstall all plug-ins (active and inactive) of which you know that you will no longer use them after the upgrade or are not using anymore now. For these plug-ins, also remove the files of the web space from the directory /includes/plugins, as in some cases even uninstalled plug-ins can cause problems after updates.
Deactivate all plug-ins that you would like to continue using after the upgrade shortly before the upgrade.

Please note: Please refer to the FAQ of our upgrade guide from JTL-Shop 4 to JTL-Shop 5: Upgrade FAQ and follow the instructions for the necessary rework in relation to a version update: Further steps after the update of JTL-Shop.

Will my template adjustments be overwritten during a shop update?

The directories/templates/Evo and, from JTL-Shop 5, /templates/Nova will always be overwritten during a shop update and will overwrite all changes you have made to the templates in these directories. Thus, the adjustments do not exist anymore. Therefore you need to save your template before the update via FTP.

If you use child templates or use a completely separate template, i.e. do not use the aforementioned directories for your adjustments, nothing will be overwritten. Please note, however, that updates to the templates may be necessary so that they are compatible with the newer version of JTL-Shop.

How do I change the PHP version?

Log in to Plesk. The URL is https://<SHOPSERVERNAME>:8443/, e.g. https://shop123.jtl-hosting.de:8443/
Under Websites & Domains and the corresponding domain, you will find the item PHP-Einstellungen (PHP settings), under which the currently used PHP version is displayed. Click on the item.

Click on the arrow icon to go to the drop-down menu next to the PHP version you have selected.

Select the desired PHP version. Make sure that the selected version is compatible with your shop and with all plug-ins.

Finally, click Übernehmen (Apply).

How do I check the shop version?

To check the shop version, two methods are available:

Method 1: Via the JTL-Shop backend

Log in to the back end of your shop. The URL is https://<SHOPDOMAIN>/admin, e.g. https://myshop.com/admin.
After logging in, you will see the shop version on the start page:

In JTL-Shop 4:

In JTL-Shop 5:

Method 2: Via the Plesk management interface

Log in to Plesk. The URL is https://<SHOPSERVERNAME>:8443/, e.g. https://shop123.jtl-hosting.de:8443/.
In the menu item Dateien (Files), select the directory httpdocs > includes.
Click on the file defines_inc.php to view it.

With JTL-Shop 4, you will now see the statements with JTL_VERSION and JTL_MINOR_VERSION, which are the shop version and the build version. In the example shown, this results in version 4.06.18.

With JTL-Shop 5, you will see a statement for APPLICATION_VERSION instead, which contains the complete shop version. In the example, this is version 5.1.2.