Introduction
What is No PO Box Shipping?
The No PO Box Shipping module updates the Magento checkout fields to prevent shipping to a PO Box. This means you'll eliminate the orders marked for shipping to a PO Box and the associated customer service support.
How it Works
No PO Box Shipping simply checks the shipping checkout fields for a PO Box. If a PO Box is detected, an error is displayed telling the customer to enter a street address.
Pre-requisites
Code/Conflicts
- NO EDITS OR MODIFICATIONS TO MAGENTO CORE (Typically, this includes all code inside the app/code/core folder)
- No conflicting modules (or conflicting custom code) installed (Typically, if installed component/module affects same functionality as Promobot--shopping-cart-rule related, you should be wary of conflicts)
Magento Version
- Community Edition 1.3 - 1.5
Installation
Before you Install
As with all our modules (and all modules in general), installing this module directly and solely in a live environment is strongly discouraged. It is recommended that it be installed in a development environment, configured, tested, and then deployed to your live environment through your deployment method of choice (i.e. - git, subversion, etc...). If this is not possible, then the next best thing would be to make a FULL backup before installation.
Installing the Basic Application
Navigate to the root of your application. You should see folders like (app, downloader, skin, etc...). If you have not already used Magento Connect or any other Pear package management for your installation, you will need to run the following:
terminal Setting up Pear
If you receive a permission error, run the following:
terminal Pear Permissions
Then (Replace /path/to... with the path to your Speed Booster TarBall.):
terminal Pear Install
If you ever need to UN-install No P.O. Box, you can run:
terminal Pear UN-Install
These Commands Giving You Grief?
Don't give up yet. If you're not a veteran to command line, it can be just a character or two that makes the difference. If you are on a shared host, you might not be allowed to run pear installs (which is lame, but happens). If that's the case, try asking them if they could run them for you (sometimes they're nice that way). If they really are mean (or just not setup that way), then you might have to do a manual install. However, your best bet is to save it for the last option. It's definitely easier to run one command than try to copy files manually.
Configuration
Settings
You can allow or disallow PO Boxes by going to System->Configuration->Shipping Settings. It should already be set to, "No".
Testing The Module
Once installation is complete, test your module by adding a product to your cart and checking out. Entering a PO Box as a shipping address should result in an error like this:
There you go! Your PO Box hassles are over.
Known Limitations
- Module Conflicts - One Step Checkout