Thema: jdoc-Anleitung

breadcrumb ist der neue Name für pathway oder im deutschen Pfadangabe.

Code:

<jdoc:include type="modules" name="breadcrumbs" />

in type steht, um was es sich handelt. "modules" ist richtig. "module" gibt es in der Typ-Beschreibung nicht!
Statt modules gibts auch noch component und message (wie schon beschrieben).

Die Pfadangaben selber sind auch nur ein Modul, dass du frei in deinem Template positionieren kannst.

In "name" steht ein ix-beliebieges Wort, dass du frei vergeben kannst und anschließend in der Modulposition auswählen kannst (du kannst es auch direkt in das Feld hineinschreiben, wenn du es nicht auswählen kannst).
"breadcrumb" oder "pathway" oder "apfelkuchen" sind mögliche Namen. denn letztlich handelt es sich schlicht und ergreifend um eine Positionsbezeichnung. Und eine Position ist nichts weiter als ein Platzhalter, an deren Stelle zur Laufzeit der Inhalt des oder der Module eingefügt werden, die du an dieser Stelle positionierst. Positionierst du mehrere Module an einer Stelle, werden sie einfach untereinander angezeigt.

Wenn du nun an ganz bestimmten Stellen deines Templates ein ganz bestimmtes Modul veröffentlichen möchtest, macht es durchaus Sinn, die Position so zu benennen, wie der Inhalt, den du da abdrucken willst.

Wenn ich beispielsweise eine Position einbinde, wo ich später ein Modul mit meinem Logo anzeigen lassen will, dann vergebe ich auch so einen Namen:

Code:

<jdoc:include type="modules" name="logo" />

Aber wie gesagt: ich könnte anstatt "logo" auch "apfelkuchen" oder "birnenbaum" dort hin schreiben. Die Bedeutung ist identisch.

Formatieren - also das Aussehen - machst du über die CSS-Datei. Meist ist das die "template.css", die du im Template-Verzeichnis findest.
Die CSS-Klassen und -IDs findest du mit den genannten AddOns für den Browser und können von Template zu Template verschieden sein.

Finden tust du das aber auch unter den Links, die wir dir gegeben habe. Du musst nur verstehen, dass die "breadcrumbs" nichts weiter sind, als ein normalsterbliches Modul, das eine ganz bestimmte Aufgabe erfüllt




Axel

Hallo,

gibt es den type "module" nicht doch?
Dann wird m.E. bei name der Name des Moduls und nicht seine Position angegeben.
Fundstelle: http://docs.joomla.org/Jdoc_statements

Christian

Klar gibt es den type "module". Nur sollte man sich gut überlegen ob man ihn nutzt, da er recht einschränkend ist.

Edit: man könnte sich sogar eigene Typen erstellen

Aber nicht im jdoc für die allermeisten Module. An der Stelle musst das "modules" nehmen. Ich spreche natürlich auch nur in dem Zusammenhang. Machst das "s" weg, funktioniert das nicht mehr.

"name" ist die Position. Es gibt keinen Modulnamen. Ausnahme der beiden genannten. Und in den Link chr-hl ist der name eindeutig als Position dargestellt und erklärt und das modules steht da auch. Oder kennst ein Modul Namens "user1"?

Schaut doch einfach mal in eure Templates, bevor ihr hier jetzt den Walter noch mehr verwirrt


Axel

Zitat von time4mambo

Schaut doch einfach mal in eure Templates

Dito, wobei, vielleicht hast du ja echt kein "module" (ohne "s") in deinem Template. Bei mir funktioniert es zumindest ohne Probleme. Ich kann damit jedes beliebige Modul laden, das ich installiert habe. Ich muss nur den Namen wissen. Ich kann sogar die Parameter völlig neu definieren etc. Und nichts anderes wird in dem (recht bescheidenen) verlinkten Beispiel von j!docs gemacht.

Edit: siehe hier

Schwierig ists...

Das eine ist die Positionsbezeichnung:

Code:

<jdoc:include type="modules" name="breadcrumbs" style="xhtml" />

An dieser Stelle wird zur Laufzeit dann das Modul und deren Inhalte ausgegeben. Das ist das, was du da oben siehst. Ändere in deinem Template bei dieser Positionsangabe name="breadcrumbs" in name="apfelkuchen" und schaue dann zur Laufzeit wieder in den Quellcode und da steht dann immer noch

Code:

<div class="moduletable">
					<h3>Pfad</h3>
					<span class="breadcrumbs pathway">
Home</span>
		</div>

, weil das zwei verschiedene Dinge sind. Das eine ist die Positionsangabe und das andere ist das eigentliche Modul. Und dort wird die Klasse vom Modul erzeugt.
Diese Klasse nun kannst du in der CSS-Datei ansprechen:

Code:

span.breadcrumbs {...}

Den "apfelkuchen" natürlich nicht - denn das ist nur die Position

Du unterscheidest die einzelnen Module in dem Sinne nicht. Alle haben eine Klasse "moduletable" in der CSS (<div class="moduletable">)
Somit kannst du generell allen Modulen ein gleiches Gesicht geben, in dem du in der CSS-Datei des Templates entsprechendes formatierst, was dann für alle Module gilt:

Code:

.moduletable {...}

Willst du das nicht, weil du einigen oder auch nur einem bestimmten Modul ein anderes Gesicht geben willst, arbeitest du mit der Module Class Suffix.
Näheres dazu hier:
http://www.time4joomla.de/templates/...ss-suffix.html

Genau so geschieht es übrigens im Menü. Dort findest du diese Zeile:

Code:

<div class="moduletable_menu">

"_menu" ist eine solche Module Class Suffix.

Aber, Walter, du beginnst dich ab hier in den tieferen Sphären Joomlas und vor allem des CSS zu bewegen (auch wenn es letztlich noch Grundlagen sind). Wenn du absolut keine Ahnung von der Materie hast, dann solltest du dich einfach erst mal mit der generellen "einfachen" Funktionsweise, wie Joomla im täglichen Gebrauch seitens des Benutzers funktioniert, vertraut machen (Bereiche und Kategorien, Beiträge anlegen und Menüs einbinden) und dich erst mal vom Templatebauen fern halten. Denn da brauchst du auch jede Menge Wissen in CSS, HTML und ein klitzeklein wenig PHP.


EDIT: Natürlich ist der Inhalt eine Moduls zur Ausgabe des Menüs ein anderer, als der zu den Breadcrumbs. Und somit ist alles, was du nach dem "h3" siehst, etwas, das vom jeweiligen Modul erzeugt wird. Da kann es schon mal Abweichungen geben




Axel