[DOCU] German:

- sync up to r17684

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17738 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/de/module_specs/Zend_Form-StandardElements.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 17663 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.form.standardElements">
     <title>Standard Form Elemente die mit dem With Zend Framework ausgeliefert werden</title>
@@ -220,7 +220,7 @@ $form->setAttrib('enctype', 'multipart/form-data');
             </para>
 
             <programlisting language="php"><![CDATA[
-if (!$form->isValid) {
+if (!$form->isValid()) {
     print "Uh oh... Prüfungsfehler";
 }
 

documentation/manual/de/module_specs/Zend_Http_Client-Advanced.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 17648 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.http.client.advanced">
     <title>Zend_Http_Client - Fortgeschrittende Nutzung</title>
@@ -229,11 +229,12 @@ $client->setRawData($xml)->setEncType('text/xml')->request('POST');
         <title>HTTP Authentifizierung</title>
         <para>
             Derzeit unterstützt Zend_Http_Client nur die Basis HTTP Authentifizierung. Diese
-            Funktion kann durch Verwendung der setAuth() Methode genutzt werden. Diese Methode
-            nimmt 3 Parameter entgegen: den Benutzernamen, das Passwort und einen optionalen
-            Authentifizierungstyp Parameter. Wie gesagt, wird derzeit nur die Basis
-            Authentifizierung unterstützt (Unterstützung für eine Digest Authentifizierung ist
-            geplant).
+            Funktion kann durch Verwendung der <methodname>setAuth()</methodname> Methode oder durch
+            Spezifikation von Benutzername und Passwort in der URI genutzt werden. Die
+            <methodname>setAuth()</methodname> Methode nimmt 3 Parameter entgegen: den
+            Benutzernamen, das Passwort und einen optionalen Authentifizierungstyp Parameter. Wie
+            gesagt, wird derzeit nur die Basis Authentifizierung unterstützt (Unterstützung für eine
+            Digest Authentifizierung ist geplant).
             <example id="zend.http.client.http_authentication.example-1">
                 <title>Setzen von Benutzer und Password für eine HTTP Authentifizierung</title>
                 <programlisting language="php"><![CDATA[
@@ -242,6 +243,9 @@ $client->setAuth('shahar', 'myPassword!', Zend_Http_Client::AUTH_BASIC);
 
 // Da Basis Authentifizierung Standard ist, kann man auch dies verwenden:
 $client->setAuth('shahar', 'myPassword!');
+
+// Man kann auch den Benutzernamen und das Passwort in der URI spezifizieren
+$client->setUri('http://christer:secret@example.com');
 ]]></programlisting>
             </example>
         </para>

documentation/manual/de/module_specs/Zend_Log-Writers-Syslog.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16589 -->
+<!-- EN-Revision: 17624 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.log.writers.syslog">
     <title>In das Systemlog schreiben</title>
@@ -30,7 +30,7 @@
 $writer = new Zend_Log_Writer_Syslog(array('application' => 'FooBar'));
 
 // Zu jeder anderen Zeit:
-$writer->setApplication('BarBaz');
+$writer->setApplicationName('BarBaz');
 ]]></programlisting>
 
     <para>

documentation/manual/de/module_specs/Zend_Paginator-Advanced.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17133 -->
+<!-- EN-Revision: 17632 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.paginator.advanced">
     <title>Advanced usage</title>
@@ -218,6 +218,44 @@ var_dump($paginator->getPageItemCache());
 ]]></programlisting>
         </para>
     </sect2>
