Extensiones de modelos

Para modificar el comportamiento de modelos de otro plugins (o del core) podemos crear una extensión de ese modelo, es decir, crearemos un archivo php con el nombre del modelo en la carpeta Extension/Model de nuestro plugin.

Las extensiones no son herencia

Las extensiones no son herencia. No se puede extender cualquier función imaginable, solamente las que tienen soporte. Y cada función que añadas en una extensión debe tener un return function().

Ejemplo: añadir métodos a un modelo

Como ya hemos comentado al añadir una columna a una tabla automáticamente se añade esa propiedad al modelo. Las extensiones para modelos se usarán únicamente para métodos o funciones. Y como también hemos comentado, las extensiones no son herencia, solamente son una forma de añadir métodos a una clase, pero sin extender y sin padre.

Continuando con el ejemplo vamos a añadir un método "usado()" que nos devolverá el valor de "usado". Podemos consultar este valor directamente, pero para el ejemplo imaginaremos que no. Para añadir el método "usado()" crearemos el archivo Extension/Model/Producto.php:

<?php
namespace FacturaScripts\Plugins\MiPLugin\Extension\Model;

use Closure;

class Producto
{
   public function usado(): Closure
   {
      return function() {
         return $this->usado;
      };
   }
}

Fíjate que no hay ningún extends Producto. No estamos heredando del modelo, solamente estamos añadiendo el método "usado()". Y fíjate además que el método devuelve una función, esta función es la que se añade al modelo. Pero para ello primero hay que cargar la extensión en el archivo Init.php del plugin.

Cargar extensiones en el Init.php

Las extensiones de archivos xml se integran automáticamente al activar el plugin o reconstruir Dinamic. En cambio, las extensiones de archivo php se deben cargar explícitamente, y se deben hacer desde el archivo Init.php del plugin, en el método init().

public function init() {
   $this->loadExtension(new Extension\Model\Producto());
}

Métodos disponibles para extender

  • clear() se ejecuta cuando se instancia un objeto del modelo, por ejemplo al hacer new Producto(). Asigna valores predeterminados.
  • delete() se ejecuta una vez realizado el delete() del modelo.
  • deleteBefore() se ejecuta antes de hacer el delete() del modelo. Si devolvemos false, impedimos el delete().
  • save() se ejecuta una vez realizado el save() del modelo.
  • saveBefore() se ejecuta antes de hacer el save() del modelo. Si devolvemos false, impedimos el save().
  • saveInsert() se ejecuta una vez realizado el saveInsert() del modelo.
  • saveInsertBefore() se ejecuta antes de hacer el saveInsert() del modelo. Si devolvemos false, impedimos el saveInsert().
  • saveUpdate() se ejecuta una vez realizado el saveUpdate() del modelo.
  • saveUpdateBefore() se ejecuta antes de hacer el saveUpdate() del modelo. Si devolvemos false, impedimos el saveUpdate().
  • test() se ejecuta una vez realizado el test() del modelo.
  • testBefore() se ejecuta antes de hacer el test() del modelo. Si devolvemos false, impedimos el test();

fsmaker

Para hacer este mismo proceso con fsmaker ejecutamos:

fsmaker extension

En el asistente elegimos modelo, escribimos el nombre, etc.

¿No funciona?

Los errores más comunes son:

  • Tener un namespace incorrecto. El namespace debe reflejar la ruta donde está el archivo. Si el archivo está en la carpeta Extension/Model de tu plugin, el namespace dene incluir Extension\Model.
  • Intentar extender funciones que no soportan extensiones. Solamente las funciones o métodos indicados arriba se pueden extender.
  • No usar return function(). Las funciones deben devolver un return function(), y si no, no funcionará. Si la función necesita parámetros, estos deben ir en el return function().
  • No cargar la extensión desde el Init.php del plugin.

Parámetros por referencia

Si crear funciones personalizadas y estas incluyen parámetros no se debe poner "&" en los parámetros ya que no está permitido, y causará problemas. Como sugerencia puedes devolverte el parámetro que deseas modificar.

Ejemplo mal

public function applyStockChangesFromWork(): Closure
{
        return function (&stock) {
            $stock->cantidad = 5;
        };
}

Ejemplo Bueno

public function applyStockChangesFromWork(): Closure
{
        return function (stock) {
            $stock->cantidad = 5;
            return $stock;
        };
}

Siguiente

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión
PRO
neorazorx_1
neorazorx_1

España, 9 años, nivel 100

Las extensiones

Patrocinadores

FacturaScripts avanza más rápido gracias al apoyo financiero de los patrocinadores, que contribuyen a que podamos dedicar más tiempo al desarrollo, testeo y documentación. Usted también puede poner su granito de arena y convertirse en patrocinador ;-)

ORO
elurk_3992
ORO
manel_11440
ORO
alexis_8932
ORO
informatica_13304
ORO
aj.garciolo_346
PLATA
adelantia_311
PLATA
s3rtec_4534
PLATA
oscar_10546
PLATA
nsat.pedidos_1235
PLATA
contacto_14936
PLATA
interiberica_795
PLATA
josepmp_2501
PLATA
ivan.gadea_16600
BRONCE
rexmaris_12857
BRONCE
flecamas_12738
BRONCE
jlgonzalezdiaz_12316
BRONCE
dani.eus79_11629
PRO
neorazorx_1
PRO
jmoreno_2610
PRO
yopli2000_5
PRO
civernet_11724
PRO
daniel89fg_739
Patrocinar

Amplíe sus conocimientos con los cursos oficiales

Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

301 9,99 €
Sesiones de programación

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 17 lecciones con 17 vídeos explicativos (más de 8 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

84 19,99 €
Cookies
Usamos cookies en nuestro sitio web para brindarte la experiencia más relevante recordando tus preferencias y visitas repetidas. Al hacer clic en "Aceptar", aceptas el uso de TODAS las cookies necesarias.

Copyright (c) 2013-2022 FacturaScripts

Soporte