¿Cómo crear ayudantes de manillar personalizados?

Al crear su tema, es posible que desee ampliar la cantidad de ayudantes; Publii ofrece a los desarrolladores de temas la posibilidad de crear ayudantes personalizados según sus necesidades. Son útiles si necesita simplificar el código de su tema.

Por ejemplo, puede crear un ayudante personalizado que reemplazará múltiples condiciones con una única verificación condicional.

Para crear ayudantes personalizados en su tema, simplemente cree un archivo helpers.js en el directorio del tema; aquí puede agregar sus funciones ayudantes personalizadas.

A continuación se muestra un ejemplo de código que crea dos ayudantes personalizados súper simples que aceptan un argumento:

/*
 * Custom theme helpers for Handlebars.js
 */

let themeHelpers = {
    test1: function(value) {
        return "TEST1 " + value;
    },
    test2: function(value) {
        return "TEST2 " + value;
    }
};

module.exports = themeHelpers;

Como puede ver, todas las funciones auxiliares están envueltas dentro de un objeto que se exporta desde el archivo helpers.js al renderizador.

También es posible utilizar la instancia del objeto Handlebars : este escenario requerirá que el campo  se  includeHandlebarsInHelpers establezca como verdaderorenderer  en la sección de configuración del tema.

Luego el archivo helpers.js se puede escribir como:

module.exports = function (Handlebars) {
	return {
	    functionName: function(arg) {
	        // ...
	        return new Handlebars.SafeString(arg);
	    }
	};
  };
arriba