Purpose

This document is a User Guide for Attachments Anywhere module for Magento. It describes how work with the extension.

With Attachments Anywhere you can easily add downloadable files to your product pages, CMS pages as well as customers’ dashboards.

System Requirements

The extension works under Magento from 1.4.x and higher.

The extension works with Apache 1.3.x and higher, PHP 5, Linux or IIS.

The extension’s correct work is guaranteed with the following browsers:

• IE7, IE8, IE9
• FireFox 4.x, 5.x
• Google Chrome 15.x
• Safari 5.x

The correct work with other Magento versions, other browsers and Apache/PHP versions is not guaranteed.

Installation

All our Magento extensions and templates are installed via IToris Installer.

Download IToris Installer and un-pack to the root of your website. It will then appear in menu System –>IToris extensions –> IToris Installer.

Open it and you will see all our Magento Extensions and Templates, both installed and available. You can install, update and un-install them with one click now.

Find Attachments Anywhere in the list of extensions and press Install button. It will ask for the license key that you will receive after the purchase. Enter the key and submit. The extension will be installed. It will be available in menu System –>IToris extensions –> Attachments Anywhere

License

Magento modules developed by IToris are provided with 2 license types - regular and premium.

Regulal license is partially encrypted. This license is website-dependent. By ‘website’ here we understand the website in Magento terms. Under one Magento installation one license key of the extension can activate all stores/storeviews. within one website. If your configuration has several Magento websites - a separate license will be required for each.

One license also supports a number of sub-domains for development/testing purposes in addition to the live website. Please see the full list of available sub-domains and additional information about the license in our Terms and Conditions

Premium license activates one Magento installation. All websites, stores and storeviews under one installation are covered with one license. Premium license is 100% open-source and is recommended for customizations.

You can switch the license from one domain to another – login to IToris website using the credentials you will receive after the purchase. Go to My Downloads area, find your key there and reset it from the current website. Then use it again to activate another website.

The license also includes free life-time updates for the extension.

General Settings

To set the module select System –>IToris extensions –> Attachments Anywhere

On this page you can select the main configuration of the module:

• Extension Enabled - this setting activates the module for the front-end
• Categories are expandable - select yes if you plan to create categories for downloadable files and want them to expand/collapse
• Show file icons - select small or large icons to be displayed for downloadable files
• Enable Downloads in accounts - activate this checkbox if you want to add downloadable files to customers’ dashboards

There is ability to select its own set of settings for stores/storeviews (use Current Configuration Scope drop-down).

Secured Download

Some files can be very sensitive against unauthorized downloading. That is why secured download functionality is implemented in the module, providing only authorized downloading.

Depending on your settings and the place where you upload files they can be downloaded only by the customers that have permissions to do that.

There is no ability to share the URL or view/download the files uploaded for another customer group, single customer, and so on.

Declare Functionality in Template

To make Attachments work please declare the module in your template:

1. Open file app/design/frontend/base/default/layout/catalog.xml and find there <catalog_product_view translate="label"> area.
2. Add the following code inside <block type="catalog/product_view" name="product.info" template="catalog/product/view.phtml">
   
   <block type="itoris_attachments/attachments" name="itoris_attachments" as="itoris_attachments" />
3. Open file app/design/frontend/base/default/template/catalog/product/view.phtml and find <div class="product-collateral">.
4. Add before Details, directly after <div class="product-collateral"> the following code:
   <?php echo $this->getChildHtml('itoris_attachments') ?>

Downloadable Files for Product Pages

To create downloadable area on product pages please open a product. There will be a new tab there Attachments.

Select the tab to add downloadable files to the product.

Upload Files for Products

There will be a special area for creating downloads. Start with uploading files.

Press Browse Files button and find you file(s) that you keep locally. You can select several files together for uploading. Add them. You will see then in the list on the page.

Press Upload Files button to upload the files.

If you upload the same file for several products - there is no need to re-upload it anew each time. Select it in Load Existing Document area.

Create Categories

All uploaded files will be displayed in the main (root category).

If you leave them as they go now - they will be displayed all together.

If you want to create categories and separate files in them - enter the first category name in Create New Category field and press Create button.

Create all categories you need the same way.

Now categories will be displayed under the list of files.

To organize files in the categories simply drag files to a category and drop there.

Green arrows on the right allow switching the order of the categories. The order they are displayed on the front-end will be the same as here in admin area.

You can remove a category by clicking Remove link near its name.

New categories can be created later on and added to the list.

Set Special Permissions for Files’ Visibility

There is ability to make each file available under special conditions only. To set this please click a file. There will appear a settings’ area:

• Title - you can change the file’s title
• Published - only when this checkbox is checked the file will be available on the front-end
• Show only if product purchased - there are 3 options available in this setting:
  • Always - the file will be shown to all customers
  • If purchased - the file will be displayed only to the customers who have purchased this product
  • If not purchased - the file will be displayed for the customers who have not purchased this product only
• Store views - if you want the file to be visible on selected stores/storeviews only, please select them here
• Groups - you can make the file available for selected customer groups only

Attachments for CMS Pages

In addition to products, you can create attachments for CMS pages as well. Attachments block is added to the pages as a widget.

Please open the page and select Content from the left tabs. Insert widget in a usual Magento way:

In the opened modal window select IToris CMS Attachments. There will appear an area for managing files and categories.

Upload files for CMS Pages

To upload files for CMS pages press Browse Files button and select the files. Several Files can be selected together.

Once selected, they will appear in the list on the page. Press Upload Files button to upload them.

If you have upload the files before, there is no need to re-upload then. Instead, press Load Existing Document drop down and select the file from the list.

Create Categories

Once files have been uploaded, they all are displayed in the root category. If you want to separate them into categories - please create the categories.

Enter the first category name in Create New Category field and press Create button. Create all categories you need the same way.

To organize files in the categories simply drag the file to the category and drop there.

Set Special Visibility Permissions

There is ability to make files available under special conditions only. To set a file’s visibility permissions click a file. A new area with the settings will be displayed.

• Title - you can change the file’s title
• Published - only when this checkbox is checked the file will be available on the front-end
• Store views - if you want the file to be visible on selected stores/storeviews only, please select them here
• Groups - you can make the file available for selected customer groups only

Attachments in Customers’ Dashboards

There is ability to create a set of downloadable files for each customer group. There will appear a new area (Attachments) in Dashboard, where the files will be available for downloading.

Each group will have its own set of files; other groups’ files will not be available.

Add Downloadable Files for Customer Groups

To add files to customer groups please select System –>IToris extensions –> Attachments Anywhere
On the left there will be tabs to create downloadable files for each customer group you have:

Select the group and add files for downloading there.

The functionality of adding files and creating categories is the same as for products or CMS pages.

If you click a file’s name - there will be additional settings for it:

File is visible on the front-end only when Published checkbox is checked.

You can change the file’s title by re-typing it and saving the changes.

Add Files for a Customer Individually

You can upload files for customers individually. For example, you can upload a contract for signing. To do it open the customer’s dashboard for editing in admin area and select Downloads tab from the left. By default the customer will have downloadable files created for his/her group (if available). They will be hidden.

To create a personal set of files uncheck Use Global checkbox. You will see the list of files for the customer group available for editing for this customer.

Upload the files you need the same way as for products, create and manage categories.

To hide default file(s) click the file’s title. There will appear additional settings. You can unpublish the file there (it will not be visible from the front-end then) or remove it by clicking Remove link.