StoreSettings

Store Settings

After correctly installing Moxycart, you will need to add a few more things to your site to prepare it for use with Moxycart.

---

MODX

System Settings

Inside the MODX manager in the System --> System Settings area, you can search for the term "moxycart" to find all the Moxycart settings. There are a handful of System Settings that control the behavior of Moxycart, but the most important ones are these:

• moxycart.domain : this must be fully-valid URL indicating your unique foxycart sub-domain, e.g. https://yoursubdomain.foxycart.com/. In rare cases, you can customize this to use your own HTTPS site. In most cases, this will be a subdomain of the foxycart.com domain. Make sure you include the fully qualified URL, including "https://" !
• moxycart.api_key : this must begin with "m42Ccf"
• friendly_urls : your MODX site must be configured to support friendly URLs for Moxycart to function properly.

WARNING: If you are migrating an existing Foxycart store to use Moxycart, you MUST generate a new API key! The key must begin with "m42Ccf". You cannot re-use an older pre-existing API key!

You may need to jump ahead to the Foxycart Settings and ensure that they are in sync with your local Moxycart System Settings

Product Container Settings

It's not required, but it can save time to adjust the settings of your product containers: when you create products, the defaults are pulled from the parent Product Container.

Datafeed Page

You will need to create a dedicated page in your MODX site that will act as the target for postbacks from Foxycart. Sometimes pages like this are called "webhooks". This page should:

• Have a descriptive name, e.g. "Foxycart Datafeed"
• Use no template (i.e. an empty template)
• Hide from Menus
• Be published
• NOT use Rich Text
• Check the "Freeze URI" option. This isn't required, but it will help ensure that your datafeed functionality does not break, even if you move this page or change your URL settings.
• The page content should contain a reference to the parseFoxycartDatafeed Snippet.

The most common invocation of the parseFoxycartDatafeed Snippet looks like this:

[[!parseFoxycartDatafeed? 
    &product_hooks=`updateInventory` 
    &transaction_hooks=`userCreate`
]]

---

Foxycart

Log into your Foxycart Dashboard and update/verify the following settings:

Store Settings

From the Store --> Settings area:

• store url: this is the URL of your MODX site where Moxycart is installed.
• receipt continue url: this is not required, but for a nicer user experience, you should create a "thank you" page on your site and paste its URL here.
• store sub domain: most sites will use the available custom subdomain at foxycart.com. For example, a sub domain slug of "mystore" corresponds to a URL of https://mystore.foxycart.com/. If you opt for the "use custom ssl" option, then you can specify a complete https URL of your choosing. Either way, the ultimate result of this is an https URL which should correspond exactly to the local Moxycart System Setting moxycart.domain.
• store version: Moxycart is currently compatible with the following store versions: 1.1
• store locale: this will determine both the language of your cart and checkout pages and the currency used in your store (e.g. "English" and "$").

Store Advanced

From the Store --> Advanced area:

• would you like to enable your store datafeed? : YES. Check this.
• datafeed url: