Aktuelle Version vom 12. Mai 2018, 16:23 Uhr

Normalerweise braucht man dazu kein richtiges Modul um einen Xing Profil Banner auf die Webseite zu bringen, da es sich ja nur um ein verlinktes Bild handelt. Aber das Bild sollte wählbar sein, die Position bestimmbar, auch mehrere davon auf einer Seite, oder verteilt auf mehrere Domains.

Mit dem Modul können Kategorien angelegt werden, in diesen dann das XING Profil. Über den XING Listener kann man dann die Kategorien auswählen, die angezeigt werden sollen. Jedem Frontend Modul kann ein eigenes Template zugeordnet werden. Drei unterschiedliche Templates + eines für ein Firmen Profil werden mitgeliefert, dazu später mehr. Somit ist es dann möglich, die Kategorien auf mehrere Layouts bzw. Domains zu verteilen. Wenn man mehrere Profile in einer Kategorie anlegt, werden alle aus der Kategorie angezeigt. Damit wäre es z.B. möglich, die Profile eines ganzen Teams anzuzeigen.

Erweiterungs-Übersicht

Name des Entwicklers	Glen Langer (BugBuster)
Entwickler Webseite	http://contao.ninja
Version der Erweiterung	C3 3.1.0 / C4 1.2.0
Kompatibilität mit Contao Version	ab 2.9

Link zum Extension Repository	http://www.contao.org/erweiterungsliste/view/gl_xing.html / https://github.com/BugBuster1701/contao-xing-bundle
Den Entwickler unterstützen	http://www.amazon.de/wishlist/26HHEJOU03G76
Link zum Tracker	https://github.com/BugBuster1701/contao_xing/issues / https://github.com/BugBuster1701/contao-xing-bundle/issues


Anmerkung	Version für Contao 3 und Contao 4 verfügbar

Forum

Fragen zum Xing Modul werden im Forum beantwortet: Sonstige-Erweiterungen
Fehler und Wünsche können im Tracking System (Links siehe oben) gemeldet werden.

Installation in Contao 3

Installation erfolgt über das Extension Repository im Backend der Contao Installation.
Eine manuelle Installation ist möglich, dazu die ZIP Datei vom Extension Repository laden, entpacken und entsprechend übertragen.
Dadurch sollte ein Verzeichnis /system/modules/gl_xing angelegt worden sein.
Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen.

Contao 3: Update von Version 1.x auf Version 2.x

Achtung: Die Version 2.x ist nicht vollständig kompatibel, ein Update ist aber möglich.

Was dabei zu beachten ist, kann hier nachgelesen werden.

Xing Update Version 1 auf Version 2

Installation in Contao 4

Installation erfolgt über Composer. Details siehe Readme auf GitHub.

Übersicht

Das Xing Modul bringt ein Backend und ein Frontend Modul mit.
Im Backend gibt es "Xing", für das Frontend "Xing Anzeige".

Backend

Xing

Frontend

Für das Frontend Modul wird als Beispiel eine CSS Datei mitgeliefert:

mod_xing_fe.css für die normale, zeilenweise Ausgabe

Xing Anzeige

Die einfachste Variante, nur das verlinkte Bild:

Die komplexere Variante, mehrere Xing Banner eines Teams, mit Teamname und Namen der Team Mitglieder.

Erste Schritte

Als erstes legt man über den Menüpunkt Xing eine neue Kategorie an. In dieser dann das Xing Profil / die Xing Profile.
Danach legt man ein Frontend Modul an und baut es in das Layout der Seite ein.
Hier nun die einzelnen Schritte, jeweils mit den Default Angaben. Feinheiten werden später erklärt.

Anlegen einer Kategorie

Um eine neue Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Xing'. Im Hauptbereich dann auf den Button 'Neue Kategorie'.

Dort gibt man der Kategorie einen Namen, auf diesem wird später das Frontend Modul zurückgreifen. Anschließend klickt man auf "Speichern und Schließen".
Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.

Anlegen des Profils

In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie.
Dort entweder auf 'Neues Profil' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie:

Nun sind einige Angaben nötig:

XING Profil eingeben, z.B.: Max_Mustermann bzw. meinefirma , Erläuterungen dazu in der Hilfe (Help Wizard)
XING Layout wählen, Erläuterungen dazu in der Hilfe (Help Wizard)
"Veröffentlicht" aktivieren

