Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Optional shipping methods for the silverstripe shop module.
PHP CSS Scheme
branch: master
Failed to load latest commit information.
_config FIX: order shipping extension fix
code FIX: Make sure shipping rate show s up in shipping options list
css FIX: * in css was causing select options to be inline in Firefox
images
templates/Includes Fixed shipping estimates.
tests Fixed shipping estimates.
.scrutinizer.yml
.travis.yml
README.md Update README.md
_config.php Updates for the latest version of shop module
composer.json FIX: gridfieldextensions composer requirement
phpunit.xml.dist added phpunit config file, and README badges

README.md

SilverStripe Shop Shipping Framework

Latest Stable Version Latest Unstable Version Build Status Code Coverage Scrutinizer Quality Score Total Downloads

Introduce shipping options to the SilverStripe shop.

Requirements

Installation

composer require burnbright/silverstripe-shop-shipping:master
  • Put the shop_shipping folder into your SilverStripe root directory
  • Add the ShippingFrameWorkModifier to your modifiers config, eg:
Order:
    modifiers:
        - ShippingFrameworkModifier
        - FlatTaxModifier
  • You need to use the new SteppedCheckout system to allow customers to set their address before they choose their shipping method. To set up steps, including the shippingmethod step, add the following to your mysite/_config/config.yml file:
CheckoutPage:
    steps:
        'membership': 'CheckoutStep_Membership'
        'contactdetails': 'CheckoutStep_ContactDetails'
        'shippingaddress': 'CheckoutStep_Address'
        'billingaddress': 'CheckoutStep_Address'
        'shippingmethod': 'CheckoutStep_ShippingMethod' #extra line for shipping method
        'paymentmethod': 'CheckoutStep_PaymentMethod'
        'summary': 'CheckoutStep_Summary'
  • If included, remove SteppedCheckout::setupSteps() from your _config.php file (SteppedCheckout::setupSteps() creates default checkout page steps no longer needed with the above yaml entries).

  • To add the shipping estimation form to your CartPage template, add the following somewhere on your CartPage.ss template:

    <% include ShippingEstimator %>

If you need some example tableshipping data to populate your site for testing/development, you can run the task: yoursite.tld/dev/tasks/PopulateTableShippingTask

Architecture

ShippingPackage is a class used to encapsulate shipping data including: weight, dimensions, value, quantity.

ShippingMethod is the base class for different types of shipping calculation. These could either be flat rates, table based rates, or a

TableShippingMethod has many TableShippingRate, where TableShppingRate extends RegionRestriction. Table shipping rates also have optional weight, volume, value, and quantity constraint fields.

DistanceShippingMethod has many DistanceShippingFare, and requires the shop_geocoding module to be present.

Region Restrictions

The RegionRestriction class serves as a base class for providing regionalised restrictions. Restrictions are specified by Country, State, and PostalCode. A value/rate can be given to each restriction. To work the appropriate rate, query for all the matchign restrictions, and sort by cheapest.

The wildcard '*' means the restriction will match any region.

Something went wrong with that request. Please try again.