---- dataentry snippet ----
type          : snippet # do not change this line
category      : shipping # mention the category like 'shipping', 'checkout' etc
name          : Setting a single flat rate shipping amount no matter which categories are included # the name of the snippet
description   :  # description about snippet
versions_tags : 0.6.0, 0.7.0, 0.7.1, 0.7.2, 1.0, 1.1 # compatible versions
reference_url : http://forum.foxycart.com/comments.php?DiscussionID=4389&page=1 # Item_14            # External link
tags_tags     : snippets, shipping, advance # tags, separated by commas.
date_dt       : 2011-05-27 # the date in YYYY-MM-DD format
----

====== Setting a single flat rate shipping amount no matter which categories are included  ======

<WRAP center round important 80%>
**Versions 0.7.1 and older**: Note that applying javascript shipping modifications using either live or flat rates where you are setting custom values has been found to not work as expected for subscription based products where you need the shipping to apply to each subscription renewal. A fix is in place for versions 0.7.2 and newer.
</WRAP>
<WRAP center round important 80%>
**Using version 2.0?** There is a new snippet available for our latest version, [[v:2.0:snippets:flat_rate_shipping_modification|available from here]].
</WRAP>
<WRAP center round info 80%>
**If you're using handling fees** note that you can't overwrite handling fees using javascript on the checkout to provide free shipping. While it will appear that the shipping is $0 on the checkout, the handling fees will be added back in server-side, and the customer will see a shipping fee that matches the handling fee cost you have set in the administration.
</WRAP>

When using multiple categories but you want a single flat rate shipping value for the whole shipment (rather than per category), you need to set this up using javascript. Currently, if all of your categories had a flat rate shipping value of 9, having a product from two different categories would equal $18 shipping rather than a flat $9.
==== Step 1: Update categories ====

Update all categories to 'Shipped using a flat rate fee' with a value of 0 in the 'Product Delivery Option' section.

==== Step 2: Insert Javascript ====

Paste the following right before the closing ''</head>'' tag in your checkout template, and update the value to be whatever shipping cost you need:

<code javascript>
<script type="text/javascript" charset="utf-8">
jQuery(document).ready(function() {
  FC.checkout.config.orderFlatRateShipping = 9;
  FC.checkout.updateShipping(-1);
});
</script></code>

<wrap hi> This will make the shipping charges $9 no matter what is added to the cart.</wrap>

===== Related Forum Discussions =====

  * http://forum.foxycart.com/comments.php?DiscussionID=4389&page=1#Item_14