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

Integrating JTL-Search into JTL-Shop

Your task/initial situation

You have booked a fee-based version of JTL-Search or started the trial period and have already registered a URL for JTL-Search (The basics of JTL-Search). You now wish to integrate JTL-Search into JTL-Shop. You use at least JTL-Shop 4.00.

Your advantages:

The search function integrates seamlessly into JTL-Shop.
In the standard JTL-Shop templates NOVA (JTL-Shop 5) and Evo (JTL-Shop 4), no adjustments are needed. With other templates, it might be necessary to exchange some plug-in template files to adjust filter boxes and the JavaScript code of the template structure.
Data in near real time: After a synchronisation with JTL-Wawi, JTL-Shop remembers new and changed items. These items are then immediately exported and sent to the queue of the JTL-Search server (will be processed as high priority within minutes).

Please note that the maintenance mode must be switched off for JTL Search to work.

Step 1: Booking the licence

Step 2: Noting down the licence key

Open the JTL-Customer Centre (https://kundencenter.jtl-software.de) and log in with your customer account.
Go to Produkte > Onlineshop > JTL-Search (Products > Online shop > JTL-Search). The Customer Centre homepage of JTL-Search opens. Here you can see the current information on your JTL-Search licence.
Click Aktionen > Lizenz Anzeigen (Actions > View licence). The dialogue Ihr Lizenzschlüssel (Your licence key) opens.

Write down the licence key, e.g. in a text document.

Step 3: Installing the plug-in (only for JTL-Shop 4)

The plug-in for JTL-Search is already included in JTL-Shop. You only need to activate it.

Open the back end of your JTL-Shop and log in.
Go to Plug-ins > Plug-in manager to open the plug-in administration.
Switch to the tab Verfügbar (Available), activate JTL-Search and click Installieren (Install). The plug-in is now available in JTL-Shop.

Step 4: Activating and configuring the plug-in

Via the menu, go to Plug-ins > JTL-Search to open the administration window of JTL-Search in JTL-Shop.
Go to the tab Lizenz (Licence) and enter the key copied in step 1 into the field Lizenzschlüssel (Licence key).
Click Suche aktivieren (Activate search). Go to the tab Verwaltung (Administration).

You need to carry out an initial export of your item data. To do this, click Export starten (Start export).

Depending on how many items there are, the export can take several minutes. Afterwards, the search server of JTL-Search is notified of the new data export. Retrieving and importing the data might also take several minutes when there are many items. JTL-Search will then be available in JTL-Shop.

You can now proceed with your individual search settings which are specified in the JTL-Search back end (which is available via the JTL-Customer Centre).

Error messages

The export does not start: You might have set up a forwarding to another URL. In that case, JTL-Search cannot access the URL initially entered during the registration anymore. You can either remove the forwarding or add the respective URL to the includes/config.JTL-Shop.ini.php.

Search in JTL-Shop

To carry out a search in JTL-Shop, you can either use the search field or the URL ShopURL.de/navi.php?suchausdruck=XYZ. In both cases, the error-tolerant search of JTL-Search is used, which means that typing errors are corrected, the after search navigation is present and search queries are counted.