Thema: Joomla API - Dokumentation verstehen !?

Hallo zusammen,

ich habe mal einige Fragen zur Joomla API-Dokumentation.

Meine PHP-Kentnisse halten sich in Grenzen, aber ich bin gewillt zu lesen und zu lernen und mir auch weiterhin die Nächte um die Ohren zu schlagen...

Kurz: ich kapier die Doku nicht und bräuchte mal etwas Starthilfe...

Nehmen wir ein Beispiel:
addStyleSheet: mir ist bewusst, das es folgendermaßen funktioniert

PHP-Code:

$doc =& JFactory::getDocument();
$doc->addStyleSheet ( 'folder/file.css' ); 


Aber woher ?? Aus der Dokumentation les ich das nicht heraus, irgendwie fehlt mir da etwas ...

Adds a linked stylesheet to the page

* access: public

void addStyleSheet (string $url, [string $type = 'text/css'], [string $media = null], [ $attribs = array()])

* string $url: URL to the linked style sheet
* string $type: Mime encoding type
* string $media: Media type that this stylesheet applies to
* $attribs

Okay, hier ist schon einiges... besser als nichts, aber wenn ich nicht wüsste das mit "StyleSheet" ein CSS-File und mit "add" hinzufügen gemeint ist würde ich vermutlich nie darauf kommen... (Ich habe bewusst ein ganz simples Beispiel gewählt).
Zudem habe ich mir das auch einfach bei anderen Komponenten abgeschaut.

Vielleicht fehlt mir auch nur der nötige Hintergrund, aber wenn es hier eine leicht verständliche Erklärung gibt, wie man das zu lesen und zu verstehen hat wäre ich wirklich sehr dankbar.

Wenn ich mir z.B. die Klasse JDatabase ansehe, bin ich mir sicher hier gibts unzählige Möglichkeiten Dinge weniger umständlich zu machen als ich das bisher tue... nur verstehen sollte man es halt...

Da Joomla! äußerst schwach dokumentiert ist, gibt es im Prinzip nur ein Weg um da durchzusteigen: lesen lesen lesen. Angefangen mit der JFactory (mit der man prinzipiell fast alle anderen Klassen aufrufen kann) über JHTML bis hin zu den einzelnen Unterklassen.

Wenn du richtig mit Joomla! programmieren lernen willst, dann solltest du eine gute MVC Komponente wie Eventlist (Was zum Teil auch nicht überall effektiv den kürzesten Weg nutzt) herunter laden und versuchen diese zu verstehen.

Dann solltest du anfangen zu versuchen die oben erwähnten Klassen zu lesen und nachzuvollziehen. (JFactory => JHTML => JApplication, um mal 3 wichtige zu nennen). Für viele Sachen gibt es mehrere Wege und auch viele Abkürzungen. Ich bevorzuge eigentlich das meiste über JFactory und JHTML abzuhandeln und nur vereinzelt direkt auf andere Klassen zuzugreifen.

Ich hoffe, dass hat dir ein bisschen geholfen.

Zitat von Viril

Nehmen wir ein Beispiel:
addStyleSheet: mir ist bewusst, das es folgendermaßen funktioniert

PHP-Code:

$doc =& JFactory::getDocument();
$doc->addStyleSheet ( 'folder/file.css' ); 


Mache ich z.B. so:

PHP-Code:

JHTML::_('stylesheet', 'file.css', 'path/to/folder/'); 


Hallo Maria,

Danke für Deine Antwort. Ja ich will möchte es lernen, und ich werde lesen, lesen lesen, lesen...
Vieles Kann man sich ja selbst aneigenen, gerade duch ausprobieren und in dem man sich andere Komponenten ansieht. Leider ist, wie du ja schon sagtest, nicht alles dokumentiert oder eben - wie für mich manchmal - nicht so das ich es auf anhieb gleich verstehe.

Danke auch für das Beispiel mit Eventlist. Oft ist es so dass man sich Komonenten ansieht, und dinge übernimmt. Doch nicht alles is immer so sauber gemacht wie man es ja lernen möchte. Da hillft es schonmal ein paar "positiv-Beispiele" zu haben.

Sebastian

Such dir jemand, der sich auskennt und dann nur noch mit Fragen quälen

Mit lesen meinte ich Joomla! Quellcode, einfach irgend eine Datei aus libraries/joomla öffnen und die lesen. Bringt ungemein viel.

Zitat von Måria

Such dir jemand, der sich auskennt und dann nur noch mit Fragen quälen

und du kennst dich aus ? ;-)

Abend,

Zitat von Viril

Hallo zusammen,

Aber woher ?? Aus der Dokumentation les ich das nicht heraus, irgendwie fehlt mir da etwas ...
.. besser als nichts, aber wenn ich nicht wüsste das mit "StyleSheet" ein CSS-File und mit "add" hinzufügen gemeint ist würde ich vermutlich nie darauf kommen... (Ich habe bewusst ein ganz simples Beispiel gewählt).
.

Ehrliche Antwort: Dann würdest Du nicht programmieren . Im Wiki nichts gefunden, daher gleich Alex Kempkens, Das Joomla Entwicklerhandbuch - 44.95 Addison-Wesley, zum Teil mehr als sehr erhellend. So wie in dem Buch aufbereitet kannst was über die Fabrik schon beim Frühstück lesen ohne Kopfschmerzen zu kriegen

Gruss

zu andern teilen dunkel wie die nacht,...
save your money - das meiste was man braucht kommt mit joomla selbst. der rest kommt mit der zeit. sagte maria glaube ich schon.

Abend,

ja ich gebs zu. Hab jetzt nichts für zahlen müssen, da ausgeliehen. Aber ich lerne daraus und dann schreib ich was ins Dunkle...

Gruss

Im Wiki nichts gefunden,

wenn das nicht danach schreit die fehlenden informationen ins wiki zu bringen. auf, auf.

Scho, lad mir mal am WE Media Wiki runter, hab schon lang nimmer damit gearbeitet.