=== WP e-Commerce ===
Contributors: mufasa, jghazally, valentinas, mychelle, garyc40
Donate link:
Tags: e-commerce, wp-e-commerce, shop, cart, paypal, authorize, stock control, ecommerce, shipping, tax
Requires at least: 3.0
Tested up to: 3.3.1
Stable tag:

WP e-Commerce is a free WordPress Shopping Cart Plugin that lets customers buy your products, services and digital downloads online.

== Description ==

We make setting up an ecommerce shop easy, and with over 1.5 Million downloads, we have unparalleled experience.


= WordPress Integration =
* Easy to install WordPress plugin
* Works with any standards compliant WordPress theme
* Plays well with other Plugins
* Supports regular WordPress widgets, as well as a few snazzy ones of our own
* Utilizes shortcodes and template tags (just like WordPress)
* Works out-of-the-box with WordPress MU (make sure you use sub domains with your MU setup)

= 100% Customizable =
* A designers dream – use your own HTML & CSS and have complete control over the look and feel of your store
* Easy to modify templates

= Amazing Support =
* Lots of video tutorials
* Guaranteed speedy response (through our premium forums)
* Access to instant support from our community of users

= Payment Gateways Integration =
* Manual Payment (checks/money orders) (included)
* PayPal Payments Standard (included)
* PayPal Payments Pro (included)
* PayPal Express Checkout (included)
* Google Checkout (Level 2) (included)
* Chronopay (included)
* PayPal Payflow Pro (available with Gold Cart)
* (available with Gold Cart)
* FirstData/LinkPoint (available with Gold Cart)
* eWay Payment (available with Gold Cart)
* iDEAL (available with Gold Cart)
* BluePay (available with Gold Cart)
* DPS (available with Gold Cart)
* Paystation (available with Gold Cart)
* SagePay (available with Gold Cart)
* If you still aren’t happy, we provide you with the necessary info to write your payment gateway

= Marketing =
* Flexible coupon/discount pricing rules
* Product specific sales
* Quantity discounts
* Free shipping options
* Multi-tier pricing for quantity discounts.
* Search Engine Friendly URLs
* New Products widget
* Cross-sells on product pages (in 3.8 this is now available as a Plugin)
* Google Site Map
* Uses the popular “Share This” button for easily promoting your products on popular social networking sites
* Integrates with Facebook Marketplace (Facebook Marketplace API has closed – we’re working on it)
* Integrates with Google Base
* Integrates with Campaign Monitor for advanced email marketing
* Integrates with Intense Debate for shared comments
* Mail Chimp integration coming soon

= Search Engine Optimization =
* 100% Search Engine Friendly
* Meta-information for products and categories
* RSS feeds for products and categories
* Integrates with Google (XML site maps and Google Merchant Centre)
* Integrates with the All in One SEO plugin for WordPress (which includes Google Analytics)

= Internationalization Support =
* Multi-lingual (the first Plugin to fully utilize and integrate with GlotPress)
* Support for multiple currencies
* Ability to target specific countries

= Shipping =
* Integrates with UPS, USPS, Australia Post and Shipwire for real-time shipping rates
* Flexible built-in shipping rate calculators
* Domestic and global shipping rates
* Flat rate shipping
* Table rate shipping
* Weight rate shipping

= Checkout =
* One-Page Checkout or Stepped Checkout, whichever you prefer
* SSL security support for orders on both front-end and back-end
* Checkout without account/Guest Checkout
* Shopping Cart with tax and shipping estimates
* Option to create account at beginning of checkout
* Fully customizable checkout page

= Managing Orders =
* Admin dashboard for sales overview
* Export orders and customers into CSV formats
* Order history with labels for order processing status
* Email notifications of orders
* Print invoices and packing slips

= Catalog Management =
* Single-page product data entry
* Ability to duplicate products
* Quickly edit your products from the store front (saving you heaps of time)
* Smart Groups allow you to organize your products with hierarchical categories, as well as by brand.
* Batch import/export of catalog
* Google Base integration
* Product variation management
* Create attributes on the fly
* Downloadable/Digital Products
* Support for donations
* Customer Personalized Products
* Media Manager with automatic image resizing
* Handles multiple product images with easy drag-and-drop sorting
* support for Special Prices
* Tax rates per location
* Basic inventory control

= Catalog Browsing =
* Live product search – mmm just like (available add on)
* Cross-sells
* Product listing in list format
* Product listing in grid format (available with Gold Cart)
* Breadcrumbs
* Product Image Zoom-in Capability
* Stock Availability
* Multiple Images Per Product (activated with Gold Cart)
* Product comments
* Filter by Product Tags
* New Products widget
* Features Products widget
* Live updating shopping cart (put it wherever you want)

