Treasure Chest eCommerce System

TreasureChest is a shopping cart and product management module developed by Scotty Delicious. It uses PayPal Website Payments Standard for payment processing.

TreasureChest is distributed under a commercial license. A license can be purchased from the TreasureChest website.

Installation

Once you have purchased a license and downloaded the application's zip file, installation is very simple.

  1. Unzip the zip archive; this will give you a folder named "install".
  2. Copy the install folder to your MODx site's root (along with the assets and manager folders).
  3. In your web browser, go to your site (http://www.mysite.com/install). You will be asked for your MODx Manager admin login. Enter your login details, then look over the license and indicate that you agree to it. Click the "Install" button.

The installation process will place a treasure_chest folder in your assets/snippets folder and create the TreasureChest snippet and the TreasureChest module. It will also create three tables in your MODx database. These tables will use the table prefix that the rest of your database tables use (modx_ by default): modx_treasure_chest, modx_treasure_chest_config and modx_treasure_chest_sales.

Create a new document that is published, but set to not show in menu. Give it an alias such as "cart" or "basket". For "Uses Template", select "None". Clear the "Show in Menu" checkbox. Under the Page Settings tab, make sure the Published box is checked. In the content field enter an uncached TreasureChest snippet call with the paramter &service=`cart`:

[!TreasureChest? &service=`cart`!]

Save the document, and make a note of its ID (the number in parentheses following its title in the Document Tree). This will be used to generate the "view cart" page.

Configuration

Log in to your MODx manager to configure TreasureChest. In the top menu, select the Modules tab, then click on the TreasureChest item. You will see two options, the Product Manager and the Sales Manager. Configuration is handled in the Product Manager. Click on the Product Manager icon.

product manager screen

The first screen allows you to set your business email and your business name. It also has a checkbox for using the PayPal sandbox for testing rather than live sales, and a list of currency codes to select from.

Using the PayPal sandbox requires a PayPal merchant's account. More information on setting up and using the sandbox can be found at the PayPal site.

Clicking the Edit Configuration button (above the Save button) will give you more configuration options.

configuration screen

The field that you MUST edit is the first one, Cart ID. Enter the ID of the cart document you created as part of the installation of TreasureChest.

The next several fields configure the HTML classnames or id and the text for various product page items:

  • The HTML classname or id for the container of the "view cart" block.
  • The text for the Add to Cart button.
  • The text for the View Cart link.
  • The text for the Empty Cart link.
  • The text for the Empty Cart warning.
  • The HTML classname for the Add to Cart button.
  • The HTML classname for the Empty Cart link.
The last two fields are for configuring the PayPal PDT feature. More information about this feature can be found on the PayPal website. To use this feature, you'll need to create a document with the content

[!TreasureChest? &service=`pdt`!]

and then enter that document's ID in the last field.