TreasureChest

Unzip & Upload

Unzip the treasureches.zip archive. This should extract to a folder called "install". Upload this "install" folder to the root of your MODx installation (where the file "index.php" and the folders "assets" and "manager" are).

Run the installer

Open your web browser and navigate to your MODx website url /install/ (e.g. http://www.yoursite.url/install/) and enter your MODx Manager credentials to authenticate and authorize the installation. Agree to the license then click the "Install" button. After installation is complete, log into the MODx Manager.

Create a "Cart" Document

Create a new Document at the root of your site. Give it an alias of something memorable such as "cart" or "basket". Set "Uses template" to "(blank)" and uncheck "Show in menu". Under the "Page Settings" tab, uncheck "Searchable" Take note of this document's ID. It is needed for the TreasureCart configuration.

In the "Document content" textarea, enter an uncached TreasureChest call with the "service" parameter set to "cart" exactly as below: [!TreasureChest? &service=`cart`!]

Configure TreasureChest

In the MODx Manager, select the Modules tab, then click Treasure Chest. Select "Product Manager". Enter your PayPal email address, give your business a name, select your currency code, and click "Save".

Next, click the "Edit Configuration" button. For "Cart ID", enter the document ID number of the document you created in the previous step. Adjust the other settings as needed. If you set up payment data transfer (PDT) on your PayPal account you should create a normal web page document, using the template of your choice with a this call in the Document content:[!TreasureChest? &service=`pdt`!]Please see the placeholders page for more information on content placeholders you can use on your PDT page. Put the ID of that document in the PDT Document ID field, and your PayPal PDT token in the PDT token field.

PayPal IPN and PDT

IPN or Instant Payment Notification is used to update your product inventory and track your sales. IPN is automatically taken care of by TreasureChest using your "Cart" document and some parameters sent to PayPal at checkout time. If you are the paranoid type, you can also set the IPN url in your PayPal profile page at http://www.paypal.com. You should enable IPN on your account and set the IPN URL to http://www.yoursite.com/cart.html?action=ipnOr if you do not use friendly URLs, and your cart ID is 99:http://www.yoursite.com/index.php?id=99&action=ipn

Before you learned how to set up a page to accept a PDT redirect from PayPal after your customers checkout. In order for PDT to work, you have to activate it in your profile and put the PDT token that paypal gives you into your TreasureChest Configuration. It should be sufficient to enable PDT on your profile (Website Payments Preferences) and let TreasureChest send the URL of your PDT document as a parameter to PayPal when your customers check out. They will be automatically be redirected to this page after completing their payment.

Add and Edit Items

To add a new item to your TreasureChest, click the "Add" button at the bottom of the product list. Fill out as many of the form fields as you need, but note that the "Item Name" and "Price" fields are REQUIRED. To Edit an item, click it's name or click the "Edit" button to the right of the product information. Take note of the first column in the products list table called "ID". This is the unique product identifier that you will use to create a product page for this item.

Create a product page

Create a new MODx document. At the top of the Document content textarea, put[[TreasureChest? &item=`1`]]Where `1` is the "ID" of the item that you were supposed to take note of in the last step!