Layout of your custom controller in Magento?

Layout of your custom controller in Magento?

When you work with custom (your own) controllers in Magento,
either frontend or backend, you will probably also use existing blocks and models or if needed write your own classes.
But what happens if you want to or have exigency to move/remove common blocks?
Can you really “design” your own page view without touching Cascading Style Sheets?

Acctually, yes you can, as a matter of fact on a pretty easy way.
All you need to know the handles of your controllers.
You know what handles are, right ?

To get handle of your controller, you will need some debugging techniques.
In action of your controller insert line:


It works for admin and frontend cotrollers in a same way.
And your custom action will look something like this:

public function indexAction()

In your browsers output you will get something like this:
Frontend controller

array(5) {
[0] => string(7) "default"
[1] => string(13) "STORE_default"
[2] => string(29) "THEME_frontend_default_hybrid"
[3] => string(29) "inchoo_developers_index_index"
[4] => string(19) "customer_logged_out"

Admin controller:

array(4) {
[0] => string(7) "default"
[1] => string(11) "STORE_admin"
[2] => string(30) "THEME_adminhtml_default_inchoo"
[3] => string(28) "adminhtml_switch_index_index"

You need value of 4th key of an arrays.

[3] => string(29) "inchoo_developers_index_index"


[3] => string(28) "adminhtml_switch_index_index"

Now, when you know the handles you can start working with your layout xml files.
All you need is to create “local.xml” file in layout folder of your theme (frontend or admin) and do the updates.
In my, simple, example I have removed headers and footers on both, frontend and admin controllers.

Frontend example:
file: app/design/frontend/default/default/layout/local.xml

< ?xml version="1.0"?>
<!-- /** * Magento * * @category Inchoo * @package Inchoo_Developers * @author Vedran Subotic - */ -->

Admin example:
file: app/design/adminhtml/default/default/layout/local.xml

< ?xml version="1.0"?>
<!-- /** * Magento * * @category Inchoo * @package Inchoo_Developers * @author Vedran Subotic - */ -->

My working example can see and download:
Inchoo Developers module.
I was using custom layout update files and you can find them in the theme folders of modules, not local.xml.

Note: try to change router of frontend controller in etc/config.xml file of module and see how debugging output behaves.

Enjoy coding!

You made it all the way down here so you must have enjoyed this post! You may also like:

Add Pagination to Custom Collection in Magento Dario Trbovic
Dario Trbovic, | 7

Add Pagination to Custom Collection in Magento

Adding custom credit card type to your payment method in Magento Toni Peric
Toni Peric, | 2

Adding custom credit card type to your payment method in Magento

Programmatically add a custom block in Magento Admin Kristijan Glibo
Kristijan Glibo, | 4

Programmatically add a custom block in Magento Admin


  1. @Verdran. can you please guide me how to write updates in xml for all action of a controller
    e.g. I want to add css and js files on all actions of
    checkout/onepage controller.




    work ??

  2. Please help me, i created my own theme and local.xml file which i use to modify my layout but whatever the changes am doing don’t reflect into my website still under development,not yet live please help.

  3. All is there : the name of the layout must match the path of the controller…. so much time wasted before reading your post !

    Thanks !!

  4. Thanks for the hint, that filled the gap I was searching for a day. A bit strange, that this isn’t mentioned in all the basic-module-setup-tutorials, ’cause loading a template for your module seems to be a very basic need.
    The tutorial on the suggests the handle is the module-name with _index_index behind, but without the namespace, which turns out to be required… but when you suggest to ask the getHandles()-function the principle behind this seems to be more complicate – it still would be nice to understand.
    …still not getting the principle, but a step further,

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <blockquote cite=""> <code> <del datetime=""> <em> <s> <strike> <strong>. You may use following syntax for source code: <pre><code>$current = "Inchoo";</code></pre>.

Tell us about your project

Drop us a line. We'd love to know more about your project.