lunarphp / table-rate-shipping
Lunar Table Rate Shipping Addon
Fund package maintenance!
lunar
Installs: 8 561
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 2
Open Issues: 0
Requires
- php: ^8.2
- lunarphp/lunar: 1.0.0-beta.5
- 1.x-dev
- 1.0.x-dev
- 1.0.0-beta.5
- 1.0.0-beta.4
- 1.0.0-beta.3
- 1.0.0-beta.2
- 1.0.0-beta.1
- 1.0.0-alpha.37
- 1.0.0-alpha.36
- 1.0.0-alpha.35
- 1.0.0-alpha.34
- 1.0.0-alpha.33
- 1.0.0-alpha.32
- 1.0.0-alpha.31
- 1.0.0-alpha.30
- 1.0.0-alpha.29
- 1.0.0-alpha.28
- 1.0.0-alpha.27
- 1.0.0-alpha.26
- 1.0.0-alpha.25
- 1.0.0-alpha.24
- 1.0.0-alpha.23
- 1.0.0-alpha.22
- 1.0.0-alpha.21
- 1.0.0-alpha.20
- 1.0.0-alpha.19
- 1.0.0-alpha.18
- 1.0.0-alpha.17
- 1.0.0-alpha.16
- 1.0.0-alpha.15
- 1.0.0-alpha.14
- 1.0.0-alpha.13
- 1.0.0-alpha.12
- 1.0.0-alpha.11
- 1.0.0-alpha.10
- 1.0.0-alpha.9
- 1.0.0-alpha.8
- 1.0.0-alpha.7
- 1.0.0-alpha.6
- 1.0.0-alpha.5
- 1.0.0-alpha.4
- 1.0.0-alpha.3
- 1.0.0-alpha.2
- 1.0.0-alpha.1
- dev-1.0.0-beta
- dev-1.0.0-alpha
This package is auto-updated.
Last update: 2024-11-05 10:04:33 UTC
README
Requirements
- LunarPHP Admin
>
1.x
Installation
Install via Composer
composer require lunarphp/table-rate-shipping
Then register the plugin in your service provider
use Lunar\Admin\Support\Facades\LunarPanel; use Lunar\Shipping\ShippingPlugin; // ... public function register(): void { LunarPanel::panel(function (Panel $panel) { return $panel->plugin(new ShippingPlugin()); })->register(); // ... }
Getting Started
This addon provides an easy way for you to add different shipping to your storefront and allow your customers to choose from the different shipping rates you have set up, based on various factors such as zones, minimum spend etc
Shipping Methods
Shipping Methods are the different ways in which your storefront can send orders to customers, you could also allow customers to collect their order from your store which this addon supports.
Shipping Zones
Shipping Zones allow you to section of area's of the countries you ship to, providing you with an easy way to offer distinct shipping methods and pricing to each zone, each zone can be restricted by the following:
- Postal codes
- Country
- State/Province (based on country)
Shipping Rates
Shipping Rates are the prices you offer for each of your shipping zones, they are linked to a shipping method. So for example you might have a Courier Area Shipping Zone and an Everywhere Else Shipping Zone, you can offer different pricing restrictions using the same shipping methods.
Shipping Exclusion Lists
Sometimes, you might not want to ship certain items to particular Shipping Zone, this is where exclusion lists come in. You can associate purchasables to a list which you can then associate to a shipping zone, if a cart contains any of them then they won't be able to select a shipping rate.
Storefront usage
This addon uses the shipping modifiers provided by the Lunar core, so you shouldn't need to change your existing implementation.
$options = \Lunar\Base\ShippingManifest::getOptions( $cart );
Advanced usage
Return available drivers
\Lunar\Shipping\Facades\Shipping::getSupportedDrivers();
Using the driver directly
\Lunar\Shipping\Facades\Shipping::with('ship-by')->resolve( new \Lunar\Shipping\DataTransferObjects\ShippingOptionRequest( shippingRate: \Lunar\Shipping\Models\ShippingRate $shippingRate, cart: \Lunar\Models\Cart $cart ) );
Shipping Zones
Each method is optional, the more you add the more strict it becomes.
$shippingZones = Lunar\Shipping\Facades\Shipping::zones() ->country(\Lunar\Models\Country $country) ->state(\Lunar\Models\State $state) ->postcode( new \Lunar\Shipping\DataTransferObjects\PostcodeLookup( country: \Lunar\Models\Country $country, postcode: 'NW1' ) )->get() $shippingZones->map(/* .. */);
Shipping Rates
$shippingRates = \Lunar\Shipping\Facades\Shipping::shippingRates( \Lunar\Models\Cart $cart );
Shipping Options
$shippingOptions = \Lunar\Shipping\Facades\Shipping::shippingOptions( \Lunar\Models\Cart $cart );