anschließend klickt man auf "Speichern und Schließen".

Frontend Modul

Ein neues Frontend Modul wird angelegt über:

Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)

Als erstes unbedingt zuerst den Titel eingeben, erst dann bei Modultyp: 'Xing' - 'Xing Anzeige' auswählen. Es ändern sich nun die Formularfelder.
Bei 'Xing Kategorie' nun die vorher angelegte Kategorie auswählen, anschließend 'Speichern und Schließen'.

Nun muss das angelegte Frontend Modul noch im Layout eingebunden werden:

Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)

Bei 'Eingebundene Module' das gerade erstellte Frontend Modul einbinden (z.b in left)

CSS-Datei

Wie bereits erwähnt, wird für die Darstellung eine CSS-Datei mitgeliefert. Für die ersten Tests sollte die Datei mod_xing_fe.css aus dem Verzeichnis /system/modules/gl_xing kopiert werden nach /tl_files bzw. /files und dann über das Backend importiert und im Layout aktiviert werden.

Feinheiten

Feinheiten sind innerhalb der Kategorie sowie im selbst angelegtem Frontend Modul machbar/einstellbar.

Feinheiten innerhalb der Kategorie

Team Profile

In den Einstellungen in der Kategorie selbst gibt es nichts weiter, aber man kann in der Kategorie mehrere Xing-Profile anlegen.
Einsatz wäre z.B. eine Übersicht von allen Team Mitgliedern.
Je nach Template Auswahl im Frontend-Modul wird der Kategorie-Name zum Team-Name.
Siehe nächsten Abschnitt wie das Ganze dann aussehen kann.

Feinheiten in der Frontend Modul Definition

Templates

Ist nur ein Xing-Profil in der Kategorie definiert, sind folgende zwei Templates sinnvoll einzusetzen:

mod_xing_list , es wird nur die verlinkte Grafik gezeigt
mod_xing_list_profile, es wird die verlinkte Grafik gezeigt, darunter der Profile Name (Unterstrich wird dabei entfernt)

Sind mehrere Xing-Profile in der Kategorie definiert um ein Team darzustellen, sind folgende zwei Templates sinnvoll einzusetzen:

mod_xing_list_profile, es werden untereinander die verlinkten Grafiken angezeigt, jeweils darunter der Profile Name (Unterstrich wird dabei entfernt)
mod_xing_list_team, wie bei mod_xing_list_profile, zusätzlich erscheint über der ersten Grafik der Team-Name (Kategorie Name)

Sie können eigene Templates im Ordner /templates bzw. im Template Ordner des verwendetem Themes speichern.
Templates müssen mit mod_xing_list beginnen und die Dateiendung .tpl / .xhtml / .html5 haben. ( z.B.: mod_xing_list_club47.xhtml )

Company Template

Da bei XING ein Firmenprofil eine andere Ziel-URL hat, wurde für ein Firmenprofil ein eigenes Template erstellt. Daher bitte bei einem Firmenprofil das Template "mod_xing_list_company" auswählen.

Nur Gästen anzeigen

Nach dem Aktivieren der Funktion wird das Modul versteckt, sobald ein Mitglied (Frontend Nutzer) angemeldet ist.

Modul schützen

Hier kann nun definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen angemeldet sind.

Datenschutz

Einige Worte zum Thema Datenschutz.

Datenspeicherung

Um den Link zum Profil generieren zu können, muss der Profilname über das Backend angegeben werden. Dieser wird gespeichert.

Ein Klick auf den Xing Profil Button wird nicht erfasst, der Link zeigt direkt zum Profil auf Xing.

In der Contao 4 Erweiterung, ab Version 1.2.0, werden die Profil Buttons lokal geladen, nicht mehr vom Xing Server (einstellbar).

--BugBuster (Diskussion) 17:19, 12. Mai 2018 (CEST)

