Cómo hacer una función en PHP y llamarla desde un TPL

En este artículo explicamos detalladamente cómo crear una función en PHP que realice la funcionalidad deseada y cómo invocar directamente desde un archivo TPL en Prestashop.

Ubicación de la Función en Prestashop

El primer paso es identificar en qué archivo PHP alojar la función. En Prestashop, la carpeta /classes contiene todos los objetos que utiliza el sistema. Por lo tanto, es dentro de esta carpeta donde deberemos ubicar nuestra función.

Si la función está relacionada con un producto, la añadiremos en el archivo Product.php. Si está asociada a un cliente, la colocaremos en Customer.php, y si trata sobre pedidos, la incluiremos en Order.php. Básicamente, debemos identificar el objeto sobre el que trabajará nuestra función y añadirla en la clase correspondiente.

En caso de que necesitemos una función que no esté asociada directamente a ningún objeto específico, podemos situarla en Tools.php. Este archivo es ideal para las funciones generales del sistema.

Ejemplo

Supongamos que queremos desarrollar una función dentro de Product.php para que, dado el ID de un producto, obtengamos su referencia. La función sería:

public static function obtenerReferencia($id_product) {

    $product = new Product($id_product);

    return $product->reference;

}//obtenerReferencia

Explicación del Código:

• La función recibe como parámetro $id_product.
• Se utiliza este ID para instanciar un objeto de la clase Product.
• La propiedad reference del objeto se recupera y devuelve.
• La función está definida como estática (static) para que pueda ser llamada directamente desde un archivo TPL.

Para utilizar esta función en un archivo TPL, simplemente invocamos la clase y la función de la siguiente manera:

{Product::obtenerReferencia($id_product)}

Pasos Detallados:

1. Encerramos el código en {} como es habitual en Smarty.
2. Escribimos el nombre de la clase (Product) seguido de ::.
3. Indicamos el nombre de la función (obtenerReferencia).
4. Pasamos el parámetro necesario ($id_product), que debe estar disponible en el TPL.

Con este sencillo ejemplo, mostramos cómo crear una función en PHP, definirla en el archivo adecuado, y llamarla desde un archivo TPL. Siguiendo esta estructura, puedes desarrollar funciones más complejas según tus necesidades.