Esta semana tive o seguinte desafio: customização do ambiente administrador (ou “admin”, ou “backend”) do Magento. Em uma primeira vista, tem-se a impressão de que o backend do Magento (cheio de campos obrigatórios as vezes não tão necessários, ou vazio de informações instrucionais para funcionalidades importantes, como preferir) não foi feito pra ser tão facilmente customizado como o frontend, principalmente pela falta da IMPORTANTE opção de se ligar os “Template Hints”, ou “Dicas de caminho de modelo”. O primeiro passo para se alterar alguma parte do layout/design do backend do Magento é descobrir em que arquivo cada parte está, porém sem a possibilidade das “template hints” a coisa complica um pouco mais.

* Esta opção fica dentro de Sistema->Configuração->Desenvolvedor. Alterando-se o Escopo para o website atual, tem-se opções para ligar as “Dicas de caminho de modelo”, porém isso só funciona para o frontend.

Eu recomendo que, antes de tudo, o cache do Magento seja desligado e devidamente limpo. Continuando, primeiro faça um backup dos arquivos do tema “default”. O método que utilizei é meio agressivo e pode danificar os arquivos do template. Enfim, para se conseguir um efeito parecido no backend, tive a seguinte abordagem (Magento 1.3.2.2):

1. Encontre um editor que faça substituição de texto em massa. Eu utilizei o já descontinuado, porém muito bom, Macromedia Homesite. Nele temos a opção “Extended Replace” que fará o trabalho.
2. Todos os arquivos do template default do backend (ao menos não encontrei um que não tenha até agora) tem um comentário logo no início, sobre a licença e etc., será esse texto que tuilizaremos como base da nossa mudança.
3. Você irá procurar por:

   <?php
   /**
   * Magento
   *
   * NOTICE OF LICENSE
   

   Em todos os arquivos (incluindo subdiretórios) do diretório /app/design/adminhtml/default/default/template/ e substituirá por:

   <?php
   
   echo "<div style='border: 1px solid red;'>".__FILE__."</div>";
   
   ?><?php
   /**
    * Magento
    *
    * NOTICE OF LICENSE
   

4. Se tudo der +ou- certo, você verá uma tela assim:
5. Devolta ao admin, temos o seguinte resultado:

Pronto, seu admin já tem todas as dicas necessárias para se começar a descobrir onde e o que alterar. Dicas:

• Se você colocar um if antes do echo, você pode controlar a impressão ou não das hints com uma simples variável de controle. Esta variável pode, por exemplo, estar dentro de index.php.
• Caso não queira inserir este “echo” dentro dos arquivos do template que terá seu layout modificado, trabalhe com 2 instalações ou 2 temas diferentes para o admin. No meu caso, eu trabalhei com uma instalação local diferente da que seria modificada. Assim você pode ter um tema ligado só para descobrir caminhos.

Edit: Acabei descobrindo um outro jeito muito bom neste link: http://classyllama.com/magento/development/enable-templateblock-hints-in-admin-panel/. Em resumo seria:
1) Conecte-se ao banco;
2) Execute esta query:

INSERT INTO core_config_data (scope, scope_id, path, value)
VALUES ('default', 0, 'dev/debug/template_hints', 1),
('default', 0, 'dev/debug/template_hints_blocks', 1);

Feito! Para desligar os hints abra a tabela core_config_data table e mude a coluna “value” da linha que você adicionou para o valor “0″.

T+!