Upload Field Extension (Uploadfelder für Formulare bereitstellen)

Inhalt

1. Wozu dient das Plugin "Upload Field Extension (Uploadfelder für Formulare bereitstellen)"

In Formularen kann es manchmal nötig sein, Felder für Dateiuploads bereitzustellen, mit denen die Besucher dem Formular eigene Dateien anhängen können. Typische Anwendungsfälle in Online-Shops können z. B. sein:

  • (Rück-) Fragen zu bestimmten Produkten
  • Reklamationen
  • Antragsformulare
  • Bewerbungsformulare
  • Studentennachweise
  • Handelsregisterauszüge
  • Individuelle Formulare in Abhängigkeit von der Branche

2. Was kann das Plugin "Upload Field Extension (Uploadfelder für Formulare bereitstellen)"

Das knowmates-Plugin „Upload Field Extension“ ist exklusiv für das Shopsystem JTL-Shop entwickelt. Mit diesem Plugin binden Sie einen Datei-Upload an verschiedenen Positionen bzw. in den gewünschten Formularen mit anschließendem E-Mail-Versand ein (siehe Abbildung 1).

Abbildung 1: „Upload Field Extension“ im Frontend eines JTL-Shops

Das Upload-Feld kann bei folgenden Formularen verarbeitet/ausgewertet werden:

  • Login (aus Navigation & aus Website) & Registrieren
  • Newsletter an-/abmelden
  • Rechnungsdaten und Lieferadressen verwalten
  • Blogbeitrag kommentieren
  • Kontaktformular
  • Bewertungsformular
  • Fragen zum Produkt

Sollte es andere Formulare geben, wäre die Funktion dort zu prüfen und ggf. neu zu entwickeln.

 

3. Systemvoraussetzungen

  • JTL-Shop 5.2, 5.3
  • PHP 8.1, PHP 8.2
  • Template NOVA
  • ionCube Loader in der aktuellsten Version

4. Installation im JTL-Shop

Für Deinen JTL-Shop 5 beziehst Du Plugins über den JTL-Extension Store. Um auf Inhalte des JTL-Extension Stores zugreifen zu können, musst Du zunächst Dein JTL-Konto mit Deinem JTL-Shop 5 verknüpfen. Dies wird normalerweise beim Installationsprozess des Shops bereits abgefragt.

So verknüpfst Du Dein JTL-Konto mit Deinem JTL-Shop 5:

  1. Logge Dich im JTL-Shop-Backend ein.
  2. Navigiere im Menü zu „PLUGINS“ > „Meine Käufe“.
  3. Klicke auf „Konto verknüpfen“.
  4. Logge Dich mit Deinen JTL-Daten ein.
  5. Anschließend siehst Du in „PLUGINS“ > „Meine Käufe“ die Übersicht zu Deinen Lizenzen und Subscriptions.

So buchst Du eine Extension für JTL-Shop 5:

  1. Rufe den JTL-Extension Store auf.
  2. Suche nach dem gewünschten Plugin.
  3. Wähle das Plugin aus und klicke auf „Jetzt auschecken“.
  4. Klicke im folgenden Fenster auf „Anmelden“ und melde Dich mit Deinem zentralen JTL-Login an.
  5. Klicke im JTL-Checkout auf „Jetzt bestellen“, um die Bestellung abzuschließen.
  6. Rufe Dein JTL-Shop-Backend auf. Unter „PLUGINS“ > „Meine Käufe“ befindet sich jetzt im Bereich „Ungebundene Lizenzen“ Deine eben erworbene Lizenz.
  7. Nun ordnest Du das Plugin Deinem Shop zu. Klicke dafür auf „An diesen Onlineshop“ anbinden.
  8. Anschließend findest Du die Lizenz im Bereich „Gebundene Lizenzen“ und die Schaltfläche „Installieren“ steht zur Verfügung. Nach der Installation kannst Du das Plugin im Menü unter „PLUGINS“ > „Plugin-Manager“ in der Registerkarte „Aktiviert“ konfigurieren.

5. Plugin "Upload Field Extension (Uploadfelder für Formulare bereitstellen)" einrichten

Rufen Sie das Konfigurationsmenü entweder unter „Plugin-Manager“ > „Aktiviert“ über das entsprechende Zahnrad-Icon auf der rechten Seite oder direkt über „Installierte Plugins“ > „Upload Field Extension“ auf.

Du siehst nun die Plugin-Benutzeroberfläche (siehe Abbildung 2).

Abbildung 2: Benutzeroberfläche vom Plugin „Upload Field Extension“

Oben rechts befindet sich ein Switch, mit welchem Du zwischen hellem und dunklem Design wechseln kannst.

Triff nun die gewünschten Einstellungen für das Plugin „Upload Field Extension“.

Der Reiter „Einstellungen“ beinhaltet folgende Optionen (siehe Abbildung 3):

Abbildung 3: Reiter „Einstellungen“

  • Plugin-Status (aus/an): Anzeige im Shop-Frontend aktivieren/deaktivieren.

