Quelltext der Seite Xing

[[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 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
| ExtVersion=2.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.4 (siehe Installationshinweise)
| ERLink=http://www.contao.org/erweiterungsliste/view/gl_xing.html
| DonateLink=Cappuccino beim nächsten Stammtisch Treff
| TrackerLink=http://dev.typolight-forge.org/projects/xing/issues
| Comment=Version für Contao 2.9.0 verfügbar
}}
[[en:Xing]]
[[Kategorie:Extensions]]

=Forum=
Fragen zum Xing Modul werden im Forum beantwortet: [http://www.contao-community.de/showthread.php?4225 Forum - Support für Extensions]
<br />
Fehler und Wünsche können im [http://dev.typolight-forge.org/projects/xing/issues Tracking System] gemeldet werden.

=Installation=
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 />
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==
===TYPOlight 2.8===
Nutzer von TYPOlight 2.8.x nutzen bitte Xing Modul Version 1.1.1 ([http://www.contao.org/erweiterungsliste/view/gl_xing.10010009.de.html Direktlink])
===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])
<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.
*[[Xing_Update_v1_auf_v2|'''Xing Update Version 1 auf Version 2''']]
<br />

=Übersicht=
Das Xing Modul bringt ein Backend und ein Frontend Modul mit.<br />
Im Backend gibt es "Xing", für das Frontend "Xing Anzeige".

==Backend==

===Xing===
[[Datei:Xing_de_backend.jpg|Xing Modul Backend]]

==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:<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 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 Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Xing'. Im Hauptbereich dann auf den Button 'Neue Kategorie'. <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 />
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.<br />
Dort entweder auf 'Neues Profil' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie: <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 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)
* Layout -> Module -> Neues Modul (TYPOlight bis 2.8.x)
<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)
* Layout -> Seitenlayout -> Edit des genutzte Layouts (TYPOlight bis 2.8.x)

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.

=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.<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 />
Sie 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''''' haben. ( z.B.: '''''mod_xing_list_club47.tpl''''' )
<br />

===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.



----
--[[Benutzer:BugBuster|BugBuster]] 10:14, 12. Aug. 2010 (CEST)