Variation Name: Frequency{sub_frequency}

Just Once{v:}
Every 2 Weeks{v:2w}
Every Month{v:1m}

And here’s another example:

Variation Name: Start Date{sub_startdate}

Immediately{v:}
1st of the Month{v:1}
15th of the Month{v:15}

You can put the “real” name of the variation in {curly braces} and then you can put the “real” dropdown value as a v: modifier. Just entering “v:” will pass in a blank value. Note that you can’t use this with other modifiers like price adjustment since this really becomes a non-variation field.

Other updates:

• Added missing radio title dkey class
• Added FoxyCart 1.1 option (even though this isn’t available yet, it will be soon)
• Added ‘foxyshop_inventory_update’ action

Here are the updates from 4.3.1 which was released in late 2012:

• Added easier category syncing for FoxyCart 0.7.2+
• Fixed spacing issue with WP 3.5
• Fix to remove the `quantity_max` field when backordering is allowed
• Show warning if cURL is not installed
• Moved the template cache functionality up so that scrolling isn’t required as often on the tools page

FoxyShop 4.3 is primarily a maintenance update but it does have some handy new features.

The new default FoxyCart store version is 1.0. (In fact, any new stores being created now won’t be able to build a 0.7.2 store.)

Native support has been added for the following fields at the product level: cart, empty, and coupon. So you can now check a box and instruct a product to add a coupon with the product or force a checkout. It should be noted that it’s generally a good idea to check the “Empty Cart” option if you are forcing a direct checkout. You can still use “cart”, “empty”, or “coupon” as a direct custom field if you want more flexibility. These new checkboxes are located under the subscription/discount information on the right side of the product page in the admin.

You can now add hidden product field variations. This gives you the flexibility to add a hidden field that will be included with the product when it goes to the cart.

Other Small Fixes:

• Updated to jQuery 1.8.2 (important for CloudZoom)
• Updated to jQuery UI 1.9.1
• Reverted jQuery UI theme to Smoothness (from Lightness in FoxyShop 4.2.1)
• Fixed double-encoding in foreign currency in JavaScript context
• Fix for apostrophes in saved variation titles
• Include and require functions now use absolute paths
• Security: added checks to make sure that any FoxyShop php pages can’t be run directly
• Fix for missing alert values on imported inventory records
• Fix for missing quantity_min and quantity_max values on the add to cart link
• Fix for inventory error generated when there’s no product code
• Fix to make sure that add to cart form can’t be submitted if submit button is disabled

Here are the changes from the previous update, 4.2.1:

• Added support for multiple dkeys split by a comma: {dkey:key1,key2}
• Bugfix for radio/checkbox elements whose values were hidden after being hidden by dkey
• Updated variations for better multiship support on repeat purchases
• Updated to jQuery 1.8
• Updated to jQuery UI 1.8.23
• Added security option if you’d like to disable user uploading: define(‘FOXYSHOP_DISABLE_USER_UPLOAD’, 1);
• Order snapshot on admin dashboard now shows up to 300 orders instead of 50 (more accurate numbers)
• Added a few more product variation container filters
• Fixed missing discounts in order_total for CSV export

FoxyShop version 4.2 focuses on some improvements to the variations processor and a number of other updates and bugfixes. Here’s the rundown of what you’ll find in 4.2:

Variation Processor Updates
The variations will now allow multiple levels of d-keys to allow very complicated structures where each d-key’ed element is viewed on all previous elements instead of just a single level of dependency checking. Now you can have a shirt type which turns on embroidery type where a certain embroidery type turns on color options. The processor has also been updated to put an x: in front of hidden text and textarea input fields. This was already in place for select’s and radio buttons, but this now means that you won’t end up with text fields in your cart that weren’t viewable when the form was submitted. This also means that you can now have multiple hidden text fields that share the same name.

Updates for Multiple Products on One Page
Sometimes when showing multiple product forms on the same page there were some collisions with the galleries. PrettyPhoto galleries have been updated to include the product ID in the rel attribute so that multiple galleries won’t overlap on each other. Out of stock messages are now members of a JavaScript array so that having more than one on a single page means they won’t overwrite each other.

Google Product Feed
The Google Product Feed feature has been updated to add CDATA markup to content field and to allow for customizable target country and currency via filters. Note that this program has changed and you now have to purchase product ads. See Google’s announcement for more information. You can still submit your product feed but then you’ll go create ads in AdWords.

New Features

