• Antes de empezar a programar +
  • ¿Qué versión de Symfony utiliza?
  • Sistema de Prioridades de Plugins
  • Diagramas de tablas
  • Cómo hacer un pull-request
• Creación de Plugins
  • El archivo facturascripts.ini
  • El archivo Init.php
  • Los Controladores +
    • Controladores extendidos +
      • ListController en FacturaScripts +
        • addFilterAutocomplete()
        • addFilterCheckbox()
        • addFilterDatePicker()
        • addFilterNumber()
        • addFilterPeriod()
        • addFilterSelect()
        • addFilterSelectWhere()
      • EditController
      • PanelController +
        • addHtmlView()
        • addEditView()
        • addEditListView()
        • addListView()
      • Personalizando con Settings
      • Método disableColumn()
      • Interacción con las Vistas
    • Obtener Parámetros de la URL, Formularios o Cookies
    • Cómo guardar una cookie
    • Consultar el usuario y sus permisos
    • Formularios de edición de facturas, albaranes, etc
  • Añadir un Endpoint a la API
  • Los modelos +
    • Operaciones comunes con modelos
    • XML de la tabla
    • ModelOnChangeClass
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->install()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->exists()
    • $modelo->loadFromData()
    • $modelo->get()
    • $modelo->getModelFields()
    • $modelo->loadFromCode()
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->tableName()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $modelo->primaryDescriptionColumn()
    • $modelo->url()
    • $modelo->test()
  • Las vistas HTML +
    • Iconos disponibles
    • Herencia de plantillas
  • Las vistas XML (XMLView) +
    • Columns
    • Rows +
      • Row status
      • Row statistics
      • Row actions
      • Row header y footer
    • Modals
    • Group
    • Column
    • Widgets +
      • Widget Autocomplete
      • Widget Bytes
      • Widget Checkbox
      • Widget Color
      • Widget Datalist
      • Widget Date
      • Widget Datetime
      • Widget File
      • Widget Library
      • Widget Link
      • Widget Money
      • Widget Number
      • Widget Password
      • Widget Select
      • Widget Stars
      • Widget Text
      • Widget Textarea
      • Widget Time
      • Widget Radio
      • Widget Variante
  • Las traducciones en Plugins
  • Las extensiones +
    • Extensiones de controladores
    • Extensiones de modelos
    • Extensiones de tablas
    • Extensiones de XMLView
    • Extensiones de Vistas HTML
  • Mostrar mensajes, errores y alertas
  • Acceso a la Base de Datos +
    • DbQuery
    • Where
    • DataBaseWhere
  • Settings: opciones del panel de control +
    • Cómo crear preferencias de aplicación para su plugin
  • Generación de PDF y Excel
  • AssetManager
  • El archivo Cron.php
  • Cómo publicar plugins
• Profundizando en el CORE +
  • Enrutado
  • Gestión de Errores
  • Gestión de Plugins
  • Uso de la caché
  • La cola de trabajos
  • Descarga de Archivos desde MyFiles
  • Cliente de API de OpenAI
  • Cliente HTTP +
    • Conectar con otro FacturaScripts mediante API
  • Validar Emails, Cadenas y URLs
  • Enviar emails con NewMail
• Test unitarios en plugins +
  • Añadir github action
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (obsoleto)
• La API REST +
  • Listado de recursos
  • Listar, filtrar y ordenar registros
  • Obtener un registro concreto
  • Crear o añadir registros
  • Cómo crear facturas
  • Hacer una factura rectificativa
  • Obtener el PDF de una factura
  • Modificar registros
  • Eliminar registros

Las traducciones en Plugins

FacturaScripts almacena las traducciones en archivos json en la carpeta Translation del plugin, de esta forma cada plugin puede contener sus propias traducciones. También puedes usar el plugin Traducciones que te ayudará a crear tus traducciones más fácil.

¿Cómo puedo traducir un texto?

Nuestro traductor se basa en el concepto clave-valor, es decir, no ponemos textos completos sino que usamos cadenas separadas por guiones (generalmente en inglés) que tengan una traducción en los archivos de traducciones. Por ejemplo, para mostrar el texto aceptar, realmente llamamos a traducir 'accept'.

use FacturaScripts\Core\Tools;

echo Tools::lang()->trans('accept');

Esto funciona porque en los archivos de traducción ya tenemos la cadena accept y su traducción correspondiente:

• Archivo es_ES.json de traducciones al español de España.
• Archivo ca_ES.json de traducciones al catalán.

Traducciones variables

En ocasiones queremos traducir textos incluyendo partes variables, por ejemplo para informar de que falta el plan contable para el ejercicio 2023. Para estos casos pasamos esos valores al traductor en un array como segundo parámetro, y en la traducción reemplazan a las variables correspondientes, que son las que van entre %. Se ve más fácil con un ejemplo:

echo Tools::lang()->trans('accounting-data-missing', ['%exerciseName%' => '2023']);

Esta cadena usará estra traducción, sustituyendo %exerciseName% por el valor asignado.

"accounting-data-missing": "Pla comptable no trobat per a l'exercici %exerciseName%",

¿Puedo usar traducciones existentes?

Si, simplemente ve al listado de traducciones en español y busca la que más se te adapte.

¿Puedo compartir mis traducciones para que me ayuden a traducir?

Si, si publicas tu plugin en la forja (sección mis plugins), en la página del plugin podrás añadir tus traducciones para que el resto de usuarios de la web pueda traducirlas. Después puedes utilizar el script incluido para descargar las traducciones actualizadas.