- sync up to r15861

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

documentation/manual/pl/module_specs/Zend_Auth.xml

@@ -5,8 +5,9 @@
     <title>Wprowadzenie</title>
 
     <para>
-        <classname>Zend_Auth</classname> zapewnia API do uwierzytelniania oraz 
-        zawiera konkretne adaptery uwierzytelniania dla najczęstszych przypadków użycia.
+        <classname>Zend_Auth</classname> zapewnia <acronym>API</acronym> do 
+        uwierzytelniania oraz zawiera konkretne adaptery uwierzytelniania dla 
+        najczęstszych przypadków użycia.
     </para>
 
     <para>
@@ -38,9 +39,10 @@
         <title>Adaptery</title>
 
         <para>
-            Adapter <classname>Zend_Auth</classname> jest używany do uwierzytelniania na podstawie
-            serwisu konkretnego typu, takiego jak LDAP, RDBMS, lub system plików.
-            Różne adaptery mogą mieć różne opcje i mogą inaczej się zachowywać,
+            Adapter <classname>Zend_Auth</classname> jest używany do uwierzytelniania 
+            na podstawie serwisu konkretnego typu, takiego jak <acronym>LDAP</acronym>, 
+            <acronym>RDBMS</acronym>, lub system plików. Różne adaptery mogą 
+            mieć różne opcje i mogą inaczej się zachowywać,
             ale niektóre podstawowe funkcjonalności są wspólne dla wszystkich
             adapterów. Na przykład akceptowanie danych uwierzytelniania,
             przeprowadzanie zapytań do serwisu uwierzytelniania i zwracanie
