Saturday, May 7

How to create a custom module in magento

Here is the steps to create the module in Magento

Step: 1

Inform Magento that you have a custom module.
app/etc/modules/Fido_All.xml Notice the _All in the xml file name. I can declare all of my modules here.
<?xml version="1.0"?>
<config>
<modules>
<fido_example>
<active>true</active>
<codepool>local</codePool>
</Fido_Example>
</modules>
</config>

Step: 2

Need to create directories as necessary.
app/code/local/Fido/Example/etc/config.xml

<?xml version="1.0"?>
<config>
<modules>
<fido_example>
<version>0.1.0</version>
</Fido_Example>
</modules>
<global>
<blocks>
<fido_example>
<class>Fido_Example_Block</class>
</fido_example>
</blocks>
</global>
</config>

I have informed Magento of my module version (it’s an arbitrary version). Version matters when you set up your module to be update-able. (A newer version will inform Magento to run the update files if you have them).
I have also informed Magento that my module contains block files which are found in fido/example/block. My class name will have “Fido_Example_Block”. If you want to see the many possibilities of stuff that goes in here, check out Mage config files (such as Catalog/etc/config.xml). You’ll also see other xml files in there. Those explanations are for another post.

Step: 3

Here is my block code. It doesn’t really do anything, but shows some functionality.
app\code\local\Fido\Example\Block\View.php

<?php
/**
* Example View block
*
* @codepool   Local
* @category   Fido
* @package    Fido_Example
* @module     Example
*/
class Fido_Example_Block_View extends Mage_Core_Block_Template
{
private $message;
private $att;

 
protected function createMessage($msg) {
$this->message = $msg;
}

 
public function receiveMessage() {
if($this->message != '') {
return $this->message;
} else {
$this->createMessage('Hello World');
return $this->message;
}
}

 
protected function _toHtml() {
$html = parent::_toHtml();

 
if($this->att = $this->getMyCustom() && $this->getMyCustom() != '') {
$html .= '
'.$this->att;
} else {
$html .= '
No Custom Attribute Found';
}

 
return $html;
}
}

The function receiveMessage() just returns “Hello World”
The function _toHtml() is responsible for outputting the template associated with the block. Make sure you run paret::_toHtml and return it as part of any other items returned in that function!

Step: 4
Here we create our template (phtml) file.
app\design\frontend\default\fido\template\example\view.phtml

<?php
 
/**
* Fido view template
*
* @see Fido_Example_Block_View
*
*/
?>
<div>
<span><strong>This is the output of the fido example:</strong></span>
<span style="color:#FF9933;">
<?php
echo $this->receiveMessage();
?>
</span>
</div>

This just outputs some HTML and also runs the receiveMessage() function from our block (view.php).

Two caveats here. By placing our view.phtml file in it’s location, we have created our own theme. You must make sure that

a) Magento knows about your theme (Admin->System->Design)
and

b) If you use the this block in a CMS page, you set the CMS page to use your theme (Admin->CMS->Manage Pages->’Your Page’->Custom Design->Custom Theme drop down)
You’re custom module is now ready for use.
In a cms page, add this to your content:

{{block type="fido_example/view" my_custom="Test" template="example/view.phtml" }}

Or something like this in the Layout Update XML area (Custom Design area in a CMS page)





//this will add your block in the right column
Now you can successfully have your block and the Hello World message being displayed (on your CMS page).


Hope it Helps! Thanks..

1 comment: