Inyectando código

En algunas situaciones quieres usar algunos scripts en una sola página o para un bloque en particular y para hacerlo es necesario incluir estilos en head y/o scripts al final del código antes de /body.

Para no tener que crear una plantilla especial para una sola página, pero al mismo tiempo poder colocar estilos y código en la misma desde cualquier contenido, puedes inyectar el código que necesites usando las funciones:

insert_in_header(code,[priority]) insert_in_footer(code,[priority]) insert_in_metas(code,[priority])

Para usarlas en alguna página o bloque, deberás iniciar primero una sección de código php usando por ejemplo:

<?php insert_in_header('<link rel="stylesheet" href="path/to/style.css" />'); insert_in_footer('<script src="path/to/script.js"></script>', 1000); ?> Nota el uso de las comillas dobles y sencillas para no tener que usar backslash (\)

Documentación

Usa estas funciones en páginas, bloques y plugins

insert_in_header(string $code, int $priority): Inyecta el código $code justo antes de finalizar /head. Ideal para colocar estilos especiales o para llamar a hojas de estilo adicionales, pero en realidad puedes insertar cualquier cosa.
Toma en cuenta que tú eres responsable de que el código esté correcto.
Puede ser llamada varias veces dentro de una misma página y en cada llamado en realidad va agregando al stack el código indicado, de manera que puede ser llamada varias veces desde varios bloques o páginas.

$priority es un parámetro opcional. Un entero que permite ordenar las prioridaddes en que se pondrá el código al final de /head. Un número más alto significa que el código se insertará más tarde en la lista. Si no se proporciona, el valor predeterminado es 0.
insert_in_footer(string $code, int $priority): Inyecta el código $code justo antes de finalizar /body. Ideal para colocar código JS o llamados a código js externo, pero en realidad puedes insertar cualquier cosa.
Toma en cuenta que tú eres responsable de que el código esté correcto y tenga sus respectivas etiquetas.
Puede ser llamada varias veces dentro de una misma página y en cada llamado en realidad va agregando al stack el código indicado, de manera que puede ser llamada varias veces desde varios bloques o páginas.
$priority es un parámetro opcional. Un entero que permite ordenar las prioridaddes en que se pondrá el código al final de /body. Un número más alto significa que el código se insertará más tarde en la lista. Si no se proporciona, el valor predeterminado es 0.
insert_in_metas(string $code, int $priority): Inyecta el código $code justo después de /title. Ideal para colocar metatags especiales dirigidos al SEO, pero en realidad puedes insertar cualquier cosa.
Toma en cuenta que tú eres responsable de que el código esté correcto.
Puede ser llamada varias veces dentro de una misma página y en cada llamado en realidad va agregando al stack el código indicado, de manera que puede ser llamada varias veces desde varios bloques o páginas.
$priority es un parámetro opcional. Un entero que permite ordenar las prioridaddes en que se pondrá el código después de /title. Un número más alto significa que el código se insertará más tarde en la lista. Si no se proporciona, el valor predeterminado es 0.

Ejemplo de Inyección

Este es un ejemplo para implementar el plugin counterup desde un bloque. Es un sencillo plugin de jQuery para hacer el efecto de aumento incremental de números.

Lo más recomendable (y ordenado) es separar la sección que requiere el código o estilo especial en un bloque y en ese bloque hacer el llamado a insert_in_header() o insert_in_footer() para luego inscrustarlo en la página con block:miBloque

<?php
insert_in_header('<style>.counter{font-size:3em;display:block;color:orange}</style>');
insert_in_footer('<script src="//cdnjs.cloudflare.com/ajax/libs/waypoints/2.0.3/waypoints.min.js"></script>',101);
insert_in_footer('<script src="https://cdnjs.cloudflare.com/ajax/libs/Counter-Up/1.0.0/jquery.counterup.min.js"></script>',102);
insert_in_footer("
    <script>
        jQuery(document).ready(function($) {
            $('.counter').counterUp({
                delay: 10,
                time: 5000
            });
        });
    </script>",103);
?>

958,393.10 3,000,000 700

AOS (pre-build tag)

This functions can be used within your tags and plugins. This is a demostration of the tag aos to implement AOS animations on your site.

Simply insert the tag in any part of the page, i.e. aos:duration=1000 and AOS animation will be activated, then you can animate tags with "data-aos=" as in

 <h2 data-aos="fade-down">
     Use in tags & plugins
 </h2>

Compatir variables entre bloques

Una página puede llamar a un bloque usando block:header. Sin embargo, hay ocasiones en que desearás compartir variables con ese bloque, por ejemplpo, en caso de tener un el bloque una plantilla para las cabeceras de las páginas donde sólo cambian eñ título de cada página.

Sin embargo, por seguridad, Flaty no comparte autmáticamente variables entre los bloques. Así que si quieres usar una variable en un bloque debes registrar dicha variable usando las funciones setTemplateVars() y getTemplateVars() para recuperarlas.

setTemplateVars() genera un array asociativo con valores que pueden ser usados en el bloque al que se llama.
Del lado del bloque, recuperas esas variables usando getTemplateVars()

Por ejemplo, al insertar el bloque block:ejemplo usando:

<?php
$titulo = "Mi título de ejemplo";
setTemplateVars('title', $titulo);
?>
block:ejemplo

obtengo:

Este es el título que se pasó como variable:

Mi título de ejemplo

Este contenido viene del bloque "ejemplo"

Las variables son presistentes en todos los bloques hijos, es decir, si la página define variables y llama al block:bloque1 y éste a su vez llama al block:bloque2 ambos bloques pueden acceder a las mismas variables.

setTemplateVars($nameOrArray, $value = null)

Define en el bloque o página que llamará a un bloque las variables que se desean compartir.
Por ejemplo, si tienes una plantilla para la cabecera de las páginas y lo únco que cambia es el título puedes hacer:

<?php
$titulo = 'mi titulo';
$subtitulo = 'mi subtitulo';
$autor = 'Juan Pérez';

// Variables individuales
setTemplateVars('titulo', $titulo);
setTemplateVars('subtitulo', $subtitulo);

// Array de variables
setTemplateVars([
    'autor' => $autor,
    'fecha' => date('Y-m-d')
]);
?>
block:header

Para claridad y coherencia del código es recomendable la segunda forma de definir las variables dentro de un array

getTemplateVars()

Recupera desde el bloque llamado las variables que su padre quiso compartir. Estas variables vienen siempre en un array de manera que puedes decidir usar el array o extraer las variables al ambiente del bloque con extract() (no recomendado).

Por ejemplo, para usar el código del ejemplo antrerior:

<?php
$vars = getTemplateVars();
// Opcional: extraer variables manualmente si se prefiere
// extract($vars);
?>
<div class="header">
    <h1><?= $vars['titulo'] ?></h1>
    <h2><?= $vars['subtitulo'] ?></h2>
    <p>Autor: <?= $vars['autor'] ?></p>
</div>

Las varaibles siempre llegan como un array