<sect1 id="zend.service.recaptcha">
    <title>Zend_Service_ReCaptcha</title>

    <sect2 id="zend.service.recaptcha.introduction">
        <title>הקדמה</title>

        <para>
            <code>Zend_Service_ReCaptcha</code> מספק תמיכה בשירות ה <ulink url="http://recaptcha.net/">reCAPTCHA</ulink>.
            כפי שמוסבר באתר reCAPTCHA, "reCAPTCHA הינו שירות ווב חינמי אשר מציג מילים מתוך ספרות למניעת ספאם ושימוש של האתר והתוכן בצורה לא חוקית ולמטרת ספאם.".
            כל reCAPTCHA דורש מהמשתמש להזין שתי מילים, המילה הראשונה היא בעצם ה captcha עצמה, והשנייה היא טקסט כלשהו שנסרק אשר מונע מתוכנת OCR לנסות ולפענח אותו.
            ההשערה היא שבמידה והמילה הראשונה הוזנה כפי שצריך רוב הסיכויים שגם השנייה תיהיה נכונה.
        </para>

        <para>
            כדי להשתמש בשירות של reCAPTCHA, תצטרך <ulink url="http://recaptcha.net/whyrecaptcha.html">להרשם</ulink> לשירות ולהוסיף דומיין אחד או יותר כדי לקבל מפתחות זיהוי.
        </para>
    </sect2>

    <sect2 id="zend.service.recaptcha.simplestuse">
        <title>שימוש בסיסי</title>

        <para>
            יצירת אובייקט <code>Zend_Service_ReCaptcha</code> חדש עם העברת המפתחות שלכם בתור פרמטרים:
        </para>

        <programlisting role="php"><![CDATA[
$recaptcha = new Zend_Service_ReCaptcha($pubKey, $privKey);
]]>
        </programlisting>

        <para>
            כדי להציג את הטקסט יש להשתמש במתודה <code>getHTML()</code>:
        </para>

        <programlisting role="php"><![CDATA[
echo $recaptcha->getHTML();
]]>
        </programlisting>

        <para>
            כשהטופס נשלח, אתם תקבלו שני שדות, 'recaptcha_challenge_field' ו 'recaptcha_response_field'.
            העבירו את שני השדות למתודה <code>verify()</code>:
        </para>

        <programlisting role="php"><![CDATA[
$result = $recaptcha->verify(
    $_POST['recaptcha_challenge_field'],
    $_POST['recaptcha_response_field']
);
]]>
        </programlisting>

        <para>
            ברגע שיש לכם את התוצאה מהמתודה, בדקו זאת אם היא תקינה.
            התוצאה הינה אובייקט של <code>Zend_Service_ReCaptcha_Response</code>, אשר מספק מתודה <code>isValid()</code>.
        </para>

        <programlisting role="php"><![CDATA[
if (!$result->isValid()) {
    // Failed validation
}
]]>
        </programlisting>

        <para>
            יותר פשוט יהיה להשתמש במתאם <link linkend="zend.captcha.adapters.recaptcha">ReCaptcha</link> <code>Zend_Captcha</code>, או להשתמש במתאם בתור בסיס ל
            <link linkend="zend.form.standardElements.captcha">אלמנט טפסים</link>. במקרה הזה, הפרטים של התצוגה והאימות מול reCAPTCHA נעשים אוטומטית.
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->
