• 1.- Introducción

    Esta será la versión más ambiciosa de nuestra corta historia: multi-empresa, multi-idioma, dashboard inteligente, buscador avanzado... Y todo ello con componentes de symfony y siguiendo los estándares de desarrollo de más alto nivel: psr-0, psr-1, psr-2, psr-4, integración continua con phpunit y revisión de código con codacy y scrutinizer-ci. ¿Cuando estará disponible? La versión beta (versión de pruebas) . ¿Podré copiar mis datos de 2017? Podrás actualizar FacturaScripts 2017 a la versión 2018 cuando esté disponible. ¿Será una simple actualización? No, no será una simple actualización....
    22-03-2018

  • 1.1.- Instalación

    Para instalar FacturaScripts 2018 en un servidor web debes seguir estas instrucciones, en función de tu sistema operativo. Advertencia: FacturaScrips 2018 no está terminado, está en pleno desarrollo. Se desaconseja su uso en producción. Y las instrucciones para instalarlo actualmente no serán las mismas que cuando esté terminado. Linux Colócate en el directorio donde desees instalarlo y ejecuta: git clone https://github.com/NeoRazorX/facturascripts.git cd facturascripts composer install npm install A continuación ya puedes entrar en el instalador.
    05-12-2017

  • 2.- Antes de empezar a programar

    Antes de que empieces a programar o modificar el código de FacturaScripts, es necesario que tengas claros algunos conceptos. Nombres de clases y archivos: Los nombres de las clases deben ser en singular, por ejemplo Artículo, y la primera letra en mayúscula. Además evita utilizar nombres de este tipo: Articulo_Personalizado, en su lugar utiliza ArticuloPersonalizado. El nombre del archivo debe coincidir con en el nombre de la clase, y un archivo solamente debe contener una clase. Espacios de nombres: Cada clase debe estar en el espacio de nombres correspondiente a su carpeta, por ejemplo,...
    22-03-2018

  • 2.1.- Creación de plugins

    Un plugin permite añadir nuevas funcionalidades a FacturaScripts. Lo primero que hace falta para crear un plugin, es incluir una carpeta con el nombre del plugin. Dicha carpeta se creará dentro de la carpeta Plugins. La carpeta que incluyamos tendrá que contener un archivo llamado facturascripts.ini donde se tendrá que definir al menos, el nombre (name) y la descripción (description) del plugin. Por ejemplo, podríamos crear la carpeta MyNewPlugin y en su interior, incluir el fichero facturascripts.ini con el siguiente contenido: name = 'MyNewPlugin' version = 1 min_version =...
    22-03-2018

  • 2.2.- Modelo, Vista y Controlador

    FacturaScripts implementa el patrón Modelo-Vista-Controlador con algunas peculiaridades: Modelos: Los modelos son los encargados de gestionar el acceso a cada una de las tablas de la base de datos donde se persisten los datos con los que se trabajan. Así para cada tabla que usemos en la aplicación deberá existir su modelo, encargado de la lectura, escritura y borrado de los datos contenidos en dicha tabla. En este sentido, mezclamos el concepto de modelo con el de repositorio. Vistas: Las vistas son plantillas HTML interpretadas por el motor de plantillas twig. Controladores: Los...
    22-03-2018

  • 3.- Modelos

    Como se ha comentado en el punto anterior, cada tabla de la base de datos tiene un modelo encargado de la gestión de su lectura, escritura y borrado. A la hora de declarar el modelo, debemos crear una nueva clase que debe heredar de ModelClass, utilizar ModelTrait, e indicar el nombre de la tabla a utilizar y su clave primaria. use FacturaScripts\Core\Model\Base\ModelClass; use FacturaScripts\Core\Model\Base\ModelTrait; class Agente extends ModelClass { use ModelTrait; public $codagente; public $dnicif; public $nombre; public $apellidos; } Métodos obligatorios Para un correcto...
    22-03-2018

  • 3.1.- Formato de las tablas

    El formato de las tablas, al igual que las vistas, utiliza una estructura basada en XML. Estos archivos deben llamarse igual que el indicado en el método tableName del propio modelo, y para evitar problemas entre los distintas bases de datos soportadas, su nombre debe ser en minúsculas. Así mismo, los nombres de los atributos se escribirán todo junto y en minúsculas, sin estilo camelCase. El nivel inicial table, define todo lo que contiene la tabla, ya sean columnas (column) o restricciones (constraint). Las columnas requieren los campos name y type, para definir su nombre y tipo...
    22-03-2018

  • 3.2.- Modelos especiales

    Existen varios modelos que no tienen una correspondencia con tablas físicas en la base de datos, por lo que no pueden ser usados para grabación o borrado de datos. La función de estos modelos es de servir de complemento sobre el resto de modelos para realizar operaciones especiales de lectura de información, de manera global, evitando así tener que crear métodos repetidos en distintos modelos. CodeModel Este modelo se utiliza en los casos que nos interesa obtener una lista registros de alguna tabla, pero sólo un campo código o identificativo y su descripción. Al ser un modelo muy simple,...
    22-03-2018

  • 4.- Controladores

    Los controladores son los encargados de relacionar la vista con su modelo, así como de gestionar la interacción con el usuario. Existen varios controladores, clasificados en base al tratamiento de los datos y su visualización en pantalla. Todos ellos usan el sistema de carga de vistas definidas por XML. El controlador se utiliza para visualizar listas de registros a modo de tabla. El controlador se utiliza para la visualización y edición de datos de un único registro de un modelo. El controlador es un controlador que permite visualizar múltiples vistas y navegar entre ellas. Cada uno de...
    20-11-2017

  • 4.1.- Controlador ListController

    Este controlador es un contenedor de vistas del tipo ListView, que gestiona automáticamente la visualización y filtrado de datos, mostrando la información de cada vista en una tabla de filas y columnas. No permite la edición de los datos pero al hacer click sobre una de las filas se realiza una llamada automática al controlador de edición del modelo. Para este evento se utiliza la configuración de la primera columna que tenga informado el atributo onclick. Para el uso de este controlador es necesario crear las vistas en formato XML, tal y como se describe en el documento XMLViews, incluido...
    22-03-2018

  • 4.2.- Controlador EditController

    Es un controlador universal para vistas del tipo EditView que muestran los datos completos de un registro de datos de un modelo, en formato "ficha" o mediante un diseño de columnas agrupadas según el tipo de información. El uso de este controlador simplifica en gran manera la programación necesaria para la edición de los datos, así como la unificación de la imagen de la aplicación y plugins creando un entorno uniforme para el usuario lo que acelera el aprendizaje y adaptación a Facturascripts. Para el uso de este controlador es necesario crear las vistas en formato XML, tal y...
    22-03-2018

  • 4.3.- Controlador PanelController

    Este controlador, al igual que el controlador ListController es un controlador universal para multiples vistas aunque en este caso se permite el uso de distintos tipos de vistas: ListView, EditView y EditListView. El controlador divide la pantalla en dos zonas, una a la izquierda (zona de navegación) y otra la derecha donde se visualizan las vistas con los datos. Para el uso de este controlador es necesario crear las vistas en formato XML, tal y como se describe en el documento XMLViews, incluido en la documentación de Facturascripts. Cómo usar el controlador Para utilizar PanelController...
    20-11-2017

  • 5.- Vistas

    Las vistas, en Facturascripts 2018 están clasificadas según su representación en pantalla tanto en la forma de visualizar como en número de registros de datos. - List : Vistas que muestran una lista de datos en formato de filas y columnas pudiendo navegar, buscar y/o filtrar por los datos pero donde los datos son de sólo lectura, es decir no se permite su edición. - Edit : Vistas que muestran un formulario de edición de un único registro de datos, pudiendo estar estos datos agrupados. - EditList : Vista resultante de la "unión" de los tipos anteriores. Es decir, una lista de...
    22-03-2018

  • 5.1.- Vistas XML

    Facturascripts 2018 implementa un nuevo sistema de definición de vistas que facilita su diseño y mantenimiento. Para crear las vistas usaremos un archivo con estructura XML y, como se ha indicado anteriormente, con el nombre del tipo de vista y el modelo, donde estableceremos la composición visual de los campos, las acciones y opciones visuales de la vista. El elemento raíz del archivo XML será <view> y se podrán incluir los siguientes grupos: - <columns>: (obligatorio) Para definir la lista de campos que se visualizan en la vista. - <rows>: (opcional) Permite definir...
    22-03-2018

  • 5.2.- Vistas Grid

    Estas vistas son vistas que dependen de otra vista padre de tipo EditView y en la que los datos “hijos” se visualizarán dentro de un tabla de filas y columnas similar a una hoja de cálculo. Este tipo de visualización permite al usuario moverse libremente por los datos, cambiar el orden de las filas, así como poder crear nuevas líneas, eliminarlas e incluso copiar/cortar y pegar. Sólo es posible tener una vista Grid dentro de un PanelController. Para el correcto renderizado de estás vistas es necesario usar la plantilla GridController en vez de la usada normalmente por PanelController. Cómo...
    22-03-2018

  • 6.- API

    ¿Qué es la API? La Interfaz de Programación de Aplicaciones, de sus siglas abreviadas en inglés, es un conjunto de subrutinas, funciones y métodos que ofrece cierta biblioteca para ser utilizado por otro software como una capa de abstracción. ¿Qué ofrece? La API nos ofrece una forma sencilla de comunicar con los recursos disponibles, mediante unos métodos concretos y simples a los que podemos denominar en su conjunto como CRUD por su acrónimo en inglés: - POST: Crear (Create) un elemento nuevo. - GET: Leer (Read) una lista de elementos o un elemento, en listados con paginación, filtros y/o...
    25-03-2018




Soporte:

FacturaScripts es software libre y gratuito, pero si lo que busca es asesoramiento y soporte profesional, use la sección soporte.

  Soporte

¿Desea ser distribuidor?

Si desa ser distribuidor oficial de FacturaScripts, comience hoy mismo el proceso.

  hágase partner

Redes sociales:

Puede encontrarnos en las principales redes sociales. Y también en google+.





© 2013-2017 FacturaScripts