Anmelden

Nsoft Plugin (V 1.0.0.0, Release 16.3)

Das Nsoft Plugin 1.0 (letzte Überarbeitung mit campus21 Release 16.3) erlaubt die Einbindung voll funktionsfähiger campus21-Extensionen (alle auf CmsCell basierende Extensionen wie Zelleninhalte, Trees, Listen) in TYPO3-Seiten. Das Entwurfsmuster für CmsCell seitens des campus21 Framework wurde für das Plugin entsprechend erweitert, sodass es möglich ist, in TYPO3 interaktive Recherchen für nahezu alle Datenbestände von campus21 zu realisieren. Konkret besitzt das Nsoft Plugin folgende Möglichkeiten:

  • Konfiguration der Eigenschaften der campus21-Extension
  • Konfiguration eines Farbcodes (Einpassung der Schaltflächen in das Farbdesign der TYPO3-Seite)
  • Lademechanismen mittels fopen und jquery
  • Ermöglichung der Interaktion zwischen campus21-Extensionen auf einer TYPO3-Seite (z.B. Suchbereich > Ausgabeliste)
  • Aufruf von Detailseiten und Formularseiten über das design-neutrale Popup-Portal (siehe Portalstruktur)
  • gesicherte Übergabe der Frontend-Nutzeranmeldung an die campus21-Extension

Ablauf für die Erstellung eines Inhaltselementes

  1. TYPO3 Backend starten und anmelden
  2. WEB > Seite

Die campus21-Extensions werden in TYPO3 als Inhaltselement eingefügt. Der allgemeine Ablauf ist wie folgt:

  1. Ggf. neue Seite erstellen
  2. Neues Inhaltselement
  3. Plugins > Nsoft Plugin auswählen
  4. Reiter Allgemein > Überschrift optional eingeben
  5. Reiter Erweitert > Eingabe des Konfigurationsstrings

Im Konfigurationsstring befindet sich die gesamte Spezifikation des Plugins: die Extension seitens campus21, deren Eigenschaften sowie das allgemeine Verhalten bestimmende Optionen, siehe Dokumentation unten. Konfigurationsstrings können aus anderen Inhaltselementen oder aus dieser Beschreibung kopiert werden. Danach muss der Konfigurationsstring in der Regel angepasst werden.

Kopieren eines Inhaltselementes

Alternativ können Inhaltselemente in TYPO3 auf ein andere Seite kopiert werden, was die Erstellung vereinfacht. Das Kopieren von Inhaltselementen erfolgt in TYPO3 mit den Funktionen Element kopieren und Element einfügen. Nach dem Einfügen kann das kopierte Inhaltselement deaktiviert sein. Man findet dies im Anzeigemodus WEB > Liste und kann es dort aktivieren. Anschließend wird es unter WEB > Seite angezeigt. Danach muss der Konfigurationsstring angepasst werden.

Allgemein

Funktion der Erweiterung nsoft_plugin ist die Integration von Funktionen oder Informationen aus ECampus21 in TYPO3-Seiten mittels Technologie Web 2.0. Weiterentwicklung von hswm_nsoft_plugin, siehe TYPO3-Extension für nsoft-Plugins. Zukünftig kann die TYPO3-Erweiterung nsoft_plugin auf den gesamten Erweiterungsvorrat sowie auf neuere Web 2.0-basierte Anwendungsfunktionen zugreifen.

  • Suchseiten mit JQ-Entwurfsmuster
  • Anzeige persönlicher Informationen, zumeist auf ECampus21-Randbereichen, Startseiten
  • Umfragen, Foren, Like/ Disliken (nsoftQDE)

Aufbau und Funktionsweise der TYPO3-Erweiterung

Die Erweiterung wird durch einen Konfugurationsstring konfiguriert. Der Konfigurationsstring enthält einen lokalen oder externen Pfad auf die zu ladene nsoft-Ressource. Mit Aufruf der TYPO3-Seite wird mittels JQuery die Ressource geladen und der Inhalt in der TYPO3-Seite dargestellt. Im weiteren erfolgt die Interaktion auf der TYPO3-Seite mit dem nsoft-Server mittels JQuery-Aufrufen

