Integración con otros plugins (Guía para desarrolladores)

⚠️ Esta sección está dirigida exclusivamente a desarrolladores.

No es necesaria para el uso normal del plugin.
SimplificaVariante funciona correctamente con todos los campos estándar de variantes del Core de FacturaScripts.

Contexto

El plugin SimplificaVariante integra los campos de la variante obligatoria directamente en la ficha del producto cuando este solo dispone de una variante.

Si otro plugin añade campos personalizados a las variantes, y desea que dichos campos también se sincronicen correctamente cuando se edita el producto desde la ficha principal, es necesario registrar esos campos en el sistema de sincronización del plugin.

Registrar campos personalizados

Para que un campo adicional de variante se actualice correctamente desde la ficha del producto, debe añadirse al sistema de sincronización en el método init() del archivo Init.php del plugin correspondiente:

if (Plugins::isEnabled('SimplificaVariante')) {
    \FacturaScripts\Dinamic\Lib\SimplificaVariante\SyncVariant::addField('myCustomField');
}

Siendo 'MyCustomField' el nombre del campo que se ha añadido por extensión a la tabla de variantes. De esta forma, cuando se edita el producto (y no directamente la variante), el valor del campo personalizado también se actualiza correctamente en la variante obligatoria.

Visualización del campo en la ficha del producto

Además del registro técnico del campo, es necesario:

Crear una extensión de vista XML en FacturaScripts de EditProducto.
Añadir la columna correspondiente en la ficha del producto.
Utilizar el nombre exacto del campo definido en la variante.

Esto permite que el campo se muestre visualmente junto al resto de campos integrados por SimplificaVariante.

<?xml version="1.0" encoding="UTF-8"?>
<view>
    <columns>
        <group name="advanced" numcolumns="12">
            <column name="my-custom-field" numcolumns="2" order="400">
                <widget type="text" fieldname="myCustomField" />
            </column>
        </group>
    </columns>
</view>

Consideraciones importantes

Esta integración solo es necesaria para campos añadidos por plugins externos.
No afecta a los campos estándar del Core.
No modifica la estructura del modelo de datos.
Solo amplía la lista de campos sincronizados en la edición simplificada.