Zend_View-Helpers.xml 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17175 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.view.helpers" xmlns:xi="http://www.w3.org/2001/XInclude">
  5. <title>View Helfer</title>
  6. <para>
  7. In deinen View Skripten ist es oft notwendig, bestimmte komplexe Funktionen immer wieder
  8. auszuführen, z.B. Datum formatieren, Formularelemente erstellen oder Links für Aktionen
  9. anzuzeigen. Du kannst Helferklassen verwenden, um diese Aufgaben für dich durchführen zu
  10. lassen.
  11. </para>
  12. <para>
  13. Ein Helfer ist einfach eine Klasse. Nehmen wir an wir wollen einen Helfer der 'fooBar'
  14. heißt. Standardmäßig wird der Klasse 'Zend_View_Helper_' vorangestellt (Es kann ein
  15. eigener Prefix definiert werden wenn ein Pfad für die Helfer definiert wird), und das letzte
  16. Segment des Klassennamens ist der Name des Helfers; Dieses Segment sollte Titel
  17. Großgeschrieben sein; der volle Klassenname ist dann:
  18. <classname>Zend_View_Helper_FooBar</classname>. Diese Klasse sollte mindestens eine einzelne
  19. Methode enthalten, die nach dem Helfer benannt und camelCased ist:
  20. <methodname>fooBar()</methodname>.
  21. </para>
  22. <note>
  23. <title>Betrachte den Fall</title>
  24. <para>
  25. Namen von Helfern sind immer camelCased, bzw. beginnen Sie nie mit einem
  26. großgeschriebenen Zeichen. Der Klassenname selbst ist MixedCased, aber die Methode die
  27. aktuell ausgeführt wird ist camelCased.
  28. </para>
  29. </note>
  30. <note>
  31. <title>Standard Helfer Pfad</title>
  32. <para>
  33. Der Standard Helfer Pfad zeigt immer zu den View Helfern des Zend Frameworks,
  34. normalerweise 'Zend/View/Helper/'. Selbst wenn <methodname>setHelperPath()</methodname>
  35. ausgerufen wird um den existierenden Pfad zu überschreiben, wird dieser Pfad gesetzt um
  36. sicherzustellen das die Standard Helfer arbeiten.
  37. </para>
  38. </note>
  39. <para>
  40. Um einen Helfer in deinem View Skript zu verwenden, rufe ihn mittels
  41. <code>$this->helperName()</code> auf. Im Hintergrund wird <classname>Zend_View</classname>
  42. die Klasse <classname>Zend_View_Helper_HelperName</classname> laden, eine Objektinstanz der
  43. Klasse erstellen und deren Methode <methodname>helperName()</methodname> aufrufen. Die
  44. Objektinstanz bleibt innerhalb der <classname>Zend_View</classname> Instanz bestehen und
  45. wird bei allen weiteren Aufrufen von <code>$this->helperName()</code> wiederverwendet.
  46. </para>
  47. <sect2 id="zend.view.helpers.initial">
  48. <title>Vorhandene Helfer</title>
  49. <para>
  50. <classname>Zend_View</classname> enthält bereits einige vorhandene Helferklassen, die
  51. sich alle auf die Erstellung von Formularelementen beziehen und die notwendige
  52. Maskierung der Ausgaben automatisch vornehmen. Zusätzlich gibt es Helfer zum Erstellen
  53. Routen-basierter <acronym>URL</acronym>S and HTML Listen, genauso wie für das
  54. Deklarieren von Variablen. Die aktuell gelieferten Helfer beinhalten:
  55. </para>
  56. <itemizedlist>
  57. <listitem><para>
  58. <methodname>declareVars()</methodname>: Primär benutzt mit
  59. <methodname>strictVars()</methodname>, kann dieser Helfer verwendet werden um
  60. template Variablen zu deklarieren welche bereits, oder noch nicht, im View Objekt
  61. bereits gesetzt sind, sowie auch Standard Werte. Arrays welche als Argument dieser
  62. Methode übergeben werden, werden verwendet um Standard Werte zu setzen; Andernfalls,
  63. wenn die Variable nicht existiert, wird diese mit einem leeren String gesetzt.
  64. </para></listitem>
  65. <listitem><para>
  66. <methodname>fieldset($name, $content, $attribs)</methodname>: Erstellt ein
  67. <acronym>XHTML</acronym> Fieldset. Wenn <varname>$attribs</varname> einen 'legend'
  68. Schlüssel enthält, wird der Wert für die Fieldset Beschriftung verwendet. Das
  69. Fieldset wird <varname>$content</varname> umfassen wie vom Helfer angeboten.
  70. </para></listitem>
  71. <listitem><para>
  72. <methodname>form($name, $attribs, $content)</methodname>: Erzeugt eine
  73. <acronym>XHTML</acronym> Form. Alle <varname>$attribs</varname> werden als
  74. <acronym>XHTML</acronym> Attribute des Form Tags escaped und dargestellt. Wenn
  75. <varname>$content</varname> vorhanden und kein boolsches false ist, dann wird dieser
  76. Inhalt innerhalb der Start und End Form Tags dargestellt werden; wenn
  77. <varname>$content</varname> ein boolsches false ist (der Standard), wird nur das
  78. beginnende Formtag erzeugt.
  79. </para></listitem>
  80. <listitem><para>
  81. <methodname>formButton($name, $value, $attribs)</methodname>: Erstellt ein
  82. &lt;button /&gt; Element.
  83. </para></listitem>
  84. <listitem>
  85. <para>
  86. <methodname>formCheckbox($name, $value, $attribs, $options)</methodname>:
  87. Erstellt ein &lt;input type="checkbox" /&gt; Element.
  88. </para>
  89. <para>
  90. Standardmäßig, wenn kein $value angegeben und keine $options vorhanden sind,
  91. wird '0' als ungecheckter Wert, und '1' als gecheckter Wert angenommen. Wenn
  92. ein $value übergeben wird, aber keine $options vorhanden sind, wird der
  93. gecheckte Wert and der übergebene Wert angenommen.
  94. </para>
  95. <para>
  96. $options sollte ein Array sein. Wenn das Array indiziert ist, ist der erste
  97. Wert der gecheckte Wert, und der zweite der ungecheckte Wert; alle anderen
  98. Werte werden ignoriert. Es kann auch ein assoziatives Array mit den Schlüsseln
  99. 'checked' und 'unChecked' übergeben werden.
  100. </para>
  101. <para>
  102. Wenn $options übergeben wurden und $value mit dem gecheckten Wert
  103. übereinstimmt, dann wird das Element als gecheckt markiert. Das Element kann
  104. auch als gecheckt oder ungecheckt markiert werden indem ein boolscher Wert
  105. für das Attribut 'checked' übergeben wird.
  106. </para>
  107. <para>
  108. Das obige wird möglicherweise am besten mit einigen Beispielen zusammengefasst:
  109. </para>
  110. <programlisting language="php"><![CDATA[
  111. // '1' und '0' als gecheckte/ungecheckte Optionen; nicht gecheckt
  112. echo $this->formCheckbox('foo');
  113. // '1' und '0' als gecheckte/ungecheckte Optionen; gecheckt
  114. echo $this->formCheckbox('foo', null, array('checked' => true));
  115. // 'bar' und '0' als gecheckte/ungecheckte Optionen; nicht gecheckt
  116. echo $this->formCheckbox('foo', 'bar');
  117. // 'bar' und '0' als gecheckte/ungecheckte Optionen; gecheckt
  118. echo $this->formCheckbox('foo', 'bar', array('checked' => true));
  119. // 'bar' und 'baz' als gecheckte/ungecheckte Optionen; nicht gecheckt
  120. echo $this->formCheckbox('foo', null, null, array('bar', 'baz');
  121. // 'bar' und 'baz' als gecheckte/ungecheckte Optionen; nicht gecheckt
  122. echo $this->formCheckbox('foo', null, null, array(
  123. 'checked' => 'bar',
  124. 'unChecked' => 'baz'
  125. ));
  126. // 'bar' und 'baz' als gecheckte/ungecheckte Optionen; gecheckt
  127. echo $this->formCheckbox('foo', 'bar', null, array('bar', 'baz');
  128. echo $this->formCheckbox('foo',
  129. null,
  130. array('checked' => true),
  131. array('bar', 'baz');
  132. // 'bar' und 'baz' als gecheckte/ungecheckte Optionen; nicht gecheckt
  133. echo $this->formCheckbox('foo', 'baz', null, array('bar', 'baz');
  134. echo $this->formCheckbox('foo',
  135. null,
  136. array('checked' => false),
  137. array('bar', 'baz');
  138. ]]></programlisting>
  139. <para>
  140. In allen Fällen, wird das Markup einem versteckten Element mit dem
  141. nicht gecheckten Wert vorangestellt; auf diesem Weg erhält man
  142. trotzdem einen gültigen Wert von der Form selbst wenn der Wert nicht
  143. gecheckt wird.
  144. </para>
  145. </listitem>
  146. <listitem>
  147. <para>
  148. <methodname>formErrors($errors, $options)</methodname>: Erzeugt eine ungeordnete
  149. <acronym>XHTML</acronym> Liste und zeigt Fehler an. <varname>$errors</varname>
  150. sollte ein String oder ein Array von Strings sein; <varname>$options</varname>
  151. sollte irgendein Attribut sein das im beginnenden List Tag platziert werden
  152. soll.
  153. </para>
  154. <para>
  155. Es kann alternativer beginnender, schließender und seperierter Inhalt
  156. spezifiziert werden wenn Fehler dargestellt werden durch aufruf von
  157. verschiedenen Methoden auf dem Helfer:
  158. </para>
  159. <itemizedlist>
  160. <listitem><para>
  161. <methodname>setElementStart($string)</methodname>; Standard ist
  162. '&lt;ul class="errors"%s"&gt;&lt;li&gt;', wobei %s mit den in
  163. <varname>$options</varname> spezifizierten Attributen ersetzt wird.
  164. </para></listitem>
  165. <listitem><para>
  166. <methodname>setElementSeparator($string)</methodname>; Standard ist
  167. '&lt;/li&gt;&lt;li&gt;'.
  168. </para></listitem>
  169. <listitem><para>
  170. <methodname>setElementEnd($string)</methodname>; Standard ist
  171. '&lt;/li&gt;&lt;/ul&gt;'.
  172. </para></listitem>
  173. </itemizedlist>
  174. </listitem>
  175. <listitem><para>
  176. <methodname>formFile($name, $attribs)</methodname>: Erstellt ein
  177. &lt;input type="file" /&gt; Element.
  178. </para></listitem>
  179. <listitem><para>
  180. <methodname>formHidden($name, $value, $attribs)</methodname>: Erstellt ein
  181. &lt;input type="hidden" /&gt; Element.
  182. </para></listitem>
  183. <listitem><para>
  184. <methodname>formLabel($name, $value, $attribs)</methodname>: Erstellt ein
  185. &lt;label&gt; Element, setzt das <code>for</code> Attribut auf
  186. <varname>$name</varname>, und den aktuellen Labeltext auf
  187. <varname>$value</varname>. Wenn <code>disable</code> an
  188. <code>attribs</code> übergeben wird, wird nichts zurückgegeben.
  189. </para></listitem>
  190. <listitem><para>
  191. <methodname>formMultiCheckbox($name, $value, $attribs, $options,
  192. $listsep)</methodname>: Erstellt eine Liste von Checkboxen.
  193. <varname>$options</varname> sollte ein assoziatives Array sein und kann beliebig
  194. tief werden. <varname>$value</varname> kann ein einzelner Wert oder ein Array von
  195. ausgewählten Werten sein die Schlüsseln im <varname>$options</varname> Array
  196. entsprechen. <varname>$listsep</varname> ist standardmäßig ein HTML Break
  197. ("&lt;br /&gt;"). Standardmäßig wird dieses Element als Array behandelt; alle
  198. Checkboxen teilen den gleichen Namen, und werden als Array übertragen.
  199. </para></listitem>
  200. <listitem><para>
  201. <methodname>formPassword($name, $value, $attribs)</methodname>: Erstellt ein
  202. &lt;input type="password" /&gt; Element.
  203. </para></listitem>
  204. <listitem><para>
  205. <methodname>formRadio($name, $value, $attribs, $options)</methodname>: Erstellt eine
  206. Reihe von &lt;input type="radio" /&gt; Elementen, eine für jeden der $options
  207. Elemente. Im $options Array ist der Elementschlüssel der Wert und der Elementwert
  208. die Bezeichnung des Radio-Buttons. Der $value Radiobutton wird für dich vorgewählt.
  209. </para></listitem>
  210. <listitem><para>
  211. <methodname>formReset($name, $value, $attribs)</methodname>: Erstellt ein
  212. &lt;input type="reset" /&gt; Element.
  213. </para></listitem>
  214. <listitem><para>
  215. <methodname>formSelect($name, $value, $attribs, $options)</methodname>: Erstellt
  216. einen &lt;select&gt;...&lt;/select&gt; block mit einer &lt;option&gt;one für jedes
  217. $options Element. Im $options Array ist der Elementschlüssel der Optionswert und
  218. der Elementwert die Optionsbezeichnung. Die $value Optionen werden für dich
  219. vorgewählt.
  220. </para></listitem>
  221. <listitem><para>
  222. <methodname>formSubmit($name, $value, $attribs)</methodname>: Erstellt ein
  223. &lt;input type="submit" /&gt; Element.
  224. </para></listitem>
  225. <listitem><para>
  226. <methodname>formText($name, $value, $attribs)</methodname>: Erstellt ein
  227. &lt;input type="text" /&gt; Element.
  228. </para></listitem>
  229. <listitem><para>
  230. <methodname>formTextarea($name, $value, $attribs)</methodname>: Erstellt einen
  231. &lt;textarea&gt;...&lt;/textarea&gt; Block.
  232. </para></listitem>
  233. <listitem><para>
  234. <methodname>url($urlOptions, $name, $reset)</methodname>: Erstellt einen
  235. <acronym>URL</acronym> String basierend auf dem Namen der Route.
  236. <varname>$urlOptions</varname> sollte ein assoziatives Array von Schlüßel/Werte
  237. Paaren sein, welche bon der speziellen Route verwendet wird.
  238. </para></listitem>
  239. <listitem><para>
  240. <methodname>htmlList($items, $ordered, $attribs, $escape)</methodname>: erzeugt
  241. ungeordnete und geordnete Listen welche auf den <varname>$items</varname> basieren
  242. die übergeben wurden. Wenn <varname>$items</varname> ein multidimensionales Array
  243. ist, wird eine verschachtelte Liste gebaut. Wenn das <varname>$escape</varname> Flag
  244. true ist (standard), werden individuelle Abschnitte escaped durch Verwendung des
  245. Escaping Mechanismus der im View Objekt registriert wurde; ein false Wert wird
  246. übergeben wenn Markups in den Listen gewünscht werden.
  247. </para></listitem>
  248. </itemizedlist>
  249. <para>
  250. Die Verwendung dieser Helfer in deinem View Skript ist sehr einfach, hier ist ein
  251. Beispiel. Beachte, dass du diese Helfer nur aufzurufen brauchst; sie werden automatisch
  252. geladen und instanziiert, sobald sie benötigt werden.
  253. </para>
  254. <programlisting language="php"><![CDATA[
  255. // Innerhalb deines View Skriptes, verweist $this auf die Zend_View
  256. // Instanz.
  257. //
  258. // Sagen wir, dass du bereits eine Serie von Auswahlwerten der Variable
  259. // $countries in Form eines Arrays zugewiesen hast
  260. // ('us' => 'United States', 'il' => 'Israel', 'de' => 'Germany')
  261. ?>
  262. <form action="action.php" method="post">
  263. <p><label>Deine Email:
  264. <?php echo $this->formText('email', 'you@example.com', array('size' => 32)) ?>
  265. </label></p>
  266. <p><label>Dein Land:
  267. <?php echo $this->formSelect('country', 'us', null, $this->countries) ?>
  268. </label></p>
  269. <p><label>Möchtest Du hinzugefügt werden?
  270. <?php echo $this->formCheckbox('opt_in', 'yes', null, array('yes', 'no')) ?>
  271. </label></p>
  272. </form>
  273. ]]></programlisting>
  274. <para>
  275. Die Ausgabe des View Skriptes wird in etwa so aussehen:
  276. </para>
  277. <programlisting language="php"><![CDATA[
  278. <form action="action.php" method="post">
  279. <p><label>Deine Email:
  280. <input type="text" name="email" value="you@example.com" size="32" />
  281. </label></p>
  282. <p><label>Dein Land:
  283. <select name="country">
  284. <option value="us" selected="selected">Amerika</option>
  285. <option value="il">Israel</option>
  286. <option value="de">Deutschland</option>
  287. </select>
  288. </label></p>
  289. <p><label>Möchtest Du hinzugefügt werden?
  290. <input type="hidden" name="opt_in" value="no" />
  291. <input type="checkbox" name="opt_in" value="yes" checked="checked" />
  292. </label></p>
  293. </form>
  294. ]]></programlisting>
  295. <xi:include href="Zend_View-Helpers-Action.xml" />
  296. <xi:include href="Zend_View-Helpers-BaseUrl.xml" />
  297. <xi:include href="Zend_View-Helpers-Cycle.xml" />
  298. <xi:include href="Zend_View-Helpers-Partial.xml" />
  299. <xi:include href="Zend_View-Helpers-Placeholder.xml" />
  300. <xi:include href="Zend_View-Helpers-Doctype.xml" />
  301. <xi:include href="Zend_View-Helpers-HeadLink.xml" />
  302. <xi:include href="Zend_View-Helpers-HeadMeta.xml" />
  303. <xi:include href="Zend_View-Helpers-HeadScript.xml" />
  304. <xi:include href="Zend_View-Helpers-HeadStyle.xml" />
  305. <xi:include href="Zend_View-Helpers-HeadTitle.xml" />
  306. <xi:include href="Zend_View-Helpers-HtmlObject.xml" />
  307. <xi:include href="Zend_View-Helpers-InlineScript.xml" />
  308. <xi:include href="Zend_View-Helpers-Json.xml" />
  309. <xi:include href="Zend_View-Helpers-Navigation.xml" />
  310. <xi:include href="Zend_View-Helpers-Translate.xml" />
  311. </sect2>
  312. <sect2 id="zend.view.helpers.paths">
  313. <title>Helfer Pfade</title>
  314. <para>
  315. Wie bei den View Skripten kann der Controller für <classname>Zend_View</classname> auch
  316. einen Stapel an Pfaden festlegen, in dem nach Hilfsklassen gesucht werden soll.
  317. Standardmäßig sucht <classname>Zend_View</classname> in "Zend/View/Helper/*" nach
  318. Hilfsklassen. Du kannst <classname>Zend_View</classname> mit Hilfe der Methoden
  319. <methodname>setHelperPath()</methodname> und <methodname>addHelperPath()</methodname>
  320. mitteilen, auch in anderen Verzeichnissen zu suchen. Zusätzlich kann man einen
  321. Klassenpräfix angeben, um Helfer in dem bereit gestellten Pfad verwenden zu können, um
  322. eigene Namensräume für die Helferklassen zu verwenden. Standardmäßig wird
  323. 'Zend_View_Helper_' angenommen, wenn kein Präfix angegeben wird.
  324. </para>
  325. <programlisting language="php"><![CDATA[
  326. $view = new Zend_View();
  327. // Setze den Pfad auf /path/to/more/helpers, mit dem Präfix 'My_View_Helper'
  328. $view->setHelperPath('/path/to/more/helpers', 'My_View_Helper');
  329. ]]></programlisting>
  330. <para>
  331. Durch Verwendung der <methodname>addHelperPath()</methodname> Methode können die Pfade
  332. "gestapelt" werden. Wenn du Pfade zu diesem Stapelspeicher hinzufügst, wird
  333. <classname>Zend_View</classname> im zuletzt hinzugefügten Pfad nach der angeforderten
  334. Hilfsklasse schauen. Dies erlaubt dir, zu den vorhandenen Helfern weitere hinzufügen
  335. oder diese durch eigene zu ersetzen.
  336. </para>
  337. <programlisting language="php"><![CDATA[
  338. $view = new Zend_View();
  339. // Füge /path/to/some/helpers mit Klassenpräfix 'My_View_Helper' hinzu
  340. $view->addHelperPath('/path/to/some/helpers', 'My_View_Helper');
  341. // Füge /other/path/to/helpers mit Klassenpräfix 'Your_View_Helper' hinzu
  342. $view->addHelperPath('/other/path/to/helpers', 'Your_View_Helper');
  343. // wenn nun $this->helperName() aufgerufen wird, wird Zend_View zuerst nach
  344. // "/path/to/some/helpers/HelperName" mit dem Klassennamen
  345. // "Your_View_Helper_HelperName", dann nach
  346. // "/other/path/to/helpers/HelperName.php" mit dem Klassennamen
  347. // "My_View_Helper_HelperName", und zuletzt nach
  348. // "Zend/View/Helpers/HelperName.php" mit dem Klassennamen
  349. // "Zend_View_Helper_HelperName" schauen.
  350. ]]></programlisting>
  351. </sect2>
  352. <sect2 id="zend.view.helpers.custom">
  353. <title>Eigene Helfer schreiben</title>
  354. <para>
  355. Eigene Helfer zu schreiben ist einfach; du mußt nur diese Regeln befolgen:
  356. </para>
  357. <itemizedlist>
  358. <listitem><para>
  359. Wärend das nicht strikt notwendig ist, ist es empfohlen entweder
  360. <classname>Zend_View_Helper_Interface</classname> zu implementieren oder
  361. <classname>Zend_View_Helper_Abstract</classname> zu erweitern wenn eigene Helfer
  362. erstellt werden. Eingeführt mit 1.6.0, definieren diese einfach die
  363. <methodname>setView()</methodname> Methode; trotzdem, in kommenden Releases, ist es
  364. geplant ein Strategy Pattern zu implementieren das vieles der Namensschemas
  365. einfacher mach wie anbei beschrieben. Wenn darauf aufgebaut wird hilft das, das der
  366. eigene Code Zukunftssicher ist.
  367. </para></listitem>
  368. <listitem><para>
  369. Der Klassenname muss mindestens auf den Helfernamen unter Verwendung der MixedCaps
  370. selber enden. Wenn du z.B. einen Helfer mit Namen "specialPurpose" schreibst, muss
  371. der Klassenname mindestens "SpecialPurpose" lauten. Man kann, und sollte, dem
  372. Klassennamen einen Präfix geben und es wird empfohlen, 'View_Helper' als Teil des
  373. Präfix zu verwenden: "My_View_Helper_SpecialPurpose" (man muss den Präfix mit oder
  374. oder abschließenden Unterstrich an <methodname>addHelperPath()</methodname> oder
  375. <methodname>setHelperPath()</methodname> übergeben).
  376. </para></listitem>
  377. <listitem><para>
  378. Die Klasse muss eine öffentliche Methode mit dem Namen des Helfers haben. Dies ist
  379. die Methode, welche vom View Skript durch "$this->specialPurpose()" aufgerufen wird.
  380. In unserem "specialPurpose" Beispiel, würde die notwendige Deklaration dieser
  381. Methode "public function specialPurpose()" lauten.
  382. </para></listitem>
  383. <listitem><para>
  384. Im Allgemeinen sollte die Klasse keine Ausgaben durch echo(), print() oder auf
  385. andere Weise erstellen. Stattdessen sollte es die auszugebenen Werte zurückgeben.
  386. Die zurückgegebenen Werte sollten entsprechend maskiert werden.
  387. </para></listitem>
  388. <listitem><para>
  389. Diese Klasse muss sich in einer Datei befinden, die nach der Helfermethode benannt
  390. ist. Bezogen auf unser "specialPurpose" Beispiel, muss der Dateiname
  391. "SpecialPurpose.php" lauten.
  392. </para></listitem>
  393. </itemizedlist>
  394. <para>
  395. Platziere die Hilfsklasse irgendwo in deinem Stapelspeicher für Hilfspfade und
  396. <classname>Zend_View</classname> wird den Helfer automatisch für dich laden,
  397. instanziieren, speichern und ausführen.
  398. </para>
  399. <para>
  400. Hier ist ein Beispiel für unseren <code>SpecialPurpose</code> Helfer:
  401. </para>
  402. <programlisting language="php"><![CDATA[
  403. class My_View_Helper_SpecialPurpose extends Zend_View_Helper_Abstract
  404. {
  405. protected $_count = 0;
  406. public function specialPurpose()
  407. {
  408. $this->_count++;
  409. $output = "Ich habe 'The Jerk' {$this->_count} Mal(e) gesehen.";
  410. return htmlspecialchars($output);
  411. }
  412. }
  413. ]]></programlisting>
  414. <para>
  415. Dann rufst du in einem View Skript den <code>SpecialPurpose</code> Helfer so oft auf,
  416. wie du möchtest; er wird einmal instanziiert und bleibt für die Lebensdauer der
  417. <classname>Zend_View</classname> Instanz bestehen.
  418. </para>
  419. <programlisting language="php"><![CDATA[
  420. // denke daran, dass $this in deinem View Skript auf die
  421. // Zend_View Instanz verweist.
  422. echo $this->specialPurpose();
  423. echo $this->specialPurpose();
  424. echo $this->specialPurpose();
  425. ]]></programlisting>
  426. <para>
  427. Die Ausgabe wird in etwa so aussehen:
  428. </para>
  429. <programlisting language="php"><![CDATA[
  430. Ich habe 'The Jerk' 1 Mal(e) gesehen.
  431. Ich habe 'The Jerk' 2 Mal(e) gesehen.
  432. Ich habe 'The Jerk' 3 Mal(e) gesehen.
  433. ]]></programlisting>
  434. <para>
  435. Hier und da ist es notwendig das aufrufende <classname>Zend_View</classname> Objekt
  436. aufzurufen -- zum Beispiel, wenn es notwendig ist die registrierte Verschöüsselung zu
  437. verwenden, oder wenn ein anderes View Skript gerendert werden soll, als Teil des eigenen
  438. Helfers. Um Zugriff zum View Objekt zu erhalten, sollte die eigene Helfer Klasse eine
  439. <methodname>setView($view)</methodname> Methode wie folgt besitzen:
  440. </para>
  441. <programlisting language="php"><![CDATA[
  442. class My_View_Helper_ScriptPath
  443. {
  444. public $view;
  445. public function setView(Zend_View_Interface $view)
  446. {
  447. $this->view = $view;
  448. }
  449. public function scriptPath($script)
  450. {
  451. return $this->view->getScriptPath($script);
  452. }
  453. }
  454. ]]></programlisting>
  455. <para>
  456. Wenn die Helfer Klasse eine <methodname>setView()</methodname> Methode hat, wird diese
  457. aufgerufen wenn die Helfer Klasse das erste Mal instanziert wird, und das aktuelle View
  458. Objekt übergeben wird. Es liegt an einem selbst das Objekt in der Klasse zu fixieren,
  459. genau so wie herauszufinden wie auf dieses zugegriffen werden sollte.
  460. </para>
  461. <para>
  462. Wenn <classname>Zend_View_Helper_Abstract</classname> erweitert wird, muß diese Methode
  463. nicht selbst definiert werden da Sie schon vordefiniert ist.
  464. </para>
  465. </sect2>
  466. </sect1>
  467. <!--
  468. vim:se ts=4 sw=4 et:
  469. -->