# Requirements and installation

## Requirements

- **Joomla:** 6.0 or newer
- **PHP:** 8.2 or newer, with the `mysqli` extension
- **YOOtheme Pro:** installed and active as the site template
- **JTL shop** with a reachable MySQL database

<div class="callout info" id="bkmrk-the-extension-works-">The extension works without Joomla's compatibility plugin. If you have enabled it for other reasons, that does no harm — it is simply not needed here.

</div>## Installation

1. Download the installation package `plg_system_jtlshop-x.y.z.zip` from your customer account on [graup-it.de](https://www.graup-it.de).
2. In the Joomla backend, open *System → Install → Extensions*.
3. Drag the ZIP file into the upload area or select it via *Browse*.

On a first installation the plugin is enabled automatically. You will find it afterwards under *System → Plugins* as *System - JTL Source*.

After the installation an overview panel appears showing the installed version and the entry points to Getting started, Download key and Manual. After an update, the changelog takes the place of "Getting started".

![The overview panel after an update, with the version number and the cards What's new, Enable updates and Help](https://docs.graup-it.de/uploads/images/gallery/2026-08/pn4doku-01-installationspanel.png)

<div class="callout warning" id="bkmrk-if-the-environment-d">If the environment does not fit — Joomla too old, PHP too old — the installation stops with a clear message instead of leaving behind an extension that silently fails later.

</div>## After the installation

1. Set up the connection to the shop and verify it with the built-in button — see [Setting up the shop connection](https://docs.graup-it.de/books/jtl-source-en/page/setting-up-the-shop-connection). **Without a connection the sources in the builder stay empty.**
2. Clear the YOOtheme cache: *YOOtheme → Settings → Advanced → Clear Cache*.
3. Open a page in the builder — the dynamic content now offers the group *Graup-IT* with the two sources.
4. Enter your download key for automatic updates — see [Download key and updates](https://docs.graup-it.de/books/jtl-source-en/page/download-key-and-updates).

## Uninstalling

Uninstall the plugin via *System → Manage Extensions*. The extension creates no tables of its own in Joomla, and it changes nothing in the JTL shop anyway. All that remains are the plugin settings, and those are removed with the uninstallation.

<div class="callout info" id="bkmrk-remember-to-remove-t">Remember to remove the database user you created for the connection in the shop as well, once you no longer need it.

</div><small>Applies to version 1.12.1.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/139)