• Added settings option for disabling cart validation (if cart validation was currently disabled via the wp-config constant, new setting will be set to “off”)
• Added a filter for the post type registration argument array
• Added filter for disabling auto-login when new user account created

Improvements

• Allow saved variations to have custom names
• Updated hidden ikey images to be written out but hidden so cloudzoom will work properly
• Improved inventory update matching to only update published products, not those in trash. Also improved to handle the different ways that different servers write serialized datatypes.

Bugfixes

• Fix for double UTF-8 encoding on foxyshop_currency() – won’t do UTF-8 encoding if the localization name ends with .utf8.
• Fix for error/typo in customer email variable in subscription datafeed
• Fix to accept custom field search criteria in CSV export feature
• Fix for CSV export not showing proper amount for quantities greater than one
• Fix for the FOXYSHOP_PRODUCT_TAGS feature

Versino 4.1.5 has been released with some patches and few small feature upgrades. It’s been a little while since a big release, but there have been several maintenance releases and some new features here and there. Here’s the skinny:

Version 4.1.1

• Added new setting so show a computed Add to Cart link with each product.
• Line breaks now shown on order page
• Multiship stores were seeing redundant shipping address in admin
• Setup page cleanups and a few syntax fixes in helperfunctions.php

Version 4.1.3

• jQuery updated from 1.7.1 to 1.7.2
• Lots of internationalization updates and a Norwegian translation added (German is in the works as well)
• Added ‘foxyshop_breadcrumbs_base_link’ filter
• Upgraded template redirect function to check for post names as well as page names
• Removed unneeded “is foxyshop installed” checks from template files
• Added settings page sniffers for Thesis and Headway users (there are now customizations available for those templates)
• Fixed bug where subsequent cloud zoom displays were “large” not “full” size images
• Fixed potential warning in templateredirect.php for foxyshop_body_class() with missing array
• Fixed notice appearing on some installs when no orders returned
• Fixed missing default dropdown on first unsaved variation (tools page)

Version 4.1.4

• Added setting for automatic FoxyTools Order Desk integration
• Added feature to add ikey images that don’t show up in slideshow (click the “eye” icon to hide)
• Introduced is_foxyshop() function as a conditional tag which returns true for all FoxyShop pages (this is improved in 4.1.5)
• Tested with WordPress 3.4 and found no issues
• Added action to SSO endpoint to allow interception
• Upgraded to prettyPhoto 3.1.4
• License changed to GPLv2 or later as recommended by WordPress
• Changed to get_user_by in datafeed functions because of deprecated function in WordPress 3.3
• Filter variation names for invalid characters on CSV import upgrade
• Fixed incorrect query match in the inventory update function when all numbers are used for code (serialization issue)

Version 4.1.5

• Added FoxyShop version 1.0 support
• Added ‘foxyshop-current-category class’ to the category list function
• Added ‘$foxyshop_skip_cart_image’ variable so the cart image can be easily skipped (globally set this in functions.php)
• Allow subscription post data to be passed through to external datafeeds
• Added setting to enable email reminders to expiring credit card customers
• Improved is_foxyshop()
• Fixed the “required file upload” feature to trigger an error if no file is uploaded
• Fixed Google Analytics script so that it won’t be inserted on skipped template pages (Checkout, Receipt)

Click here to watch the video

Resources:

• Always HTML Plugin
• Guide to Easily Updating Cart and Checkout Images
• FoxyCart Cart Template Suggestions

Step 1

The following theme files need to be placed in your child theme folder. If you aren’t using a child theme, it is strongly recommended that you do so (otherwise updating Headway to a new version will wipe out your theme customization files).

• foxyshop-single-product.php
• foxyshop-single-category.php
• foxyshop-all-products.php
• foxyshop-all-categories.php

All files need to have the get_header() and get_footer() functions removed from them. To make this easy, just download this file and put the contents in your theme folder.

Step 2

Create two manual pages with the slugs of products and product-cat. These pages will show the “All Products” and “All Categories” views. They don’t strictly “exist” in the default WP structure so we have to create them manually and then we’ll assign content blocks to them in step 4. The page content doesn’t matter since it won’t be used: the only important thing is the slug.

Step 3

Install and activate this WordPress plugin: FoxyShop Plugin for Headway. This plugin doesn’t replace the main FoxyShop plugin but is a secondary plugin which will add the content blocks necessary for showing FoxyShop content in the main Headway content blocks inside your pages.

Step 4

Install the FoxyShop content blocks in four key areas. Do this inside the Headway Visual Editor:

