Creating and maintaining downloads
A download is an entry with exactly one file. You create it under Components → Fileshelf → Downloads → New.
The form has at most seven tabs: File and description, Access, in the Pro version Sharing, Versions and Statistics, plus Publishing and Permissions. Custom fields get a tab of their own, as with articles.
Tab “File and description”
- Category – the main category. It decides the address of the download, its inherited permissions and the folder its file lies in.
- Additional categories – the download also appears in the lists of these categories. Address and inherited settings still come from the main category.
- Description – appears on the page of the download. It is edited with the same editor as an article, with images, media and the editor buttons; content plugins work in it as in articles. If the field shows only an empty frame, the editor is the cause: check the editor under Users → your profile → “Basic Settings” and, with JCE, whether an editor profile is published and applies to your user group.
- Tags and fields as with articles.
Image or symbol
Below the file you choose how the download appears in lists, cards and on its page:
- Automatic – the coloured tile of its file type (ZIP, PDF …), as before;
- Own image – an image of the media manager, such as a product picture;
- Symbol from a library – a symbol of Joomla or, when YOOtheme Pro is installed, one of YOOtheme's UIkit symbols. A search field filters the symbols by name.
If the image is gone later or YOOtheme Pro is no longer installed, Fileshelf shows the tile of the file type again.
The file
- Upload a file – the file is stored in the folder of the main category when you save.
- Or choose a file from the storage folder – lists files that do not belong to a download yet, such as ones copied there by FTP. Fileshelf reads the folder only when you click Show free files in the storage folder; the list shows up to 200 files.
- If the same file already belongs to another download, Fileshelf shows a note.
- Version – under “About the file”, free text such as
2.1. Visitors see it in the lists. In the Pro version the facts about the file stand at the top of the tab “Versions”. - License – appears there once an import from another download extension has created the field (Pro version). On the website it carries the label “License” in the visitor's language.
Allowed are the file types from Options → Storage → Allowed file types. Programs and web
pages (for example php, svg, html) are never accepted, not even in
names like report.php.pdf. Fileshelf also checks whether the content matches the extension,
and Joomla checks the file as well.
Extensions and other software packages
A ZIP with an extension for Joomla, Shopware or WordPress contains PHP files. Joomla refuses such archives on upload, and Fileshelf then says what to do. To offer extensions, switch on Options → Storage → Allow software packages. Fileshelf then accepts zip, tar, gz and tgz archives with program code:
- only on upload in the backend (form, multiple upload, import), never from the website;
- only while the self test reports the storage folder as protected – otherwise Fileshelf refuses the package with a hint to the self test;
- never with a forbidden part in the name such as
package.php.zip.
For tar.gz and tgz also add gz and tgz to the allowed file
types. Programs such as .exe or .msi stay blocked. Visitors always get a package as a file
to save; the checksum on the page of the download helps them verify it.
Tab “Access”
Here you set a password for this one download (see Password protection). In the Pro version you also bind the download to plans of Membership Pro there.
Tab “Sharing” (Pro version)
One-time and time-limited links (see Links) and the notifications (see Notifications).
Tab “Publishing”
Status, access level, language, start and end of publishing, author and counter. An unpublished or expired download does not exist for visitors – not even through an old link.
On saving, Fileshelf checks the permissions, whichever way the download comes (form, several files, upload from the website): only who may change the state in the category can publish – otherwise a new download stays unpublished. Only one's own access levels can be chosen, and an additional category only where one may create downloads.
The list
For every download the list shows the main category, the file with type and size, version, access level and counter. A download without a file is marked red. Above the list are quick filters with their numbers: All, Published, Unpublished and – if there are any – Without file. The filter options also filter by status, featured, file, category (main or additional) and level, access level, author, language and tag.
- Download in the backend – the file name in the column “File” fetches the file without counting it. The user needs the permission “Download in the backend” for it.
- Batch processing – set access level, language and tags, add or remove additional categories, move to another main category. Copying is not offered, because a file belongs to one download only.
Ordering and overall ordering
Downloads have two orders, both set by dragging them in the list:
- Ordering (sort “Ordering ascending”) counts within the main category. The list then shows the downloads grouped by category; you drag within a category. Where a list on the website shows several categories, they stand in this order, grouped by category.
- Overall ordering (sort “Overall ordering ascending”) counts across all categories. The list then shows all downloads in one sequence, and you drag each one to any place – whatever its category. Choose “Overall ordering” in the YOOtheme element, the source, the module or in the options and the menu item “Category” when downloads of different categories should stand in an order of your own.
New downloads and copies go last in both. After the update to 1.12.0 the overall ordering is the list as it was: by category, then by ordering.