Skip to main content

Requirements and installation

Requirements

  • Joomla 6
  • PHP 8.3 or newer
  • MySQL 8.0.13 or newer, or MariaDB 10.4 or newer

Installing

  1. Download the package pkg_fileshelf-<version>.zip.
  2. In the backend open System → Install Extensions and drop the ZIP file into the field.
  3. After the installation Joomla shows an overview of the package with links to the dashboard. In the Free version it also carries a short note on the Pro version.

On installation Fileshelf creates the storage folder fileshelf/ in the Joomla folder and writes protection files into it. Then open Components → Fileshelf → Dashboard: it shows whether the folder is protected (see Storage folder and self-test).

The Fileshelf dashboard: figures and the storage folder at the top, below “Needs your attention”, quick access and the downloads changed last
The dashboard: figures and the state of the storage folder at the top, below what needs your attention, quick access and the downloads changed last.

The dashboard

  • Figures – cards of the same height with a head: downloads (published and unpublished), categories, in the Pro version the hits, and the storage folder. At the bottom of each card is the way on, such as “All downloads”.
  • Storage folder – where the folder is and what it is for: the files are kept here, and visitors get a file only through Fileshelf, with access, password and limits checked. With “Check now”, the settings and this guide.
  • Needs your attention – only what is to be done, with the way to mend it: for example a download without a file (“Assign a file”), a storage folder whose protection is not confirmed, or plans that stay locked without Membership Pro. With nothing to do it is one line.
  • Quick access – the pages you need most often, as tiles.
  • Changed last – the five downloads edited last; next to them “Set up and maintain” with tools and options.
  • In the Free version a box at the top names the Pro version, and the row “In the Pro version” explains its features, each on a page of its own.

Every page of Fileshelf has the button Help at the top right: it opens this manual. All pages, including those of the Pro version, are also in the menu under Components → Fileshelf.

Updates

New versions appear under System → Update → Extensions. An update keeps your downloads, files and settings; it works from any earlier version.

Uninstalling

When you uninstall the package, Joomla removes the tables of Fileshelf. The storage folder with your files stays – delete it by hand if you no longer need it.

Deutsche Fassung