====== FoxyCart v1.0 Documentation ======

Welcome to the documentation for FoxyCart v1.0. If you're on **a different version** you can find it from [[:start|the documentation homepage]]. 

<wrap hi>If you're looking to upgrade</wrap> from an earlier version please view the [[:static:upgrading|upgrade notes]], or visit [[.:upgrading#changelog_summary|the changelog]] to see what's changed since the previous version.

<wrap hi>Need help? Don't despair!</wrap>
We're here to help. If you can't find what you need in our documentation please just let us know [[http://forum.foxycart.com|on our forum]] or [[helpdesk+wiki@foxycart.com|by email]]. Our goal is for FoxyCart to make your life easier, so if you have problems that our documentation can't help with just let us know.

<wrap hi>Not sure where to start?</wrap>
Try the "Required Reading" section below if you're new to e-commerce in general, or if you'd like a refresher on the core concepts behind e-commerce.

<wrap hi>**Advanced user**</wrap> just looking for quick info? Try [[.:cheat_sheet|the cheatsheet!]]

===== Who This Documentation Is For =====
Because FoxyCart is radically different than most e-commerce systems (in that it isn't turnkey, nor is it an "all in one" solution), FoxyCart does require at least some web design and development knowledge. As such, this documentation assumes at least a passing familiarity with the lingo associated with building websites. If something is unclear please feel free to ask, but if you're a completely non-technical user hoping to learn HTML, these pages will probably frustrate you.

If, on the other hand, you already know a little HTML/CSS/JavaScript and want to improve by getting advanced with FoxyCart, or if you're already capable, dive right in. Please [[helpdesk@foxycart.com|let us know]] how you like the docs. And please note that <wrap tip>this wiki is publicly editable</wrap>, so if you feel you can improve a section, please do!


===== Getting Started =====

<WRAP column 47%>
//**Required Reading**//
//Things to understand about e-commerce in general.//
  - [[:primer:the_pieces|Gateways, Merchant Accounts, Bank Accounts, Oh My!]]
  - [[:primer:security|Security: What You Really (Really) Need To Know]]
  - [[:primer:errors|Errors: The Different Types, and What To Do About Them]]

//**Introducing FoxyCart**//
//How and why FoxyCart is different.//
  - [[.:foxycarts_reason_for_being|FoxyCart's Raison D'Etre]]
  - [[.:foxycarts_reason_for_being#what_foxycart_is|What FoxyCart Is]]
  - [[.:foxycarts_reason_for_being#what_foxycart_isn_t|What FoxyCart Isn't]]

</WRAP>

<WRAP column 47%>
//**Beginning FoxyCart**//
//Setting up your site and your FoxyCart store.//
  - [[.:getting_started:foxycart_setup|Setup FoxyCart]] in 5 minutes.
  - [[.:getting_started:site_setup|How to setup your site]], including javascript and theme calls.
  - [[.:products|Products]], and creating "add-to-cart" links and forms.
  - [[.:getting_started:testing|Testing]].
  - [[.:getting_started:notes|Important Notes]] to read before going live.
  - [[.:getting_started:admin_users_and_billing_contacts|Paying for your store]] and providing client admin access.
  - [[.:getting_started:store_administration_and_order_management|Store Administration and Order Management]].
</WRAP>


===== Digging Deeper =====

<WRAP column 47%>
//**Intermediate FoxyCart**//
//For those with a solid handle on HTML, CSS, and maybe a little JavaScript.//
  - [[.:templates|Template, Caching, and Customization]]
  - [[.:customers|Customers]]: Notes and Features
  - [[.:products#a_complete_list_of_product_parameters|Products]]: Complete list of parameters
  - [[.:categories|Product Categories]]
  - [[.:session_variables|Non-Product Session Variables]]
  - [[.:cart|The Cart]]
  - [[.:checkout|The Checkout]]
  - [[.:receipt|The Receipt]]
  - [[.:emails|Email Receipts]]
  - [[.:minfraud|minFraud]] fraud prevention
  - [[.:coupons_and_discounts|Coupons and Discounts]]
  - [[.:taxes|Taxes]]
  - [[.:shipping|Shipping]]
  - [[.:i18n|Internationalization & Translations]]
</WRAP>

<WRAP column 47%>
//**Advanced FoxyCart**//
//For those about to <del>rock</del> program, we salute you. (([[http://www.youtube.com/watch?v=shcI6vE-PlE|Video]] and [[wp>For_Those_About_to_Rock_(We_Salute_You)|Wikipedia]])) //
  - [[.:javascript|FoxyCart's Javascript: ''foxycart.js'']]
  - [[.:json|Using FoxyCart's JSON, and JSONP]]
  - [[.:api|The API]]
  - [[.:webhooks|Webhooks]] (aka Datafeeds)
    - [[.:transaction_xml_datafeed|Transaction XML Datafeeds]]
    - [[.:subscription_xml_datafeed|Subscription XML Datafeeds]]
  - [[.:sso|Single Sign-On (SSO)]]
  - [[.:hmac_validation|HMAC Link and Form Validation]]
  - [[.:unified_order_entry|Unified Order Entry]] (aka The Superpassword)

//**Optional Features**//
  - [[.:multiship|Multi-Ship]] (multiple ship-to addresses on one checkout)
  - [[.:custom_domain|Custom Subdomains]]
</WRAP>


===== Reference & Additional Information =====

<WRAP column 47%>

//**Product Types**//
  * [[.:products:subscriptions|Subscription Products]]
  * [[.:products:downloadables|Downloadable Products]]

//**Payment Gateways**//
  * [[:gateways:start|Gateways]]

//**Shipping Carriers**//
  * [[.:shipping:fedex|FedEx Account Setup]]
  * USPS Notes and Caveats
  * UPS Notes and Caveats

//**3rd Party Integrations**//
  * [[:integration|Integrations]]

</WRAP>


<WRAP column 47%>
//**PCI Compliance, Security, & Privacy**//
  * [[:static:foxycart_security|Information about FoxyCart's Security]]
  * [[:static:foxycart_security#foxycarts_pci_compliance|Our PCI Compliance]]
  * [[:primer:security#pci_dsswhat_it_is_and_what_it_means_to_you|About Your PCI Requirements]], separating the FUD from the truth
  * [[:integration:logos|Security Badges]] and "Powered by FoxyCart" Logos
  * [[.:security_and_privacy_considerations|Security and Privacy Considerations]]

//**Reference**//
  * [[cheat_sheet|Cheat Sheet]]: <wrap tip>Reserved values, placeholders, and methods.</wrap>
  * [[:snippets:|Code Snippets]] for advanced customisation and functionality.

//**Glossary**//
  * [[:static:glossary|Glossary]]

//**Upgrading**//
  * [[upgrading|Upgrading from previous versions]]
  * [[:static:known_issues|Known Issues]]

</WRAP>