Grav - Ganchos de eventos
En este capítulo, estudiaremos sobre Event Hooksen Grav. En el capítulo Complementos , verá que la lógica del complemento se incluyó en dos métodos. Los métodos sononPluginsInitialized y onPageInitialized; estos métodos son similares a los ganchos de eventos. Para saber más y controlar el poder de los complementos de Grav, debe verificar la disponibilidad de los ganchos de eventos. Los ganchos de eventos tienen una relación directa con Grav de principio a fin. Debe conocer el orden en el que se llaman los hooks y lo que se puede utilizar en el momento de estas llamadas.
La siguiente tabla enumera el núcleo Grav event hooks que se activan durante el procesamiento de una página.
| No Señor. | Descripción del evento |
|---|---|
| 1 | onFatalException Puede disparar este evento en cualquier momento, si PHPda una excepción fatal. losProblem El complemento lo usa para administrar la visualización de una lista de explicación completa, de por qué Grav entrega el error fatal. |
| 2 | onPluginsInitialized Este es el primer evento de complemento que se puede utilizar en Grav. Los siguientes objetos se han introducido como se menciona a continuación:
|
| 3 | onAssetsInitialized Esto especifica que el assets El administrador está cargado y listo para usar y administrar. |
| 4 | onPageNotFound Si encontró una página inesperada, puede descartar este evento. Actualmente, el complemento de error se utiliza para especificar un404 error página. |
| 5 | onPageInitialized Esto especifica la página solicitada por un URL que se carga en el objeto Page. |
| 6 | onOutputGenerated Esto especifica el proceso de salida por el Twig templatingmotor. Actualmente, es solo una cadena deHTML. |
| 7 | onOutputRendered Este es un proceso de salida, que se envía a la pantalla. |
| 8 | onShutdown Este es un evento nuevo y muy poderoso que le permite realizar acciones. Esto se hace después de que Grav hayacompleted processingy se cierra la conexión con el cliente. Esta acción individual no requiere ninguna interacción con el usuario, por lo que puede afectar el rendimiento. Incluye el seguimiento de usuarios y el procesamiento de trabajos. |
| 9 | onBeforeDownload Este es un nuevo evento que passesen el objeto de evento que contiene un archivo. Permite a los usuarios realizar registros, otorgar e ignorar el permiso para descargar el archivo mencionado. |
Ganchos de evento Twig
Twig tiene su propia colección de ganchos de eventos para usar como se menciona a continuación.
| No Señor. | Descripción del evento |
|---|---|
| 1 | onTwigTemplatePaths La ubicación base de la ruta de la plantilla se establece en el Twig object. Este evento se usa para agregar otras ubicaciones donde Twig buscará rutas de plantilla. |
| 2 | onTwiglnitialized Eso initialize el motor de plantillas Twig. |
| 3 | onTwigExtensions Especifica que las extensiones de ramitas centrales están listas para usar. Este gancho de eventos le permite agregar su propia extensión Twig. |
| 4 | onTwigPageVariables Este proceso Twig le permite una página directamente, es decir, puede localizar process:twig:truen una página de encabezados YAML. Aquí puede agregar cualquier variable a Twig y debería ser accesible a twig durante este proceso. |
| 5 | onTwigSiteVariables En este proceso, verá la plantilla del sitio completo en order wisepor métodos Twig. Además, puede agregar cualquier variable a Twig durante este proceso. |
Colección Event Hooks
La siguiente tabla enumera un gancho de evento de colección.
| No Señor. | Descripción del evento |
|---|---|
| 1 | onCollectionProcessed En esta sección, una vez completado el proceso, puede control Una colección. |
Ganchos de eventos de página
La siguiente tabla enumera una colección de enlaces de eventos de página.
| No Señor. | Descripción del evento |
|---|---|
| 1 | onBuildPagesInitialized Este evento es útil para que los complementos controlen el contenido y almacenen en caché los resultados. Una vez activado este evento, las páginas se reciclarán. Esto ocurre cuando la cachéexpired o necesidades refreshing. |
| 2 | onBlueprintCreated Este evento ayuda a procesar y administrar formularios. |
| 3 | onPageContentRaw En este proceso, cuando se encuentra una página, headers son fijos, pero contentno se arreglará. Verá que todas las páginas se disparan en el sistema Grav. Si ha borrado el caché o borrado el caché, se produce este evento. |
| 4 | onPageProcessed Una vez que una página es testedy fijo, cada página se descarta en el sistema Grav. El rendimiento no importa en este caso, ya que no se reproducirá en una página almacenada en caché. |
| 5 | onPageContentProcessed Puede ver que este evento se descarta, una vez que la técnica content () de la página ha corregido el contenido de la página. Este evento es útil en caso de que desee realizar acciones en el contenido pos-fijo, pero asegúrese de que los resultados seancached. |
| 6 | onFolderProcessed Una vez folderse prueba y se corrige, todas las carpetas se descartan en el sistema Grav. El rendimiento no importa en este caso, ya que no se reproducirá en una página almacenada en caché. |