PHPXref.com - Redaxo CMS 3.2 - /_getstarted.txt source

[Summary view] [Print] [Text view]
   1  
   2  Redaxo Version: 3.0
   3  Ersteller: Jan Kristinus
   4  Datum: Juni 2005
   5  Titel: Get Started.. [deutsch]
   6  
   7  1. Allgemeines
   8  2. Struktur
   9  3. Kategorien
  10  4. Artikel
  11  5. Templates
  12  6. Module
  13  
  14  
  15  Hier ein paar Infos um mit REDAXO umgehen zu können. Das ganze ist noch 
  16  nicht so professionell aufgebaut - aber im Laufe der Zeit soll sich das Ganze 
  17  natürlich verbessern und erweitern. Dazu sind aber auch Sie gefragt.
  18  
  19  1. Allgemein gibt es erst mal ein paar Infos:
  20  Unser Ziel war und ist ein einfaches, schnell zu erlernendes Redaktionssystem, 
  21  welches dennoch einen hohen Grad an Flexibilität gewährleistet. Dabei setzen wir 
  22  nicht nur auf Templates, sondern auf eine Kombination von Templates und Modulen. 
  23  Die Templates definieren im Normalfall den Rahmen des dargestellten Inhaltes 
  24  (z.B. Popup-Fenster, Inhalte mit Navigation, ...) während sich der eigentliche 
  25  Inhalte über mehrere Module generiert (z.B. Headline, Fliesstext, Bild mit Text, 
  26  Links ...)  Dabei kann ein Inhalt aus theoretisch unendlich vielen Modulen, und 
  27  damit Texten und Grafiken, bestehen.
  28  
  29  
  30  2. Struktur:
  31  
  32  Bei REDAXO setzen wir eine hierarchische Struktur ein. D.h. Verschiedene 
  33  Kategorien (Ordner) enthalten verschiedene Artikel (Inhalte). Jede Kategorie hat 
  34  einen Startartikel (Startartikel sind Einstiegsseiten einer Kategorie- im Normalfall 
  35  Übersichtsseiten ). Jeder Artikel entspricht nachher einer Webseite. Jedem Artikel 
  36  muß auch ein Template zugewiesen werden, damit die Darstellungsform eindeutig ist.
  37  
  38  
  39  3. Kategorien:
  40  Kategorien benutzt man um Navigationsstrukturen abzubilden. Für die meisten Fälle gilt: 
  41  Was in der Struktur zu sehen ist sieht man auch auf der Sitemap und in der Navigation. 
  42  Die Priorität organisiert die Reihenfolge.
  43  
  44  
  45  4. Artikel:
  46  Es gibt Startartikel und "normale" Artikel. Ein Startartikel generiert sich automatisch 
  47  bei Erstellen einer Kategorie und kann nicht gelöscht werden - außer man löscht die 
  48  Kategorie. Normale Artikel können in beliebiger Anzahl erstellt werden. Einem Artikel 
  49  kann man ein Template zuweisen welches die Darstellungsform bestimmt. Ein Artikel 
  50  besteht aus mehreren Blöcken (Modulen) und repräsentiert den eigentlichen Inhalt. 
  51  Weiterhin hat der Artikel Metadaten die ihn allgemein beschreiben (z.B. Kurzbeschreibung, 
  52  Suchbegriff und Grafik).
  53  
  54  
  55  5. Templates:
  56  Sie sind die Basis der Darstellung. D.h. Hier wird definiert wie sich die Navigation/en 
  57  zusammenbaut und wie das Layout sich aufbaut. Es können Templates erstellt werden die in 
  58  den Artikeln selektiert werden sollen, oder welche die in andere Templates eingebunden 
  59  werden sollen.
  60  
  61  5.1. Wie erstelle ich Templates:
  62  
  63  Die einfachste Form eines Templates ist diese:
  64  
  65  <html><head>title</head><body><?
  66  echo $this->getArticle();
  67  ?></body></html>
  68  
  69  Alle Parameter eines Artikels lassen sich über das $this Objekt abrufen. z.B. 
  70  Könnten man sich mit 
  71  
  72  echo $this->getValue("name");
  73  
  74  den Artikelnamen ausgeben lassen. 
  75  Weitere Parameter (Metadaten) sind: name, beschreibung, file, category_id, type_id, 
  76  startpage, prior, path, status, online_from, online_to, keywords, template_id.
  77  
  78  
  79  6. Module:
  80  Die eigentlichen Inhalte werden aus Modulen zusammengebaut. Man könnte sie auch 
  81  Minitemplates nennen, wobei eine unendliche Anzahl von diesen in einem Artikel 
  82  möglich sind. Diese Module können sehr unterschiedlich sein. Mögliche Formen 
  83  eines Moduls sind z.B. Headline, Fliesstext, Grafiken hochladen und darstellen 
  84  oder dynamische Listen aus Datenbanken, dynamische Grafiken, Unternavigationen etc.
  85  
  86  6.1. Wie erstelle ich Module
  87  Bei Modulen gibt es 2 Einteilungen. Einerseits das Eingabeformular eines Moduls 
  88  für die Verwaltung und andererseits die Ausgabe der eingegebenen Informationen. 
  89  
  90  Die einfachste Form eines Modules ist diese:
  91  
  92  Eingabeformular:
  93  <input type=text size=20 name=VALUE[1] value="REX_VALUE[1]">
  94  
  95  Ausgabeformular:
  96  <font size=3>REX_VALUE[1]</font>
  97  
  98  Dieses Modul erfaßt einen Text welcher dann formatiert ausgegeben wird. Allgemein 
  99  werden bestimmte Platzhalter verwendet um unterschiedliche Texte, Grafiken etc. 
 100  dann dafür wieder einsetzen zu können. Hier wird im der Platzhalter REX_VALUE[1] 
 101  verwendet. 
 102  
 103  Ein weiteres Modul zum Bildupload mit Bildbeschreibung:
 104  
 105  Eingabeformular:
 106  <?
 107  
 108  echo "Bild: <br>";
 109  
 110  ?>REX_MEDIA_BUTTON[1]<?
 111  
 112  if ("REX_FILE[1]" != "")
 113  {
 114    echo "<img src=../files/REX_FILE[1] width=100><br>";
 115  }
 116  
 117  ?><br><br>Bildunterschrift:<br>
 118  <input type=text size=50 name=VALUE[1] value="REX_VALUE[1]" class=inp100>
 119  <br><br>
 120  
 121  Ausgabeformular:
 122  <?
 123  if ("REX_FILE[1]" != "") echo "<img src=/files/REX_FILE[1]>";
 124  if ("REX_VALUE[1]" != "") echo "<br>REX_VALUE[1]";
 125  echo "<br><br>";
 126  ?>
 127  
 128  In diesem Modul hat der Redakteur die Möglichkeit ein Bild hochzuladen und die 
 129  Bildunterschrift einzugeben. Dabei werden folgende Platzhalter verwendet. FILE[1], 
 130  REX_VALUE[1] sowie feste Formularwerte wie VALUE[1], FILE1, FILEDEL1.. In jedem 
 131  Modul kann php verwendet werden - und in den meisten Fällen macht es auch Sinn 
 132  und man sollte davon gebrauch machen. 
 133  
 134  Es gibt weitere Platzhalter die von Modul zu Modul Sinn machen könnten: 
 135  
 136  REX_VALUE[1]  .... REX_VALUE[10]
 137  Dabei wird der eingegebene Text als htmlcode eingesetzt. Z.B. wird aus ä -> &auml;
 138  Relevante feste Formularwerte: VALUE[1] ....
 139  
 140  REX_IS_VALUE[1]  ….  REX_IS_VALUE[10]
 141  Sollte ein Text in z.B. REX_VALUE[1] eingeben sein enthält REX_IS_VALUE[1] den Wert 1
 142  Relevante feste Formularwerte: VALUE[1] ....
 143  
 144  REX_HTML_VALUE[1] …. REX_HTML_VALUE[10]
 145  Der eingegeben Text wird genauso ausgegeben. Um zu sichern das kein php-code enthalten 
 146  ist wird <? Und ?> gelöscht.
 147  Relevante feste Formularwerte: VALUE[1] ....
 148  
 149  REX_HTML_BR_VALUE[1] …. REX_HTML_BR_VALUE[10]
 150  Der eingegeben Text wird genauso ausgegeben. Jeder Umbruch wird durch <br /> ersetzt. 
 151  Um zu sichern das kein php-code enthalten ist wird <? Und ?> gelöscht.
 152  Relevante feste Formularwerte: VALUE[1] ....
 153  
 154  REX_PHP_VALUE[1] …. REX_PHP_VALUE[10]
 155  Der eingegeben Text wird genauso ausgegeben. Sofern php code eingegeben wurde wird 
 156  dieser auch ausgeführt. 
 157  Relevante feste Formularwerte: VALUE[1] ....
 158  
 159  REX_LINK[1] …. REX_LINK[10]
 160  Einhält die ArtikelID eines Artikels im Eingabeformular und den kompletten Link im 
 161  Relevante feste Formularwerte: LINK[1] ....
 162  
 163  FILE[1] …. FILE[10]
 164  Enthält den Dateinamen der hochgeladenen Datei (jede Art von Datei - z.B. Photo )
 165  Relevante feste Formularwerte: FILEDEL1 FILE1 ....
 166  
 167  REX_ARTICLE_ID
 168  Hier wird die aktuelle Artikel ID eingesetzt.
 169  
 170  REX_CATEGORY_ID
 171  Hier wird die aktuelle Kategorie ID eingesetzt.
 172  
 173  REX_PHP
 174  Sofern PHP als Modul verwendet werden soll. Ist es am sinnvollsten dieses Platzhalter 
 175  zu verwenden. 
 176  Relevante feste Formularwerte: INPUT_PHP ....
 177  
 178  REX_MEDIA_BUTTON[1] ... REX_MEDIA_BUTTON[10]
 179  Erstellt Auswahlbuttons für die Selektion und zum Hinzufügen von dateien/Bilder [Mediapool]
 180  
 181  REX_LINK_BUTTON[1] ... REX_LINK_BUTTON[10]
 182  Erstellt Auswahlbuttons für die Selektion von Links
 183
[ PHPXref.com ]	[ Generated: Sun Jul 20 20:10:04 2008 ]	[ Redaxo CMS 3.2 ]
[ Index ] [ Variables ] [ Functions ] [ Classes ] [ Constants ] [ Statistics ]
/ -> _getstarted.txt (source)
