Campos personalizados en formularios de edición para Prestashop 1.7

22 junio

por Maya Rodriguez Santiago

En este artículo vamos a hablar sobre la creación de módulos en Prestashop 1.7 y más concretamente hablaremos sobre la creación de campos personalizados en formularios de edición.

Cuando estamos creando módulos en Prestashop, la creación de formularios de edición es fundamental, ya que mediante esta edición podemos interactuar con los datos que guardamos: leerlos, actualizarlos…

Para la creación de formularios de edición en Prestashop, necesitamos utilizar la clase HelperForm. Esta clase nos ofrece unos tipos de campos concretos: ‘text’, ‘select’, ‘textarea’, ‘radio’, ‘checkbox’, ‘file’, ‘shop’, ‘asso_shop’, ‘free’, ‘color’.

Esta sería una declaración de campo básico, campo de texto, para un formulario de edición:

$this->fields_form[0]['form']['input'] = array(
	array(
            	'type' => 'text',
                'label' => $this→l('Nuevo campo de pruebas básico'),
                'name' => 'AVANZA_TEST_BASICO',
              )   
);

$this->fields_form[0]['form']['input'] = array(

array(

'type' => 'text',

'label' => $this→l('Nuevo campo de pruebas básico'),

'name' => 'AVANZA_TEST_BASICO',

)

);

Pero además de crear campos básicos, puede que necesitemos crear algún tipo de campo especial, que podamos personalizar, para que trabaje de una forma concreta… distinto a los que Prestashop nos ofrece por defecto.

Esto se realizaría de la siguiente forma para módulos creados utilizando “Modelo – Vista – Controlador”. La estructura MVC se encarga de separar la lógica de negocio de la interfaz de usuario, para seguir esta estructura en la creación de módulos, tendremos que crear las siguientes carpetas dentro del módulo:

mimodulo/models
mimodulo/views/templates/admin/_configure/helpers/form
mimodulo/controllers/admin

El ejemplo que vamos a mostrar, crea un campo personalizado, que nos servirá para seleccionar artículos con un ‘autocomplete’ y retornarlos en el mismo campo personalizado, para posteriormente excluirlos en un proceso concreto.

Sigue estos sencillos pasos:

1.- Dentro de la carpeta del controlador (mimodulo/controllers/admin/AdminAvanzaTestController.php), donde creamos el formulario de edición, introducimos el siguiente código:

$this->fields_form[0]['form']['input'] = array(
	array(
            	'type' => 'AVANZA_TEST_PERSONALIZADO',
                'label' => $this→l('Nuevo campo de pruebas'),
                'name' => 'AVANZA_TEST_PERSONALIZADO',
                'values' => array(
                  	0 => $this->products_ele                                           
                ) 
              )   
);

