کپچاپرس

۱. پیش‌نیازها

پیش از نصب کپچاپرس، مطمئن شوید سایت شما این شرایط را دارد:

۲. نصب افزونه

کپچاپرس به‌صورت یک فایل captchapress.zip به شما تحویل داده می‌شود. با هر روشی که با هاست شما سازگار است آن را نصب کنید.

روش الف — پیشخوان وردپرس

ساده‌ترین روش که روی اکثر هاست‌ها کار می‌کند.

1. وارد پیشخوان وردپرس شوید (https://your-site.com/wp-admin).
2. به افزونه‌ها ← افزودن افزونه بروید.
3. روی دکمه‌ی بارگذاری افزونه در بالای صفحه کلیک کنید.
4. روی انتخاب فایل یا Browse... کلیک کرده، سپس فایل captchapress.zip را که در پوشه plugin از فایل خریداری شده قرار دارد، انتخاب کرده و سپس هم‌اکنون نصب کن را بزنید.
5. پس از اتمام بارگذاری، روی فعال‌سازی افزونه کلیک کنید.

روش ب — سی‌پنل (مدیریت فایل)

زمانی که هاست شما cPanel دارد (رایج در هاست‌های اشتراکی).

1. وارد سی‌پنل شوید (معمولاً https://your-site.com:2083).
2. بخش Files ← File Manager را باز کنید.
3. به محل نصب وردپرس و سپس به public_html/wp-content/plugins/ بروید. روی گزینه Upload کلیک کنید.
4. در صفحه ای که باز شده است روی Select File کلیک کرده و فایل captchapress.zip را که در پوشه plugin فایل خریداری شده قرار دارد، بارگذاری کنید.
5. به File Manager بازگردید، روی captchapress.zip راست‌کلیک کرده و Extract را بزنید.
6. پس از استخراج باید پوشه‌ی wp-content/plugins/captchapress/ را داشته باشید.
7. به وردپرس ← افزونه‌ها بروید و روی فعال‌سازی کلیک کنید.

روش پ — دایرکت‌ادمین (مدیریت فایل)

زمانی که هاست شما DirectAdmin دارد.

1. وارد دایرکت‌ادمین شوید (معمولاً https://your-site.com:2222).
2. بخش File Manager را باز کنید.
3. به wp-content/plugins/ بروید.
4. روی Upload کلیک کرده و captchapress.zip را انتخاب کنید.
5. فایل بارگذاری‌شده را انتخاب کرده و با گزینه‌ی Extract آن را همان‌جا استخراج کنید.
6. مطمئن شوید پوشه‌ی wp-content/plugins/captchapress/ را دارید.
7. به وردپرس ← افزونه‌ها بروید و روی فعال‌سازی کلیک کنید.

۳. فعال‌سازی افزونه

1. به افزونه‌ها ← افزونه‌های نصب‌شده بروید.
2. کپچاپرس را پیدا کرده و روی فعال‌سازی کلیک کنید.

تشخیص خودکار یکپارچه‌سازی‌ها

وقتی کپچاپرس را برای نخستین بار فعال می‌کنید، بررسی می‌کند چه افزونه‌های فرمی روی سایت شما فعال هستند و یکپارچه‌سازی‌های متناظر را به‌طور خودکار روشن می‌کند:

۴. نگاهی کلی به صفحه‌ی تنظیمات

به تنظیمات ← کپچاپرس بروید. این صفحه به پنج زبانه (تب) تقسیم شده است:

۵. افزودن کپچا به افزونه‌های دیگر

تمام یکپارچه‌سازی‌ها از یک مکان مدیریت می‌شوند: تنظیمات ← کپچاپرس ← یکپارچه‌سازی‌ها. هر ردیف یک کلید روشن/خاموش ساده است.

افزونه‌های فرم خارجی

ووکامرس

۶. افزودن کپچا به فرم ورود وردپرس

برای محافظت از صفحه‌ی ورود:

1. به تنظیمات ← کپچاپرس ← یکپارچه‌سازی‌ها بروید.
2. کلید فرم ورود را روشن کنید.
3. روی ذخیره‌ی تغییرات کلیک کنید.
4. صفحه‌ی ورود را در یک پنجره‌ی ناشناس باز کنید تا از نمایش کپچا مطمئن شوید.

۷. انتخاب و سفارشی‌سازی ۴ سبک کپچا

کپچاپرس شامل چهار سبک چالش تعاملی است. سبک پیش‌فرض را از تنظیمات ← کپچاپرس ← عمومی ← سبک فعال کپچا انتخاب کنید.

تنظیم رفتار (زبانه‌ی عمومی)

۸. تغییر آیکن ربات

آیکن داخل باکس «من ربات نیستم» را می‌توان به هر یک از ۱۸ آیکن ربات ارائه‌شده تغییر داد.

1. به تنظیمات ← کپچاپرس ← ظاهر بروید.
2. فیلد آیکن ربات را پیدا کنید — همه‌ی آیکن‌ها به‌صورت یک شبکه‌ی قابل‌کلیک نمایش داده می‌شوند.
3. روی آیکن دلخواه کلیک کنید. کاشی انتخاب‌شده با یک حاشیه‌ی آبی مشخص می‌شود.
4. روی ذخیره‌ی تغییرات کلیک کنید.

۹. حالت روشن / تیره

کپچاپرس می‌تواند ابزارک خود را با طرح رنگی روشن یا تیره نمایش دهد.

1. به تنظیمات ← کپچاپرس ← ظاهر بروید.
2. کشویی حالت رنگ را روی یکی از موارد زیر بگذارید:

• ◆روشن — همیشه از طرح روشن استفاده کن.
• ◆تیره — همیشه از طرح تیره استفاده کن.
• ◆خودکار (بر اساس دستگاه) — با تنظیم حالت تیره‌ی سیستم‌عامل هماهنگ شو.

۱۰. فونت‌ها و نحوه‌ی غیرفعال‌سازی آن‌ها

کپچاپرس شش فونت وب فارسی را همراه دارد: وزیرمتن، دانا، ایران‌سنس، یکان بخ، یکان و پرستو.

1. به تنظیمات ← کپچاپرس ← ظاهر بروید.
2. از کشویی فونت یک قلم انتخاب کنید.
3. با تیک‌های بارگذاری فونت در تعیین کنید فونت کجا اعمال شود.
4. روی ذخیره‌ی تغییرات کلیک کنید.

نحوه‌ی غیرفعال‌سازی فونت‌های داخلی

• ◆راه ۱ (پیشنهادی): در کشویی فونت، گزینه‌ی «هیچ‌کدام (استفاده از پیش‌فرض قالب)» را انتخاب کنید.
• ◆راه ۲: یک فونت را انتخاب‌شده باقی بگذارید اما هر دو تیک «صفحات سمت کاربر» و «صفحات ورود» را بردارید.

۱۱. استفاده از کد کوتاه

برای فرم‌های سفارشی (هر فرمی که تحت پوشش یکپارچه‌سازی‌های داخلی نیست)، کپچا را با یک کد کوتاه اضافه کنید.

استفاده‌ی پایه — داخل تگ <form> قرار دهید:

[captchapress]

انتخاب یک سبک مشخص با ویژگی style:

[captchapress style="slider"]
[captchapress style="puzzle"]
[captchapress style="shapes"]
[captchapress style="text"]

نام مستعار — برای سازگاری با نسخه‌های پیشین:

[custom_recaptcha style="shapes"]

۱۲. مرجع کامل ویژگی‌های کد کوتاه

کد کوتاه از یک ویژگی پشتیبانی می‌کند:

[captchapress]                     ← از سبک پیش‌فرض زبانه‌ی عمومی استفاده می‌کند
[captchapress style="puzzle"]      ← اینجا سبک پازل را اجبار می‌کند
[captchapress style="text"]        ← اینجا سبک متنی کلاسیک را اجبار می‌کند
[custom_recaptcha style="shapes"]  ← تگ مستعار، سبک اشکال

۱۳. اعتبارسنجی یک فرم سفارشی

وقتی از کد کوتاه روی یک فرم دست‌ساز استفاده می‌کنید، باید هنگام ارسال فرم، کپچا را در سمت سرور اعتبارسنجی کنید:

$result = \CaptchaPress\Controllers\CaptchaController::verify_request( wp_unslash( $_POST ) );

if ( is_wp_error( $result ) ) {
    // کپچا ناموفق بود — ارسال را رد کنید و $result->get_error_message() را نمایش دهید.
} else {
    // موفق بود — پردازش فرم را ادامه دهید.
}

محافظت خودکار با فیلتر

یا با فیلتر زیر، اجبارِ اعتبارسنجی را برای ارسال فرم خود فعال کنید:

add_filter( 'captchapress_require_captcha', function ( $require ) {
    if ( isset( $_POST['my_custom_form_action'] ) ) {
        return true; // اکنون ارسال بدون توکن به این فرم مسدود می‌شود
    }
    return $require;
} );

۱۴. عیب‌یابی و پرسش‌های متداول

کپچاپرس — پیاده سازی شده توسط WPDAK.ir