Der Reiter „Formulareinstellungen“ beinhaltet die folgenden Optionen (siehe Abbildungen 4 und 5):

Abbildung 4: Reiter „Formulareinstellungen“

  • neues Feld erstellen: Über diesen Button öffnen Sie das Dialogfenster „Formularfeld bearbeiten“, über das Sie die gewünschten Feldeinstellungen treffen. In diesem Reiter werden die angelegten Felder aufgelistet. Diese können Sie auch im Nachhinein bearbeiten, löschen oder duplizieren.

Abbildung 5: Dialogfenster „Formularfeld bearbeiten“ – Feldeinstellungen

  • Feld aktiv: Anzeige im Shop-Frontend aktivieren/deaktivieren
  • Pflichtfeld: Bei gesetzter Einstellung kann der Kunde das Formular nur absenden, wenn dieses Feld befüllt ist.
  • Feldname (Deutsch): Das ist der für den Kunden sichtbare Feldname.
  • Beschreibung (Deutsch): Dieses Feld bietet die Möglichkeit, eine zusätzliche Beschreibung zum Formularfeld zu hinterlegen, sofern dies für den Kunden hilfreich ist.
  • Feldname (Englisch): Das ist der für den Kunden sichtbare Feldname.
  • Beschreibung (Englisch): Dieses Feld bietet die Möglichkeit, eine zusätzliche Beschreibung zum Formularfeld zu hinterlegen, sofern dies für den Kunden hilfreich ist.
  • Dateiname: Mit diesem Dateinamen wird die Datei gesendet (erlaubte Zeichen a-z und Unterstrich).
  • Empfänger-E-Mail: An diese E-Mail-Adresse wird die hochgeladene Datei versendet.
  • Max-Größe in MB: Hier legen Sie die maximale Dateigröße für die hochzuladende Datei fest.
  • erlaubte Dateitypen: Bilder (.bmp, .gif, .jpg, .png, .svg, .webp), Videos (.avi, .mpeg, .ogv, .webm, .3gp), Textdokumente (.txt, .doc, .docx, .odt, .rtf), Präsentationen (.odp, .pdf, .ppt,  .pptx), Daten (.csv, .xml), Tabellen (.ods, .xls, .xlsx), Dateiarchive (.rat, .zip, .7z)

Mit einem Klick auf „Formular hinzufügen“ legen Sie die Verknüpfung für das eben erstellte Feld an (siehe Abbildung 6).

Abbildung 6: Dialogfenster „Formularfeld bearbeiten“ – Formulareinstellungen

  • Name für die Verknüpfung: Hier geben Sie die Bezeichnung für die Verknüpfung an. Diese dient lediglich internen Zwecken.
  • Selektor für das zu verknüpfende Formular: Mit diesem CSS-Selektor wird auf das Formular zugegriffen.
  • Anzeigeposition: Hier legen Sie fest, ob das Feld im Formular als erstes Feld oder als letztes Feld hinzugefügt werden soll oder aber nach/vor einem gewünschten Element bzw. ob es dieses Element ersetzen soll.
  • Selektor für die Anzeigeposition: Hier geben Sie ein Element an, auf das sich die Anzeigeposition beziehen soll.

Der Reiter „Lizenz“ beinhaltet folgende Optionen (siehe Abbildungen 7 & 8):

Abbildung 7: Reiter „Lizenz“ – keine gültige Lizenz vorhanden

  • Lizenz abfragen: Beim Kauf wird für die angegebene Domain eine Lizenz auf dem Lizenz-Server angelegt. Über den Button wird auf diesem geprüft, ob für Deine Domain eine Lizenz des Plugins vorliegt, und welche Art von Lizenz es ist.
  • Plugin für 14 Tage testen: Fordere eine Testphase von 14 Tagen an. Nach diesen 14 Tagen läuft die Test-Lizenz ab.
  • Lizenz kaufen: Eine vollwertige Lizenz über 12 Monate ist im JTL-Extension Store zu erwerben. Hier kannst Du Deine Lizenz auch um 12 oder 24 Monate verlängern.

Abbildung 8: Reiter „Lizenz“ – gültige Lizenz vorhanden

  • Lizenz abfragen: Beim Kauf wird für die angegebene Domain eine Lizenz auf dem Lizenz-Server angelegt. Über den Button wird auf diesem geprüft, ob für Deine Domain eine Lizenz des Plugins vorliegt, und welche Art von Lizenz es ist.
  • Lizenz verlängern: Eine vollwertige Lizenz über 12 Monate ist im JTL-Extension Store zu erwerben. Hier kannst Du Deine Lizenz auch um 12 oder 24 Monate verlängern.

Der Reiter „Über“ beinhaltet folgende Informationen (siehe Abbildung 9):

Abbildung 9: Reiter „Über“ (Versionsnummer exemplarisch)

Im Reiter „Über“ findest Du Informationen zur Plugin-Version, PHP-Version, IonCube-Version, zum Plugin-Autor sowie die (Shop)-Webseite des Autors als auch zwei Buttons, über den Du das Plugin Log leerst bzw. öffnest.