PrestaShop 1.6. Francisco Rodríguez Redondo

Transcripción

1 PrestaShop 1.6 Francisco Rodríguez Redondo 21 de julio de 2015

2 2

3 Índice general 1. Introducción Fundamentos del desarrollo en PrestaShop Aspectos básicos del desarrollo de PrestaShop Arquitectura técnica de PrestaShop (three-tier) El modelo La vista El controlador Algunas cuestiones sobre la base de datos La clase DBQuery La clase ObjectModel El dispacher Cómo añadir una nueva URL amigable Conguración de los enlaces Formato de los enlaces Los controladores en PrestaShop La clase FrontController Cómo sobreescribir un controlador Las vistas en PrestaShop Ficheros TPL en el tema utilizado Ficheros TPL en los módulos Sobreescribiendo un chero de la vista Trabajando con cookies Datos almacenados en una cookie de un cliente/visitante Datos almacenados en una cookie de empleado o administrador Trabajando con Hook Formas de trabajar con los Hook's Utilización de Hook's dentro de un controlador Utilización de Hook's dentro de un módulo Utilización de Hook's dentro de un Tema Incorporar el hook en un template Cómo crear un Hook Ayuda en la escritura de código Problema con el autocompletado de código en PrestaShop. 40 3

4 4 ÍNDICE GENERAL 2. Otras cuestiones Sobreescritura en PrestaShop Sobreescribiendo clases y controladores Sobreescribiendo una clase Sobreescribiendo un controlador Sobreescribendo el comportamiento de los módulos Cambiando estos comportamientos manualmente Ejemplos de código Sobreescribiendo la clase MySQLCore Sobreescribiendo la clase AdminTabCore Cómo usar jquery y jqqueryui Cómo añadir jquery Cómo añadir jqueryui Cómo incluir otros plugins Trabajar con bases de datos en PrestaShop Fundamentos Métodos disponibles insert() update() delete() execute() query() executes() getrow() getvalue() NumRows() Otros métodos La clase ObjectModel Cómo usar la clase AdminController en PrestaShop Bug al crear un nuevo CMS Crear una página nueva, fuera del CMS Los Helpers de PrestaShop Cómo utilizar la clase HelperForm Text input Selector Checkbox Radio button (botón de radio) Cómo utilizar la clase HelpersOptions Cómo utilizar la clase HelperList Usando helpers para sobreescribir un template del back-oce Algunos ejemplo Este apartado, se ha traducido de la siguiente dirección web: 2 Este apartado se ha traducido desde la siguiente dirección web:

5 ÍNDICE GENERAL Cómo utilizar un template de tipo helper dentro de un controlador Forma de sobreescribir un template de tipo helper Cómo sobreescribir un template ya existente Creación de Módulos en PrestaShop Administración de los módulos de PrestaShop Cómo añadir módulos a PrestaShop Creación manual de Módulos Ficheros de conguración de PrestaShop Estructura de directorios de un módulo Creando el primer módulo Introducir el constructor de la clase Añadiendo métodos para instalar y desinstalar El objeto Conguration El chero conteniendo el icono El chero cong.xml Añadir una página de conguración Mostrando el formulario Mostrando contenido en el front-oce de PrestaShop Algunas cuestiones sobre Smarty Smarty Instalación de Smarty Un primer ejemplo realizado con Smarty Los delimitadores de Smarty Sintaxis utilizada por Smarty Comentarios en Smarty Las variables en Smarty Las funciones y atributos en Smarty Trabajando con variables Variables denidas desde PHP Variables provenientes de Arrays asociativos Variables provenientes de Arrays con un índice numérico Variables que contienen objetos PHP Variables cargadas desde los archivos de conguración La variable reservada {$smarty} Los modicadores de las variables capitalize cat count-characters count_paragraphs count_words date_format lower

6 6 ÍNDICE GENERAL nl2br replace spacify string_format truncate upper Funciones integradas dentro de Smarty capture {foreach},{foreachelse} iteration rst last show total include insert if, elseif,else literal section, sectionelse index index_prev index_next iteration rst last rownum loop show total Concepto de herencia en Smarty Función {block} Función {extends} Función debug en PrestaShop Algunas variables importantes de Smarty en PrestaShop Los plugins de Smarty en PrestaShop Los objetos de PHP Denición de una clase en PHP Generar instancias de una clase Función constructor de una clase La herencia de clases en PHP Métodos o funciones de un objeto Herencia encadenada Valores y alcances de las variables Miembros públicos, privados y protegidos Métodos privados

7 ÍNDICE GENERAL Métodos protegidos Métodos públicos Las interfaces Las clases abstractas Clases con métodos estáticos Llamadas a funciones de la clase padre Serialización Funciones de manejo de clases A. Hooks de PrestaShop. 153 A.1. Nuevos Hook's desde la versió A.2. hook's del Front-oce A.2.1. Página principal y páginas generales A.2.2. Página de productos A.2.3. Página del carrito A.2.4. Página de búsqueda A.2.5. Selección de la página del carrito A.2.6. Página de pago A.2.7. Página de órdenes A.3. Hook's para el back-oce A.3.1. Hook's generales A.3.2. Órdenes y detalles de órdenes A.3.3. Productos A.3.4. Hook's para estadísticos A.4. Hook's para los clientes A.5. Hook's para carritos de la compra B. Otras utilidades para PHP. 161 B.1. PEAR B.2. Composer B.3. phpdocumentor C. Referencia rápida Smarty. 167 D. Sitios web interesantes. 171

