# Requirements and installation

## Requirements

- **Joomla:** 6.0 or newer
- **PHP:** 8.2 or newer
- **YOOtheme Pro:** installed and active as the site template
- **Phoca Download:** version 6.x — available free of charge at [phoca.cz](https://www.phoca.cz/phocadownload)

<div class="callout warning" id="bkmrk-install-phoca-downlo">Install **Phoca Download first**. The installation of Phoca Download Source checks whether the component is present and stops with a notice otherwise — without the download manager the plugin would have no data to offer.

</div>## Installation

1. Download the installation package `plg_system_ytp_phocadownload-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 - Phoca Download Source*.

![The panel after installing Phoca Download Source, with version, status and the cards Getting started, Enable updates and Help](https://docs.graup-it.de/uploads/images/gallery/2026-08/dTBdoku-05-installationspanel.png)

The panel after the installation names the installed version and leads to the three things now due: selecting the source in the builder, storing the download key for updates, and the manual. After an update, the changelog takes the place of "Getting started".

## After the installation

1. Clear the YOOtheme cache: *YOOtheme → Settings → Advanced → Clear Cache*.
2. Open a page in the builder — the dynamic content of the elements now offers the group "Phoca Download" with the three source types.
3. Enter your download key for automatic updates — see [Download key and updates](https://docs.graup-it.de/books/phoca-download-source-en/page/download-key-and-updates).

## Updating from version 1.6 or older

An update is installed like a fresh installation via the ZIP, or conveniently through the Joomla updater; your settings are preserved. Version 1.7 automatically cleans up the files of older plugin versions and converts a download ID already stored to the current key format — you do not have to do anything further.

## Uninstalling

Under *System → Manage Extensions*, select the plugin *System - Phoca Download Source* and uninstall it. Your downloads and categories in Phoca Download remain fully intact; only the source in the builder is gone. Phoca Download sources used in layouts show no content afterwards.

<small>Applies to version 1.7.3.</small>

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