Deliverables
------------

Deliverables produced:
 - Updated permissions pointstore products that allow defining an email of instructions sent to the purchaser
 - Removed previous necessary timeout of permission products after defined number of hours passes
 - Support for the permissions pointstore products in the eCommerce system (non-bundled addon)
 - A points/currency conversion factor config option
 - Modified member profiles, to show downloads you have access to
 - Integrated signup into purchase module
 - The explanation below

Explanation
-----------

STEP 0 (initial config):

Set up PayPal as normal in the ocPortal configuration.

STEP 1 (upload):

Upload the attached new/updated code files from download-purchase.tar (compatible with v8).

STEP 2 (upgrade):

The points and pointstore modules are version-bumped, so you'll need to call up the upgrader and run a "Do a database upgrade" step (step 5).

STEP 3 (config):

See step3.png to understand how the points/currency conversion factor config option works. As you can see, an intuitive default has been chosen, so you can leave as is.

STEP 4 (downloads):

Create download categories for each product. I note you may have a "bulk purchase" option -- make a category for this. We'll need to duplicate entries into that category (a fudge, but K.I.S.S.). When you create the categories, make sure to untick all the "View access" check boxes under "Permissions", i.e. no default view access to anyone. Note down the IDs of the categories by looking at the IDs in the 'edit this category' URL after you add each.

(For the purpose of screenshots for your explanation I am making a single download category entitled "Example purchasable", ID#3)

Add your downloads to your download categories.

STEP 5 (products):

(See step5.png for reference)

Go to...
Admin Zone > Setup > Point-store inventory management

On this screen, look under "Add", and then under "Add new permission product", expand the settings.

Fill in the form:
 - The Title is the name of the product
 - The Description is shown in the purchase module after selecting the product (or when you link direct to that step of the wizard in your case)
 - The cost is in pennies/cents due to our points/currency conversion factor option
 - "Permission type" should be "Category-access"
 - "The zone" can be left as "Welcome"
 - "The module codename" should be "downloads"
 - "The category" should be the category ID you added

I choose to set "Confirmation e-mail subject" as "Access to your document has been granted".
and, "Confirmation e-mail body" as
"Collect your download from the downloads area of your account:

{$PAGE_LINK,site:members:view#tab__purchases}"

(Repeat for all your products / download categories)

STEP 6 (enabling purchase):

Manually call up the purchase module (it is not linked into any menus by default)
http://yoursite/index.php?page=purchase

You'll see your product(s) in the list.

Or if you like you can call a filtered view of the same:
http://yoursite/index.php?page=purchase&filter=PERMISSION

You now have a choice, how exactly you will link people through to the purchase module:
1) To the list of (probably filtered) products
2) To the product description of each product separately
3) To the purchase page for each product separately
4) Avoid the purchase module entirely, use PayPal button code directly somewhere else [possibly a bad idea, as it will bypass the integrated OCF signup code]

For 1/2/3 you simply grab the URL(s) from your browser's address bar for the step you want. Link to it from your menus/Comcode as appropriate.

For 4, you can grab the PayPal button HTML from the next step and use it directly. Don't worry, it's safe for this particular payment hook, with one exception... 
<input type="hidden" name="custom" value="2" />
needs to actually be...
<input type="hidden" name="custom" value="{$USER*}" />
So that the purchase is assigned to the active user, and not your own admin account!

STEP 7 (obtaining purchases):

This is more of a note. The purchased downloads could be accessed from the downloads module, but we've also placed a new tab in member profiles. The "Confirmation e-mail body" I used in Step 5 informed the user of this and linked them to it directly.

STEP 8 (customising layout):

You may want to disable the "Reveal usage figures" option to stop the download counts being shown to the customers.

If you want to customise the layout further, edit the DOWNLOAD_BOX.tpl template.

STEP 9 (manual transactions):

If you need to manually grant a member a purchase (e.g. if they paid by cheque), go to:
Admin Zone > Setup > eCommerce > Manual transaction

Choose your product.

Put in the member's member ID as the Identifier.

Click Manual Transaction.

The member will be e-mailed to tell of their purchase, and granted access, exactly as if they had gone it themselves through the purchase module.