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

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://contao.ninja
| ExtVersion=C3 3.1.0 / C4 1.0.0
| Version=ab 2.9
| ERLink=http://www.contao.org/erweiterungsliste/view/gl_xing.html / https://github.com/BugBuster1701/contao-xing-bundle
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
| TrackerLink=https://github.com/BugBuster1701/contao_xing/issues / https://github.com/BugBuster1701/contao-xing-bundle/issues
| Comment=Version für Contao 3 und Contao 4 verfügbar
}}
[[en:Xing]]
[[Kategorie:Extensions]]

=Forum=
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 Tracking System (Links siehe oben) gemeldet werden.

=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 [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 />

=Installation in Contao 4=
Installation erfolgt über Composer. Details siehe [https://github.com/BugBuster1701/contao-xing-bundle/blob/master/README.md Readme auf GitHub].


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

==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 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)
<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 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.<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===
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]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 21:02, 26. Mär. 2016 (CET)