+
+    <sect2 id="zend.paginator.advanced.aggregator">
+        <title>Zend_Paginator_AdapterAggregate Interface</title>
+
+        <para>
+            Abhängig von der Anwendung kann es gewünscht sein Objekte zu Seiten zu verarbeiten,
+            dessen interne Datenstruktur identisch zu existierenden Adaptern ist, aber bei denen
+            man nicht will das die eigene Kapselung gebrochen wird um Zugriff auf diese Daten
+            zu erlauben. In anderen Fällen könnte ein Objekt in einer "hat einen Adapter" Relation
+            stehen, statt in einer "ist ein Adapter" Relation die
+            <classname>Zend_Paginator_Adapter_Abstract</classname> promotet. Für diese Fälle kann
+            man das <classname>Zend_Paginator_AdapterAggregate</classname> Interface verwenden das
+            sich so verhält wie das <classname>IteratorAggregate</classname> Interface der SPL
+            Erweiterung von PHP.
+        </para>
+
+        <para>
+            <programlisting language="php"><![CDATA[
+interface Zend_Paginator_AdapterAggregate
+{
+    /**
+     * Return a fully configured Paginator Adapter from this method.
+     *
+     * @return Zend_Paginator_Adapter_Abstract
+     */
+    public function getPaginatorAdapter();
+}
+]]></programlisting>
+        </para>
+
+        <para>
+            Das Interface ist sehr klein und erwartet nur das eine Instanz von
+            <classname>Zend_Paginator_Adapter_Abstract</classname> zurückgegeben wird. Eine
+            Aggregate Instanz des Adapters wird dann von beiden erkannt, sowohl
+            <code>Zend_Paginator::factory</code> als auch dem Konstruktor von Zend_Paginator
+            und entsprechend behandelt.
+        </para>
+    </sect2>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/de/module_specs/Zend_Paginator-Usage.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17274 -->
+<!-- EN-Revision: 17662 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.paginator.usage">
     <title>Verwendung</title>
@@ -169,14 +169,26 @@ $this->view->paginator = $paginator;
         <title>Die Adapter DbSelect und DbTableSelect</title>
         <para>
             Die Verwendung der meisten Adapter ist recht zielgerichtet. Trotzdem benötigen die
-            Datenbank Adapter detailiertere Erklärungen. Im Gegensatz zur üblichen Meinung holen
-            diese Adapter <emphasis>nicht</emphasis> alle Einträge von der Datenbank um sie zu
-            zählen. Stattdessen manipuliert der Adapter die originale Abfrage um die entsprechende
-            COUNT Abfrage zu erzeugen. Paginator führt dann diese COUNT Abfrage aus um die Anzahl
-            der Zeilen zu erhalten. Das erfordert eine zusätzliche Beanspruchung der Datenbank, ist
-            aber um ein vielfaches schneller als das komplette Ergebnisset zu holen und
-            <methodname>count()</methodname> zu verwenden. Speziell bei einer großen Anzahl an
-            Daten.
+            Datenbank Adapter detailiertere Erklärungen betreffend dem Empfang und dem Zählen von
+            Daten aus der Datenbank.
+        </para>
+
+        <para>
+            Um die DbSelect und DbTableSelect Adapter zu verwenden muß man die Daten nicht direkt
+            von der Datenbank empfangen. Beide Adapter führen den Empfang selbst durch, und Zählen
+            auch die Anzahl der Seiten. Wenn zusätzliche Arbeit basieren auf den Ergebnissen des
+            Adapters getan werden soll, kann die <code>getItems()</code> Methode des Adapters in der
+            eigenen Anwendung erweitert werden.
+        </para>
+
+        <para>
+            Zusätzlich holen diese Adapter <emphasis>nicht</emphasis> alle Einträge von der
+            Datenbank um sie zu zählen. Stattdessen manipuliert der Adapter die originale Abfrage um
+            die entsprechende COUNT Abfrage zu erzeugen. Paginator führt dann diese COUNT Abfrage
+            aus um die Anzahl der Zeilen zu erhalten. Das erfordert eine zusätzliche Beanspruchung
+            der Datenbank, ist aber um ein vielfaches schneller als das komplette Ergebnisset zu
+            holen und <methodname>count()</methodname> zu verwenden. Speziell bei einer großen
+            Anzahl an Daten.
         </para>
 
         <para>

documentation/manual/de/module_specs/Zend_Queue-Adapters.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17508 -->
+<!-- EN-Revision: 17669 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.queue.adapters">
     <title>Adapter</title>
@@ -177,7 +177,7 @@ $options = array(
 );
 
 // Eine Datenbank Queue erstellen.
-$queue = Zend_Queue::factory('Db', $options);
+$queue = new Zend_Queue('Db', $options);
 ]]></programlisting>
 
             <itemizedlist>

documentation/manual/de/module_specs/Zend_Queue-Example.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16599 -->
+<!-- EN-Revision: 17660 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.queue.example">
     <title>Beispiel der Verwendung</title>
@@ -18,7 +18,7 @@ $options = array(
 );
 
 // Erstellung einer Array Queue