= Additional Modules =
* Gold Cart & Grid Module – adds more options and functionality to your store
* Drop Shop – an incredibly snazzy way for buyers to add products to their cart, via a simple drag n drop process.
* Mp3 Audio Player – Preview audio clips on your website
* NextGen Gallery Buy Now Buttons – turns your NextGen gallery into an ecommerce solution
* Product Slider – Display your products in a new and fancy way
* Members Only Module – Create pay to view subscription sites

For more information visit []( "")

== Installation ==

1. Upload the folder 'wp-e-commerce' to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress

= Updating =

Before updating please make a backup of your existing files and database. Just in case.
After upgrading from earlier versions look for link "Update Store". This will update your database structure to work with new version.

== Changelog ==
= =
* Fix: Session ID is overridden.

= =
* Fix: PHP Warning for 'wpsc_load_settings_page' callback.
* Fix: PHP Warning in wpsc-transaction_results_functions.php.
* Fix: get_current_screen() is not available in WP 3.0.

= =
* New: Default hook to filter sessionid for previously selected payment gateways.
* Change: Stock notification emails are now sent to "purchase log email address" rather than admin address.
* Fix: SQL injection vulnerability.
* Fix: 3.7 -> 3.8 Database Upgrade Routine fails when importing variations sets with the same name.
* Fix: Category link structure is not correct in pagination links with hierarchical category permalink.
* Fix: Fix SQL error when using "?items_per_page=all" query.
* Fix: Missing "Use as product thumbnail" on WordPress 3.3.
* Fix: Products Page does not support custom page template - uses page.php instead.
* Fix: Products page, category items per page is broken, relies on 'posts per page' setting in Settings -> reading.
* Fix: Sticky post view broken due to deprecated query_string filter.
* Fix: Sub-pages of Products Page aren't supported.
* Fix: Total Quantity check for coupons.
* Fix: Use ->add_help_tab() to support WP 3.3 admin screen API.
* Fix: [wpsc_products] shortcode does not use 'Sort Product By' setting - it defaults to date-based ordering.
* Fix: dashboard.css is loaded for WordPress > 3.3 (404 error).

= =
* Fix XSS vulnerability.

= =
* Fix: "Session expired" error when viewing Customer Account page.

= =
* Security fixes.

= =
* New: Support for g:availability to Google Merchant Centre feed. Props bbaskets & longercat
* Fix: Admin product page sorting by column was not working.
* Fix: Call to undefined function wpsc_clear_stock_claims().
* Fix: Checkbox and Radio buttons have unexpected issues in checkout.
* Fix: Checkout field options' values are mutilated before getting inserted into the database.
* Fix: PayPal standard IPN fails if data used to validate the IPN POST contains ' or ".
* Fix: Price incorrectly updated when multiple products with variations exist on the same page.
* Fix: Security vulnerability.
* Fix: ShareThis integration does not properl respect HTTPS connections.
* Fix: The Terms and conditions checkbox on the checkout page should have a required field asterisk, just like all other required checkout fields do.
* Fix: Wrong login URL for [userlog] page.
* Fix: Zero shipping price doesn't work in flatrate.php.
* Fix: invalid HTML on checkout page for default theme.
* Fix: wpsc_coupons::uses_coupons() needs optimization.

= =
* Fix: Fancy notifications not being displayed on single product page.
* Fix: Sale and normal prices are switched around.

