Category: magento


Magento Module Tutorial

This tutorial is taken from http://blog.baobaz.com/en/blog/magento-module-create-your-own-controller, So please go there if you want see more info i just makes my own backup :)

Magento is based on MVC model. This model helps for defining models, view (layout + templates) and controllers. Despite big amount of modules available by default in Magento and on Magento Connect, you may want to create your own module and define your controller for you Magento website. No problem, this tutorial will explain you how to create your own controller and how to make it respect its authoritah to layouts and templates.

Purpose of this example controller will be to give result of two integers multiplication (very useful if you lost your calculator). Integers will be provided through a basic form. Result will be displayed in a Magento notification.

Before starting creation of your module, please turn off the cache management in order to see immediately every change.

Creating your module

Our extension will be named arithmetic. Folders needed for this extension are created.

$ mkdir -p app/code/local/Baobaz/Arithmetic/controllers
$ mkdir -p app/code/local/Baobaz/Arithmetic/etc

We create file app/code/local/Baobaz/Arithmetic/etc/config.xml, in order to register this extension

<?xml version=“1.0″ encoding=“UTF-8″?>
<config>
    <modules>
        <baobaz_arithmetic>
            <version>0.0.1</version>
        </baobaz_arithmetic>
    </modules>
</config>

And a file app/etc/modules/Baobaz_Arithmetic.xml for its activation:

<?xml version=“1.0″ encoding=“UTF-8″?>
<config>
    <modules>
        <Baobaz_Arithmetic>
            <active>true</active>
            <codePool>local</codePool>
        </Baobaz_Arithmetic>
    </modules>
</config>

For more informations about creation of a new extension, please check Wojtek‘s post “Developing module for Magento Tutorial – Where to Begin [Part 1]“.

Creating a controller

You need now to create file app/code/local/Baobaz/Arithmetic/controllers/IntegerController.php and write method that will be used for multiplication.

Controller files must always follow pattern xxxxxController.php (xxxxx will be used after in url for calling this controller) and put in controllers folder.
Controllers methods names must follow pattern yyyyyAction (yyyyy will also be used in url for calling this controller). For the moment content of our file is:

class Baobaz_Arithmetic_IntegerController extends Mage_Core_Controller_Front_Action
{
    public function multiplyAction(){
    }
}

We need to indicate now that some controllers are available in Arithmetic modules. For doing that, we add the following content in app/code/local/Baobaz/Arithmetic/etc/config.xml file:

<config>
    …
    <frontend>
        <routers>
            <arithmetic>
                <use>standard</use>
                <args>
                    <module>Baobaz_Arithmetic</module>
                    <frontName>arithmetic</frontName>
                </args>
            </arithmetic>
        </routers>  
    </frontend>
</config>

Let see how this router declaration works:

  • indicates that router will be use in front part of website
  • is where you declare all your routers
  • is identifier of this router
  • standard can take value standard (for front part) or admin (for admin part).
  • Baobaz_Arithmetic indicates which module contain controller that handles this router
  • arithmetic is router name that will be used in url

We can now modify multiplyAction method for making it displaying a message:

public function multiplyAction(){
    echo “Respect my authoritah”;
}

When you call now url http://monsitemagento/arithmetic/integer/multiply message “Respect my authoritah” will be displayed. Let dissect this url:

  • arithmetic tells that controller is in Baobaz_Arithmetic module
  • integer tells that controllers/integerController.php file must be cehcked
  • multiply tells that multiplyAction method must be chosen in this file

Displaying a template

We define which layout file will be used in the module:

<config>
    …
    <frontend>
        …
        <layout>
            <updates>
                <arithmetic>
                    <file>arithmetic.xml</file>
                </arithmetic>
            </updates>
        </layout>
    </frontend>
</config>

We create app/design/frontend/default/default/layout/arithmetic.xml file in order to define which blocks will be used for controller that was just made.

