WP e-Commerce Plugin (WordPress Plugin) Help, Answers and Customization

FAQs / Tips / Common Issues

When trying to check out, the visitor gets a message saying “Sorry, online ordering is unavailable to this destination and/or weight. Please double check your destination details.”

Usually it means you neglected a few settings when you were building your store. Before you email us in a panic, check the following things…

Store > Settings > General
1. Did you set up your Base Country/Region?
2. Did you select at least your own country as a target market? If a customer resides in a country you didn’t select as a target market (even if it’s your own), then the store won’t ship to them.
Store > Settings > Shipping
1. Did you enable the “Use Shipping” option?
2. Did you fill in your base zip code?
3. Did you select at least one shipping calculator?
4. Did you actually fill in the settings for your shipping calculator? Hint…you gotta click the little edit button that shows up when you hover over a shipping option.
5. If you are using UPS or USPS, did you sign up for the stuff you were supposed to sign up for? The cart can’t calculate shipping without the proper credentials.
Store > Categories
1. Do your product categories have at least one target market selected. If you set up your target markets on the General page, they should automatically copy over to the categories, but you should double check just in case.
Store > Products

If you are using Weight Rate, UPS, or USPS, did you remember to set a weight for your product?
If you did set a weight for your product, and your product has variations, did you also set a weight for EACH of the variations? If any variation doesn’t have a weight, the shipping calculator won’t work. To set a weight for a variation, click on the little “more” button next to it.

I never got my API Key for the Gold Cart Plugin. Where can I get it?

Check out Instinct’s API tool for retrieving your API Key. You will need the email address and first name used in the checkout process when you bought the plugin. #

How do I Install the Gold Files (Premium Upgrade)

For WP e-Commerce 3.6

Unpack the files and copy the contents of the Gold zip file into the “wp-e-commerce” directory in your plugins folder. If you have copied this over properly there will now be a new tab in the E-Commerce admin options called Gold Options, once you have browsed to this page and you have entered in your API key all of the additional gold features will unlock.

For WP e-Commerce 3.7

Unpack the files and copy the contents of the Gold zip file into the “wp-content/uploads/wpsc/upgrades” folder. If you have copied this over properly there will now be a new tab in the E-Commerce admin options called Gold Options, once you have browsed to this page and you have entered in your API key all of the additional gold features will unlock.

If it does not appear straight away you might need to deactivate and then reactivate the e-commerce plugin. The following image should give you a feel for where to put files when installing the WP e-Commerce plugin and any respective Gold Module. #

Gold Cart API activation does not work

If your gold API key is not working there are a number of things to check before requesting support. Here are some of the common things to look out for.

Your API key may be associated with another website? If so then you need to de-activate the API key from your test site so that it is free to use on your new site.
Your server does not support cURL or fsockopen. Your server needs to allow these protocols so that your website can communicate with the WP e-Commerce API database. WordPress itself uses fsockopen to activate Akismet spam protection therefore if Akismet works then so should your WP e-Commerce API key.

If you don’t know what this means check with your web host or server administrator.
Your firewall is blocking outgoing connections. When activating your API key your website will try and reach out and connect to the WP e-Commerce API database. You might need to ensure that our IP address 209.20.70.163 is added to your firewall.
Your Gold files are in the wrong place. You need to ensure that your file structure is correct:

For WP e-Commerce 3.6 +, the gold files need to be unpacked and uploaded into the “wp-e-commerce/” folder like so:

“wp-content/wp-e-commerce/gold_cart_files/”

You also need to ensure that the gold_shopping_cart.php file is in the “wp-shopping-cart/” folder otherwise the gold tab won’t appear in your admin site. Ensure that this file is uploaded like so:

“wp-content/wp-e-commerce/gold_shopping_cart.php”

For WP e-Commerce 3.7, the gold files need to be unpacked and uploaded into the “wp-e-commerce” folder like so:
“wp-content/uploads/wpsc/upgrades”
You have not uploaded all the files correctly. It is possible that an Auto update went wrong or perhaps when you were uploading your files they did not copy over properly. You should check to make sure the files sizes are correct.

How do I increase the file size...

WP E-Commerce does not actually impose any sort of file size restrictions. Any errors uploading files or saving forms with uploaded files that refer to “File Size” are most likely caused by limits imposed by your hosting account or server configuration. #

Does Gold Cart include support for the First Data/Link Point payment gateway?

Yes it does. It will be listed as Link Point in the merchant list. #

When I setup and test First Data/Link Point as my payment gateway I get a blank screen