@@ Zeile 1: / Zeile 1: @@
-{{stub}}
+[[Datei:Modul_Xing_Team.jpg|right|Xing Team]]Normalerweise braucht man dazu kein richtiges Modul um einen Xing Profil Banner auf die Webseite zu bringen, da es sich ja nur um ein verlinktes Bild handelt. Aber das Bild sollte wählbar sein, die Position bestimmbar, auch mehrere davon auf einer Seite, oder verteilt auf mehrere Domains.
-[[Datei:Modul_Xing_Team.jpg|right|Xing Team]]Normalerweise braucht man dazu kein richtiges Modul um einen Xing Banner auf die Webseite zu bringen, da es sich ja nur um ein verlinktes Bild handelt. Aber das Bild sollte wählbar sein, die Position bestimmbar, auch mehrere davon auf einer Seite, oder verteilt auf mehrere Domains.
+Mit dem Modul können Kategorien angelegt werden, in diesen dann das XING Profil. Über den XING Listener kann man dann die Kategorien auswählen, die angezeigt werden sollen. Jedem Frontend Modul kann ein eigenes Template zugeordnet werden. Drei unterschiedliche Templates + eines für ein Firmen Profil werden mitgeliefert, dazu später mehr.
-Mit dem Modul können Kategorien angelegt werden, in diesen dann das XING Profil. Über den XING Lister kann man dann die Kategorien auswählen, die angezeigt werden sollen. Jedem Frontend Modul kann ein eigenes Template zugeordnet werden. Drei unterschiedliche Templates werden mitgeliefert, dazu später mehr.
 Somit ist es dann möglich, die Kategorien auf mehrere Layouts bzw. Domains zu verteilen. Wenn man mehrere Profile in einer Kategorie anlegt, werden alle aus der Kategorie angezeigt. Damit wäre es z.B. möglich, die Profile eines ganzen Teams anzuzeigen.
 {{ExtInfo
 | Dev=Glen Langer ([[User:BugBuster|BugBuster]])
-| DevSite=http://www.contao.glen-langer.de
+| DevSite=http://contao.ninja
-| ExtVersion=1.1.1
+| ExtVersion=C3 3.1.0 / C4 1.2.0
 | Version=ab 2.9
-| TLVersion=2.8.0 - 2.9.0
+| ERLink=http://www.contao.org/erweiterungsliste/view/gl_xing.html / https://github.com/BugBuster1701/contao-xing-bundle
-| ERLink=http://www.contao.org/erweiterungsliste/view/gl_xing.html
+| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
-| DonateLink=Cappuccino beim nächsten Stammtisch Treff
+| TrackerLink=https://github.com/BugBuster1701/contao_xing/issues / https://github.com/BugBuster1701/contao-xing-bundle/issues
-| TrackerLink=http://dev.typolight-forge.org/projects/xing/issues
+| Comment=Version für Contao 3 und Contao 4 verfügbar
-| Comment=Version 2.0.0 in Vorbereitung - dann Theme Manager kompatibel
 }}
 [[en:Xing]]
@@ Zeile 19: / Zeile 17: @@
 =Forum=