<?xml version=“1.0″ encoding=“UTF-8″?>
<layout version=“0.1.0″>
    <arithmetic_integer_multiply>
        <reference name=“root”>
            <action method=“setTemplate”>
                <template>page/1column.phtml</template>
            </action>
        </reference>
        <reference name=“content”>
            <block type=“core/template” name=“arithmetic_integer_multiply” template=“arithmetic/integer/multiply.phtml”></block>
        </reference>
    </arithmetic_integer_multiply>
</layout>

Main template used by arithmetic/integer/multiply is page/1column.phtml. For “content” part of this template, only arithmetic_integer_multiply block will be displayed. This block does not need any particular management. It is then set with core/template type that is default type. Template file used will be arithmetic/integer/multiply.phtml.

Our template is defined, app/design/frontend/default/default/template/arithmetic/integer/multiply.phtml must then be created. This file will be empty for the moment..

For displaying correctly layout, it must be loaded in controller

public function multiplyAction(){
    $this->loadLayout();
    $this->renderLayout();
}

Interaction between template and controller

Our template will just have a basic form for providing integers to multiply

<form action=” method=”post”>
    <fieldset>
        <ul>
            <li>
                <label for=“int1″>Integer 1</label>
                <input type=“text” id=“int1″ name=“int1″ />
            </li>
            <li>
                <label for=“int2″>Integer 2</label>
                <input type=“text” id=“int2″ name=“int2″ />
            </li>
            <li><input type=“submit” value=“Multiply” /></li>
        </ul>
    </fieldset>
</form>

Action form url is again arithmetic/integer/multiply. Controller action must then be modified in order to manage data from form and to give result.

public function multiplyAction(){
    if ($this->getRequest()->isPost()){
        $int1 = $this->getRequest()->getPost(‘int1′);
        $int2 = $this->getRequest()->getPost(‘int2′);
        $result = $int1 * $int2;
    Mage::getSingleton(‘customer/session’)->addSuccess($int1 * $int2 = $result);
    }
    $this->loadLayout();
    $this->_initLayoutMessages(‘customer/session’);
    $this->renderLayout();
}

In order to know if controller is called after using form, following instruction is used:

$this->getRequest()->isPost()

Result is put in ‘customer/session’ session. For being able to display this result in template, message template must be loaded in multiplyAction method:

$this->_initLayoutMessages(‘customer/session’);

Add then in you template the following line where you want to display the result

echo $this->getMessagesBlock()->getGroupedHtml();

And here we are: we have now a new controller that displays result of a multiplication.

Magento E-commerce features :)

Checkout the features list :

http://www.magentocommerce.com/product/features

while development is ongoing @ magento developer need to see what’s going wrong …while we see Exception printing is disabled by default for security reasons. … such message.

to enable this error display follow

1. Go MagentoRoot/errors/

2. Copy local.xml.sample – and create local.xml @ MagentoRoot/errors/local.xml

Now the error message will show and you can easy debug the system. Very easy :) hah

Speed up your store by combining, compressing and caching JS and CSS. The extension  ( Fooman Speedster )reworks how Magento handles the loading of JavaScript and CSS. It utilises the Minify library developed by Steve Clay and released under a BSD license.

Fooman Speedster

View full article »

Magento Admin menus not work some times?

Change the permissions of the folder “js” and the file “js/proxy.php” to 755 fixes the problem.

if still not wok then.. http://www.magentocommerce.com/boards/viewthread/4679/P30/#t17628 by Scend

For Beginner working with magento theme for the first time some times confuse the developer when categories are not shown.

Go : admin->Catalog->Manage Categories  and select your root category and make sub-categories.

if you change the root categories then Make sure that ROOT is the “Root Category” of your site

You can check it in Admin > System > Manage Store > Edit Store

You need to read more about categories :)

http://www.magentocommerce.com/knowledge-base/entry/tutorial-creating-and-managing-categories

after adding a product it, still not shown.??? ——-ok you should confirm that the product inventory In-Stock is selected, ant the quantity also :D … its bit confusing but once you get the problem … no hassle for future..

clear cache from admin->system->cache management : : to check the recent update… you can download Magento Developer toolbar also for quick cache clear :)

Follow

Get every new post delivered to your Inbox.