---- dataentry ----
type : integration # do not change this line
system : LightCMS
name : LightCMS Tutorial
description : A tutorial for integrating FoxyCart with LightCMS sites
tags_tags : cms, tutorial
date_dt :
version :
developer_url :
----
====== Ecommerce for Light CMS ======
===== About Light CMS =====
[[http://speaklight.com/|LightCMS]] is a content management system for web designers. Design sites, upload them to our content management system, and deploy world-class websites your clients can manage themselves.
===== Getting Started =====
**Assumptions:**
* We're going to assume that you know at least a little bit about Light. If you don't, please check out their wonderful [[http://support.publishpath.com/|support]] to familiarize yourself with it.
- Setup your FoxyCart account first, as [[getting_started:foxycart_setup|described here]].
- **Setup your Light site**
- Login to your Light CMS backend. Hover over the "My Website" link up top and click on "Designs".
- Hit the "My Designs" tab.
- Hit the "Edit" link, in between "Apply" and "Download"
- Select the template from the list at left that you're going to have FoxyCart functionality on.
- Follow the steps to [[getting_started:site_setup|add the FoxyCart code]] to your '''' section of the template. Make sure to change ''YOURDOMAIN'' to the appropriate subdomain.
- Add the following code beneath the code you pasted in from the step above:
Make sure you change the ''YOURDOMAIN'' to the appropriate store domain. This makes your "add to cart" links appear inside the FoxyBox/Thickbox overlay.
- Repeat steps 4-6 above for all templates that will have FoxyCart functionality, including sitewide "View Cart"/"Checkout" links or a persistent "mini-cart" that displays the cart quantity and sub-total.
- **Create your "Add to Cart" Links**
- Navigate to the page you'd like to create an "Add to Cart" link on.
- Click the "Add Element" button where you'd like the link to go.
- Change the element type to "Files & Links" and click "Add" next to it.
- A link section will now appear. Hover over it and click the "Add Link" link.
- For the "Link name", enter whatever text you'd like. Maybe something like "Add to Cart!"
- For the "Link type", leave it on "URL" and enter a URL like this: ''https://YOURDOMAIN.foxycart.com/cart?name=A Red Baloon&price=9.99''
* Make sure to change ''YOURDOMAIN'' to your store's subdomain.
- **Test.**
===== Caching and Customizing your Checkout Page =====
The basic idea is [[getting_started:templates|covered here]], but there are a few Light CMS specific considerations:
* Set the checkout template page to not show in the menu.
- While logged in, navigate to the page you're using for your checkout template.
- Click the "Page Settings" link up top, then click the "Advanced" tab.
- Check the "Hidden" checkbox under "Advanced Settings".
- You may wish to include the checkout specific CSS files in the "Additional Header" section there, rather than modifying a template for it.
- You might also want to explicitly set your ''favicon'', as [[http://www.foxycart.com/ecommerce-tips-andamp-tricks-favicons.html|described here]].
- Save, then cache your page as normal (in the FoxyCart admin, [[getting_started:templates|described here]]).
If your checkout just hangs when you hit the "checkout" button, you probably have an extra form tag. This happens about 75% of the time, and has to do with the underlying technology that Light uses. Read below for the fix.
You'll need to manually remove the form tag that follows the opening body tag: