PContentArticle und die Grundfunktionen der Objekte

PContentArticle bildet einen Artikel der Portalsuite Datenbank ab.

Um auf einen bestehenden Artikel mit der Überschrift „Kontakt & Impressum“ zuzugreifen und einige Felder auszugeben, kann folgendes Beispiel in einem Template verwendet werden:

     Templateauszug:;            <?      $KontaktArtikel = new PconentArticle ("Kontakt & Impressum");      ?>            <h1><? echo ($KontaktArtikel->Field ("Headline")); ?></h1>      <p class=summary><? echo ($KontaktArtikel->Field ("Summary")); ?></p>

Dem Konstruktor der Klasse PContentArticle wird die vollständige Überschrift übergeben. Gibt es mehrere Artikel mit der gleichen Überschrift, ist nicht definiert welcher der Artikel dann im Zugriff steht. Stimmt die Überschrift nicht 100% überein, kann der Artikel ebenfalls nicht gefunden und im folgenden abgebildet werden. Der lesende Zugriff auf einzelne Felder eines Artikels wird mittels der „Field“ Funktion der Klasse PContentArticle umgesetzt. Die Funktion erwartet als einzigen Parameter den Namen des Feldes und liefert den Inhalt zurück. Existiert das Feld nicht, wird ein leerer Wert zurückgegeben. Der zurückgelieferte Wert kann normal weiterverarbeitet werden, einer Variable zugewiesen oder wie im Beispiel mit der PHP-Echo-Funktion auch ausgegeben werden. Der Artikel besteht natürlich noch aus weiteren Feldern. Eine Übersicht aller Felder eines Objektes finden Sie in der Objektreferrenz der „Portalsuite Objects“ auf unserer Webseite. Nachdem Sie ein Objekt instanziert haben, können Sie jedoch auch einige (nicht alle) Felder ändern:

    Templateauszug:            <?      $KontaktArtikel = new PconentArticle ("Kontakt & Impressum");      $KontaktArtikel->WriteField ("Headline","Kontakt");      ?>

Die erste Zeile verbindet die Objektvariable $KontaktArtikel wieder mit dem Artikel in der Datenbank. In der zweiten Zeile findet nun der Schreibzugriff statt durch die Objektfunktion „WriteField“. „WriteField“ erwartet als ersten Wert wieder den Namen des Feldes und als zweiten Parameter den neuen, zukünftigen Inhalt des Feldes. Der Schreibzugriff findet unmittelbar statt und wird nicht erst gecached oder zwischengespeichert. Wenn Sie mehrere Felder ändern möchten, rufen Sie einfach die „WriteField“-Funktion mehrmals, für jedes Feld einmal, auf. Bitte beachten Sie, daß einige wenige Felder der Datenbank durch die Objekte allerdings auch schreibgeschützt sind und inhaltlich durch die Objekte nicht geändert werden können oder auch nicht durch die Objekte abgebildet werden. Der größte Teil, ca. 95% der Felder sind jedoch verfüg- und auch beschreibbar. Mit den Objekten können Sie auch neue Artikel anlegen:

     Templateauszug:            <?      $KontaktArtikel = new PconentArticle;      $KontaktArtikel->Create ("Ein neuer Artikel");      $KontaktArtikel->WriteField ("Summary","Eine Summary...");      ?>

Die „Create“-Funktion legt unter der als Parameter übergebenen Überschrift einen neuen Artikel an. Mit der WriteField-Funktion können anschließend die weiteren Felder des Artikels beschrieben werden. Mit den Objekten können Sie auch Artikel löschen:

     Templateauszug:;            <?      $KontaktArtikel = new PconentArticle ("Ein neuer Artikel");      $KontaktArtikel->Delete ();      ?>

Die „Delete“-Funktion löscht den Artikel in der Portalsuite-Datenbank, den das Objekt repräsentiert. Der Artikel wird in der Datenbank allerdings nicht wirklich gelöscht, sondern lediglich in den Papierkorb verschoben. Eine weitere wichtige Grundfunktion ist die „Valid“-Funktion:

     Templateauszug:;            <?      $KontaktArtikel = new PconentArticle ("Artikel, den es nicht gibt...");      if ($KontaktArtikel->Valid ())          echo ("Den Artikel gibt es !");      else          echo ("Den Artikel gibt es leider NICHT !");      ?>

Die „Valid“-Funktion prüft, ob das Objekt einen Artikel in der Portalsuite-Datenbank repräsentiert (Rückgabewert = true) oder nicht (=false).
Die fünf Objektfunktionen „Field“, „WriteField“, „Create“, „Delete“ und „Valid“ sind Standardfunktionen der „Portalsuite Objects“ und finden sich in den meisten der Objekte wieder. Wenn Sie diese Funktionen, sowie die Feldnamen der Objekte kennen, können Sie bereits auf nahezu alle Tabellen der Portalsuite lesend und schreibend zugreifen. Es spielt keine Rolle, ob es sich um ein Template, eine Formatvorlage, einen Artikel oder ein Konfigurationset handelt. Mit den Objekten können Sie so neue Kateogorien, Formatvorlagen oder gar Templates anlegen und bestehende ändern oder löschen. Alle Objekte funktionieren im Grunde mit diesen fünf Funktionen. Natürlich bieten einige Objekte noch weitere Funktionen und Features.

Copyright © 2000-2012 by Portunity GmbH - Alle Rechte vorbehalten.
Diese Seite wird mit der Portunity Portalsuite Enterprise-Edition betrieben.

Providing unter: http://portunity.net

	DSL, ENUM, Hosting, Server,...

unter: enum-center.de