Componentes
Para el framework, un componente será todo aquello que pueda ser agrupado bajo un mismo concepto. Es decir, el framework no tiene un sólo criterio para agrupar componentes, y su uso depende únicamente del contexto y las implementaciones.
Por ejemplo, como regla general el framework tiene carpetas donde se guarda su código (libraries, plugins, scripts, etc.). Cada una de ellas será un componente en la compilación. Ahora bien, los middlewares, los enums o las notificaciones tienen sus propias reglas, y, por lo tanto, serán considerados componentes en el contexto de las librerías.
Aplicación
Gestiona gran parte de la carpeta app/, basándose en la idea de componentes y su estructura de controladores, modelos y vistas.
Para acceder, debe seleccionar un registro y presionar el botón:
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Nombre
Nombre del componente.
Ámbito
El punto de acceso.
Componentes
Los elementos de componente que utiliza. Estos pueden ser: modelo, vista, controlador y javascript.
Puntos de entrada
Una vista rápida a los puntos de entrada o endpoints que contiene el controlador.
Filtrar la lista
Para filtrar la lista presione el botón:
El filtro de lista contiene:
Selector
El selector permite mostrar métodos públicos de los modelos que, según las convenciones del framework, no se corresponden con ningún punto de entrada del controlador.
Crear
Esta opción crea un controlador vacío. Si el controlador existe, no realiza ninguna acción.
El formulario será similar a:
El nombre del controlador consta de 3 partes:
Punto de acceso
El punto de acceso al controlador. Las opciones son las del enrutador, y pueden modificarse desde las configuraciones.
Alias de la extensión
El alias de la extensión, esta no puede ser modificada.
Sub-componente (opcional)
El sub-componente permite ampliar las posibilidades de controladores en una misma extensión.
Eliminar
Esta opción intenta eliminar todo lo referido al componente.
Es decir, si el componente tiene punto de acceso, entonces eliminará: controlador, sub-modelo, vistas y javascript. De lo contrario, solo eliminará el modelo.
Puntos de entrada
La opción permite gestionar los puntos de entrada que ejecuta el controlador y todos los elementos vinculados a los mismos: modelo, sub-modelo y vista.
Presionando sobre el nombre del componente, también podrá acceder a los puntos de entrada.
Descargar
Podrá descargar todos los elementos del componente de aplicación.
En caso de tener un punto de acceso, esto es: controlador, sub-modelo, vistas y javascript. De lo contrario, será solo el modelo.
Importar componentes
Los componentes pueden ser importados desde plugins.
Para ello, existen plugins que contienen componentes "universales", en los que se les reemplazó cualquier texto significativo por un token. Esto permite importarlos a cualquier otra extensión.
Un ejemplo práctico de la utilidad de importar un componente es la de crear un CRUD completo sin necesidad de programar.
Exportar componentes
Los componentes pueden ser exportados a plugins (Véase Importar componentes).
A la hora de exportar, es posible crear un nuevo plugin, o editar uno ya existente.
Si elegimos crear un nuevo componente "universal", debemos ingresar la extensión a la que pertenecerá y, opcionalmente, un nombre alternativo.
Para editar, debemos seleccionar un componente existente.
Puntos de entrada
Un punto de entrada o endpoint es un método público del controlador. A través de un punto de entrada es posible asociar una url con un recurso o acción del servidor.
Para gestionar los puntos de entrada, debemos acceder a través de la opción «Puntos de entrada» de un componente de aplicación.
Una vez que accedemos, se mostrará una lista como la siguiente:
Datos por registro
Un registro contiene los siguientes datos:
Recuadro de color
Éste permite una identificación rápida del tipo de tarea. Esta clasificación es interna, pertenece a la herramienta, y sirve solo como un modo de agrupar puntos de entrada.
Nombre
El nombre del punto de entrada, tal y como se encuentra en el controlador.
Elementos del punto de entrada
Una lista de los elementos que el framework asocia al punto de entrada.
Filtrar la lista
El filtro de lista contiene:
Selector
El selector permite mostrar elementos que, según las conversaciones del framework, no se corresponden con ninguno de los puntos de entrada.
Crear un punto de entrada
Para crear un punto de entrada, precione el botón:
Se desplegará un modal con varias opciones para crear, cada una de ellas con una descripción. También, cuenta con etiquetas que ayudan a entender todo lo que se va a crear. Las posibilidades de creación de código son: Modelos, Vistas, Controlador (Puntos de entrada), Rutas, Javascript (Controles), Botones y Configuraciones.
Para selecciona una de las opciones, presione el botón:
Una vez seleccionada una opción, el formulario que se despliega varía según la opción.
Algunos de los formularios requieren que, previamente, se hayan completado las Preferencias.
Eliminar un punto de entrada
Para eliminar un punto de entrada, seleccione un registro y precione el botón:
Se desplegará un modal para confirmar la acción.
La herramienta intentará eliminar todos los elementos asociados: modelos, vistas, controlador, rutas, javascript y botones. Aunque no siempre encuentra a estos elementos, y es posible que tenga que eliminarlos de modo manual.
Reordenar los puntos de entrada
Reordena todos los métodos del controlador y de los modelos, según la clasificación interna que realiza la herramienta.
Preferencias
Se utiliza internamente para declarar valores que se utilizan para crear código. Por ejemplo, el nombre de la tabla que es administrada por el controlador.
Varias de las opciones para crear puntos de entrada, requieren de estas preferencias.
Rutas
El archivo de rutas permite modificar las convenciones de enrutamiento del framework.
Las rutas estarán siempre acotadas a un punto de acceso de una extensión. Esto mejora el rendimiento y facilita la organización.
Para acceder a los archivos de rutas, seleccione una o varias extensiones y presione el botón:
A continuación, se abrirá un modal con la lista de rutas, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Ámbito
El ámbito o punto de entrada de las rutas.
Extensión
La extensión de las rutas.
Filtrar la lista
El filtro de la lista contiene:
Caja de texto
La caja de texto busca en el nombre de la librería.
Crear un archivo de rutas
Esta opción crea un archivo de rutas. Para ello, presione el botón:
El formulario será similar a:
Nombre
El nombre de la librería a crear.está compuesto por el punto de acceso y el alias de la extensión.
Reescribir
Esta opción reescribirá cualquier archivo de rutas existente.
Api
El apartado permite completar el archivo de rutas con las rutas para crear una Api.
Crear
Activa la opción.
Eliminar un archivo de rutas
Para eliminar un archivo de rutas, debe seleccionarlo y presionar el botón:
LibrerÃas
Para gestionar las librerías php, debe seleccionar un registro y presionar el botón:
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Nombre
Nombre de la librería.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre de la librería.
Crear una librería
Esta opción crea una librería vacía. Para ello, debe presionar el botón:
El formulario será similar a:
Nombre
El nombre de la librería a crear.
Reescribir
Esta opción reescribirá cualquier librería existente.
Eliminar
Para eliminar una librería, debe seleccionarla y presionar el botón:
Crear documentación
Está herramienta lee una librería, extrae datos relevantes y los devuelve en un formato que solemos utilizar para la documentación.
Middlewares
Para gestionar los middlewares, debe seleccionar una extensión y presionar el botón:
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Nombre
Nombre del middleware.
Extensión
Alias de la extensión propietaria del middleware.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre del middleware.
Crear un middleware
Esta opción crea el esqueleto de un middleware. Para ello, debe presionar el botón:
El formulario será similar a:
Nombre
El nombre del middleware a crear.
Reescribir
Esta opción reescribirá cualquier middleware existente.
Eliminar un middleware
Para eliminar un middleware, debe seleccionar el middleware a eliminar y presionar el botón:
Enums
Para gestionar las enums, debe seleccionar una extensión y presionar el botón:
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Nombre
Nombre del enum.
Extensión
Alias de la extensión propietaria del enum.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre del enum.
Crear un enum
Esta opción crea el esqueleto de un enum. Para ello, debe presionar el botón:
El formulario será similar a:
Nombre
El nombre del enum a crear.
Reescribir
Esta opción reescribirá cualquier enum existente.
casos
Una lista separada por coma de los casos para el enum. Puede ser con o sin comillas.
Métodos
Incluye algunos de los métodos más utilizados en los enums del framework.
Eliminar un enum
Para eliminar un enum, debe seleccionar un registro y presionar el botón:
Notificaciones
Para gestionar las notificaciones, debe seleccionar una extensión y presionar el botón:
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Nombre
Nombre de la notificación.
Extensión
Alias de la extensión propietaria de la notificación.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre de la notificación.
Crear un notificación
Esta opción crea el esqueleto de una notificación. Para ello, debe presionar el botón:
El formulario será similar a:
Nombre
El nombre de la notificación a crear.
Reescribir
Esta opción reescribirá cualquier notificación existente.
Eliminar un notificación
Para eliminar una notificación, debe seleccionar la notificación a eliminar y presionar el botón:
Plugins
Esta opción permite gestionar los plugins de una o varias extensiones.
Para ello, puede seleccionar una o varias extensiones y presionar el botón:
Si no se selecciona ninguna extensión, se mostrará la lista completa de plugins.
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Extensión
El alias de la extensión que contiene el plugin.
Nombre
Nombre del plugin.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre del plugin.
Crear un plugin
La aplicación pone a disposición plantillas para crear los plugins más frecuentes.
Para crear un plugin, debe seleccionar una de las opciones disponibles:
El formulario será similar a:
Nombre
Ingrese un nombre alternativo al plugin por defecto.
Reescribir
Esta opción reescribirá cualquier archivo existente.
Hook
Cada hook es una función del plugin y, por lo tanto, un archivo en particular. Cada plugin tendrá una lista de hook a crear.
Eliminar
Para eliminar un plugin, debe seleccionar un registro y presionar el botón:
Se desplegará un modal para confirmar la acción.
Fragmentos
Esta opción permite gestionar los fragmentos (snippets) de una o varias extensiones.
Para ello, puede seleccionar una o varias extensiones y presionar el botón:
Si no se selecciona ninguna extensión, se mostrará la lista completa de fragmentos.
A continuación, se abrirá un modal mostrando el contenido de la carpeta, por ejemplo:
Datos por registro
Un registro de la lista contiene los siguientes datos:
Extensión
El alias de la extensión que contiene el fragmento.
Nombre
Nombre del fragmento.
Filtrar la lista
El filtro de lista contiene:
Caja de texto
La caja de texto busca en el nombre del fragmento.
Eliminar
Para eliminar un fragmento, debe seleccionar el fragmento a eliminar y presionar el botón:
Se desplegará un modal para confirmar la acción.