-Fragen zum Xing Modul werden im Forum beantwortet: [http://www.contao-community.de/showthread.php?4225 Forum - Support für Extensions]
+Fragen zum Xing Modul werden im Forum beantwortet: [https://community.contao.org/de/forumdisplay.php?119 Sonstige-Erweiterungen]
 <br />
-Fehler und Wünsche können im [http://dev.typolight-forge.org/projects/xing/issues Tracking System] gemeldet werden.
+Fehler und Wünsche können im Tracking System (Links siehe oben) gemeldet werden.
-=Installation=
+=Installation in Contao 3=
 Installation erfolgt über das Extension Repository im Backend der Contao Installation.<br />
-Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/erweiterungsliste/view/gl_xing.html vom Extension Repository laden], entpacken und entsprechend übertragen.<br />
+Eine manuelle Installation ist möglich, dazu die ZIP Datei [https://contao.org/de/erweiterungsliste/view/gl_xing.html vom Extension Repository laden], entpacken und entsprechend übertragen.<br />
 Dadurch sollte ein Verzeichnis /system/modules/gl_xing angelegt worden sein.<br />
 Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen.<br />
-( /typolight/install.php bei älteren TYPOlight Installationen )<br /><br />
-==Hinweis für ältere TYPOlight Versionen==
+==Contao 3: Update von Version 1.x auf Version 2.x==
-===TYPOlight 2.7===
-Nutzer von TYPOlight 2.7.x nutzen bitte Xing Modul Version 1.0.4 ([http://www.contao.org/erweiterungsliste/view/gl_xing.10000049.de.html Direktlink])
-===TYPOlight 2.6===
-Nutzer von TYPOlight 2.6.x nutzen bitte Xing Modul Version 1.0.4 ([http://www.contao.org/erweiterungsliste/view/gl_xing.10000049.de.html Direktlink])
-<br /><br />
-==Update von Version 1.x auf Version 2.x==
 {{Achtung|Die Version 2.x ist nicht vollständig kompatibel, ein Update ist aber möglich.}}
 <br />
-Was dabei zu beachten ist, kann hier nachgelesen werden. (sobald erschienen)
+Was dabei zu beachten ist, kann hier nachgelesen werden.
-*[[Xing_Update_v1_auf_v2|Xing Update Version 1 auf Version 2]]
+*[[Xing_Update_v1_auf_v2|'''Xing Update Version 1 auf Version 2''']]
 <br />
+=Installation in Contao 4=
+Installation erfolgt über Composer. Details siehe [https://github.com/BugBuster1701/contao-xing-bundle/blob/master/README.md Readme auf GitHub].
 =Übersicht=
@@ Zeile 51: / Zeile 45: @@
 ===Xing===
-ToDo: Bild
+[[Datei:Xing_de_backend.jpg|Xing Modul Backend]]
 ==Frontend==
@@ Zeile 58: / Zeile 52: @@
 ===Xing Anzeige===
-ToDo: Bild
+Die einfachste Variante, nur das verlinkte Bild:<br />
+[[Datei:Modul_Xing_List.tpl.jpg|Xing Banner]]
+<br /><br />
+Die komplexere Variante, mehrere Xing Banner eines Teams, mit Teamname und Namen der Team Mitglieder.<br />
+[[Datei:Modul_Xing_Team.jpg|Xing Team]]
+<br /><br />
 =Erste Schritte=
-Als erstes legt man über den Menüpunkt Xing eine neue Besucher Kategorie an. In dieser dann das Xing Profil / die Xing Profile.<br />
+Als erstes legt man über den Menüpunkt Xing eine neue Kategorie an. In dieser dann das Xing Profil / die Xing Profile.<br />
 Danach legt man ein Frontend Modul an und baut es in das Layout der Seite ein.<br />
 Hier nun die einzelnen Schritte, jeweils mit den Default Angaben. Feinheiten werden [[Xing#Feinheiten|später erklärt]].
 ==Anlegen einer Kategorie==
-Um eine neue Besucher Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Xing'. Im Hauptbereich dann auf den Button 'Neue Kategorie'. <br />
+Um eine neue Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Xing'. Im Hauptbereich dann auf den Button 'Neue Kategorie'. <br />
-''Bild folgt''<br />
+[[Datei:Xing_de_backend_kategorie.jpg|Xing - Neue Kategorie]]<br /><br />
-Dort gibt man der Kategorie einen Namen, auf diesem wird später das Fontend Modul zurückgreifen. Anschließend klickt man auf "Speichern und Schließen".<br />
+Dort gibt man der Kategorie einen Namen, auf diesem wird später das Frontend Modul zurückgreifen. Anschließend klickt man auf "Speichern und Schließen".<br />
 Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.
@@ Zeile 74: / Zeile 73: @@
 In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie.<br />
 Dort entweder auf 'Neues Profil' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie: <br />
-''Bild folgt''<br />
+[[Datei:Xing_de_backend_profil_neu.jpg|Xing - neues Profil]]<br /><br />
 Nun sind einige Angaben nötig:
-* XING Profil eingeben, z.B.: Max_Mustermann , Erläuterungen dazu in der Hilfe (Help Wizard)
+* XING Profil eingeben, z.B.: Max_Mustermann bzw. meinefirma , Erläuterungen dazu in der Hilfe (Help Wizard)
 * XING Layout wählen, Erläuterungen dazu in der Hilfe (Help Wizard)
 * "Veröffentlicht" aktivieren
@@ Zeile 82: / Zeile 81: @@
 ==Frontend Modul==
+Ein neues Frontend Modul wird angelegt über:
+* Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)
+<br />
+Als erstes unbedingt '''zuerst den Titel''' eingeben, erst dann bei Modultyp: 'Xing' - 'Xing Anzeige' auswählen. Es ändern sich nun die Formularfelder.<br />
+Bei 'Xing Kategorie' nun die vorher angelegte Kategorie auswählen, anschließend 'Speichern und Schließen'.<br />
+<br />
+Nun muss das angelegte Frontend Modul noch im Layout eingebunden werden:
+* Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)
+Bei 'Eingebundene Module' das gerade erstellte Frontend Modul einbinden (z.b in left)
 ==CSS-Datei==
 Wie bereits erwähnt, wird für die Darstellung eine CSS-Datei mitgeliefert.
-Für die ersten Tests sollte die Datei mod_xing_fe.css aus dem Verzeichnis /system/modules/gl_xing kopiert werden nach /tl_files und dann über das Backend importiert und im Layout aktiviert werden.
+Für die ersten Tests sollte die Datei mod_xing_fe.css aus dem Verzeichnis /system/modules/gl_xing kopiert werden nach /tl_files bzw. /files und dann über das Backend importiert und im Layout aktiviert werden.
 =Feinheiten=
-Feinheiten sind einstellbar im selbst angelegtem Frontend Modul.
+Feinheiten sind innerhalb der Kategorie sowie im selbst angelegtem Frontend Modul machbar/einstellbar.
 ==Feinheiten innerhalb der Kategorie==
 ===Team Profile===
+In den Einstellungen in der Kategorie selbst gibt es nichts weiter, aber man kann in der Kategorie mehrere Xing-Profile anlegen.<br >
+Einsatz wäre z.B. eine Übersicht von allen Team Mitgliedern.<br />
+Je nach Template Auswahl im Frontend-Modul wird der Kategorie-Name zum Team-Name.<br />
+Siehe nächsten Abschnitt wie das Ganze dann aussehen kann.
 ==Feinheiten in der Frontend Modul Definition==
 ===Templates===
+Ist nur ein Xing-Profil in der Kategorie definiert, sind folgende zwei Templates sinnvoll einzusetzen:
+* mod_xing_list , es wird nur die verlinkte Grafik gezeigt<br />[[Datei:Modul_Xing_List.tpl.jpg‎|mod_xing_list]]
+* mod_xing_list_profile, es wird die verlinkte Grafik gezeigt, darunter der Profile Name (Unterstrich wird dabei entfernt)<br />[[Datei:Modul_Xing_Profile.tpl.jpg‎|mod_xing_profile]]
+<br />
+Sind mehrere Xing-Profile in der Kategorie definiert um ein Team darzustellen, sind folgende zwei Templates sinnvoll einzusetzen:
+* mod_xing_list_profile, es werden untereinander die verlinkten Grafiken angezeigt, jeweils darunter der Profile Name (Unterstrich wird dabei entfernt)<br />[[Datei:Modul_Xing_Profile-2.tpl.jpg‎|mod_xing_profile]]
+* mod_xing_list_team, wie bei mod_xing_list_profile, zusätzlich erscheint über der ersten Grafik der Team-Name (Kategorie Name) <br />[[Datei:Modul_Xing_Team.jpg‎|mod_xing_team]]
+<br />
+Sie können eigene Templates im Ordner /templates bzw. im Template Ordner des verwendetem Themes speichern.<br />
+Templates müssen mit '''''mod_xing_list''''' beginnen und die Dateiendung '''''.tpl''''' / '''''.xhtml''''' / '''''.html5''''' haben. ( z.B.: '''''mod_xing_list_club47.xhtml''''' )
+<br />
+===Company Template===
+Da bei XING ein Firmenprofil eine andere Ziel-URL hat, wurde für ein Firmenprofil ein eigenes Template erstellt.
+Daher bitte bei einem Firmenprofil das Template "mod_xing_list_company" auswählen.
 ===Nur Gästen anzeigen===
@@ Zeile 102: / Zeile 131: @@
 Hier kann nun definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen angemeldet sind.
+=Datenschutz=
+Einige Worte zum Thema Datenschutz.
+==Datenspeicherung==
+Um den Link zum Profil generieren zu können, muss der Profilname über das Backend angegeben werden. Dieser wird gespeichert.
+Ein Klick auf den Xing Profil Button wird nicht erfasst, der Link zeigt direkt zum Profil auf Xing.
+In der Contao 4 Erweiterung, ab Version 1.2.0, werden die Profil Buttons lokal geladen, nicht mehr vom Xing Server (einstellbar).
 ----
---[[Benutzer:BugBuster|BugBuster]] 10:29, 9. Aug. 2010 (CEST)
+--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 17:19, 12. Mai 2018 (CEST)

Xing: Unterschied zwischen den Versionen

Aus Contao Community Documentation

Aktuelle Version vom 12. Mai 2018, 16:23 Uhr

Inhaltsverzeichnis