| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| v:2.0:multiship [2014/09/25 06:52] – [How Multi-Ship Works] adam | v:2.0:multiship [2017/07/05 02:46] (current) – [Custom Address Fields for MultiShip] adam |
|---|
| While it is a little more advanced than the standard single-ship checkout process, it's really not that bad, and can be a very profitable feature if the product and target market are right. | While it is a little more advanced than the standard single-ship checkout process, it's really not that bad, and can be a very profitable feature if the product and target market are right. |
| |
| | {{ :v:2.0:screen_shot_2017-06-29_at_3.39.59_pm.png?nolink&600 |}} |
| ===== How Multi-Ship Works ===== | ===== How Multi-Ship Works ===== |
| Multi-Ship works by adding a [[.:cheat_sheet#standard_product_options|''shipto'' parameter]] to any products added to the cart. The value of the ''shipto'' can be anything, but we recommend [[:integration:foxycart:multiship_javascript_2|a quick bit of javascript]] (results of which is displayed below) to keep ''shipto'' values consistent and easy to manage for your customers. | |
| | Multi-Ship is enabled by checking the box labeled ''multiple ship-to addresses'' in the settings page of your store's admin and click the ''Update Store'' button to save the setting. Here's a link to that page: [[https://admin.foxycart.com/admin.php?ThisAction=EditStore|FoxyCart Store Settings]] |
| | |
| | To implement Multi-Ship in your store, you'll start by adding a [[.:cheat_sheet#standard_product_options|''shipto'' parameter]] to any products added to the cart. To see it in action, add to cart at least 2 products with different values of the ''shipto'' parameter. For example - if the following product was added to the cart twice, once with with the shipto select element set to "Me" and another time with it set to "Mom", it would look like the screenshot above: |
| | |
| | <code html> |
| | <form action="https://YOURDOMAIN.foxycart.com/cart?" method="post"> |
| | <input type="hidden" name="code" value="CCCOOKIES" /> |
| | <input type="hidden" name="name" value="Chocolate Chip Cookies" /> |
| | <input type="hidden" name="price" value="10.00" /> |
| | <label>Ship To:</label> |
| | <select name="shipto"> |
| | <option value="Me">Me</option> |
| | <option value="Mom">Mom</option> |
| | <option value="Friend">Friend</option> |
| | </select> |
| | <input type="submit" value="Add Chocolate Chip Cookies to cart" /> |
| | </form> |
| | </code> |
| | |
| | For applying Multi-Ship to your store you probably wouldn’t want to hard-code the different ''shipto'' values as in the example above, but instead let the customer enter their own custom values and have the dropdown remember those. We recommend [[:integration:foxycart:multiship_javascript_2|a quick bit of javascript]] (results of which is displayed below) to keep ''shipto'' values consistent and easy to manage for your customers. |
| |
| {{ :v:0.7.0:multiship.site.png?direct |Selecting a "shipto" address for a product.}} | {{ :v:0.7.0:multiship.site.png?direct |Selecting a "shipto" address for a product.}} |
| |
| When multi-ship is enabled for your store you'll notice that [[.:cart|your cart]] now displays products grouped by "ship to" headings, and [[.:checkout|the checkout]] (displayed below) also has different functionality in the shipping address section. | With Multi-Ship enabled for your store, you'll notice that [[.:cart|your cart]] now displays products grouped by "ship to" headings, and [[.:checkout|the checkout]] (displayed below) also has different functionality in the shipping address section. |
| |
| {{ :v:2.0:multiship_2.jpg?direct&500 |A shipping address selection for a multi-ship checkout.}} | {{ :v:2.0:multiship_2.jpg?direct&500 |A shipping address selection for a multi-ship checkout.}} |
| |
| Worth noting is that, like all product options, a ''shipto'' value cannot be changed on a product once it is in the cart. Products can be removed and re-added, but not modified, so you'll want to make it easy for your customers to view their cart in order to remove products as necessary. | Worth noting is that, like all product options, a ''shipto'' value cannot be changed on a product once it is in the cart. Products can be removed and re-added, but not modified, so you'll want to make it easy for your customers to view their cart in order to remove products as necessary. |
| | |
| | ===== Custom Address Fields for MultiShip ===== |
| | Just like [[.:checkout#adding_custom_checkout_fields|normal custom checkout fields]], you can add additional custom fields //per shipping address// on the checkout. Just add the extra code in the appropriate section of the template configuration options in the admin, and the rest happens fairly automagically. It'll look something like this: |
| | |
| | {{ https://www.evernote.com/shard/s1/sh/944aa3a7-6bdb-4788-a231-fefe0d280c29/472a6b88613fda7e123d6e7d264c46e8/deep/0/The-Man-Can!-Stuff-Secure-Checkout.png }} |
| | |
| | Here's some sample code for adding a referral source for each shipto address: |
| | |
| | <code> |
| | <div class="fc-form-group "> |
| | <div class="col-md-8 col-md-offset-3" data-fc-error-for="referral_source" data-fc-error-class="fc-alert-container--error"> |
| | <div class="fc-input-group-container fc-input-group-container--checkbox fc-input-group-container--active"> |
| | <label class="fc-input-group-container__title fc-input-group-container__title--forced fc-form-label"> |
| | Referred by… (required) |
| | </label> |
| | <div class="fc-form-group"> |
| | <p>Please let us know who referred you.</p> |
| | <input |
| | type="text" |
| | id="referral_source" |
| | name="referral_source" |
| | placeholder="" |
| | autocomplete="off" |
| | class="fc-form-control" |
| | formnovalidate="" |
| | autofocus="" |
| | aria-required="true" |
| | value="{{ referral_source }}" |
| | data-fc-required |
| | > |
| | </div> |
| | </div> |
| | </div> |
| | </div> |
| | </code> |
