Mambo: API - mosLoadModules

Aus Wikibooks

← API - Database	Das Mambo-Buch: Profi-Bereich - API - mosLoadModules()	→
↑ Startseite Profi-Abschnitt	↑ Passendes Anfänger-Thema	↑ Startseite Schnelleinstieg

Inhaltsverzeichnis 1 Was macht mosLoadModules? 2 Der Parameter Bereich 3 Der Parameter Style 3.1 Style : 0 (default Wert) - Vertikale Tabelle 3.2 Style : 1 - Horizontale Tabelle 3.3 Style : -1 3.4 Style : -2 - Ausgabe im XMambo Format 3.5 Style : -3 - Kapselung in 4 verschachtelte <DIV>-Tags

[Bearbeiten] Was macht mosLoadModules?

mosLoadModules definiert den Bereich und die Art, wie Module im Template angezeigt werden. Es hat einen zwingenden Parameter Bereich und einen optionalen Parameter Style.

mosLoadModules(string Bereich[,integer Style])

Angewandt wird mosLoadModules bei der Templateerzeugung und nicht bei der Programmierung von Komponenten oder Modulen.

[Bearbeiten] Der Parameter Bereich

mosLoadModules(string Bereich)

Für eine Kompatibilität mit Mambo 4.5 muss mosLoadModules mit dem Parameter Bereich verwendet werden. Man verzichtet dadurch dann aber auf praktische Gestaltungsmöglichkeiten unter Mambo 4.5.x.

Unter Mambo sind einige Bereiche definierbar. Ihnen können im Backend Module zugeordnet werden. In der Version 4.5.2 sind in Mambo folgende Modulnamen voreingestellt. (Die Namen dienen nur grob der Orientierung. Eigentlich sind sie willkürlich, da ihre tatsächliche Position in den Templates festgelegt wird. Nichtsdestotrotz dienen sie der Verständlichkeit.)

• top - Geeignet für Module die oben angezeigt werden (z.B. ein horizontales Menü)
• bottom - Oft für Module unter dem Hauptinhalt
• left - Links: z.B. für das linke Modul oder Module links vom Inhalt
• right - Rechts: z.B. Module rechts des Inhalts
• banner - Mambo bietet Banner-Support
• inset -
• user1 bis user9 - frei definierbare Bereiche
• advert1 bis advert3 - Zur Anzeige von Werbung
• header -
• footer -
• newsflash - z.B. Zur Anzeige des Newsflashes
• legals - Disclaimer etc.
• pathway - Anzeige des Pathways, nicht für beliebige Module gedacht.
• cpanel - z.B. für Administrator Templates
• toolbar - Vermutlich auch nur für Admin Templates
• icon -
• debug - z.B. Zur Anzeige von Debuginfos

Beispiel für Bereich: left:

mosLoadModules ('left')

[Bearbeiten] Der Parameter Style

mosLoadModules(string Bereich, integer Style)

Style darf eine Zahl zwischen 1 und -2 (-3 bei Mambo 4.5.2) sein. Dabei hat Style folgende Bedeutungen:

[Bearbeiten] Style : 0 (default Wert) - Vertikale Tabelle

Die Module werden in einer Tabelle untereinander dargestellt. Dieser Wert wird auch verwendet, wenn kein Wert angegeben wird.

 <!-- Modul1 -->
 <table cellpadding="0" cellspacing="0" class="moduletable[suffix]">
  <tr>
    <th valign="top">Modul Überschrift</th>
  </tr>
  <tr>
    <td>
      Modulausgaben
    </td>
  </tr>
 </table>
 <!-- Modul1 Ende -->
 

[Bearbeiten] Style : 1 - Horizontale Tabelle

Die Module werden in einer Tabelle nebeneinander dargestellt. Jedes Modul wird in eine Zelle einer Tabelle gepackt.

 <!-- Umschliessende Tabelle -->
 <table cellspacing="1" cellpadding="0" border="0" width="100%">
   <tr>
     <td align="top">
       <!-- Modul1 Anfang -->
       <table cellpadding="0" cellspacing="0" class="moduletable[suffix]">
         <tr>
           <th valign="top">Modul Überschrift</th>
         </tr>
         <tr>
           <td>
             Modulausgaben
           </td>
         </tr>
       </table>
       <!-- Modul1 Ende -->
     </td>
     <td align="top">
       <!-- ...nächstes Modul... -->
     </td>
   </tr>
 </table>
 

Jedem Modul kann im Backend ein Suffix zugeordnet werden, das dann ans Ende des Klassennamens der Modultable angehängt wird.

<table cellpadding="0" cellspacing="0" class="moduletable[suffix]">

Dadurch ist es möglich, jedem Modul seinen eigenen Style per CSS zuzuordnen.

[Bearbeiten] Style : -1

Die Module werden komplett unformatiert nebeneinander dargestellt. Dabei werden die Modulüberschriften nicht mit ausgegeben.

Modul1 Modul2 Modul3

[Bearbeiten] Style : -2 - Ausgabe im XMambo Format

Die Module werden nicht in eine Tabelle geschachtelt, sondern in einzelne <DIV>-Tags verpackt.

 <div class="moduletable[suffix]">
   <h3>Modul Überschrift</h3>
   Modulausgaben
 </div>
 

Dadurch und durch die Möglichkeit, im Backend ein Suffix für das Class Attribut des <DIV>-Tags zu definieren, lassen sich einzelne Module nahezu beliebig positionieren und anpassen.

[Bearbeiten] Style : -3 - Kapselung in 4 verschachtelte <DIV>-Tags

Ab Mambo 4.5.3 gibt es den zusätzlichen Style -3. Dieser soll die Möglichkeit bieten Module mit abgerundeten Ecken in CSS darzustellen. Genaueres zu Runden Ecken per CSS und DIV findet man unter Selfhtml.

 <div class="module[suffix]">
   <div>
     <div>
       <div>
         <h3>Module Title</h3>
           Module output
       </div>
     </div>
   </div>
 </div>
 

Auch hier lassen sich natürlich mit Suffix individuelle Gestaltungen etc. realisieren.

Beispiel für Bereich: left und Style: -2:

mosLoadModules ('left', -2)

← API - Database	Das Mambo-Buch: Profi-Bereich - API - mosLoadModules()	→
↑ Startseite Profi-Abschnitt	↑ Passendes Anfänger-Thema	↑ Startseite Schnelleinstieg