Override en Prestashop

Definición:

Override es el sistema que tiene Prestashop para proteger aquellos archivos considerados modificados: clases y controladores (php) son de los más importantes, ya que, si añades o modificas alguna función en el fichero original y se te ocurre actualizar Prestashop… ¡adiós! Todos los cambios que hayas realizado en ese archivo se borrarán.

Técnica del Override para los archivos .php:

La técnica del override en Prestashop consiste en la creación de un nuevo archivo que lleve dentro una clase que extienda de la original, cuya información sustituirá a la del archivo original, siempre y cuando, el nombre de la función o instrucción coincida con la del archivo original.

Técnica del Override para los módulos:

En la carpeta de tienda/themes/nombre_del_tema/modules/ se guardan una copia del modulo entero o de ciertos archivos para modificarlos desde ahí, en lugar del original tienda/modules/. Si existe una carpeta en dicha dirección, Prestashop lo leerla sobre el original, pero las actualizaciones solo serán en la carpeta original. Si no ves alguna actualización del modulo, borra la carpeta del override ;)

Ejemplo añadir al formulario un ¿como nos conociste?:

TPL

Me dirijo a /themes/nombre_del_tema/authentication.tpl. Ya que los tpl, no tienen clases y funciones, nos toca hacerlo así.Ahí añadimos las veces que corresponda el siguiente texto:

<div form-group>

<label class="control-label col-sm-4">{l s='¿Como nos conoció?'}</label>

<div class="col-sm-6">

<input type="radio" id="conocer" name="conocer" value="amigo"  class="conocer"> {l s = 'A través de un amigo' } <br>

<input type="radio" id="conocer" name="conocer" value="google"  class="conocer"> {l s = 'Buscando en Google' } <br>

<input type="radio" id="conocer" name="conocer" value="blog"  class="conocer"> {l s = 'A través del blog Ofertitas' } <br>

<input type="radio" id="conocer" name="conocer" value="foro"  class="conocer"> {l s = 'A través de un foro' } <br>

<input type="radio" id="conocer" name="conocer" value="twitter"  class="conocer"> {l s = 'A través de las redes sociales' } <br>

<input type="radio" id="conocer" name="conocer" value="otros"  class="conocer"> {l s = 'De otra forma' } <br>

<div class="col-sm-6">

<label class="control-label col-sm-8">{l s='¿De que otra forma?'}</label>

<input type="text" class="is_required validate form-control" data-validate="conocerOtro" id="conocerOtro" name="conocerOtro" value="{if isset($smarty.post.conoceOtro)}{$smarty.post.conoceOtro}{/if}" /><br>

</div>

</div>

</div>

Para tener la última referencia de las plantillas recomiendo un control de versiones.

Y una documentación, comentando las actualizaciones. 

Nos queda así:

El CSS seguiría los mismos pasos que los archivos.tpl

PHP

Ahora llega lo interesante.

Original (controllers/front/AuthController.php)

class AuthControllerCore extends FrontController

{

}

Override (override/controllers/front/AuthController.php)

class AuthController extends AuthControllerCore

{

}

En este archivo es donde guardamos la acción del boton, que nos guardara la información del formulario.

Si buscas submit en el tpl modificado, encontraras que existen 4 botones, del cual, según mi plantilla, necesitare 2 (submitGuestAccount y submitAccount). Investigando el documento vemos la función:

Original (controllers/front/AuthController.php)

class AuthControllerCore extends FrontController

{

          protected function processSubmitAccount()

          {

                    //función original

           }

}

Override (override/controllers/front/AuthController.php)

class AuthController extends AuthControllerCore

{

           protected function processSubmitAccount()

          {

                    //código a añadir:

                  $customer = new Customer();

                  $conocer = Tools::getValue('conocer');

                  $conocerOtro=Tools::getValue('conocerOtro');

                  $customer->referralcode = $conocer;

                  $customer->referralcode = $conocerOtro;

                  $this->context->cookie->customer_referralcode = $customer->$conocer;

                  $this->context->cookie->customer_referralcode = $customer->$conocerOtro;

                   //para que el resto de la función en la original también se ejecute

                    parent::processSubmitAccount();

           }

}

Podrás ver si funciona con la siguiente "marquita"

