This tutorial is similar to Creation of Payment Method module, and differs the most in adapter model.

Each shipping method can be done as separate module or few methods can be combined in same module if they share functionality or could be used together.

Our new module will be called NewModule.

Replace all instances of ‘NewModule’ with name of your module and ‘newmodule’ with simplified code, that contains only alphanumeric characters and underscore.

Replace all instances of ‘YourCompany’ with your company name or whatever name you choose.

To make this tutorial most concise, it’s implied that mentioned folders will be created when needed.

Make sure that app/code/local is in PHP‘s include_path. To do so, execute the following code, either in a shell or inside a web-accessible PHP file:

Make sure you put this code somewhere after Magento was loaded, at the bottom of index.php for example, because Magento might modify the include_path on its own to fit its needs and dynamically attribute locations.

If you are using configuration cache, don’t forget to clean it after modifying config xml files.

Create app/code/local/YourCompany/NewModule/etc/config.xml:

Edit app/etc/modules/YourCompany_NewModule.xml:

Note: using “<!– ... –>” could imply there is more to input here, but for newbies like me, this is confusing if there is actually nothing to input. Also, I have seen some modules with <depends> <Mage_Shipping /> </depends> within the <YourCompany_NewModule> section. Should this be suggested?

Now application is aware of the module, but nothing will happen until we’ll create model logic.

Note: ShippingMethod name is arbitrary and is up to your decision.

Create app/code/local/YourCompany/NewModule/Model/Carrier/ShippingMethod.php:

Now that we have the model let’s give admin a way to configure it and also make checkout process aware of this method.

In this step, we need to tell Magento how to display our module in the Configuration section of the administrative panel. In order to do so, we must create app/code/local/YourCompany/NewModule/etc/system.xml and make it look something like this

You should now see your module in the Administration under “System” > “Configuration” > “Shipping Methods”. It’s now up to you to add your custom fields in the <fields> tag, and subsequently make your configuration do something constructive.

Here is a list of things that have happened to others while trying to implement thier own Shipping Module. (Please add to this list or provide responses to unresolved issues if you can. A collection of common problems and how to avoid them can only help everybody.)

Module won’t activate

Relating to the importance of casing, be sure the CompanyName you use has an initial cap letter - a lowercase initial letter will prevent this from activating. Magento really needs to have clear documentation for these norms.

This code doesn’t work on 1.4.1.1

In adminhtml all work. But model class doesn’t load. How to tell Magento in config.xml, system.xml or anywhere else to load this model class?

I’ve just managed to get this to work, with a bit of hacking. I had created a method following the instructions above, but couldn’t get it it give me a quote on the front end. The problem was in app/core/Mage/Shipping/Model/Shipping.php, line 164:

$className = Mage::getStoreConfig('carriers/'.$carrierCode.'/model', $storeId);

The module didn’t have a ‘model’ defined for it, so the getCarrierByCode() method was returning false straight away. The hack involved creating a new field in the system.xml file:

<model translate="label">
  <label>Model</label>
  <frontend_type>text</frontend_type>
  <sort_order>900</sort_order>
  <show_in_default>1</show_in_default>
  <show_in_website>1</show_in_website>
</model>

Then, using the admin panel, I gave this a value of ‘newmodule/carrier_newmodule’. While I was there I also created a ‘name’ field to give the method a name.

After doing that, the method was appearing in my list of quotes! — David Edwards 2008/07/28 10:26

I found another solution: insert the following code into config.xml right below the config -tag:

    <default>
        <carriers>
            <mage_newmodule>
                    <active>1</active>
                    <sallowspecific>0</sallowspecific>
<model>newmodule/carrier_newmodule</model>
                    <name>New Module</name>
                    <title>New Module</title>
                    <specificerrmsg>
                        This shipping method is currently unavailable.
                        If you would like to ship using this shipping
                        method, please contact us.
                    </specificerrmsg>
                    <handling_type>F</handling_type>
            </mage_newmodule>
        </carriers>
    </default>

— office@blu-ray-onlineshop.at 2008/09/24

Check to make sure that you have the system.xml and config.xml files in the suggested directory structure. Capitalization appears to be important. Be careful not to use “locale” where you meant to use “local”.

Make sure that the content in every <source_model> - tag has no line-break.

Correct:

<source_model>adminhtml/system_config_source_yesno</source_model>

Incorrect:

<source_model>
                adminhtml/system_config_source_yesno
</source_model>

I get this error: -

Notice: Undefined variable: response in /var/www/vhosts/dev.theironmanstore.com/httpdocs/app/code/local/Auburn/TNTpricing/Model/Carrier/ShippingMethod.php on line 37

which happens to be this line : " foreach ($response as $rMethod) {

”

any ideas?

Please, can you describe where exactly should I change the name from NewModel to Newmodel for to make this work in 1.4.1.1?

For about two years does anybody find this solution? This code does not work with magento 1.4.1.1 maybe this fact should be mentioned.

from：http://www.magentocommerce.com/wiki/5_-_modules_and_development/shipping/create-shipping-method-module