= 3.8.7 =
* New: 'insert_child_product_meta' filter to allow customising of meta data when a variation product (child product) is created.
* New: 'wpsc_variation_groups' and 'wpsc_all_associated_variations' filters. Allows customising order of variation menu items etc.
* New: Add hook "wpsc_product_form_fields_end" and rename "wpsc_product_form_fields" to "wpsc_product_form_fields_begin" to offer more flexibility when adding new fields to the product form.
* New: Add hooks "wpsc_add_to_cart_button_form_begin" and "wpsc_add_to_cart_button_form_end" when outputting [add_to_cart] shortcode. wpsc_add_to_cart_button() is also refactored to get rid of ugly repetitive "$output .= ".
* New: Additional hooks for adding extra FORM fields to the add to cart form.
* New: Additional filter hooks for product price and transaction result messages.
* New: Allow hierarchical product category URL.
* New: Hooks 'wpsc_product_form_fields_begin' and 'wpsc_product_form_fields_end' for list and grid views.
* New: Option to set claimed stock clearance interval (Store Settings -> General).
* New: filterable g:shipping_weight to google product feed. Thanks to Rudy Hassall.
* Change: Proper post updated messages - now says "Product updated" instead or "Post updated".
* Change: Settings tabs are restyled to conform with WordPress UI. Props Pippin.
* Fix: A product is displayed as "sold out" when its variations' stock control options are turned off.
* Fix: Additional Checkout Form Fields Not Showing with Variation. Props jRayx.
* Fix: Australia Post shipping quote caching by reducing the transient key length from 51 to 41 characters.
* Fix: AJAX error when changing country with a coupon applied.
* Fix: Breadcrumbs not showing for empty product categories.
* Fix: Discounts / coupons not passing to Paypal Standard.
* Fix: Error with merging image metadata in Media popup. Props Ben Huson.
* Fix: Fancy notifications are sometimes output twice.
* Fix: Fatal memory allocation error in Add Product page when WPEC downloadable folder is not created yet.
* Fix: Incompatibility with WP 3.3-dev (dashboard.css is merged into wp-admin.css).
* Fix: JavaScript globals not properly escaped, causing fatal JS errors due to internationalized strings that have single quotes in them.
* Fix: Paypal Express Checkout fails if product names contain unicode special characters.
* Fix: Paypal Standard passes wrong discount amount.
* Fix: PHP Notice when activating wpec, resulting in 'unexpected output' error message.
* Fix: PHP Notice when editing product category.
* Fix: PHP notice in wpsc-functions.php.
* Fix: Product categories sometimes disappear in admin (but still show on front end).
* Fix: Product variations not deleted when deleting a product from the trash.
* Fix: Products with variations display 'from' even if all prices are the same. Change: Product that have variations will display "from" price regardless of whether the variations are in stock or not (to avoid inconsistency).
* Fix: Removing additional description of a product doesn't have any effect. Props groques.
* Fix: SQL error when updating from 3.7.
* Fix: Saving thumbnail settings caused PHP timeout.
* Fix: Single product image is not re-generated properly sometimes.
* Fix: User submitted data is double-escaped, causing slashes to be stored in database table and sent to payment gateways.
* Fix: Variations are not cloned properly when duplicating a product, causing error / hang in wp-admin.
* Fix: WP Menus items don't apply current-menu-item (and ancestor) for product categories.
* Fix: When on the edit products page, the filter by category menu does not show subcategories if the parent has no products. Props benjaminhuson.
* Fix: for paypal express, coupons being included when there are none
* Fix: is_home() is true when viewing default category on products page.
* Fix: login redirect on checkout page if WordPress files are in a subfolder.
* Fix: $wpsc_cart->use_shipping() returns true even when shipping is disabled.
* Fix: wpsc_display_purchlog_totalprice() returns wrong value. Props dlingren for initial patch.
* Fix: wpsc_is_single_product() returns false even when viewing a single product. Props Ben Huson for initial patch.
* Fix: wpsc_the_product_thumbnail() sometimes returns relative URL instead of absolute URL, which causes image failure in Google Product Feed.

= =
* Fix: Security vulnerability in chronopay.