You need to download a PEM file from their website and place it in the following location on your server:

wp-content/plugins/gold_cart_files_plugin/merchants/linkpointpem
#

Installation Instructions

Upload the folder 'wp-e-commerce' to the '/wp-content/plugins/' directory
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.

FAQ

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 http://getshopped.org/resources/wp-consultants/.

Changelog

3.8.8

New: 3 action hooks to process PayPal IPN responses: wpsc_paypal_pro_ipn, wpsc_paypal_standard_ipn and wpsc_paypal_express_ipn.
New: Actions for bulk actions on sales page: wpsc_sales_log_process_bulk_action, wpsc_sales_log_extra_tablenav
New: Allow variation checkboxes to be collapsed & expanded without having to tick the variation set checkbox itself.
New: Digital Download UI improvement.
New: Extra hooks during checkout cart display: wpsc_before_checkout_cart_row, wpsc_before_checkout_cart_item_image, wpsc_after_checkout_cart_item_image, wpsc_before_checkout_cart_item_name, wpsc_after_checkout_cart_item_name, wpsc_after_checkout_cart_row
New: Filter for ordering the sales logs: wpsc_purchase_logs_orderby.
New: Filter wpsc_cart_shipping.
New: Filter wpsc_default_shipping_quote.
New: Filter wpsc_item_shipping_amount_db.
New: Filter wpsc_paypal_standard_post_data.
New: Filter wpsc_product_permalink_cat_slug.
New: Filter wpsc_product_postage_and_packaging.
New: Filter wpsc_shipping_quote_value.
New: Filters wpsc_calculate_total_tax, wpsc_coupons_amount.
New: 4 new filters for user meta in profile page and during checkout.class.php - wpsc_checkout_user_profile_get - wpsc_checkout_user_profile_update - wpsc_user_log_get - wpsc_user_log_update.
New: Settings Page API.
New: Some helpful filters to download_csv function: wpsc_purchase_log_start_end_csv, wpsc_purchase_log_month_year_csv, wpsc_purchase_log_month_year_csv, wpsc_purchase_log_csv_headers, wpsc_purchas_log_csv_output
New: Variation Drag & Drop sorting.
Change: Display file names instead of the product name on the downloads page.
Change: Improved variation UI in Product Edit page.
Change: In General Settings page, when changing country, load region / state list using AJAX instead of page reload.
Change: Only display variants' associated terms in Product Edit page rather than including the parent product name, which is redundant and cluttered.
Change: PayPal Standard settings now just offer dropdown of "live" / "sandbox" rather than URL entry.
Change: Subtle UX tweaks for Store Settings page.
Fix: %-based shipping cost is not working internationally.
Fix: $wpsc_query->query_vars['wpsc_product_category'] not always set on product page with hierarchical category permalinks.
Fix: Cannot add new Checkout field.
Fix: Cannot re-re-send buyer receipt.
Fix: Custom Meta copies values when adding new.
Fix: 3.7 -> 3.8 Database Upgrade Routine causes some products with variations to display a $0.00 price.
Fix: Double

p> tag with wpec_taxes_display_tax_bands() on product edit page. * Fix: Fatal error when trying to include a non-existent admin file. * Fix: Hide Google Feed information from display * Fix: Incompatibility with Genesis framework in Product Edit page. * Fix: Make the WP e-Commerce 3.8.x activation/installation routine much more efficient. * Fix: Mandatory fields in user_log_functions.php are not properly validated. * Fix: Memory improvement for productfeed. * Fix: Purchase logs have incorrect time if a timezone is specified in Settings->General. * Fix: Summary line does not get updated when sales log status is changed. * Fix: Total Quantity check fails for coupon codes. * Fix: USPS: "FLATE RATE ENVELOPE" should be changed to "VARIABLE" to allow for shipping quotes to be based on weight. * Fix: USPS settings not saving correctly. * Fix: Use ->add_help_tab() to support WP 3.3 admin screen API. * Fix: Using discount causes Paypal Express to calculate wrong total amount. * Fix: get_the_content() is not enough in product feed. * Fix: settings page JS compatibility issue with Firefox. * Fix: wpsc_get_template_file_url() function is inefficient and causes 10 extra SQL queries per page load.

3.8.7.6.1

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.

3.8.7.6

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).

3.8.7.5

Fix XSS vulnerability.

3.8.7.4

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

3.8.7.3

Security fixes.

3.8.7.2

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.

3.8.7.1

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.

3.8.6.1

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 display-update.page.php
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)

Help, Support & Customization for