ApiShip API integration for Shopaholic E-Commerce plugin / October CMS
Shipping method for Shopaholic that integrates ApiShip delivery API in checkout and backend management.
Plugin features
- Pickup points select + map (Yandex.Maps)
- Delivery city autocomplete
- Calculating delivery price based on ApiShip configured providers
- Checkout integration example for Shopaholic Bootstrap theme
- ApiShip Shipping Method in Shopaholic Shipping types
- Backend config for ApiShip integration
- Backend delivery management in orders (dispatch send/update/delete)
- Console commands for pickup points, shipping providers, tariffs, ApiShip statuses and orders delivery status synchronization
Required Plugins
- Toolbox
- Shopaholic
- Orders for Shopaholic
License
© 2019, GABIX under Commercial License.
The following plugins are required

Toolbox
Helpers for faster development: pagination rendering, objects and lists caching, UI strings for using in third...
Toolbox
Helpers for faster development: pagination rendering, objects and lists caching, UI strings for using in third...

Shopaholic
No. 1 e-commerce platform for October CMS
Shopaholic
No. 1 e-commerce platform for October CMS

Orders for Shopaholic
Allows customers to purchase products using the cart
Orders for Shopaholic
Allows customers to purchase products using the cart
Configuration
- Register an account at ApiShip Platform to obtain API access using
Login
andPassword
- Configure needed shipping providers in ApiShip Management Panel and tariff rules if necessary
- You can use test mode as noted in official documentation, but limited providers will be available for usage and no backend orders management
- Fill the required params on plugin configuration page in backend, i.e.
yoursite.com/backend/system/settings/update/gabix/apishipshopaholic/settings
- Run (and also configure periodical execution via cron) the following artisan commands to obtain/update providers, tariffs, shipping statuses and pickup points:
php artisan shopaholic:apiship.providers
php artisan shopaholic:apiship.tariffs
php artisan shopaholic:apiship.statuses
php artisan shopaholic:apiship.points
- Note that while using production mode ApiShip fetched data is limited to configured providers at ApiShip Management Panel
- If you are using cargo self-delivery to shipping terminal, do not forget to specify corresponding points for each
active provider
inSender Point-ins
tab - Note that ApiShip system needs to get not only your company address info (
Sender Address
tab), and customerFull name
,Email
andPhone
as well asStreet
,House
andFlat
(optional) for courier delivery, so correspondingOrder fields
under the self-titled tab are mandatory - You'll need to create only one universal Shipping type (
yoursite.com/backend/lovata/ordersshopaholic/shippingtypes
) with selectedApiShip API
asAPI method
- Setup cron artisan commands
php artisan shopaholic:apiship.points
(synchronize pickup points data) andphp artisan shopaholic:apiship.orderstatus
(update order delivery statuses) - Integrate delivery in frontend checkout, based on example for Shopaholic Bootstrap theme (see
partials/themes/lovata-bootstrap-shopaholic
in plugin directory for corresponding/edited files)
Experimental Plugin Events
- You can use
'gabix.apishopaholic.cart.get.sender_city_guid'
event for dynamically specifying City GUID in cart shipping price calculation, has to return GUID string - And
'gabix.apishopaholic.dispatch.get.sender'
event (withLovata\OrdersShopaholic\Models\Order $obOrder
param) on dispatch creation in backend. For example:
Event::listen('gabix.apishopaholic.dispatch.get.sender', function( $obOrder ) { $arResult = [ 'city_guid' => '...', 'postcode' => '...', 'street' => '...', 'house' => '...', 'block' => '...', 'flat' => '...', 'company_name' => '...', 'contact_name' => '...', 'phone' => '...', 'email' => '...' ]; return $arResult; });
Feel free to contact our support team if you have any questions regarding this integration.
-
Evgeniy Vorushilov
Found the plugin not useful on 2 Jun, 2021
There is no documentation! Instead, we suggest reading an example from the bootstrap theme for a shopaholic.
How terrible these partials are cannot be expressed in words.
Given that the bootstrap theme has a page checkout.htm and everything revolves around it, you are unlikely to adapt this solution to yourself.
In most cases, the shopping cart and checkout are located on the same page without a checkout template.
It is difficult to write your own component, since there is no normal documentation and comments in the code.
In the end, what we have. For just $ 50, you will get an unforgettable experience in reverse engineering and a powerful hardening of your nervous system.
I highly do not recommend buying it!
-
1.0.3 |
Added `experimental` backend shipping price calculation Mar 14, 2021 |
---|---|
1.0.2 |
Fix ApiShipHelper method Feb 24, 2021 |
1.0.1 |
Added offer dimensions calculation & config Feb 08, 2021 |
1.0.0 |
Initialize plugin. Dec 14, 2019 |