Funktionsmerkmale:

  • Cross-Domain-Unterstützung
  • optionale JS- und CSS-Ressourcen: Aus dem Konfigurationsstring werden ferner zusätzlich zu ladene JS- und CSS-Ressourcen ermittelt (feoptions)
  • Cookieübertragung: von der Extension im FE erstellte Cookies werden beim initialen Laden mitgesendet (z.B. Wiederherstellung Suchselektion, Personalisierungen bei erneutem Seiten Aufruf). Ist insbesondere erforderlich bei cross-domain-Ressourcen.
  • Nutzeranmeldung (in Arbeit, sichere Übertragung der TYPO3-Nutzeridentität an das nsoft-System, dortige Identifizierung des Nutzers)
  • Einbindung einer kundenspezifischen CSS-Ressource (in Arbeit)

Technologie

Die TYPO3-Erweiterung verwendet das JQuery-Framework. Lokale Ressourcen werden mittels AJAX-Aufrufen (HttpRequest) geladen. Externe Ressourcen (auch Cross-Domain-Ressourcen genannt) werden mittels JSONP- (veraltet) oder CORS-Aufrufen (domain-übergreifende AJAX-Aufrufe) geladen, siehe auch Cross-Domain-Ressourcen.

Entwicklungsumgebung

Der Test des Plugins sowie die Erzeugung eines installierbaren Extension (t3x-Archiv) erfordert eine TYPO3-Installation. Die Umgebung ist sehr aufwendig. Grundlegen wurde das Plugin so implementiert, dass es bzgl. alle Extensionen transparent ist. Änderungen im Zuge der Fortentwicklung des campus21-Frameworks sind aber nicht ausschließbar.

Die aktuelle Quelle befindet sich auf QUAD unter:
C:\Users\Falk Neuner\_php\introductionpackage-4.7.7\typo3conf\ext\nsoft_plugin

TODO und Probleme

  • Scriptmerger
  • Bisher (Release 18.1) können im Plugin keine Glyphicons aktiviert werden. In der TYPO3-Seite werden diese nicht angezeigt, auch wenn alle nötigen Ressourcen geladen wurden. In Chrome Tools wird "Rendered Fonts" als "Arial - 1 Glyphs" angezeigt. Offenbar findet Chrom den Font nicht, genaue Ursache ist bisher unbekannt. Aus diesem Grund werden Glyphicons deaktiviert, wenn campus21-Extension durch TYPO3 geladen.

Konfigurationsstring

Syntax

[CORS]?[EXT]:[PAR]

[EXT]:[PAR]

Dabei bedeuten:

  • CORS = Cross-Domain-Adresse (optional)
  • EXT = Pfad der Erweiterung im nsoft-Scriptverzeichnis, beginnend mit nsoft (oder /nsoft gleichwertig)
  • PAR = Parameter, kommagetrennte Schlüssel/Wert-Paare

Beispiel:

http://www.nsoft.de/nsoft/his/jquery.asp?nsoft/sys/extensions/SysStatus:feoptions=0,

Die Parameter werden im wesentlichen durch die Erweiterung bestimmt und nur durch diese serverseitig ausgewertet. Der Parameter feoptions bestimmt das Verhalten der TYPO3-Erweiterung beim initialen Seitenaufruf:

Bit

Beschreibung

1

gleichnamige JS-Ressource laden

2

gleichnamige CSS-Ressource laden

* 1 gleichnamige JS-Ressource laden

* 2 gleichnamige CSS-Ressource laden

* 4 JS/CSS spät laden (workarround für HSM Scriptmerger, wieder abstellen)

* 8 fopen verwenden

* 16 Zelle registrieren, Achtung Änderung in Altsystem-Daten wären erforderlich

* 32 Verfahren Update 16.3 verwenden

* 64 controls.css einbinden (falls Scriptmerger nicht korrekt arbeitet, normalerweise über 2 eingebunden)

* muss bei allen Extension auf der Seite gesetzt sein, sonst siegt letzte

* 128 cookies senden bei fopen

* 256 syslist einbinden

Client-Ressourcen

  • cp js-16.3.js js.js
  • cp jq-16.3.js jq.js
  • cp popup-16.3.js popup.js
  • cp syslist-16.3.js syslist.js
  • cp controls-16.3.css controls.css
   
Top

Wir arbeiten mit Software von http://www.campus21.de.

Verantwortlich für angezeigte Daten ist der Webdomain-Eigentümer laut Impressum.

Suche