@@ -66,8 +68,9 @@
             hasła. Inne szczegóły, takie jak sposób przeprowadzania zapytania
             uwierzytelniającego, zostały pominięte w celu zwiększenia
             czytelności:
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 class MyAuthAdapter implements Zend_Auth_Adapter_Interface
 {
     /**
@@ -94,6 +97,7 @@ class MyAuthAdapter implements Zend_Auth_Adapter_Interface
 }
 ]]></programlisting>
 
+        <para>
             Jak pokazano w bloku dokumentacyjnym, metoda <methodname>authenticate()</methodname>
             musi zwracać instancję <classname>Zend_Auth_Result</classname> (lub instancję klasy
             rozszerzającej <classname>Zend_Auth_Result</classname>). Jeśli z jakiegoś
@@ -117,48 +121,49 @@ class MyAuthAdapter implements Zend_Auth_Adapter_Interface
             dlatego poniższe cztery metody zapewniają podstawowy zestaw
             operacji, które są wspólne dla rezultatów adapterów 
             <classname>Zend_Auth</classname>:
-            <itemizedlist>
-                <listitem>
-                    <para>
-                        <methodname>isValid()</methodname> - zwraca logiczną wartość true
-                        tylko wtedy, gdy rezultat reprezentuje udaną próbę
-                        uwierzytelniania.
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getCode()</methodname> - zwraca identyfikator w postaci
-                        stałej klasy <classname>Zend_Auth_Result</classname> dla
-                        określenia powodu nieudanego uwierzytelniania lub
-                        sprawdzenia czy uwierzytelnianie się udało. Metoda może
-                        być użyta w sytuacjach gdy programista chce rozróżnić
-                        poszczególne typy wyników uwierzytelniania. Pozwala to
-                        na przykład programiście na zarządzanie szczegółowymi
-                        statystykami na temat wyników uwierzytelniania. Innym
-                        przykładem użycia tej funkcjonalności może być potrzeba
-                        zapewnienia wiadomości informujących użytkownika o
-                        przebiegu uwierzytelniania, ale jednak zalecane jest
-                        rozważenie ryzyka jakie zachodzi przy przekazywaniu
-                        użytkownikowi takich szczegółowych informacji, zamiast
-                        podstawowej informacji o błędzie. Aby uzyskać więcej
-                        informacji, zobacz poniżej.
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getIdentity()</methodname> - zwraca tożsamość próby
-                        uwierzytelniania
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <methodname>getMessages()</methodname> - zwraca tablicę wiadomości
-                        odnoszących się do nieudanej próby uwierzytelniania
-                    </para>
-                </listitem>
-            </itemizedlist>
         </para>
 
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <methodname>isValid()</methodname> - zwraca logiczną wartość true
+                    tylko wtedy, gdy rezultat reprezentuje udaną próbę
+                    uwierzytelniania.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getCode()</methodname> - zwraca identyfikator w postaci
+                    stałej klasy <classname>Zend_Auth_Result</classname> dla
+                    określenia powodu nieudanego uwierzytelniania lub
+                    sprawdzenia czy uwierzytelnianie się udało. Metoda może
+                    być użyta w sytuacjach gdy programista chce rozróżnić
+                    poszczególne typy wyników uwierzytelniania. Pozwala to
+                    na przykład programiście na zarządzanie szczegółowymi
+                    statystykami na temat wyników uwierzytelniania. Innym
+                    przykładem użycia tej funkcjonalności może być potrzeba
+                    zapewnienia wiadomości informujących użytkownika o
+                    przebiegu uwierzytelniania, ale jednak zalecane jest
+                    rozważenie ryzyka jakie zachodzi przy przekazywaniu
+                    użytkownikowi takich szczegółowych informacji, zamiast
+                    podstawowej informacji o błędzie. Aby uzyskać więcej
+                    informacji, zobacz poniżej.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getIdentity()</methodname> - zwraca tożsamość próby
+                    uwierzytelniania
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>getMessages()</methodname> - zwraca tablicę wiadomości
+                    odnoszących się do nieudanej próby uwierzytelniania
+                </para>
+            </listitem>
+        </itemizedlist>
+
         <para>
             Programista może chcieć przeprowadzić jakieś specyficzne akcje
             zależne od typu wyniku uwierzytelniania. Przykładami operacji,
@@ -167,8 +172,9 @@ class MyAuthAdapter implements Zend_Auth_Adapter_Interface
             adresów IP po wpisaniu przez użytkownika nieistnięjącej nazwy
             tożsamości czy zapewnienie własnych zdefiniowanych komunikatów po
             próbie uwierzytelniania. Dostępne są takie kody wyników:
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 Zend_Auth_Result::SUCCESS
 Zend_Auth_Result::FAILURE
 Zend_Auth_Result::FAILURE_IDENTITY_NOT_FOUND
@@ -177,13 +183,12 @@ Zend_Auth_Result::FAILURE_CREDENTIAL_INVALID
 Zend_Auth_Result::FAILURE_UNCATEGORIZED
 ]]></programlisting>
 
-        </para>
-
         <para>
             Poniższy przykład pokazuje w jaki sposób programista może obsłużyć
             to kodzie:
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // wewnątrz akcji loginAction kontrolera AuthController
 $result = $this->_auth->authenticate($adapter);
 
@@ -207,8 +212,6 @@ switch ($result->getCode()) {
 }
 ]]></programlisting>
 
-        </para>
-
     </sect2>
 
     <sect2 id="zend.auth.introduction.persistence">
@@ -223,10 +226,10 @@ switch ($result->getCode()) {
         </para>
 
         <para>
-            HTTP jest protokołem niezachowującym stanu pomiędzy żądaniami,
-            a techniki takie jak pliki cookie oraz sesje zostały stworzone w
-            celu ułatwienia zarządzania stanem pomiędzy żądaniami w aplikacjach
-            serwerowych.
+            <acronym>HTTP</acronym> jest protokołem niezachowującym stanu pomiędzy 
+            żądaniami, a techniki takie jak pliki cookie oraz sesje zostały 
+            stworzone w celu ułatwienia zarządzania stanem pomiędzy żądaniami w 
+            aplikacjach serwerowych.
         </para>
 
         <sect3 id="zend.auth.introduction.persistence.default">
@@ -236,7 +239,7 @@ switch ($result->getCode()) {
             <para>
                  Domyślnie <classname>Zend_Auth</classname> zapewnia trwały pojemnik do
                  przechowywania tożsamości pochodzącej z udanej próby
-                 uwierzytelniania używając sesji PHP. Po udanej próbie
+                 uwierzytelniania używając sesji <acronym>PHP</acronym>. Po udanej próbie
                  uwierzytelniania, metoda <methodname>Zend_Auth::authenticate()</methodname>
                  przechowuje wtrwałym pojemniku tożsamość pochodzącą z wyniku
                  uwierzytelniania. Jeśli nie skonfigurujemy tego inaczej, klasa
@@ -265,7 +268,7 @@ switch ($result->getCode()) {
 
                 <para>
                     <classname>Zend_Auth_Storage_Session</classname> używa przestrzeni
-                    nazw sesji o nazwie 'Zend_Auth'. Ta przestrzeń
+                    nazw sesji o nazwie '<classname>Zend_Auth</classname>'. Ta przestrzeń
                     nazw może być nadpisana przez przekazanie innej wartości do
                     konstruktora klasy <classname>Zend_Auth_Storage_Session</classname>, a
                     ta wartość wewnętrznie jest przekazywana do konstruktora
@@ -273,8 +276,9 @@ switch ($result->getCode()) {
                     nastąpić zanim przeprowadzone zostanie uwierzytelnianie,
                     ponieważ metoda <methodname>Zend_Auth::authenticate()</methodname>
                     automatycznie zapisuje dane tożsamości.
+                </para>
 
-                    <programlisting language="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 // Zapisujemy referencję do pojedynczej instancji Zend_Auth
 $auth = Zend_Auth::getInstance();
 
@@ -290,8 +294,6 @@ $auth->setStorage(new Zend_Auth_Storage_Session('someNamespace'));
 $result = $auth->authenticate($authAdapter);
 ]]></programlisting>
 
-                </para>
-
             </example>
 
         </sect3>
@@ -318,8 +320,9 @@ $result = $auth->authenticate($authAdapter);
                     niż <classname>Zend_Auth_Storage_Session</classname>, programista
                     implementuje interfejs
                     <classname>Zend_Auth_Storage_Interface</classname>:
+                </para>
 
-                    <programlisting language="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 class MyStorage implements Zend_Auth_Storage_Interface
 {
     /**
@@ -384,14 +387,13 @@ class MyStorage implements Zend_Auth_Storage_Interface
 }
 ]]></programlisting>
 
-                </para>
-
                 <para>
                     W celu użycia własnej klasy pojemnika, wywołaj metodę
                     <methodname>Zend_Auth::setStorage()</methodname> przed przeprowadzeniem
                     zapytania uwierzytelniającego:
+                </para>
 
-                    <programlisting language="php"><![CDATA[<?php
+                <programlisting language="php"><![CDATA[<?php
 // Instruujemy klasę Zend_Auth aby użyła niestandardowej klasy pojemnika
 Zend_Auth::getInstance()->setStorage(new MyStorage());
 
@@ -403,8 +405,6 @@ Zend_Auth::getInstance()->setStorage(new MyStorage());
 $result = Zend_Auth::getInstance()->authenticate($authAdapter);
 ]]></programlisting>
 
-                </para>
-
             </example>
 
         </sect3>
@@ -417,7 +417,9 @@ $result = Zend_Auth::getInstance()->authenticate($authAdapter);
 
         <para>
             Są dwa możliwe sposoby użycia adapterów <classname>Zend_Auth</classname>:
-            <orderedlist>
+        </para>
+
+        <orderedlist>
             <listitem>
                 <para>
                     pośrednio, za pomocą metody
@@ -430,14 +432,14 @@ $result = Zend_Auth::getInstance()->authenticate($authAdapter);
                     adaptera
                 </para>
             </listitem>
-            </orderedlist>
-        </para>
+        </orderedlist>
 
         <para>
             Poniższy przykład pokazuje jak użyć adaptera <classname>Zend_Auth</classname>
             pośrednio, poprzez użycie klasy <classname>Zend_Auth</classname>:
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // Pobieramy instancję Zend_Auth
 $auth = Zend_Auth::getInstance();
 
@@ -457,29 +459,30 @@ if (!$result->isValid()) {
     // $result->getIdentity() === $auth->getIdentity()
     // $result->getIdentity() === $username
 }]]></programlisting>
-        </para>
 
         <para>
             Jeśli uwierzytelnianie zostało przeprowadzone w żądaniu tak jak w
             powyższym przykładzie, prostą sprawą  jest sprawdzenie czy istnieje
             pomyślnie uwierzytelniona tożsamość:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $auth = Zend_Auth::getInstance();
 if ($auth->hasIdentity()) {
     // Tożsamość istnieje; pobieramy ją
     $identity = $auth->getIdentity();
 }
 ]]></programlisting>
-        </para>
 
         <para>
             Aby usunąć tożsamość z trwałego pojemnika, użyj po prostu metody
             <methodname>clearIdentity()</methodname>. Typowo może być to użyte do
             implementacji w aplikacji operacji wylogowania:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 Zend_Auth::getInstance()->clearIdentity();
 ]]></programlisting>
-        </para>
 
         <para>
             Gdy automatyczne użycie trwałego pojemnika jest nieodpowiednie w
@@ -490,8 +493,9 @@ Zend_Auth::getInstance()->clearIdentity();
             <methodname>authenticate()</methodname>. Szczegóły specyficzne dla adaptera są
             opisane w dokumentacji dla każdego z adapterów. Poniższy przykład
             bezpośrednio używa <emphasis>MyAuthAdapter</emphasis>:
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // Ustawiamy adapter uwierzytelniania
 $authAdapter = new MyAuthAdapter($username, $password);
 
@@ -508,7 +512,6 @@ if (!$result->isValid()) {
     // $result->getIdentity() === $username
 }
 ]]></programlisting>
-        </para>
 
     </sect2>
 

documentation/manual/pl/module_specs/Zend_Auth_Adapter_DbTable.xml

@@ -15,52 +15,55 @@
             konstruktora lub za pomocą metod instancji, po jednej dla każdej z
             opcji.
         </para>
+
         <para>
             Dostępne opcje konfiguracyjne to:
-            <itemizedlist>
-                <listitem>
-                    <para>
-                        <emphasis>tableName</emphasis>: Jest to nazwa tabeli bazy
-                        danych, która zawiera dane uwierzytelniania i do której
-                        jest przeprowadzane zapytanie uwierzytelniające.
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <emphasis>identityColumn</emphasis>: Jest to nazwa kolumny
-                        tabeli bazy danych, która reprezentuje tożsamość.
-                        Kolumna tożsamości musi zawierać unikalne wartości,
-                        na przykład takie jak nazwa użytkownika czy adres
-                        e-mail.
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <emphasis>credentialColumn</emphasis>: Jest to nazwa kolumny
-                        tabeli bazy danych, która reprezentuje wartość
-                        uwierzytelniającą. W prostym schemacie uwierzytelniania
-                        opartym o nazwę tożsamości i hasło, wartość
-                        uwierzytelniająca odpowiada hasłu. Zobacz także opcję
-                        <emphasis>credentialTreatment</emphasis>.
-                    </para>
-                </listitem>
-                <listitem>
-                    <para>
-                        <emphasis>credentialTreatment</emphasis>: W wielu przypadkach,
-                        hasło i inne wrażliwe dane są zszyfrowane, haszowane,
-                        zakodowane lub w inny sposób przetworzone przez
-                        jakąś funkcję lub algorytm. Określając metodę
-                        przerobienia danych, taką jak na przykład
-                        'MD5(?)' czy 'PASSWORD(?)',
-                        programista może użyć konkretnej funkcji SQL na danych
-                        uwierzytelniających. Z tego względu, że te funkcje są
-                        specyficzne dla konkretnych systemów baz danych, zajrzyj
-                        do odpowiednich dokumentacji aby sprawdzić dostępność
-                        takich funkcji dla twojego systemu bazy danych.
-                    </para>
-                </listitem>
-            </itemizedlist>
         </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>tableName</emphasis>: Jest to nazwa tabeli bazy
+                    danych, która zawiera dane uwierzytelniania i do której
+                    jest przeprowadzane zapytanie uwierzytelniające.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis>identityColumn</emphasis>: Jest to nazwa kolumny
+                    tabeli bazy danych, która reprezentuje tożsamość.
+                    Kolumna tożsamości musi zawierać unikalne wartości,
+                    na przykład takie jak nazwa użytkownika czy adres
+                    e-mail.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis>credentialColumn</emphasis>: Jest to nazwa kolumny
+                    tabeli bazy danych, która reprezentuje wartość
+                    uwierzytelniającą. W prostym schemacie uwierzytelniania
+                    opartym o nazwę tożsamości i hasło, wartość
+                    uwierzytelniająca odpowiada hasłu. Zobacz także opcję
+                    <emphasis>credentialTreatment</emphasis>.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis>credentialTreatment</emphasis>: W wielu przypadkach,
+                    hasło i inne wrażliwe dane są zszyfrowane, haszowane,
+                    zakodowane lub w inny sposób przetworzone przez
+                    jakąś funkcję lub algorytm. Określając metodę
+                    przerobienia danych, taką jak na przykład
+                    'MD5(?)' czy 'PASSWORD(?)',
+                    programista może użyć konkretnej funkcji SQL na danych
+                    uwierzytelniających. Z tego względu, że te funkcje są
+                    specyficzne dla konkretnych systemów baz danych, zajrzyj
+                    do odpowiednich dokumentacji aby sprawdzić dostępność
+                    takich funkcji dla twojego systemu bazy danych.
+                </para>
+            </listitem>
+        </itemizedlist>
+
         <example id="zend.auth.adapter.dbtable.introduction.example.basic_usage">
             <title>Podstawowe użycie</title>
             <para>
@@ -71,6 +74,7 @@
                 instancja adaptera uwierzytelniania. Na początku powinno być
                 utworzone połączenie do bazy danych.
             </para>
+
             <para>
                 Poniższy kod tworzy adapter bazy danych przechowywanej w pamięci,
                 tworzy prostą strukturę tabeli, a następnie wstawia wiersz, w
@@ -78,6 +82,7 @@
                 uwierzytelniające. Ten przykład wymaga dostępnego rozszerzenia
                 PDO SQLite:
             </para>
+
             <programlisting language="php"><![CDATA[
 // Tworzymy połączenie do bazy danych SQLite przechowywanej w pamięci
 $dbAdapter = new Zend_Db_Adapter_Pdo_Sqlite(array('dbname' =>
@@ -101,6 +106,7 @@ $sqlInsert = "INSERT INTO users (username, password, real_name) "
 // Wstawiamy dane
 $dbAdapter->query($sqlInsert);
 ]]></programlisting>
+
             <para>
                 Gdy połączenie do bazy danych oraz dane w tabeli są już
                 dostępne, możesz utworzyć instancję klasy
@@ -108,6 +114,7 @@ $dbAdapter->query($sqlInsert);
                 mogą być przekazane do konstruktora lub przekazane jako
                 parametry do metod dostępowych już po utworzeniu instancji:
             </para>
+
             <programlisting language="php"><![CDATA[
 // Konfigurujemy instancję za pomocą parametrów konstruktora
 $authAdapter = new Zend_Auth_Adapter_DbTable(
@@ -125,6 +132,7 @@ $authAdapter
     ->setCredentialColumn('password')
 ;
 ]]></programlisting>
+
             <para>
                 W tym momencie intancja adaptera uwierzytelniania jest gotowa
                 do przeprowadzenia zapytań uwierzytelniających. W celu
@@ -132,6 +140,7 @@ $authAdapter
                 są przekazywane do adaptera przed wywołaniem metody
                 <methodname>authenticate()</methodname>:
             </para>
+
             <programlisting language="php"><![CDATA[
 // Ustawiamy wartości danych uwierzytelniania (np., z formularza logowania)
 $authAdapter
@@ -141,12 +150,14 @@ $authAdapter
 // Przeprowadzamy zapytanie uwierzytelniające, zapisując rezultat
 $result = $authAdapter->authenticate();
 ]]></programlisting>
+
             <para>
                 Oprócz możliwości użycia metody <methodname>getIdentity()</methodname>
                 obiektu rezultatu uwierzytelniania, obiekt
                 <classname>Zend_Auth_Adapter_DbTable</classname> pozwala także na
                 odebranie wiersza tabeli po udanym uwierzytelnieniu.
             </para>
+
             <programlisting language="php"><![CDATA[
 // Wyświetlamy tożsamość
 echo $result->getIdentity() . "\n\n";
@@ -166,11 +177,13 @@ Array
 )
 */
 ]]></programlisting>
