{"id":835050,"date":"2026-02-26T13:54:29","date_gmt":"2026-02-26T13:54:29","guid":{"rendered":"https:\/\/www.knowband.com\/blog\/?p=835039\/"},"modified":"2026-03-10T13:22:39","modified_gmt":"2026-03-10T13:22:39","slug":"como-usar-o-sistema-de-overrides-do-prestashop-sem-quebrar-o-core","status":"publish","type":"post","link":"https:\/\/www.knowband.com\/blog\/pt-br\/prestashop-pt-br\/como-usar-o-sistema-de-overrides-do-prestashop-sem-quebrar-o-core\/","title":{"rendered":"Como usar o sistema de sobrescrita do PrestaShop sem comprometer o n\u00facleo do sistema."},"content":{"rendered":"

O sistema de sobrescrita do PrestaShop permite personalizar o comportamento principal sem alterar os arquivos originais. No entanto, usado de forma descuidada, ele cria lojas fr\u00e1geis que quebram ap\u00f3s atualiza\u00e7\u00f5es. Este guia da Knowband aborda como as sobrescritas funcionam, quando us\u00e1-las e tr\u00eas armadilhas cr\u00edticas que todo desenvolvedor deve conhecer.<\/span><\/p>\n

O que \u00e9 o sistema de sobreposi\u00e7\u00e3o?<\/b><\/h2>\n

O PrestaShop utiliza heran\u00e7a PHP para permitir que voc\u00ea substitua qualquer classe principal por sua pr\u00f3pria vers\u00e3o, sem alterar as originais. Cada classe principal recebe o sufixo “Core”, por exemplo, `ProductCore`. Se voc\u00ea criar o arquivo `\/override\/classes\/Product.php` com uma classe chamada `Product` que estende `ProductCore`, o PrestaShop carregar\u00e1 sua vers\u00e3o. O mesmo se aplica aos controladores.<\/span><\/p>\n

Substitua apenas os m\u00e9todos espec\u00edficos que voc\u00ea precisa alterar; nunca copie um arquivo de classe inteiro. Isso mant\u00e9m sua substitui\u00e7\u00e3o enxuta e muito menos propensa a conflitos com atualiza\u00e7\u00f5es futuras.<\/span><\/p>\n

Por exemplo, expondo o nome do controlador atual no seu modelo de cabe\u00e7alho:<\/span><\/p>\n

Onde colocar seus arquivos de sobreposi\u00e7\u00e3o<\/b><\/h2>\n

As configura\u00e7\u00f5es personalizadas podem estar em dois locais. O diret\u00f3rio global `\/override\/` na raiz da sua instala\u00e7\u00e3o fica ativo imediatamente ap\u00f3s a limpeza do cache. A melhor abordagem \u00e9 agrupar as configura\u00e7\u00f5es personalizadas dentro de um m\u00f3dulo.<\/span><\/p>\n

Colocar um arquivo de sobrescrita dentro de um m\u00f3dulo (por exemplo, \/modules\/mymodule\/override\/classes\/Product.php) faz com que o PrestaShop o copie para \/override\/ durante a instala\u00e7\u00e3o e o remova completamente durante a desinstala\u00e7\u00e3o. Esta \u00e9 a abordagem recomendada.<\/span><\/p>\n

Um exemplo r\u00e1pido de sobrescrita de classe. Digamos que voc\u00ea queira expor o nome do controlador atual no seu modelo de cabe\u00e7alho:<\/span><\/p>\n

\/\/ \/override\/classes\/controllers\/FrontController.php<\/span>\r\n\r\nclasse FrontController estende FrontControllerCore {<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0fun\u00e7\u00e3o p\u00fablica initHeader() {<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0self::$smarty->assign('currentController', get_class($this));<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0retornar parent::initHeader();<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0}}<\/span>\r\n\r\nSempre chame o m\u00e9todo pai, a menos que tenha um motivo espec\u00edfico para n\u00e3o faz\u00ea-lo. Ignor\u00e1-lo quebrar\u00e1 silenciosamente a funcionalidade principal.<\/span><\/pre>\n
Sobrescrita de classes e controladores de m\u00f3dulos<\/b><\/h2>\n
A partir do PrestaShop 1.6, voc\u00ea tamb\u00e9m pode sobrescrever classes de m\u00f3dulos. Adicione “Override” ao nome da classe (por exemplo, BlockUserInfoOverride estendendo BlockUserInfo) e coloque-a em \/override\/modules\/. O mesmo padr\u00e3o se aplica aos controladores de m\u00f3dulos. Ap\u00f3s qualquer sobrescrita, limpe o cache, especificamente exclua o arquivo \/cache\/class_index.php, ou as altera\u00e7\u00f5es n\u00e3o ter\u00e3o efeito.<\/span><\/p>\n
Quando N\u00c3O usar substitui\u00e7\u00f5es<\/b><\/h2>\n
As sobrescritas s\u00e3o exclusivas \u2014 s\u00f3 pode existir uma por classe. Elas tamb\u00e9m s\u00e3o proibidas em m\u00f3dulos do marketplace e devem ser reservadas para personaliza\u00e7\u00f5es privadas da loja. Antes de recorrer a uma sobrescrita, considere uma destas alternativas:<\/span><\/p>\n