• Single / Pages/ Products: Edit the page and for the main content block, select More Blocks / FoxyShop All Products
• Single / Pages/ Product Cat: Edit the page and for the main content block, select More Blocks / FoxyShop All Categories
• Single / Product: Edit the page and for the main content block, select More Blocks / FoxyShop Product
• Archive / Taxonomy / Product Category: Edit the page and for the main content block, select More Blocks / FoxyShop All Categories

That should do it. If you run into troubles, please let me know.

The Orders page in the admin has been adjusted so that instead of adding buttons for each new customization, these new customizations can be placed into a dropdown menu:

Custom buttons can still be added using the existing filter. The new action is called foxyshop_order_search_list.

The FoxyShop product detail page now has an option for native ColorBox image popups. You can select prettyPhoto, CloudZoom, or ColorBox on the foxyshop-single-product.php template. If you want to customize, you can grab the code from the foxyshop_build_image_slideshow() function in helperfunctions.php and paste it right into your template file.

Maintenance Items:

• Sped up admin product page load by skipping javascript and loading images natively on first load and by caching and condensing a lot of jQuery
• Removed UPS export option in settings – it will always show up on the View Orders page in the new dropdown
• Added an argument to the foxyshop_setup_product() function to speed up the inventory page load
• Added ‘foxyshop_main_menu_name’ filter so you can customize the main admin menu title
• Moved the jQuery insert from ‘init’ to ‘wp_enqueue_scripts’ so it initializes later
• The foxyshop_setup_product() function was upgraded to accept product ID’s and slugs as well as $post objects
• Added optional append argument to the foxyshop_save_attribute() helper function
• Added filters for the order/customer/subscription search defaults
• Bugfix: Related products were matching an add-on product, not the main parent
• Bugfix: Search page template was loading the foxyshop header instead of footer at end of file

Attributes for Transactions, Customers, and Subscriptions

FoxyCart 0.7.2 users can now add and edit attributes for all transactions, customers and subscriptions. These are special data fields that live with the records and can hold tracking information, notes, or any other data you want to store. Since attributes are included with the FoxyCart API, you’ll be able to use the data anywhere you need to. Use the helper functions foxyshop_save_attribute() and foxyshop_delete_attribute() to easily save and manage attributes in your own integrations. You can see the arguments for these functions in adminfunctions.php.

Redesigned Discount Entry Interface

FoxyCart has an incredibly powerful coupon system, but the syntax is a little hard to get the hang of and it can be difficult and time-consuming to enter the discount strings. FoxyShop now includes a user-friendly entry system that also shows the computed discount string so you can still enter the old way if that feels more comfortable. It will even parse your entry and show you exactly what you entered.

WordPress 3.0 Support Removed

NOTICE: WordPress 3.0 support has been removed. Do not upgrade if you are still using WordPress 3.0! I feel that there’s no legitimate reason for not upgrading WordPress and if you aren’t upgrading WordPress, you likely aren’t upgrading FoxyShop either. WordPress 3.0.3 was released in December 2010. It’s important for the health of the plugin that it only focus on the most relevant versions. This creates cleaner code that is easier to maintain and build on.

Other Improvements

• Dropdown variations can now click the “Required” checkbox if they want the first option in the dropdown to be an invalid choice. This is helpful if you want to force the customer to select an option from the dropdown menu. The first option could be “Select One” and would be marked invalid as a checkout option.
• Instead of one tax total, all taxes are now displayed by name on the admin order page and the default receipt template
• Adjusted item price and weight variations on admin order page now show accurately
• Cloud-zoom functionality updated for better mobile device support. Also, the slideshow options won’t be displayed if just one image is returned.
• The Google Product Feed feature that looks for unmatched products has been improved. You’ll notice the difference if you have more than one page of products since any products synced with Google now have a hidden meta field to let FoxyShop know they are syncing.
• Menu name changed from “Products” to “FoxyShop” for easier recognition (WordPress 3.2+)
• Removed jQuery from the enqueue if FoxyShop includes are skipped – you don’t need jQuery on the FoxyCart checkout pages and including multiple versions can cause problems. Note that it will not do this skip if you are using * to skip inclusion on ALL pages because then it’s assumed that you are doing includes manually. If you don’t want jQuery, uncheck the jQuery include box in settings.
• Subscription management urls now have empty=true in them to ensure an easier update experience (info)
• Updated fallback FoxyCart Colorbox CSS to version 3.1.18 (for 0.7.2 users)
• A hook has been added for the email address to which inventory updates alerts are delivered. Sample code here.
• Made the FoxyCart domain entry box on the settings and setup pages a little more self-explanatory
• Added two recommended plugins to tools page for helpful user login functions