+
             <para>
                 Z tego względu, że wiersz tabeli zawiera dane potrzebne do
                 uwierzytelniania, ważne jest, aby dane były zabezpieczone przed
                 dostępem przez osoby nieuprawnione.
             </para>
+
         </example>
     </sect2>
     <sect2 id="zend.auth.adapter.dbtable.advanced.storing_result_row">
@@ -185,6 +198,7 @@ Array
             <methodname>getResultRowObject()</methodname> aby zwrócić obiekt klasy
             <classname>stdClass</classname>. Poniższy kod ilustruje sposób jego użycia:
         </para>
+
         <programlisting language="php"><![CDATA[
 // uwierzytelniamy za pomocą Zend_Auth_Adapter_DbTable
 $result = $this->_auth->authenticate($adapter);
@@ -226,12 +240,14 @@ if ($result->isValid()) {
             wyjaśnić swój problem, czasem może być przydatne rozwiązanie
             problemu autoryzacji podczas uwierzytelniania.
         </para>
+
         <para>
             Komponent <classname>Zend_Auth_Adapter_DbTable</classname> posiada 
             pewien wbudowany mechanizm, który może być użyty do dodania dodatkowych 
             warunków podczas uwierzytelniania, dzięki czemu można rozwiązać niektóre
             problemy.
         </para>
+
         <programlisting language="php"><![CDATA[
 // Wartość pola "status" dla tego konta nie jest równa wartości "compromised"
 $adapter = new Zend_Auth_Adapter_DbTable(
@@ -251,6 +267,7 @@ $adapter = new Zend_Auth_Adapter_DbTable(
     'MD5(?) AND active = "TRUE"'
 );
 ]]></programlisting>
+
         <para>
             Innym przykładem może być implementacja mechanizmu saltingu. Jest to
             technika pozwalająca w znaczny sposób zwiększyć bezpieczeństwo
@@ -258,10 +275,12 @@ $adapter = new Zend_Auth_Adapter_DbTable(
             łańcuch znaków spowodujemy, że niemożliwe będzie przeprowadzenie
             ataku brute force na bazę danych w oparciu o przygotowany słownik.
         </para>
+
         <para>
             Zaczniemy od zmodyfikowania schematu tabeli bazy danych, aby móc
             przechowywać nasz łańcuch znaków salt:
         </para>
+
         <programlisting language="php"><![CDATA[
 $sqlAlter = "ALTER TABLE [users] "
           . "ADD COLUMN [password_salt] "
@@ -269,19 +288,23 @@ $sqlAlter = "ALTER TABLE [users] "
 
 $dbAdapter->query($sqlAlter);
 ]]></programlisting>
+
         <para>
             W prosty sposób wygenerujmy salt dla każdego rejestrującego się
             użytkownika:
         </para>
+
         <programlisting language="php"><![CDATA[
 for ($i = 0; $i < 50; $i++)
 {
     $dynamicSalt .= chr(rand(33, 126));
 }
 ]]></programlisting>
+
         <para>
             I skonfigurujmy sterownik bazy danych:
         </para>
+
         <programlisting language="php"><![CDATA[
 $adapter = new Zend_Auth_Adapter_DbTable(
     $db,
@@ -298,11 +321,12 @@ $adapter = new Zend_Auth_Adapter_DbTable(
                 Możesz jeszcze zwiększyć bezpieczeństwo używając dodatkowo
                 statycznego fragmentu łańcucha znaków umieszczonego na stałe
                 w kodzie aplikacji. W przypadku, gdy atakujący uzyska dostęp
-                do bazy danych (np. za pomocą ataku SQL injection), a nie będzie
-                miał dostępu do kodu źródłowego, hasła wciąż będą dla niego
-                nieprzydatne.
+                do bazy danych (np. za pomocą ataku <acronym>SQL</acronym> 
+                injection), a nie będzie miał dostępu do kodu źródłowego, 
+                hasła wciąż będą dla niego nieprzydatne.
             </para>
         </note>
+
         <para>
             Innym sposobem jest użycie metody <methodname>getDbSelect()</methodname> 
             klasy <classname>Zend_Auth_Adapter_DbTable</classname> po utworzeniu
@@ -314,11 +338,13 @@ $adapter = new Zend_Auth_Adapter_DbTable(
             dotyczących nazwy tożsamości i hasła, ponieważ te dane będą umieszczone
             tam dopiero w czasie wywołania metody <methodname>authenticate()</methodname>.
         </para>
+
         <para>
             Przykładem sytuacji w której można by użyć metody getDbSelect() 
             może być potrzeba sprawdzenia statusu użytkownika, czyli sprawdzenia
             czy konto użytkownika jest aktywne.
         </para>
+
         <programlisting language="php"><![CDATA[
 // Kontynuując poprzedni przykład 
 $adapter = new Zend_Auth_Adapter_DbTable(

documentation/manual/pl/module_specs/Zend_Auth_Adapter_Digest.xml

@@ -126,5 +126,4 @@ Array
 ]]></programlisting>
 
     </sect2>
-
 </sect1>