$this->fields_form[0]['form']['input'] = array(

array(

'type' => 'AVANZA_TEST_PERSONALIZADO',

'label' => $this→l('Nuevo campo de pruebas'),

'name' => 'AVANZA_TEST_PERSONALIZADO',

'values' => array(

0 => $this->products_ele

)

);

Este código nos crea un campo llamado AVANZA_TEST_PERSONALIZADO, el cual vamos a personalizar en el siguiente paso.

2.- Dentro de la carpeta de vista (mimodulo/views/templates/admin/_configure/helpers/form/form.tpl) introducimos el siguiente código, que será el que nos dé los datos a mostrar y la funcionalidad autocomplete del campo.

{block name="input_row"}
    {if $input.type == 'AVANZA_TEST_PERSONALIZADO'}
            <div class="row">
                {assign var=test_prod_val value=$input.values} 
                                                                                
                {if isset($test_prod_val) && count($test_prod_val) > 0}            
                
                    <div class="form-group" {if isset($tabs) && isset($input.tab)} data-tab-id="{$input.tab}"{/if}>
                        <label class="control-label col-lg-3" for="product_autocomplete_input">
                            <span class="label-tooltip" data-toggle="tooltip" title="" data-original-title="Puede indicar productos para excluirlos. Escriba las primeras letras del nombre del producto, después elija el producto en el menú desplegable.¡No olvide guardar los cambios al terminar!">                            
                            {l s='Products to exclude' mod='avanzatest'}
                            </span>
                        </label>
                        <div class="col-lg-5">
                            <input name="inputAccessories" id="inputAccessories" value="{foreach $test_prod_val[0] as $key => $ltest_prod_val}{$ltest_prod_val@key}-{/foreach}" type="hidden">
                            <input name="nameAccessories" id="nameAccessories" value="{foreach $test_prod_val[0] as $key => $ltest_prod_val}{$ltest_prod_val}¤{/foreach}" type="hidden">
                            <div id="ajax_choose_product">
                                <div class="input-group">
                                    <input id="product_autocomplete_input" name="product_autocomplete_input" autocomplete="off" class="ac_input" type="text">
                                    <span class="input-group-addon"><i class="icon-search"></i></span>
                                </div>
                            </div>                                                        

                            <div id="divAccessories">
                                {foreach $test_prod_val[0] as $ltest_prod_val}
                                
                                    <div class="form-control-static">
                                        <button type="button" class="btn btn-default delAccessory" name="{$ltest_prod_val@key}">
                                            <i class="icon-remove text-danger"></i>
                                        </button>
                                        {$ltest_prod_val@key|escape:'html':'UTF-8'} - {$ltest_prod_val|escape:'html':'UTF-8'}
                                    </div>
                                    
                                {/foreach}
                            </div>
                        </div>
                    </div>     
                    
                
                    
                {/if}
                
            </div>
      {/if}
{/block}

{block name="input_row"}

{if $input.type == 'AVANZA_TEST_PERSONALIZADO'}

{assign var=test_prod_val value=$input.values}

{if isset($test_prod_val) && count($test_prod_val) > 0}

{l s='Products to exclude' mod='avanzatest'}

</span>

</label>

<input name="inputAccessories" id="inputAccessories" value="{foreach $test_prod_val[0] as $key => $ltest_prod_val}{$ltest_prod_val@key}-{/foreach}" type="hidden">

<input name="nameAccessories" id="nameAccessories" value="{foreach $test_prod_val[0] as $key => $ltest_prod_val}{$ltest_prod_val}¤{/foreach}" type="hidden">

</div>

{foreach $test_prod_val[0] as $ltest_prod_val}

</button>

{$ltest_prod_val@key|escape:'html':'UTF-8'} - {$ltest_prod_val|escape:'html':'UTF-8'}

</div>

{/foreach}

</div>

{/if}

</div>

{/if}

{/block}

3º.- El tratamiento de estos datos se realizaría de nuevo en la carpeta del controlador (mimodulo/controllers/admin/AdminAvanzaTestController.php).
Introducimos el siguiente código:

$prods = Tools::getValue('AVANZA_TEST_PERSONALIZADO', Configuration::get('AVANZA_TEST_PERSONALIZADO'));        
        
$prods_amp = explode("-", $prods);
        
foreach ($prods_amp as $prod)
{
	if ($prod) {        
                $this->products_ele[$prod] = Product::getProductName($prod);                
            }
}

$prods = Tools::getValue('AVANZA_TEST_PERSONALIZADO', Configuration::get('AVANZA_TEST_PERSONALIZADO'));

$prods_amp = explode("-", $prods);

foreach ($prods_amp as $prod)

{

if ($prod) {

$this->products_ele[$prod] = Product::getProductName($prod);

}

De esta forma hemos conseguido crear un campo de una forma y características concretas… y de forma relativamente sencilla.

Al igual que hemos creado este campo, podemos crear cualquier otro campo que necesitemos dándole las características y funcionamiento necesarios.

Categorías:Desarrollo Web