# Captive Portal
Portal settings, SMS/WhatsApp portal settings and portal language settings
# Portal Settings
The Captive Portal is the login screen your guests see before they connect to Wi-Fi. On this page you manage its **appearance**, **which details are required to log in**, the **legal texts**, and the **advertisement slots**.
> **How do I open this screen?** From the left menu, go to **Captive Portal → Portal Settings**.
>
> **Note:** the panel interface is only partly translated. Where a control still appears in Turkish on screen, the Turkish label is given in brackets so you can find it.
The page has three tabs: **General Settings**, **Theme Settings** and **Advertisements**. The **Preview** on the right reflects every change instantly — you see the result without saving.
---
## 1. General Settings
This tab defines the basic behaviour of the portal.
- **Portal Title:** the text shown at the top of the welcome screen — usually your business name.
- **Exit page** (on screen: *Çıkış sayfası*)**:** when *on*, the guest sees the exit page after logging in (your menu, your social media links). When *off*, they are redirected straight to the web address you enter in the **Page Redirect** field that appears underneath.
- **Page Redirect** (on screen: *Sayfa Yönlendirme*)**:** only visible while "Exit page" is off. Enter the address to open after login (for example your corporate website).
- **Terms of Use:** the usage text the guest must accept at login. **Legally required — cannot be switched off.**
- **Hide User Login** (on screen: *Kullanıcı Girişi Gizle*)**:** turn on for special scenarios where the login form should be hidden on the portal.
- **KVKK (data protection):** the personal-data disclosure/consent text. **Legally required — cannot be switched off.**
- **Terminate the session when the page is closed:** turn on if you want the guest's session to end when they close the portal page.
- **Default Language:** the language the portal opens in. The list comes from the **Portal Language Settings** page (Azerbaijan, Bulgaria, China, France, Georgia, Greece, Israel, Italy, Kazakhstan, Netherlands, Poland, Romania, Serbia, South Korea, Spain, Turkey).
### Social Media Links
Enter the addresses of your Facebook, Twitter, Pinterest, Instagram and YouTube pages. These icons appear on the welcome screen so guests can reach you in one tap. **Any field you leave empty hides its icon.**
- **Show Instagram card after login:** after the guest completes Wi-Fi login, the exit page shows a prominent card linking to the Instagram address above, plus an "I liked it" confirmation. *The like cannot be verified technically; it is reported as the guest's own statement.*
### Wi-Fi Connection (for QR)
Enter your network details so guests can join in a single tap from a QR code.
- **Wi-Fi name (SSID)** (on screen: *WiFi adı (SSID)*)**:** the name of your guest network.
- **Wi-Fi password** (on screen: *WiFi şifresi*)**:** your network password. Leave empty for open networks.
- **Embed Wi-Fi in QR codes** (on screen: *QR kodlarına WiFi'yi göm*)**:** when enabled, scanning a menu or hotel QR code connects the device to the Wi-Fi network automatically.
Confirm your changes with **Save**.
---
## 2. Theme Settings
This tab is where you set the visual identity of the portal.
- **Logo Selection:** upload your logo with *Choose file*. Use **Logo Size** to adjust how large it appears on screen.
- **Background Selection:** upload the portal background image. It may be cropped on mobile screens, so choose an image whose key elements sit in the centre.
- **Colour Settings:** six separate colours are defined — **Login Box Colour**, **Button Hover Colour**, **Button Colour**, **Button Text Colour**, **Link Colour** and **Text Colour**. Each is set with a colour picker.
- **Reset Colours:** returns every colour to its default value.
- **Footer text:** free text shown at the bottom of the portal, written in the rich-text editor.
> **Tip:** the **Captive Portal Preview** panel on the right updates instantly, so you can try colours out without saving.
---
## 3. Advertisements
This tab manages the advertisement and announcement content shown on the welcome screen. The list has **Title** and **Status** columns.
Use the **+ Advertisements** button to add a new record:
- **Title:** the name of the advert (used to identify it in the admin view).
- **Type:** *Before login* or *After login* — determines at which stage the guest sees the advert.
- **Duration:** how many seconds the advert stays on screen.
- **Content:** the rich-text editor lets you add images, text and links.
Use the **Status** column to switch an advert off without deleting it.
---
> **Related pages:** see **Portal Language Settings** for which languages appear on the portal, **SMS Portal Settings** for SMS registration, and **WhatsApp Portal Settings** for WhatsApp registration.
# SMS Portal Settings
The SMS Portal Settings screen is used to **switch registration by mobile phone number on or off** on the welcome screen. The guest enters their number, is verified by the confirmation SMS, and gets internet access.
> **How do I open this screen?** From the left menu, go to **Captive Portal → SMS Portal Settings**.
**In practice this screen does one job: turning the module on or off.** The welcome screen's title, appearance, the details requested and the legal texts are all managed on **Captive Portal → Portal Settings**. The detailed fields on this page are no longer used.
---
## SMS Module
The **SMS Module** switch sits at the top of the page. While the module is off, the screen shows only this warning:
> *"Warning! SMS module is currently turned off. If you want your system to accept registration via SMS, you must activate the module."*
- **Switch off:** the guest does not see the SMS login option on the welcome screen.
- **Switch on:** the SMS registration flow becomes available.
**Turning the module on is not enough on its own:** for the guest to receive a verification code, your provider details, the message text and the group the guest is added to must be configured under **Settings → SMS Settings**. If the module is on but the SMS settings are missing, the guest never gets a code and cannot log in.
---
## How do I test the result?
After saving, open the welcome screen as the guest sees it. Connect a device to your test network's portal address (for example `http://192.168.2.1:8090/`) and confirm the login options appear as expected.
---
> **Related pages:** **Captive Portal → Portal Settings** (appearance and login fields), **Settings → SMS Settings** (provider and message), **Guests → SMS / WhatsApp Users**, **Analytics and Reports → SMS / WhatsApp Reports**.
# WhatsApp Portal Settings
The WhatsApp Portal screen is used to **switch WhatsApp login on or off** on the welcome screen. The guest taps "Log in with WhatsApp", sends the message in the chat that opens, and is logged in automatically once delivery is confirmed. Because it uses no SMS credit, it is the preferred option at busy locations.
> **How do I open this screen?** From the left menu, go to **Captive Portal → WhatsApp Portal**.
**In practice this screen does one job: turning the module on or off.** The welcome screen's title, appearance, the details requested and the legal texts are all managed on **Captive Portal → Portal Settings**. The detailed fields on this page are no longer used.
---
## WhatsApp login module
The **WhatsApp login module** switch sits at the top of the page. While the module is off, the screen shows only this warning:
> *"Warning! Whatsapp module is currently turned off. If you want your system to accept registration with Whatsapp, you must activate the module."*
- **Switch off:** the guest does not see the WhatsApp login option on the welcome screen.
- **Switch on:** the WhatsApp registration flow becomes available.
**Critical — firewall permissions:** for the WhatsApp flow to work while the guest is still behind the captive portal, your firewall (walled garden) **must allow** `*.wa.me`, `*.whatsapp.com`, `*.whatsapp.net`, `g.whatsapp.net`, `mmg.whatsapp.net`, `fbsbx.com` and `*.useroam.com`. Without these rules the WhatsApp login screen will not open even with the module enabled. See the page for your device under **Installation Guides**.
The message text, the group the guest is added to and the service configuration are set on **Settings → WhatsApp Settings**.
---
## How do I test the result?
After saving, open the welcome screen as the guest sees it. Connect a device to your test network's portal address (for example `http://192.168.2.1:8090/`) and confirm the WhatsApp login button appears and the chat opens.
---
> **Related pages:** **Captive Portal → Portal Settings**, **Settings → WhatsApp Settings**, **Guests → SMS / WhatsApp Users**, **Installation Guides**.
# Portal Language Settings
Portal Language Settings show which languages the welcome screen is offered in. When a guest switches language on the portal, they choose from the languages defined in this list.
> **How do I open this screen?** From the left menu, go to **Captive Portal → Portal Language Settings**.
---
## Language list
The page contains a single table with three columns:
- **LANGUAGE:** the name of the language (for example Turkey, France, Netherlands).
- **CODE:** the two-letter country/language code (for example `TR`, `FR`, `NL`).
- **PHONE CODE:** that country's international dialling prefix (for example `+90`, `+33`, `+31`). This prefix list is used in the SMS and WhatsApp registration flows when the guest enters their number.
**16 languages** are defined in the system: Azerbaijan (AZ, +994), Bulgaria (BG, +359), China (CN, +86), France (FR, +33), Georgia (GE, +995), Greece (GR, +30), Israel (IL, +972), Italy (IT, +39), Kazakhstan (KZ, +7), Netherlands (NL, +31), Poland (PL), Romania (RO), Serbia (RS), South Korea (KR), Spain (ES) and Turkey (TR).
### Navigating the list
- The **10 / 25 / 50 / 100 / All** selector at the top left sets how many records appear per page. The default is 10, so the list is split across two pages.
- The **search box** at the top right filters instantly on language name, code or phone code.
- Use the **← 1 2 →** links below the table to move between pages; the record count is shown on the left as "Total: 16 / 1 - 10".
---
> **Which language does the portal open in?** The startup language is not set here but under **Portal Settings → General Settings → Default Language**. The list on this page determines the options available in that field.