Installation

DigiShop application is distributed as a package and the easiest way to deploy it is to install the package via Joomla Extensions manager. The package consists of a component and two plugins. Do not forget to enable plugins after installation! Go to Joomla Plugins manager and type "digishop" in search field to make it easier to find the related items and enable both content and system plugins.

Prepare Downloads Folder

Files must be previousely uploaded to your server in order to become available as DigiShop downloads. You can create subfolders and add more files at any time but for initial component configuration you should create and configure "downloads" parent folder. Use your favourite FTP client or your site control panel to create this folder, it can be located anywhere in your server space, the folder name is also up to you ("downloads" was used as an example). Make sure that this folder cannot be accessed directly - the easiest solution is to password-protect it (see your site control panel "password-protected directories"). Do not skip this step, otherwise your paid file would be simply available by direct links in browser.

If you can create folders outside your "public_html" web space, for example in its parent folder (where logs, private_html and other folders are located), do it. This is the most secure option because the contents of such a folder will not be visible in a browser.

The screenshot shows an example of such configuration

downloads folder

I used my hosting "Control panel", visually it may differ from your's but the point should be clear. You can also use an FTP client for this task (e.g. CyberDuck for Mac OS or WinSCP for Windows).

Configure the Component

Login to your Joomla administration interface and open DigiShop component. Go to "Options".

The setting that is absolutely required is "Downloads Folder" - enter the path to downloads folder created on previous step, the path should be relative to the root of your Joomla installation. For example if you created download folder in your Joomla root directory and called it "myfiles" the correct path will be "/myfiles". If your download folder is located in "public_html" parent directory do not forget add "level up" part to the path, e.g. "/../myfiles". The screenshot below corresponds to "download folder" location shown in the first screenshot

configuration

Joomla is installed in public_html folder (as usual), so "/../downloads" is actually pointing to a sibling folder of public_html, exactly as shown on screenshot.

When a free download is requested or a paid file is purchased DigiShop creates a unique download key. This key is displayed on download confirmation page and also sent to the user by email (if he purchased the file or was logged in when starting a free download). Normally users will download requested files right away using the link displayed on download confirmation page, but they can re-download files later using download key. "Limit Downloads" and "Download Link Expires" settings define how many times and during what period of time a download key can be used. When a download key expires it is no more valid for a download, users have to request free downloads again or purchase paid files. 

Another important settings is your PayPal account configuration. It is not required for free downloads but if you plan to sell your files you have to configure PayPal account. Both "Sandbox" and "Live" modes are supported and it is recommended to test the application with a "sandbox" account first. After you check that component configuration is OK and you can purchase paid downloads you can change PayPal mode from "Sandbox" to "Live" and provide account credentials for your real live PayPal account.

paypal

This page explains how to create / view your PayPal credentials. For creating / managing test (sandbox) accounts visit this page.

Please note, that if you are testing on "localhost" make sure that SMTP server is running on your machine (you can use SMTP emulators also), otherwise you will not be able to test download confirmation emails. Also be careful with emails while testing purchases - if your SMTP server is running and online, download confirmation emails will be actually sent.

Setup Articles as DigiShop Items

Any Joomla article can be linked to a DigiShop download. When the component is configured ("Downloads Folder" must exist) you will see a new "DigiShop" pane in article edit form in Joomla administration. Select "Yes" in "DigiShop Item" setting and configure price and currency. Put price "0" for free downloads (currency setting doesn't matter for free downloads). Then select a file.

The screenshots below show a real article from this site (one of Smart Countdown 3 animation profiles)

digishop pane

Return to the "Content" pane in the article form and insert DigiShop placeholder (shortcut) {digishop} into your article text. Download or Pay link will replace the shortcut when the article is viewed in Joomla front end.

content pane

This is the contents of the article in editor view. The item has a non-zero price and {digishop} placeholder is replaced by PayPal "Buy Now" button in frontend. You can check it here. Naturally, 'loadposition' shortcuts are also replaced with module samples.

You can take an article out of DigiShop scope at any time, just set "DigiShop Item" to "No" in article edit form "DigiShop" pane. All occurrences of {digishop} shortcut in the article will be removed when viewed in frontend. You can also use more than one digishop shortcuts whithin the same article, all of them will point to the same file and launch the same action. May be useful in large texts, e.g. place one shortcut before "read more" and the other at the end of the article.