Bugfixes

• Subscriptions now show all products in the subscription, not just the first one
• Fixed settings link on plugins page

Skip FoxyCart Includes

By default, FoxyShop puts FoxyCart includes on all your pages for you. It picks the right includes based on your version so you don’t have to worry about it. If you want to load in your own includes or want to skip them on some pages, you can now do so. Just go to your settings page and enter page slugs or id’s separated by comma for the pages which should not have FoxyCart includes. If you want to skip FoxyCart includes on all pages, just put an asterisk (*) in this box.

This is particularly helpful if you want to use your WordPress template to create an update-able FoxyCart checkout template since these pages should not have the FoxyCart includes.

More Hooks and Filters

If you want to allow external users to access your orders but not necessarily the rest of your admin, you can now setup permission filtering. To see some sample code and the necessary hooks, click here and look for the Permission Hooks section.

A filter was added for when the product slug string is set in the product initiation. This allows for the product url to be dynamically modified with, for example, the category name.

An action hook was added that fires after any transactions have been archived or unarchived.

A filter was added for foxyshop_descriptionfield_variation which will let you manage the description field contents and potentially do some special customizations.

Other Changes

The foxyshop_container div has been moved so that it now sits inside of the foxyshop-header.php and foxyshop-footer.php files. This should makes any custom integration a little easier since the foxyshop_container should, more accurately go inside of the header and footer includes.

The shipping category has been renamed (more accurately) “FoxyCart Category.” If there were no customized shipping locations, the FoxyCart Category dropdown would have been hidden. Now, it will always be visible for more clarity and to allow for customized shipping process functions, like FoxyCart Download Sync in FC version 0.7.2. If using 0.7.2 you may want to re-sync your FoxyCart Category list after upgrade.

FoxyCart is taking 0.7.2 out of beta so FoxyShop now sets 0.7.2 as the default version when it’s first installed.

Bugfixes and Cleanups

• Images uploaded while the product is untitled will now be called “Image” instead of “Auto Draft”
• Warnings have been added to the admin page so that the & and " characters can’t be saved in the product code string. This causes validation to fail.
• Bugfix: Minimum quantities that were entered without a maximum quantity weren’t being saved. This has been corrected.
• Bugfix: Expired Google Products authentication now correctly prompts for renewal. Authentication expires every two weeks.

Inventory Updates

There’s been a new helper function added for developers to update inventory levels. You just have to pass in the item code, the new inventory level, and an optional product ID, and the function finds the correct product and updates the inventory level. This makes it much easier to integrate into a third-party inventory system. Speaking of which, there is some code available for SmartTurn and ConsoliBYTE inventory integration so please let me know if you are interested in this code. The ConsoliBYTE integration will be officially supported soon.

You can also now import your inventory levels all at once. Previously, the inventory import would only save existing values. The only fields that need to be filled out in order to add new inventory values are the Code and Inventory columns (third and fifth column). The other columns can be blank as they are ignored.

API Updates

You can now show more than 50 orders per page (FoxyCart 0.7.1+ only) by setting the FOXYSHOP_API_ENTRIES_PER_PAGE constant in your wp-config.php file. The Orders, Customers, and Subscriptions lists also have much better paging now–it’s the default WordPress paging style.

A Bulk Archive option has been added to the Manage Orders screen so you can archive or unarchive a bunch of products at once. The important thing to remember here, is that each transaction still has to be processed one at a time on the backend, so it can be a little slow. You may want to only do 10-15 at a time to ensure the process finishes without timing out. Your experience may differ, just tread with caution.

Other Updates:

• The Bulk Update feature now lets you update prices dynamically with +, -, or by percentage.
• Many datafeed template improvements–this template is moving toward having most of the page in external functions. Added WP actions as well.
• cURL connection error now displays actual error
• Added MinFraud score (0.7.2+) to transaction details
• “No Weight” can now be set as a system default if your products don’t use weight. Just set your default weight to 0.
• Added a filter so that the date format can be adjusted on the order page
• Bugfix: transaction receipts outside the default date filter now viewable
• Bugfix: admin nag bars are now limited to admins only
• Bugfix: corrected jQuery error (variations js) which was appearing only in iOS 4
• Bugfix: Corrected some errors in the subscription datafeed processor – update your datafeed template