R Rafina Panel guide
Guides / Settings / Captcha

Captcha

Captcha asks for “I'm not a robot” verification before the forms bots go after: SMS code request, login, sign-up, comment and other forms. You choose the service; ARCaptcha and ALTCHA also work on Iranian hosts.

Where is it? Rafina Panel → Settings → Captcha

Captcha tab overview
The “Captcha” tab.

Setup

  1. In the “Captcha service” card, choose one of the five services.
  2. With the service's “Sign up and get key” link, add the site domain and get the “Site key” and “Secret key” (ALTCHA needs no sign-up or key).
  3. Paste the two keys in the keys card and turn on the “Captcha is on” switch.
  4. In “Where to display”, tick the forms.
  5. In the “Preview” card look at the box and tick it once; then “Save settings”.
NoteUntil the selected service's keys are entered, no form asks for captcha; so turning it on before getting keys blocks nothing. With captcha off, no request goes to the captcha service either.

Captcha is on

The section's main switch (default off). Beside it is the sign-up and get key link of the selected service so it is available before turning on.

Captcha service

Captcha service card with five services and each one's sign-up and guide link
Five services; each has its own keys and changing service doesn't delete the other keys.
ServiceWhen it fits
ARCaptchaIranian service; reachable from servers inside the country. Default.
ALTCHAOpen source and on the site itself; it connects to no external service and needs no sign-up — the theme creates the key itself. The most hassle-free option on an Iranian host.
Google reCAPTCHAThe site server must be able to reach Google for verification, and many Iranian hosts don't have that access.
hCaptchaA Google-independent alternative; the site server must be able to reach api.hcaptcha.com .
Cloudflare TurnstileMost of the time it shows the user no puzzle; the site server must be able to reach challenges.cloudflare.com .

Keys

Site key and secret key card of the selected service
The keys card of the selected service (here Cloudflare Turnstile).
OptionWhat it does
Site KeyFrom that service's panel. It appears in the page and is not a secret.
Secret KeyStays only on the server and is sent to that service to verify the user's response. Not shown after saving; to change it, type the new key.
Test keysFor some services a test key is written that is always accepted; it is for trying only, and a real key must be set before the site goes live.

Google reCAPTCHA-only options

With reCAPTCHA chosen, these options also appear in the same card:

OptionWhat it doesDefault
reCAPTCHA version“Version 2, I'm not a robot box”, “Version 2, invisible” or “Version 3, boxless with score”. Each version's key is separate in Google's console.Version 2 with box
Minimum accepted scoreVersion 3 only: Google gives each request a score between 0 and 1, and anything below this number is rejected.0.5
Service addressrecaptcha.net The address of Google's own alternative, for places where google.com is blocked.recaptcha.net

For ALTCHA, instead of the keys card an “ALTCHA” card appears explaining that the user's browser solves a small math puzzle on the site itself.

Box appearance

Box appearance card with display type, theme and language
The “Box appearance” card.
OptionWhat it doesDefault
Display typeBox size; options depend on the service: “Normal (I'm not a robot box)”, “Form width”, “Compact” or “Invisible”. In invisible mode no box is seen and the challenge opens at button press only when the service is suspicious.Normal
Theme“Follow the site's light and dark mode”, “Light” or “Dark”.Follows day and night mode
Box languagePersian or English.Persian
Box colorOnly ARCaptcha accepts a color; leave empty to keep the service's own color.Empty
Show the box's error messageARCaptcha only: messages such as “Verification time expired” under the box itself.On

Where it is shown

Where to display card with three groups of forms and two final switches
Wherever ticked, the server also rejects the request without verification; so bypassing the form doesn't get past it either.
GroupPlaces
Login and user accountSending a one-time code (each code request costs one SMS; the most important place for captcha), login with password, sign-up (first step only), forgot password (recovery code request only).
Site formsArticle comment, product comment, product Q&A, contact us form, newsletter signup, coming-soon page signup, support ticket submission, order placement.
WordPress and WooCommerce formsAdmin login to the dashboard (wp-login.php and the custom login address), WordPress sign-up, WordPress password recovery, WooCommerce account login and sign-up (including shop seller sign-up).

On a fresh install every place is ticked except “Order placement” and “Support ticket submission”. Order placement is deliberately off: every pause on the checkout page means fewer orders.

OptionWhat it doesDefault
Guests onlyA logged-in user does not see the captcha on comments, contact, newsletter and orders. Login and sign-up forms always require the captcha. Tickets are for logged-in users only, so this switch has no effect on “Support ticket submission”.On
If the captcha service is unreachable, let the form workWhen on, a service outage does not shut the store and is only recorded in the server error log. An explicit “rejected” answer always rejects. ALTCHA is verified on the site itself and has no outages.On

Preview

Captcha box preview card
The box with the site key and the settings above, as it appears on the forms.

Tick the normal box like a visitor would. For hidden modes (the “Invisible” display type, or reCAPTCHA version 2 invisible and version 3) where no box is visible, a “Try verification” button appears that solves the box once and reports the result. If the message “The captcha service script did not load” appears, your browser cannot reach that service.

FAQ and troubleshooting

After turning on captcha I can't log in to the dashboard.

If “Admin login to the dashboard” is ticked and the secret key is wrong, the service answers “rejected” and “Let the form work” doesn't help. Temporarily deactivate the theme via FTP or delete the option rafina_captcha from the database; then set the correct key. Before ticking dashboard login, try the captcha on the other forms.

A red “Test only” text appears under the Turnstile box.

This is Cloudflare's own warning for a test key and doesn't appear with a real key.

Google or hCaptcha always gives an error.

Your server can't reach that service; choose ARCaptcha or ALTCHA.