= 3.8.6 =
* New: Filter for 'wpsc_display_product_multicurrency'.
* New: Additional filters for compatibility with WPML.
* Change: Discount information is now displayed on the Packing Slip.
* Fix: Sometimes wpsc_product_has_multicurrency() returns true when it should return false.
* Fix: Edit product page makes many database queries if you have lots of variations.
* Fix: Variation prices are not calculated correctly.
* Fix: Request-URI Too Large error when searching on the Admin Products page with lots of products.
* Fix: Add to cart shortcode doesn't display fancy notifications, and also doesn't check whether variations are selected.
* Fix: Infinite AJAX loop on checkout page when Same as Billing is checked.
* Fix: Per-item shipping total is calculated incorrectly in various places (Packing Slip, Sales Report etc.).
* Fix: Wrong product link when the product is assigned multiple categories.
* Fix: Canonical tags are not generated correctly for products with multiple categories.
* Fix: Edit variations inline messes up columns when stock limitation is disabled.
* Fix: Product with no category selected is not automatically assigned a default category when sort by drag&drop is enabled.
* Fix: Unnecessary use of livequery in variations.js causes Product edit page to freeze when there are many variation sets.
* Fix: Slashes added to checkout form field that has single quotes in it (e.g: O\'Connor).
* Fix: Multicurrency price is truncated when displayed.
* Fix: Checkout page keeps refreshing without displaying Google Checkout Button.
* Fix: Discount doesn't work with Paypal Standard.
* Fix: wpsc_single_template is not removed from the_content after it's run, causing subsequent the_content() calls to output the single product again.
* Fix: Sorting product categories is broken.
* Fix: Coupon rule "In Category" not taken into consideration.
* Fix: WPEC default stylesheet imposes #content font-size.
* Fix: Incompatibility with Prototype JS library.
* Fix: Checking (or unchecking) Stock checkbox when editing product causes variation table columns to break.
* Fix: jQuery 1.6 incompatibility with attr( 'className' ).

= 3.8.5 =
* New: Added hooks to support WPML.
* New: Links to WP e-Commerce documentation for individual payment gateways.
* Change: User can specify 0 in thumbnail width or height to make it scale proportional.
* Change: Show display name, not internal name for shipping method on purchase log view.
* Change: Presentation settings page is restored to WPEC Settings page when WooTheme is activated.
* Fix: Add to cart using Donation widget causes the page to reload and the item is added twice.
* Fix: Free-shipping discount causes tax to be calculated incorrectly.
* Fix: Paypal Buy Now button passes the wrong price to Paypal if product is on sale.
* Fix: Thumbnail sizes are not generated correctly.
* Fix: Broken output buffering rendering wpsc_add_advanced_options hook useless.
* Fix: Paypal Pro doesn't properly account for discount and coupon.
* Fix: IPN doesn't work on Paypal Standard.
* Fix: IPN doesn't work on Paypal Pro gateway.
* Fix: Paypal Express doesn't handle discounts.
* Fix: Paypal Express doesn't handle IPN.
* Fix: Paypal Express doesn't send purchase receipt after a payment is accepted on Paypal.
* Fix: Paypal Express doesn't include item description, quantity, tax etc. in email receipts.
* Fix: Invalid country code in Paypal Pro and Express, should be GB instead of UK
* Fix: Take Discount into account when DoExpressCheckout in Paypal Express gateway.
* Fix: Category checkout form sets don't work.
* Fix: Incorrect Product display mode selected when ['view_type'] is set and 'show_advanced_search' is disabled.
* Fix: PHP notice in wpsc-transaction_results_functions.php.
* Fix: attr('checked') == true always evaluates to false. Use is(':checked') instead.
* Fix: jQuery 1.6 select by attribute incompatibility.
* Fix: Price tag is added to RSS even when there is no price.
* Fix: Span tag is not closed in issue 598.
* Fix: Faulty php tag in template (issue 589).
* Fix: PHP Notices when checking out with shipping disabled.

= 3.8.4 =
* Add: User can duplicate a product in admin panel
* Add: WooThemes integration support
* Change: Total in Cart widget now excludes shipping and tax
* Fix: Invalid country code in paypal-standard.merchant.php
* Fix: Tax is not passed properly to Paypal Pro
* Fix: Currency code preference not correctly selected in Paypal gateways
* Fix: Paypal gateways doesn't check whether the currency being sent to Paypal is accepted or not, resulting in wrong currency
* Fix: Checkout form selecting the wrong field when a previous field with the same uniquename was deleted
* Fix: Various issues with Google Checkout
* Fix: State data outside of US is not passed to payment gateways
* Fix: State is not displaying correctly in the users purchase history
* Fix: Wrong generated product permalink when a product is assigned multiple cats, and a product category is being viewed
* Fix: Submitting a checkout form with mandatory billing state only refreshes the form although everything is filled out correctly
* Fix: Billing Country is trimmed, and Billing State is not properly decoded
* Fix: Billing and shipping state no longer stored correctly
* Fix: Checkout form validation skips mandatory custom checkout fields on default form set
* Fix: Paystation does not properly update purchase logs
* Fix: When there's no product, and Sort Product By is set to 'dragndrop', viewing the admin product list would produce a Division by zero warning
* Fix: Store sub-pages return 404 error
* Fix: Only Purchase History in Your Account show the login option
* Fix: Weight on Variations contain too many decimals
* Fix: Add to Cart in grid view bypasses Variations selection
* Fix: get_queried_object() requires WP 3.1
* Fix: Invalid version number in
* Fix: Correct HTML, to stop Free Shipping Discount getting blanked
* Fix: Support taxonomy archives for product_tag taxonomy

= 3.8.3 =
* New: Individual item details are sent to Paypal Express Checkout
* Change: Automatically reload database update page when PHP maximum execution time is detected
* Change: Add progress bar and estimated time remaining for database update tasks
* Change: Themes can now use taxonomy-wpsc_product_category-{$term}.php and taxonomy-wpsc_product_category.php templates, which take precedence over page.php when viewing a product category
* Change: Paypal Express Checkout API is updated to ver 71.0
* Fix: Tax is calculated incorrectly when a coupon is used
* Fix: Update a large database of products and variations take ages
* Fix: Reloading database update page makes wpec scan the records from the beginning instead of continuing where it left off
* Fix: Reactivating the plugin causes Fatal Error (PHP Timeout) if there are a lot of attached images (not just post products, but all image attachments)
* Fix: Purchase logs' statuses are not properly updated when upgrading from 3.7.x
* Fix: Billing state is not sent to checkout
* Fix: Country name is truncated when sending to payment gateway
* Fix: Billing state code is not properly converted before sending to payment gateway
* Fix: Wrong USA country code is sent to Paypal Standard Payment
* Fix: Wrong sandbox gateway URL for Paypal Pro
* Fix: SSLVERIFY error when connecting to Paypal Pro Gateway
* Fix: Template hierarchy error with child themes
* Fix: Total amount is not visible when checking out with Paypal Express Checkout
* Fix: Transaction result page is inaccurate after checking out with Paypal Express Checkout
* Fix: Incompatibility with Thesis theme's loop when viewing product category, or paginated product listing

= 3.8.2 =
* Add: Currency display for Google RSS feed
* Add: Third-party plugins can now filter 'wpsc-tax_rate' to provide their own tax solution
* Change: Merchant subclasses now have access to $this->address_keys
* Change: Grid Settings are now always visible
* Change: Total Shipping is no longer included in notification email when shipping is disabled
* Change: Thumbnail size for single product view now defaults to Single Product Page thumbnail size option
* Change: wpsc_the_product_thumbnail() defaults to 'medium-single-product' size when in single product view
* Fix: Update notice being displayed when it has already been completed
* Fix: Broken image in latest products widget
* Fix: Custom checkout field not always saved
* Fix: Downloadable file list not updated after existing files are selected
* Fix: Already attached downloadable files are duplicated each time you select an existing downloadable file
* Fix: Inconsistent behavior when adding a new field to a checkout form set
* Fix: Custom product slug not editable
* Fix: Incompatibility issues with shipping helper and modules
* Fix: Product meta are not included in Google product feed
* Fix: Incorrect variation "from" price
* Fix: Shortcode not working in single product description
* Fix: Item cost not correctly calculated in paypal-standard-merchant
* Fix: Invalid SSL URL for some images
* Fix: Select from wrong table in WPSC_Merchant::get_authcode()
* Fix: Wrong use of get_query_var() in wpsc_category_id()
* Fix: Table `wordpress.wp_wpsc_product_list` doesn't exist
* Fix: ?items_per_page=all is ignored
* Fix: Duplicate transaction result emails
* Fix: Wrong filter in wpsc_item_add_preview_file()
* Fix: Wrong display type when using advanced search view mode and viewing a category
* Fix: Category list is displayed in tag archive
* Fix: wpsc_display_products_page() outputs "Fail" when the product shortcode is used 10 times (no kidding)
* Fix: Single product view's thumbnail size is incorrect
* Fix: Wrong featured thumbnail is displayed in Single Product View when there are multiple attached product images
* Fix: Incorrect condition statements in WPSC_Coupons::compare_logic()
* Fix: Can't add new field to checkout form set in IE
* Fix: Missing trash icon when adding custom options to dropdowns in checkout form
* Fix: Custom select, checkbox and radio fields are displayed as textbox on [userlog] page
* Fix: Custom checkboxes, radios and select fields are not properly populated in Checkout form
* Fix: Attachment metadata are not properly generated when converting product thumbnails from 3.7.x to 3.8

= 3.8.1 =
* Fix: Special price mix-up when ugprade to 3.8
* Fix: Missing database update notice
* Fix: Breadcrumb markup and style fixes
* Fix: Deprecate WPSC_Query()
* Fix: Deprecate wpsc_total_product_count()
* Fix: Deprecate wpsc_print_product_list()
* Change: Warning message for PHP 4 users. GoldCart requires PHP 5 or above.
* Change: Don't display categories when there's a search

= 3.8 =
* Utilize custom post types for products
* Utilize custom taxonomy for categories and variations
* Database optimization
* Redesigned taxes and shipping systems
* New user interface
* Integrates with WordPress Media Manager
* Better template integration for designers
* Optimized for ticketing (Tikipress)

== Frequently Asked Questions ==

= How do I customize WP e-Commerce =

First of all you should check out the Presentation settings which are in the Settings->Store page.

Advanced users can edit the CSS (and do just about anything). Not so advanced users can hire WP consultants developers and designers from []( "").

== Screenshots ==

1. Products list in WordPress backend
2. Edit Product screen
3. Single product page
4. Checkout page

== Upgrade Notice ==

= 3.8.1 =
This version addresses several urgent issues when upgrading from 3.7.x to 3.8.