Página CMS en la homepage sin modificar el core

ignacio96

Hola a todos,

Estoy intentando mostrar el contenido de una página CMS específica directamente en la página de inicio de mi tienda. La idea es tener un bloque de texto que se gestione desde el panel de control de PrestaShop, pero que aparezca en la homepage.

Mi problema es que cada vez que intento hacerlo modificando el IndexController o directamente index.tpl, acabo con un código frágil que se rompe con las actualizaciones o que entra en conflicto con otros módulos. He intentado algo así en un override/controllers/front/IndexController.php:

class IndexController extends IndexControllerCore
{
    public function initContent()
    {
        parent::initContent();

        $id_cms_page = (int)Configuration::get('MI_CMS_HOMEPAGE_ID'); // ID de CMS desde configuración
        if ($id_cms_page) {
            $cms = new CMS($id_cms_page, $this->context->language->id);
            if (Validate::isLoadedObject($cms)) {
                $this->context->smarty->assign([
                    'page_title' => $cms->meta_title,
                    'cms_home_content' => $cms->content,
                ]);
            }
        }
        $this->setTemplate('index.tpl');
    }
}

El problema es que, aunque cms_home_content se asigna, no sé cómo hacer que se renderice en la sección principal de index.tpl sin editar directamente la plantilla, lo cual quiero evitar. ¿Alguna idea de cómo integrar esto de forma limpia sin un override tan invasivo?

claudiahub

@ignacio96 ¿En qué versión de PrestaShop estás trabajando? Es importante saberlo porque las cosas cambian un poco entre versiones, especialmente si ya estás en PS 8 o 9.

Sobre tu código, el override del IndexController es un poco complicado de mantener. Como bien dices, te asigna la variable, pero luego tienes que modificar index.tpl para mostrarla. Si no quieres tocar index.tpl (que es lo ideal para futuras actualizaciones), necesitarías un hook o un módulo que inyecte ese contenido de manera más limpia. ¿Has mirado si hay algún hook disponible en la homepage que te permita añadir contenido?

Milo

@ignacio96 @claudiahub tiene razón. Sobreescribir IndexController para algo así no es lo más recomendable, ya que es uno de los controladores más propensos a conflictos y puede complicar las actualizaciones o la compatibilidad con otros módulos que también intenten modificar el comportamiento de la homepage.

En PrestaShop 1.7.x, la forma más limpia de añadir contenido a la página de inicio es a través del hook displayHome. Este hook está diseñado específicamente para inyectar bloques de contenido en la homepage sin necesidad de tocar el core ni el IndexController. Para esto, lo ideal es crear un pequeño módulo que implemente este hook y asigne el contenido de la página CMS.

Aquí te dejo un ejemplo de cómo sería el método hookDisplayHome dentro de tu módulo (suponiendo que tienes un módulo llamado mi_cms_homepage):

public function hookDisplayHome($params)
{
    $id_cms_page = (int)Configuration::get('MI_CMS_HOMEPAGE_ID'); // ID de CMS configurable

    if ($id_cms_page) {
        $cms = new CMS($id_cms_page, $this->context->language->id);

        if (Validate::isLoadedObject($cms)) {
            $this->context->smarty->assign([
                'cms_home_title' => $cms->meta_title,
                'cms_home_content' => $cms->content,
            ]);
            // Renderiza tu propia plantilla de módulo para mostrar el contenido
            return $this->display(__FILE__, 'views/templates/hook/mi_cms_homepage_block.tpl');
        }
    }
    return ''; // Devuelve vacío si no hay CMS configurada o válida
}

Dentro de views/templates/hook/mi_cms_homepage_block.tpl pondrías algo tan simple como:

<div class="cms-homepage-block">
    {if isset($cms_home_title)}
        <h3>{$cms_home_title}</h3>
    {/if}
    {if isset($cms_home_content)}
        {$cms_home_content nofilter}
    {/if}
</div>

De esta forma, puedes configurar el ID de la página CMS desde la configuración de tu módulo, y el contenido se inyectará en la homepage a través del hook displayHome. Si prefieres no desarrollar un módulo personalizado para esto, existen soluciones ya preparadas que te permiten gestionar página cms sin tocar el código core de forma más sencilla y con una interfaz de configuración en el Back Office.

ignacio96

¡Muchas gracias, @Milo! Estoy en PrestaShop 1.7.8.6 y la solución que propones con el hook displayHome en un módulo es exactamente lo que buscaba para hacerlo de forma más limpia. Tu ejemplo de código es perfecto y me ha aclarado cómo integrar la plantilla del módulo. Así evito los overrides directos que me estaban dando problemas.

He implementado el módulo siguiendo tus indicaciones y funciona a la perfección. Ahora puedo gestionar el contenido de la homepage desde una página CMS sin preocuparme por futuras actualizaciones. ¡De verdad, un alivio!