Skip to content
Farin Theme Guide
GuidesTools

International internet

On Iranian hosts, when the international internet is cut or very slow, WordPress and plugins wait several seconds on foreign servers for every request. The dashboard becomes slow, and sometimes the site pages too. Outage mode drops these requests at once so the site does not wait.

Where is it? Farin → Settings → International internet

Payment gateways, SMS panels and other Iranian services work as usual in this mode. With the default setting, “Automatic”, you do not need to do anything: the site detects the outage itself and returns to normal when the internet comes back.

Status

Foreign internet status card with the last check time and the number of held requests
The status card tells you whether the foreign internet is connected from your server right now.
RowWhat it means
Card heading“Foreign internet is connected”: nothing is blocked. “Foreign internet is down; outage mode turned on”: the site does not wait for foreign servers. “Outage mode is on (manual)”: the mode is set to “Always on”. “Off”: this feature does nothing.
Last checkWhen it was measured and how many seconds the foreign server took to respond.
Down sinceSince when it has been down. If “connected but very slow” appears beside it, the internet was not fully down but was slow enough to count as an outage.
Held so farHow many foreign requests or files have been set aside in outage mode.

The “Check now” button measures the foreign internet right now, without waiting for the next check.

Outage mode

The box for when the foreign internet goes down, with the three options Automatic, Always on and Off
“Automatic” suits most hosts.
OptionWhat it does
Automatic (recommended)Every five minutes the site tests two foreign addresses. If neither answers, or the answer takes more than four seconds, outage mode turns on. When the internet comes back, it turns off at the next check. If a request from the site to a foreign server fails, the check runs in the background at once and there is no need to wait five minutes.
Always onFor a host that never has access to the outside. Nothing is measured and outage mode is always in effect.
OffThe site connects everywhere as usual and measures nothing.

Always reachable

These work as usual even in outage mode:

  • The site itself and any address on a “.ir” domain.
  • Payment gateways, SMS panels, national ID lookup and Iranian captcha that Farin works with, even if their domain is not “.ir” (such as Zarinpal and Kavenegar). The full list opens with “See Iranian domains without .ir”.
  • Rtl-Theme and Jacket, for licensing and updates, and several Iranian hosts and CDNs.
OptionWhat it doesDefault
Other domains that must stay reachableOne domain per line, such as api.example.com. Subdomains count too. If a plugin has an Iranian service whose domain is not “.ir”, write it here.Empty
Maximum wait for an allowed foreign domainIf you have allowed a foreign domain, in outage mode it does not wait for it longer than this many seconds.5 seconds

Site pages

OptionWhat it doesDefault
Remove foreign servers' scripts and styles from the pageFiles that plugins load from a foreign server (such as a CDN) are not put in the page in outage mode. A visitor inside Iran could not fetch them anyway, and the page would wait for them. Farin's own files are always on your site.On
Replace the Gravatar profile picture with a simple local imageThe profile pictures of comments and users come from Gravatar, which does not open in an outage. A simple image from the site itself is shown instead.On
Captcha is replaced automaticallyIf the site's captcha is Google reCAPTCHA, hCaptcha or Cloudflare Turnstile, in outage mode it neither opens for the visitor nor can the server verify its answer. So the login and sign-up forms stay blocked. At that time Farin shows ALTCHA itself, which works on the site itself. Your choice in the Captcha section is not changed, and when the internet comes back, the previous service returns.

What was held

List of held domains with the count and an Allow button beside each
Each domain with the number of server requests or page files that were set aside.

Domains that were set aside in outage mode, newest at the top. If one is needed for the site to work, for example an Iranian service whose domain is not “.ir”, click “Allow” to add it to the allowed list. “Clear report” empties the list.

Frequently Asked Questions

Is it different from a plugin like Ghatino?

The main job is the same, but here it is built into Farin: Farin's gateways and SMS panels are already allowed, it detects the outage itself, and it replaces the captcha too. If you have another plugin installed for the same purpose, keep only one.

What happens to WordPress and plugin updates?

In outage mode, update checks to foreign servers are not made, since no answer would come anyway. When the internet comes back, they run as usual. Updates from Rtl-Theme and Jacket work even in outage mode.

Does anything change if the internet is connected?

No. In “Automatic”, as long as the foreign internet is connected, no request or file is blocked. Only one small background check runs every five minutes.

Farin Theme · 1405