-$queue = Zend_Queue('Array', $options);
+$queue = new Zend_Queue('Array', $options);
 
 // Eine Liste von Queues erhalten
 foreach ($queue->getQueues() as $name) {
@@ -26,7 +26,7 @@ foreach ($queue->getQueues() as $name) {
 }
 
 // eine neue Liste erstellen
-$queue2 = $queue->create('queue2');
+$queue2 = $queue->createQueue('queue2');
 
 // Die Anzahl von Nachrichten in einer Queue erhalten
 // (unterstützt das Countable Interface von SPL)
@@ -47,6 +47,6 @@ foreach ($messages as $i => $message) {
 $queue->send('Meine Test Nachricht');
 
 // Eine Queue die wir erstellt haben löschen inklusive aller Ihrer Nachrichten
-$queue->delete('queue2');
+$queue->deleteQueue('queue2');
 ]]></programlisting>
 </sect1>

documentation/manual/de/module_specs/Zend_Service-ReCaptcha.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17133 -->
+<!-- EN-Revision: 17621 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.recaptcha">
     <title>Zend_Service_ReCaptcha</title>
@@ -35,18 +35,26 @@
             öffentlichen und privaten Schlüssel übergeben:
         </para>
 
-        <programlisting language="php"><![CDATA[
+        <example id="zend.service.recaptcha.example-1">
+            <title>Erstellung einer Instanz des ReCaptcha Services</title>
+
+            <programlisting language="php"><![CDATA[
 $recaptcha = new Zend_Service_ReCaptcha($pubKey, $privKey);
 ]]></programlisting>
+        </example>
 
         <para>
             Um das reCAPTCHA darzustellen, muß einfach die <methodname>getHTML()</methodname>
             Methode aufgerufen werden:
         </para>
 
-        <programlisting language="php"><![CDATA[
+        <example id="zend.service.recaptcha.example-2">
+            <title>Das ReCaptcha darstellen</title>
+
+            <programlisting language="php"><![CDATA[
 echo $recaptcha->getHTML();
 ]]></programlisting>
+        </example>
 
         <para>
             Wenn das Formular übertragen wurde, sollte man zwei Felder empfangen haben,
@@ -54,12 +62,16 @@ echo $recaptcha->getHTML();
             <methodname>verify()</methodname> Methode des ReCaptcha Objekts zu übergeben:
         </para>
 
-        <programlisting language="php"><![CDATA[
+        <example id="zend.service.recaptcha.example-3">
+            <title>Das Formular Feld verifizieren</title>
+
+            <programlisting language="php"><![CDATA[
 $result = $recaptcha->verify(
     $_POST['recaptcha_challenge_field'],
     $_POST['recaptcha_response_field']
 );
 ]]></programlisting>
+        </example>
 
         <para>
             Sobald man das Ergebnis hat, kann es getestet werden um zu sehen ob es gültig ist. Das
@@ -67,11 +79,15 @@ $result = $recaptcha->verify(
             eine <methodname>isValid()</methodname> Methode anbietet.
         </para>
 
-        <programlisting language="php"><![CDATA[
+        <example id="zend.service.recaptcha.example-4">
+            <title>Das ReCaptcha prüfen</title>
+
+            <programlisting language="php"><![CDATA[
 if (!$result->isValid()) {
     // Fehlerhafte Prüfung
 }
 ]]></programlisting>
+        </example>
 
         <para>
             Noch einfacher zu verwenden ist
@@ -82,6 +98,128 @@ if (!$result->isValid()) {
             automatisch durchgeführt.
         </para>
     </sect2>
+
+    <sect2 id="zend.service.recaptcha.mailhide">
+        <title>Email Adressen verstecken</title>
+
+        <para>
+            <classname>Zend_Service_ReCaptcha_MailHide</classname> kann verwendet werden um Email
+            Adressen zu verstecken. Es ersetzt den Teil der Email Adresse mit einem Link der ein
+            Popup Fenster mit einer ReCaptcha Challenge öffnet. Das Lösen der Challenge gibt die
+            komplette Email Adresse zurück.
+        </para>
+
+        <para>
+            Um diese Komponente zu verwenden benötigt man
+            <ulink url="http://recaptcha.net/whyrecaptcha.html">einen Account</ulink>, und muß
+            öffentliche und private Schlüssel für die Mailhide API erstellen.
+        </para>
+
+        <example id="zend.service.recaptcha.mailhide.example-1">
+            <title>Verwenden der Mail Hide Komponente</title>
+
+            <programlisting language="php"><![CDATA[
+// Die Mail Adresse die wir verstecken wollen
+$mail = 'mail@example.com';
+
+// Eine Instanz der Mailhide Komponente erstellen, dieser die öffentlichen und
+// privaten Schlüssel übergeben sowie die Mail Adresse die man verstecken will
+$mailHide = new Zend_Service_ReCaptcha_Mailhide();
+$mailHide->setPublicKey($pubKey);
+$mailHide->setPrivateKey($privKey);
+$mailHide->setEmail($mail);
+
+// Es darstellen
+print($mailHide);
+]]></programlisting>
+        </example>
+
+        <para>
+            Das obige Beispiel zeigt "m...@example.com" wobei "..." einen Link enthält der sich
+            mit einem Popup Fenster und einer ReCaptcha Challenge öffnet.
+        </para>
+
+        <para>
+            Der öffentliche Schlüssel, private Schlüssel und die Email Adresse können auch im
+            Konstruktor der Klasse spezifiziert werden. Es existiert ein viertes Argument das es
+            erlaubt einige Optionen für die Komponente zu setzen. Die vorhandenen Optionen sind in
+            der folgenden Tabelle aufgelistet:
+            <table id="zend.service.recaptcha.mailhide.options.table">
+                <title>Zend_Service_ReCaptcha_MailHide options</title>
+                <tgroup cols="4">
+                    <thead>
+                        <row>
+                            <entry>Option</entry>
+                            <entry>Beschreibung</entry>
+                            <entry>Erwartete Werte</entry>
+                            <entry>Standard Werte</entry>
+                        </row>
+                    </thead>
+                    <tbody>
+                        <row>
+                            <entry>linkTitle</entry>
+                            <entry>Das Titel Attribut des Links</entry>
+                            <entry>string</entry>
+                            <entry>'Reveal this e-mail address'</entry>
+                        </row>
+                        <row>
+                            <entry>linkHiddenText</entry>
+                            <entry>Der Text welche den Popup Link enthält</entry>
+                            <entry>string</entry>
+                            <entry>'...'</entry>
+                        </row>
+                        <row>
+                            <entry>popupWidth</entry>
+                            <entry>Die Breite des Popup Fensters</entry>
+                            <entry>int</entry>
+                            <entry>500</entry>
+                        </row>
+                        <row>
+                            <entry>popupHeight</entry>
+                            <entry>Die Höhe des Popup Fensters</entry>
+                            <entry>int</entry>
+                            <entry>300</entry>
+                        </row>
+                    </tbody>
+                </tgroup>
+            </table>
+        </para>
+
+        <para>
+            Die Konfigurations Optionen können gesetzt werden indem Sie als viertes Argument an den
+            Konstruktor gesendet werden oder indem die <methodname>setOptions($options)</methodname>
+            aufgerufen wird, welche ein assoziatives Array oder eine Instanz von
+            <link linkend="zend.config">Zend_Config</link> entgegen nimmt.
+        </para>
+
+        <example id="zend.service.recaptcha.mailhide.example-2">
+            <title>Viele versteckte Email Adressen erzeugen</title>
+
+            <programlisting language="php"><![CDATA[
+// Eine Instanz der Mailhide Komponente erstellen, dieser die öffentlichen und
+// privaten Schlüssel übergeben sowie die Mail Adresse die man verstecken will
+$mailHide = new Zend_Service_ReCaptcha_Mailhide();
+$mailHide->setPublicKey($pubKey);
+$mailHide->setPrivateKey($privKey);
+$mailHide->setOptions(array(
+    'linkTitle' => 'Click me',
+    'linkHiddenText' => '+++++',
+));
+
+// Die Adressen die wir verstecken wollen
+$mailAddresses = array(
+    'mail@example.com',
+    'johndoe@example.com',
+    'janedoe@example.com',
+);
+
+foreach ($mailAddresses as $mail) {
+    $mailHide->setEmail($mail);
+    print($mailHide);
+}
+]]></programlisting>
+        </example>
+    </sect2>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et: