En este artículo presentaremos los lineamientos básicos para la creación de módulo en prestashop versión 1.6.1 en él se encontrarán los conocimientos necesarios para utilizar las clase y funciones que utiliza el motor de prestashop para poder incluirlas en nuestro módulo a crear, hay que tomar en cuenta algunas consideraciones y que es necesario realizarlo de esa manera y no de ninguna otra forma puesto que prestashop lo necesita de esa manera para poder reconocerla, como son la identificación de la carpeta y de los archivos del módulo, así como hay que respetar el nombre de las clases que utilizamos.
Manos a la obra, vamos a empezar creando un módulo que actualizará el stock por medio de un archivo plano, es decir en este archivo plano contendrá los códigos de los artículos y el stock actual de cada producto, el cual debe actualizar la base de datos del prestashop de su respectivo producto.
El módulo llevará por nombre stock, entonces creamos una carpeta llamada del mismo nombre y ésta la colocaremos dentro de la carpeta modules junto al resto de módulos que tengamos instalados, el archivo principal llevará el mismo nombre es decir stock.php ya dentro de ella se puede crear más carpetas y archivos según sea necesarios. Con lo que quedaría más o menos según la siguiente imagen
Explicando más a fondo, la carpeta de nuestro modulo llamado stock, que contiene lo siguiente:
CSS Es la carpeta encargada de contener los archivos de hoja de estilo el cual le dará el diseño adecuado a nuestro módulo.
FILES. En ella se almacenará los archivos procesados por nuestro modulo necesarios para la actualización del stock
VIEWS. Un Carpeta que a su vez contiene la subcarpeta templates y esta la carpeta front, en ella tendrá los archivos de la plantilla los .tpl, es decir los formulario que necesita para recoger los datos del usuario.
LOGO.PNG. Es la imagen que identificará al módulo en lista del repositorio de prestashop
STOCK.PHP. Es el archivo propiamente del módulo encargado de inicializar todas las clases e interrelacionarse con el motor de prestashop
Descripción del archivo principal stock.php
Como se puede observar en la imagen se define la clase stock (Nombre también de nuestro módulo y esto tiene que ser así, regla del prestashop).
A continuación se define el método constructor, aquí se define el nombre del módulo, a que categoría pertenece (tab), nombre del autor, versión del módulo y las versiones con las que es compatible, Luego título del módulo y una pequeña descripción.
Más o menos quedaría como la figura a continuación.
Continuamos describiendo el archivo stock.php
Dentro del método getContent. Es donde se programa toda la lógica del módulo,
Se empieza mostrando el nombre del módulo en formato de cabecera H2
Luego realiza la pregunta si el usuario a presionado el botón enviar y a continuación ejecutará el método _postValidation(); el cual también debemos definirlo y agregarle el código correspondiente.
Si no hay errores se continúan procesando los datos del formulario con el método _postProcess(). De lo contrario muestra el conjunto de errores que provoco la acción del usuario al dar click en el botón guardar del formulario.
Y siempre que se abra este método mostrará el formulario con el método _displayForm()
Es así como se define la estructura básica de un módulo para prestashop, en los próximos artículos se explicará cosas específicas como guardar los datos en las tablas o realizar consultas de actualización en la base de datos, creación de formularios y muchas cosas más útiles para la creación de módulos.