Seitentemplate-Verwaltung
Änderungen
Bitte beachten Sie, dass hier mit Release 5.20 grundlegende Änderungen stattgefunden haben. Bisher wurden die Seitentemplates im Dateisystem editiert. Nunmehr werden sie (wie alle Templates in contentXXL) sowohl in der Datenbank als auch im Dateisystem gespeichert. In Sitemanager gibt es den neuen Bereich "Seitentemplates".
Das Standard-Seitentemplate (desktopdefault.ascx) wird nunmehr unter ~\portaldata\<portalid>\pagetemplates\ gespeichert. Device-Templates können im Seitentemplate-Manager nicht bearbeitet werden. Die Layout-Controls (tablayout.asc etc.), die bisher notwendig waren, um Module mit Drag & Drop in bestimmten Seitenbereiche zu platzieren, entfallen. Die Bereiche werden nun direkt im Seitentemplate definiert.
Beim Upgrade bestehender Installationen auf Release 5.20 werden alle notwendigen Änderungen automatisch durchgeführt.
Konzept
Seitentemplates in contentXXL enthalten
- aktive Zonen zur Platzierung von Modulen per Drag & Drop
- Programmcode zum Laden von Modulen
- zusätzlicher Header- oder Footer-Informationen
Zwar können beliebig viele Seitentemplates erzeugt werden, es ist aber sinnvoll, sich auf einige wenige zu beschränken. In vielen Fällen genügt ein einziges.
Wenn Sie ein neues Portal erzeugt haben und aufrufen, sehen Sie eine weiße Seite. Hier greift das Standard-Seitentemplate, das mit der Codebasis ausgeliefert wird und im Root-Verzeichnis von contentXXL liegt (desktopdefault.ascx). Sie können diese Datei als Modell für den Aufbau kundenspezifisch angepasster Seitentemplates nehmen. Im Folgenden erklären wir den die Struktur eines Seitentemplates, wie sie im Dateisystem vorliegt:
Ein sehr einfaches Seitentemplate könnte so aussehen:
<%@ Control %>
<div id="contentpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"></div>
Da es sich bei einem Seitentemplate um ein ASP.NET-Steuerelement handelt, befindet sich in der ersten Zeile die Control-Deklaration. Das HTML-Steuerelement in der zweiten Zeile (statt <div> kann natürlich auch ein anderes geeignetes Element, z.B. <td>, verwendet werden) definiert einen Seitenbereich, in dem Module platziert werden können. Es können beliebig viele unterschiedliche Bereiche definiert werden, obligatorisch ist das Vorhandensein eines HTML-Controls mit der ID "contentpane". Das Attribut data-contentxxl-layoutclass="LayoutZoneAny" kann entfallen, wenn der Bereich nicht für Drag & Drop aktiv sein soll.
Neu im Release 5.20: Seitenbereiche, die für das Platzieren von Modulen mit Drag & Drop zugänglich sein sollen, müssen mit dem Attribut data-contentxxl-layoutclass="LayoutZoneAny" versehen werden. <asp:placeholder>-Controls können weiterhin in Templates verwendet werden, dürfen aber nicht dieses Attribut tragen (ruft einen .NET-Ausnahmefehler hervor). Gegebenenfalls müssen solche Placeholder durch HTML-Controls wie <div> oder <td> ausgetauscht werden.
Üblicherweise werden Module im Seiten-Manager per Drag & Drop in den gewünschten Bereich gezogen. Ein solches Modul ist dann nur auf der jeweiligen Seite vorhanden. Module können aber mit der addmoduletopane-Funktion im Seitentemplate fest verankert werden, In diesem Fall erscheinen sie auf jeder Seite, die dieses Seitentemplate verwendet (das macht. z.B. Sinn bei Navigationsmodulen, related Modulen, Header-Grafiken...):
<%@ Control %>
<%@ Import Namespace="AspNetPortal" %>
<script language="vb" runat="server">
Sub Page_Load()
contentxxlhelper.addmoduletopane(5,headerpane.controls)
End Sub
</script>
<div id="headerpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"></div>
<div id="contentpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"></div>
In diesem Beispiel wird ein Modul mit der ID 5 im Headerpane platziert.
Neu im Release 5.20: Module können nun ohne .NET-Code fest im Seitentemplate durch Einbettung von <xxl:module moduleid="<moduleid>" runat="server" /> an der gewünschten Stelle im HTML-Markup verankert werden.
Das vorige Beispiel könnte also in einfacher Weise auch so realisiert werden:
<div id="headerpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"><xxl:module moduleid="5" runat="server" /></div>
Wenn man vom Seitentemplate aus auf das body-Tag der Seite zugreifen will um eine CSS-Klasse zuzuweisen, ist das mit einem Property "bodyparams" möglich. Weiterhin können mit der insertcontrol-Funktion beliebige Controls im Header- (zwischen <head> und </head>) oder Footer-Bereich (zwischen </form> und </body>) eingebaut werden:
<%@ Control %>
<%@ Import Namespace="AspNetPortal" %>
<script language="vb" runat="server">
Public ReadOnly Property bodyparams()
Get
Return " class=""contentxxl"" "
End Get
End Property
Sub Page_Load()
contentxxlhelper.insertcontrol("portaldata/1/modules/myheadcontrol.ascx", Page.FindControl("headcontrols").Controls)
contentxxlhelper.insertcontrol("portaldata/1/modules/myfootcontrol.ascx", Page.FindControl("footcontrols").Controls)
End Sub
</script>
<div id="headerpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"></div>
<div id="contentpane" data-contentxxl-layoutclass="LayoutZoneAny" runat="server"></div>