8 8 ÍNDICE GENERAL

9 Prólogo. PrestaShop se conere como unos de los sistemas de código abierto más utilizados para la creación de tiendas online utilizadas en el comercio electrónico debido entre otras cosas a su facilidad de manejo y a la existencia de módulos, que permiten amplicar la enorme potencia que por defecto tiene PrestaShop. Sin embargo su verdadero potencial se encuentra en que al ser un sistema de código abierto, se puede modicar o ampliar su código, permitiendo obtener cualquier tipo de mejora o necesidad con la implementación del código necesario para ello. No obstante para poder conseguir esto último se necesita tener un conocimiento importante de desarrollo en PHP, así como el manejo de las clases que denen este sistema. Por otro lado, la propia página web de PrestaShop ofrece cierta información sobre estos aspectos de una forma muy resumida y además en inglés. Por todo ello y en vistas de las dicultades que todo esto pudiera tener para el colectivo de personas hispanohablantes, se ha desarrollado este pequeño manual que pretende dar a conocer las características básicas que reviste la programación en PrestaShop, de tal manera que permita adquirir al nal de la lectura del mismo, una serie de conceptos y habilidades básicas sucientes para poder a comenzar a desarrollar programas o módulos que permitan ampliar las funcionalidades que por defecto ofrece PrestaShop. 9

10 10 ÍNDICE GENERAL

11 Capítulo 1 Introducción a la programación en PrestaShop El estándar PrestaShop está escrito en lenguaje PHP y soportado bajo el gestor de base de datos MySQL, es sumamente exible y por consiguiente a las prestaciones que por defecto posee, se le pueden añadir otras muchas, bien mediante la utilización de los múltiples módulos que existen, o bien y teniendo determinados conocimientos de programación diseñar estos mismos módulos que permitan implementar las funcionalidades que necesitamos. El contenido de este documento está pensado en facilitar los conocimientos necesarios, como para que se puedan implementar mediante código ciertos programas en PrestaShop que permitan añadir funcionalidad necesaria y se adapte a las necesidades concretas de cada usuario Fundamentos del desarrollo en PrestaShop La construcción de PrestaShop está soportada bajo una plataforma muy exible y además mucha parte de su éxito se fundamenta en que la programación sobre la que se sustenta es fácil de construir y de expandir mediante la implementación o utilización de Módulos y mediante la posibilidad de sobreescribir código. Como ya se ha dicho anteriormente, PrestaShop está escrito básicamente sobre código PHP, pero también utiliza JavaScript, HTML, CSS, las etiquetas de Smarty, SQL, y XML. Igualmente se utiliza una arquitectura de tipo Modelo-Vista-Controlador ( conocido por las siglas MVC), que permite diferenciar y modular las cargas de trabajo entre los diferentes componentes que componen esa arquitectura. Igualmente, también utiliza otras tecnologías, tales como jquery, BootStrap, Sass, etc. Con esta guía, voy a intentar ir claricando cómo utilizar todo este conjunto de herramientas, para que puedan ser utilizadas de forma coherente y 11

12 12 CAPÍTULO 1. INTRODUCCIÓN poder construir elementos de apoyo con los que aumentar la potencialidad de PrestaShop Aspectos básicos del desarrollo de PrestaShop PrestaShop está desarrollado bajo una estructura que descansa especialmente en tres puntos básicos: 1. Los temas ( conocidos en inglés por Themes). Los temas son la parte de PrestaShop que se encarga de hacer la presentación en las páginas web correspondientes de todos los elementos de la tienda online. Dependiendo del tema que se utilice se podrá tener una u otra presentación de la tienda. Hay muchos temas desarrollados para PrestaShorp, unos gratuitos y la mayoría de pago. La mayor parte de los existentes hoy en día en el mercado se pueden descargar desde PrestaShop Addons, que es la tienda ocial de PrestaShop. La creación de temas no lo vamos a desarrollar en esta obra, pero te adelanto que debido a la gran cantidad de cheros que integran un tema de PrestaShop, lo que normalmente se hace es arrancar de un tema que guarde un perl de tienda que nos guste, y posteriormente y sobre todo mediante elementos CSS cambiar la presentación hasta conseguir el tema que se busca. 2. Los Módulos. Esta es una de las bazas fuertes de PrestaShop, pues gracias a estos módulos, podemos añadir al corazón de PrestaShop, cualquier tipo de funcionalidad añadida que deseemos. Tener presente que PrestaShop está construido bajo una estructura modular, y estos módulos son las partes integrantes de esta estructura. Hay que tener en cuenta que por defecto en una instalación básica de PrestaShop, se instalan más de 100 módulos. Además de todo esto, más de módulos se pueden encontrar en PrestaShop Addons. Un módulo se puede considerar que es una extensión de PrestaShop que va a permitir a los desarrolladores añadir entre otras funcionalidades, las siguientes: a) Incorporar diferentes funcionalidades dentro de PrestaShop. b) Ver items adicionales dentro del Back Oce (selección de productos, etc.) c) Comunicación con otros servicios de comercio electrónico. 3. La sobreescritura de código. Este es otro de los puntos fuertes de PrestaShop, gracias a ello podemos modicar el comportamiento que por defecto presentan determinados componentes, y además se hace de una manera tal que dicha modicación pueda permanecer ante posibles actualizaciones tanto del corazón de PrestaShop como de los temas.