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 .MAX an 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.notes in /js/notes.js) baut die Benutzeroberfläche zur Laufzeit auf.

Einbinden von benutzerdefiniertem JavaScript

So laden Sie Ihre eigenen Skripte in HireHop:

  1. Navigieren Sie zu Einstellungen > Firmeneinstellungen.
  2. Suchen Sie das Feld Plugins.
  3. Geben Sie die vollständige URL Ihrer gehosteten JavaScript-Datei ein (muss auf einer sicheren https://-Domain gehostet werden).
  4. 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-SnippetZweck & 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.