Personalización de widgets con la API de HireHop
HireHop es completamente personalizable. Utilizando el método de inyección de JavaScript, puedes escribir scripts personalizados para modificar elementos de la interfaz, crear funcionalidad a medida o añadir campos personalizados directamente en tu instancia de HireHop.
Al ver el código fuente de cualquier página de HireHop, busca la etiqueta de comentario <!-- PLUGINS -->. Todo el código JavaScript personalizado inyectado a través de la configuración de tu complemento se insertará directamente después de este punto.
Comprender el marco de trabajo NoHTML
HireHop está construido sobre un marco de trabajo personalizado y ligero llamado NoHTML. Combina tecnologías web estándar para crear una experiencia de renderizado en el lado del cliente ultrarrápida y ampliable:
- Archivos fuente sin comprimir: Todos los archivos JS estándar de HireHop están comprimidos para mejorar el rendimiento. Para inspeccionar código fuente legible y sin comprimir durante el desarrollo, añade
.MAXa la ruta del archivo (p. ej.,/js/notes.MAX.js).
- Renderizado en el lado del cliente: Aparte de la estructura principal de la página, la mayoría de los componentes de la interfaz de usuario se construyen de forma dinámica en el equipo del cliente utilizando JavaScript personalizado y widgets de jQuery UI (similar a React y JSX, pero más ligero y usando jQuery estándar).
- Transferencia de datos asíncrona: Las páginas se cargan vacías
<div>destinos (p. ej.,<div id="notes_tab"></div>). Cuando un usuario interactúa con una pestaña, una llamada AJAX obtiene datos JSON ligeros del servidor, y un widget de jQuery UI (como$.custom.notesen/js/notes.js) construye la interfaz sobre la marcha.
Inyección de JavaScript personalizado
Para cargar tus scripts personalizados en HireHop:
- Ve a Configuración > Configuración de la empresa.
- Busca el campo Complementos.
- Introduce la URL completa de tu archivo JavaScript alojado (debe estar alojado en un dominio
https://seguro). - Opcional: Para cargar varios scripts, separe las URL con un punto y coma
;.
Nota: Por motivos de seguridad, los complementos personalizados no se cargarán en la página de Configuración y requieren una suscripción de pago activa.
Ampliar un Widget
Como HireHop se basa en widgets estándar de jQuery UI, puede utilizar la herencia orientada a objetos para anular, ampliar o añadir funciones a los componentes existentes.
A continuación se muestra un ejemplo completo de un complemento personalizado que inyecta un <span> que contiene la palabra “Hola” justo después del botón Actualizar en el widget de notas.
Implementación de JavaScript
Cree un archivo JS en su servidor HTTPS (o inspeccione nuestra demostración en vivo en [https://s.myhirehop.com/plugins/demo.js](https://s.myhirehop.com/plugins/demo.js)):
$(document).ready(function(){
// Check if the notes widget exists (if user is defined a user is logged in, and if doc_type is defined, you are in a HireHop page)
if(typeof($.custom.notes)!==”undefined” && typeof(user)!==”undefined” && typeof(doc_type)!==”undefined” && hh_api_version<=1.3) {
// Redefine notes widget
$.widget(“custom.notes“, $.custom.notes, {
_init_main: function() {
// Call the old _init_main
this._super(arguments);
// Add a hello after the refresh button
$(“<span>“,{ html:” Hello” }).insertAfter(this.btnRefresh);
},
// Even add your own new functions into the widget if you want
new_function_name: function() { }
});
}
});
Desglose del código
| Línea / Fragmento de código | Propósito y mejores prácticas |
| $(document).ready(…) | Espera a que se cargue el DOM antes de ejecutarse. |
| if(typeof($.custom.notes) !== “undefined” …) | Valida que el widget, la sesión de usuario activa y la versión de la API de HireHop compatible existan antes de intentar sobrescribir. |
| $.widget(“custom.notes”, $.custom.notes, {…}) | Combina tus nuevos métodos personalizados directamente en el objeto de widget existente. |
| _init_main: function() { … } | Sobrescribe el método de inicialización predeterminado. |
| this._super(arguments); | Ejecuta la función principal original antes de aplicar tus personalizaciones. |
| $(“”, …).insertAfter(this.btnRefresh); | Inserta el nuevo elemento. Haz siempre referencia a las variables de elementos internos (como this.btnRefresh) en lugar de a los ID de elementos dinámicos, que cambian en cada instancia. |
| new_function_name: function() { } | Muestra cómo añadir nuevas funciones auxiliares al ámbito del widget existente. |
Gestión de caché y versiones
Como el marco de trabajo NoHTML almacena intensamente en caché los archivos de JavaScript para lograr la máxima velocidad, los navegadores no recuperarán automáticamente los archivos de complementos actualizados cuando apliques cambios.
Para forzar a los navegadores de los clientes a borrar su caché y descargar tu script más reciente, añade un parámetro de consulta de versión a la URL de tu complemento en Configuración de la empresa:
- Versión inicial:
[https://www.mywebsite.com/plugin.js?v=1](https://www.mywebsite.com/plugin.js?v=1)
- Versión actualizada:
[https://www.mywebsite.com/plugin.js?v=2](https://www.mywebsite.com/plugin.js?v=2)
Demostración funcional
Para ver un complemento en vivo en acción, añada la siguiente URL a la configuración de su complemento: [https://myhirehop.com/plugins/title_bar.js](https://myhirehop.com/plugins/title_bar.js)
Este script añade un widget de cabecera de acceso rápido en las páginas de Trabajos que permite a los usuarios autorizados cambiar de almacén mediante un menú desplegable. Inspeccione el archivo fuente para ver cómo estructura las adiciones a la interfaz de usuario.