Getting Started

In diesem Abschnitt erfährst du, wie du unsere Module in Ninox einbinden und verwenden kannst.

Kauf für Eigengebrauch und Subkunden

Um Nutzerlizenzen für Module in unserem Shop zu erwerben, legst du zuerst ein Benutzer-Profil an und hinterlegst deine Rechnungsdaten. Sobald dein Profil aktiv ist, siehst du alle gebuchten Module zentral in deiner Modulverwaltung und kannst dort den Modul-Code für dich und deine Subkunden verwalten. Wenn du also z.B. Ninox-Partner bist und Module für deine Kunden kaufen möchtest, kannst du sowohl deinen eigenen Modulcode als auch den deiner Kunden über denselben Login kaufen und verwalten.

Grundsätzlich gilt für die Preisgestaltung unserer Module:

• Jede Lizenz muss nur einmalig bezahlt werden. Es gibt kein Abo und keine Pflichtgebühren für Support oder Updates
• Updates bleiben kostenfrei (es besteht jedoch kein Anspruch auf neue Features)

Jeder Kauf gilt als einmaliger Fixpreis pro Primärkunde. Sowohl du als auch jeder deiner Subkunden (falls vorhanden) ist ein Primärkunde.

Bonus-Programm für Subkunden: Wenn du Subkunden hast und für mindestens einen dieser Subkunden eine Modul-Lizenz erworben hast, erhältst du für dein Hauptkonto (dich selbst) eine kostenfreie Lizenz für dieses Modul. Diesen Bonus kannst du nicht rückwirkend in Anspruch nehmen, wenn du bereits für dein Hauptkonto eine Lizenz erworben hast und danach dasselbe Modul für einen Subkunden kaufst.

Was ist ein Primärkunde?

• Fall 1: Du kaufst für dein eigenes Unternehmen 'Meine Digitale GmbH' Modul-Lizenzen → Du als 'Meine Digitale GmbH' bist der Primärkunde
• Fall 2: Du als Ninox-Entwickler 'Meine Digitale GmbH' kaufst für deinen Kunden 'Metallbau Nord GmbH' → 'Metallbau Nord GmbH' ist der Primärkunde für diese Lizenz. Zusätzlich erhältst du für dein Hauptkonto 'Meine Digitale GmbH' eine kostenlose Entwicklerlizenz zum Gebrauch in deinen eigenen Datenbanken (vorausgesetzt du besitzt das Modul für dein Hauptkonto nicht bereits)
• Fall 3: Du als Ninox-Entwickler 'Meine Digitale GmbH' kaufst für 'Software AG', die die Ninox-Umgebung anschließend als SaaS Drittunternehmen bereitstellt → 'Software AG' bleibt der Primärkunde, eventuelle Drittkunden benötigen keine eigene Lizenz

Solltest du weitere Fragen zu unserem Lizenzmodell haben oder dein Anwendungsfall von unserem Primärkundenmodell abweichen, dann kontaktiere uns gerne unter info@goetje-ing.de.

Verwendung in Ninox

Um unsere Module in Ninox einsetzen zu können, sind die folgenden Schritte nötig:

Achtung

Du musst Administrator-Berechtigungen in deiner Ninox-Umgebung haben, um die Module installieren und programmieren zu können.

Abruf des Globalen Codes aus der Modulverwaltung

Nach dem Kauf der Modul-Lizenzen findest du in deinem Nutzer-Bereich unter Modulverwaltung die gekauften Module für dein Hauptkonto und deine Subkunden. Du kannst hier vor dem Download auswählen, welche Modulversionen du exportieren möchtest oder auch Module ausschließen.

In der Kundenverwaltung kannst du für jeden Primärkunden (dich selbst und Subkunden) jeweils individuelles Custom CSS hinterlegen. Dieses Custom CSS wird beim Export des Modulcodes automatisch mit exportiert und in die Funktion GIP_customCSS() integriert. Dadurch besteht nicht die Gefahr, dass du deine individuellen Styles beim Ersetzen des Ninox-Globalcodes versehentlich überschreibst.

Der Export lädt dir eine ZIP-Datei herunter, in der du für jeden ausgewählten Primärkunden eine Textdatei mit dem Globalen Modul-Code für Ninox findest. Deine Export-Zusammenstellungen werden in einer Historie gespeichert, sodass du auch später noch einmal dasselbe Paket herunterladen kannst.

Globalen Code in Ninox einfügen

Den Globalen Modul-Code darfst du in Ninox in jedem Team und jeder Datenbank deines Primärkunden verwenden, für den du die Module gekauft hast.

Wähle eine Datenbank in der du die Module verwenden möchtest. Aktiviere den Bearbeitungsmodus und gehe über die Startseite der Datenbank zu Optionen → Globale Funktionen. Öffne die entsprechende Textdatei aus der heruntergeladenen ZIP-Datei für den gewünschten Primärkunden und kopiere den Modul-Code. Füge den Code in die Globalen Ninox-Funktionen in einer leeren Zeile ein und klicke auf Speichern. Danach musst du deinen Browser einmal mit STRG + F5 (Windows) oder Cmd + Shift + R (MacOS) neu laden. Du kannst nun überall in deiner Datenbank die Module nutzen.

Modulcode in Ninox nutzen

Um ein Modul in einer Ninox-Tabelle oder -Page zu nutzen, erstellst du ein neues Formelfeld. Wähle nun ein Modul aus unserer Dokumentation und kopiere den Modulcode. Insgesamt hast du beim Modulcode verschiedene Varianten zur Verfügung:

• Empfohlene Code-Struktur für Basis, Medium oder Fortgeschritten
• Vollständigen Modulcode
• Vollständigen Modulcode mit Master

Der Master ist eine kleine Funktion von uns, mit der einmalig alle CSS-Stylings und Funktionen geladen werden, sodass sie von all unseren Modulen genutzt werden können. Dadurch müssen diese Inhalte nicht von jedem Modul neu abgerufen werden und wir können dir eine bessere Performance bieten.

Zu beachten

Du musst pro Ninox-Tabelle und pro View, in der du eines unserer Module verwenden möchtest, mindestens einmal den Master geladen haben. Dafür nutzt du die folgende Code-Struktur:

html( raw( GIP_master({}) ) + raw( //GIP-Modulcode deiner Wahl ))

Füge nun den kopierten Modulcode in dein Formelfeld ein und fülle die Werte der Keys aus. Eine Beschreibung der einzelnen Keys sowie Informationen zu Datentyp, Default-Werten und Besonderheiten findest du ebenfalls in der Dokumentation des Moduls im Abschnitt Modulkeys. Außerdem ist dort angegeben, ob der Key ein Pflichtkey ist, also unbedingt von dir ausgefüllt werden muss.

Nachdem du den Modulcode vollständig ausgefüllt hast, kannst du dein Formelfeld speichern und das Ergebnis in deinem Ninox-Formular bewundern.