Anpassen von Widgets mit der HireHop-API
HireHop ist vollständig anpassbar. Über die JavaScript-Injektionsmethode können Sie eigene Skripte schreiben, um Benutzeroberflächenelemente zu ändern, maßgeschneiderte Funktionen zu erstellen oder benutzerdefinierte Felder direkt in Ihre HireHop-Instanz einzufügen.
Suchen Sie im Seitenquelltext einer beliebigen HireHop-Seite nach dem <!-- PLUGINS --> Kommentar-Tag. Jegliches über Ihre Plug-in-Einstellungen injizierte benutzerdefinierte JavaScript wird direkt nach diesem Punkt eingefügt.
Das NoHTML-Framework verstehen
HireHop basiert auf einem maßgeschneiderten, schlanken Framework namens KeinHTML. Es verbindet Standard-Webtechnologien zu einem ultraschnellen, erweiterbaren Client-Side-Rendering-Erlebnis:
- Unkomprimierte Quelldateien: Alle standardmäßigen HireHop-JS-Dateien sind zur Leistungssteigerung komprimiert. Um lesbaren, unkomprimierten Quellcode während der Entwicklung zu prüfen, hängen Sie
.MAXan den Dateipfad an (z. B./js/notes.MAX.js).
- Client-Side-Rendering:Abgesehen von der Hauptseitenstruktur werden die meisten Benutzeroberflächenkomponenten dynamisch auf dem Computer des Clients mithilfe von benutzerdefiniertem JavaScript und jQuery-UI-Widgets erstellt (ähnlich wie React und JSX, jedoch leichtgewichtiger und unter Verwendung von Standard-jQuery).
- Asynchrone Datenübertragung:Seiten laden leere
<div>Ziele (z. B.<div id="notes_tab"></div>). Wenn ein Benutzer mit einem Reiter interagiert, ruft ein AJAX-Aufruf leichtgewichtige JSON-Daten vom Server ab, und ein jQuery-UI-Widget (wie$.custom.notesin/js/notes.js) baut die Benutzeroberfläche zur Laufzeit auf.
Einbinden von benutzerdefiniertem JavaScript
So laden Sie Ihre eigenen Skripte in HireHop:
- Navigieren Sie zu Einstellungen > Firmeneinstellungen.
- Suchen Sie das Feld Plugins.
- Geben Sie die vollständige URL Ihrer gehosteten JavaScript-Datei ein (muss auf einer sicheren
https://-Domain gehostet werden). - Optional: Um mehrere Skripte zu laden, trennen Sie die URLs mit einem Semikolon.
;.
Hinweis: Aus Sicherheitsgründen werden benutzerdefinierte Plugins auf der Einstellungsseite nicht geladen und erfordern ein aktives, kostenpflichtiges Abonnement.
Erweitern eines Widgets
Da HireHop auf Standard-jQuery-UI-Widgets basiert, können Sie objektorientierte Vererbung verwenden, um Funktionen bestehender Komponenten zu überschreiben, zu erweitern oder hinzuzufügen.
Unten sehen Sie ein vollständiges Beispiel für ein benutzerdefiniertes Plugin, das ein <span> einfügt, das das Wort “Hallo” direkt nach der Schaltfläche „Aktualisieren“ im Notizen-Widget.
JavaScript-Implementierung
Erstellen Sie eine JS-Datei auf Ihrem HTTPS-Server (oder sehen Sie sich unsere Live-Demo an unter [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() { }
});
}
});
Code-Aufschlüsselung
| Zeile / Code-Snippet | Zweck & Best Practices |
| $(document).ready(…) | Wartet vor der Ausführung auf das Laden des DOM. |
| if(typeof($.custom.notes) !== “undefined” …) | Validiert, dass das Widget, die aktive Benutzersitzung und eine kompatible HireHop-API-Version vorhanden sind, bevor ein Überschreiben versucht wird. |
| $.widget(“custom.notes”, $.custom.notes, {…}) | Führt Ihre neuen benutzerdefinierten Methoden direkt mit dem bestehenden Widget-Objekt zusammen. |
| _init_main: function() { … } | Überschreibt die Standard-Initialisierungsmethode. |
| this._super(arguments); | Führt die ursprüngliche übergeordnete Funktion aus, bevor Ihre Anpassungen angewendet werden. |
| $(“”, …).insertAfter(this.btnRefresh); | Fügt das neue Element ein. Verweisen Sie immer auf interne Elementvariablen (wie this.btnRefresh) anstelle von dynamischen Element-IDs, die sich je Instanz ändern. |
| new_function_name: function() { } | Demonstriert, wie brandneue Hilfsfunktionen an den bestehenden Widget-Geltungsbereich angehängt werden. |
Cache-Verwaltung & Versionierung
Da das NoHTML-Framework JavaScript-Dateien zur Maximierung der Geschwindigkeit stark zwischenspeichert, rufen Browser aktualisierte Plug-in-Dateien beim Veröffentlichen von Änderungen nicht automatisch ab.
Um zu erzwingen, dass Client-Browser ihren Cache leeren und Ihr neuesestes Skript herunterladen, hängen Sie einen Versionierungs-Abfrageparameter an Ihre Plug-in-URL in den Firmeneinstellungen:
- Anfängliche Version:
[https://www.mywebsite.com/plugin.js?v=1](https://www.mywebsite.com/plugin.js?v=1)
- Aktualisierte Version:
[https://www.mywebsite.com/plugin.js?v=2](https://www.mywebsite.com/plugin.js?v=2)
Funktionierende Demo
Um ein Live-Plugin in Aktion zu sehen, fügen Sie die folgende URL in Ihre Plugin-Einstellungen ein: [https://myhirehop.com/plugins/title_bar.js](https://myhirehop.com/plugins/title_bar.js)
Dieses Skript fügt ein Schnellzugriff-Header-Widget auf Auftragsseiten hinzu, mit dem berechtigte Benutzer über ein Dropdown-Menü das Depot wechseln können. Untersuchen Sie die Quelldatei, um zu sehen, wie UI-Erweiterungen strukturiert werden.