Ahora definimos los nuevos campos y los añadimos al objeto customer

Original (classes/Customer.php)

class CustomerCore extends ObjectModel

{

}

Override(override/classes/Customer.php)

class Customer extends CustomerCore

{

    //declaración:

    public $conocer;

    public $conocerOtro;

//definición del objeto:
como no es una función que se pueda 'separar' la creamos entera
public static $definition = array(
        'table' => 'customer',
        'primary' => 'id_customer',
        'fields' => array(
            'secure_key' => array('type' => self::TYPE_STRING, 'validate' => 'isMd5', 'copy_post' => false),
            'lastname' => array('type' => self::TYPE_STRING, 'validate' => 'isName', 'required' => true, 'size' => 32),
            'firstname' => array('type' => self::TYPE_STRING, 'validate' => 'isName', 'required' => true, 'size' => 32),
            'email' => array('type' => self::TYPE_STRING, 'validate' => 'isEmail', 'required' => true, 'size' => 128),
            'passwd' => array('type' => self::TYPE_STRING, 'validate' => 'isPasswd', 'required' => true, 'size' => 32),
            'last_passwd_gen' => array('type' => self::TYPE_STRING, 'copy_post' => false),
            'id_gender' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId'),
            'birthday' => array('type' => self::TYPE_DATE, 'validate' => 'isBirthDate'),
            'newsletter' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool'),
            'newsletter_date_add' => array('type' => self::TYPE_DATE,'copy_post' => false),
            'ip_registration_newsletter' => array('type' => self::TYPE_STRING, 'copy_post' => false),
            'optin' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool'),
            'website' => array('type' => self::TYPE_STRING, 'validate' => 'isUrl'),
            'company' => array('type' => self::TYPE_STRING, 'validate' => 'isGenericName'),
            'siret' => array('type' => self::TYPE_STRING, 'validate' => 'isSiret'),
            'ape' => array('type' => self::TYPE_STRING, 'validate' => 'isApe'),
            'outstanding_allow_amount' => array('type' => self::TYPE_FLOAT, 'validate' => 'isFloat', 'copy_post' => false),
            'show_public_prices' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool', 'copy_post' => false),
            'id_risk' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedInt', 'copy_post' => false),
            'max_payment_days' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedInt', 'copy_post' => false),
            'active' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool', 'copy_post' => false),
            'deleted' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool', 'copy_post' => false),
            'note' => array('type' => self::TYPE_HTML, 'validate' => 'isCleanHtml', 'size' => 65000, 'copy_post' => false),
            'is_guest' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool', 'copy_post' => false),
            'id_shop' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'copy_post' => false),
            'id_shop_group' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'copy_post' => false),
            'id_default_group' => array('type' => self::TYPE_INT, 'copy_post' => false),
            'id_lang' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'copy_post' => false),
            'date_add' => array('type' => self::TYPE_DATE, 'validate' => 'isDate', 'copy_post' => false),
            'date_upd' => array('type' => self::TYPE_DATE, 'validate' => 'isDate', 'copy_post' => false),
            'conocer' =>                    array('type' => self::TYPE_STRING, 'validate' => 'isName', 'size' => 100),
            'conocerOtro' =>                array('type' => self::TYPE_STRING, 'validate' => 'isName', 'size' => 100),
        ),

    );

}

Por último modifico la base de datos:

ALTER TABLE `pp_customer`

ADD `conocer` VARCHAR( 100 );

ALTER TABLE `pp_customer`

ADD `conocerOtro` VARCHAR( 100 );

Para hacer la prueba es recomendable tener activado el aviso de errores.

En config/defines.inc.php

/* Debug only */

if (!defined('_PS_MODE_DEV_'))

define('_PS_MODE_DEV_', true);

Al hacer la prueba veo que se ha enfadado el smarty

Busco en el foro de prestashop, y la solución es borrar cache, obligar a compilar y si sigue fallando quitar el depurador de errores, ya que no es un error grave o que nos pueda afectar. Más info aquí y aquí.

También recomiendo esta léctura sobre ObjectModel, del cual creare una entrada más adelante. Con más ejemplos. Así como subiré como hacer para que se vea la nueva información en el backOffice (administración).

Por último la prueba final: