Shipping Director

After you unzip the downloaded file, put only the Shipping.Director folder in your \Plugins folder.  Then, restart your web application.  Go to administration > Configuration > Plugins, and on the line with Shipping rate computation / Shipping Director, click the Install link.  

Now, in nopCommerce administration, Configuration > Shipping > Shipping Rate Computation Methods, you will see Shipping Director. 

When using Shipping Director, it should be the only "Is Active" method.  Click its Edit button, and check its Is Active checkbox; then click its Update button.   Be sure to uncheck Is Active for all the other methods.  If you need to call the other methods from Shipping Director, you can still configure them with their Configure link, but be sure that the only active method is Shipping Director.

Click Shipping Director' Configure link to configure Shipping Director.

In the Shipping Director configuration page, click the Import button to import the included 'ShippingDirector (Hello World).txt' file.  Then, go to the public store, add an item to the cart, and then processed through checkout to see the result.  (Or, you can use Estimate Shipping from the cart page.) 

For more detailed installation instructions and troubleshooting information, see the Shipping Director Plugin Installation.pdf at  http://www.noptools.com/Content/files/Shipping%20Director%20Plugin%20Installation.pdf

If you see the message "Sorry, we are unable to calculate your shipping. Please contact the store.", then look in the Admin > System > Log for more details.

For additional debugging information, add the $Debug variable to the rules - e.g. 
0	(active)	$Debug		true

It's easiest to test your shipping rules by using the "Test" button on the configuration page.


At this time, there is no formal user manual.  Refer to the blogs at www.nopTools.com for more information.  You can contact us at support@noptools.com .  If you need help in setting up a shipping scenario, be sure to provide us with a few examples of "what's in the cart", and the expected shipping rate (and why).   

When setting up a complex set of shipping rules, be sure to consider what rate to calculate when there are multiple items in the cart each having their own specific rules and/or combination-specific rule.


Without a License.txt file, Shipping Director runs in evaluation (trial) mode.  In evaluation mode, you can calculate 5 rates, and then it will present a warning message.

When you are satisfied with Shipping Director and wish to purchase a license, note the URL (or Domain) next to the Version information on the configuration page - e.g.  Version 1.14 (Evaluation. Domain=mydomain.com; URL=www.mydomain.com) .  Be sure to copy the URL [Domain] exactly as it is presented; you will need this when you purchase online at www.noptools.com.  If you are using the multiple store option in NopCommerce, then you need to purchase a license for each store (URL).   (Each license file generated is named License.txt;  be sure to name them uniquely when putting them in the plugin folder; the file name must be prefixed with "License" - e.g. License_store1.txt, License_store2.txt, etc.)

To uninstall, after clicking the Uninstall link in the plugin configuration page, be sure to also remove the Shipping.Director folder from your \Plugins folder and restart your web application.

In nopCommerce 3.20, a "Use Warehouse Location" setting was added to the Configuration > Settings > Shipping Settings.  If you have set warehouses on your products, this setting will cause nopCommerce to call the active shipping rate calculation method(s) once for each warehouse (with only the products that originate from that warehouse).  Depending on your Shipping Director configuration, this may not be desirable.  Shipping Director has included its own "Use Warehouse Location" setting which may be more appropriate or not depending on if you need to do Packing.  Check the blogs for more info.  If you have a complex shipping scenario, feel free to contact us at support@noptools.com

Thanks
