Wi-Fi Setup
Most cafes already have Wi-Fi and give the internet on it away. The gateway turns it into something you control, and internet access you can charge for. This page is the network side: getting the Wi-Fi onto the gateway and deciding who gets through. The selling side, access packages and codes and the till, is Wi-Fi Vouchers.
What you need
- An access point. Any normal one. The Wi-Fi built into a router works too, as long as that router can be put into access point mode so it stops handing out addresses of its own.
- A cable from it to a network card on the gateway. The portal works per card. When the access point has a card of its own, the portal only touches the devices on the Wi-Fi. When it hangs off the cafe switch, it shares a card with the stations. See Portal LAN card.
Two devices handing out addresses on one network is the mistake that costs an afternoon. If the Wi-Fi box was the cafe's router before the gateway arrived, turn its DHCP off.
The guest network
Guest Wi-Fi is a network of its own. A phone in the corner is not sitting on the same network as the till and the stations.
- SSID. The name guests see.
- VLAN. The tag that keeps guest traffic apart from the cafe's own. Set the same tag on the access point and on the gateway. Then the two agree on what is guest traffic and what is not.
An access point that cannot do VLANs still works. You lose the separation, not the portal.
The portal
With the portal on, a phone joining the Wi-Fi gets a page asking for a code or a member sign-in before it reaches the internet. With it off, the Wi-Fi is open and anyone in range is on it.
Turning it on is the Portal switch on the Guest Wi-Fi tab of the Wi-Fi page. That tab needs access to the Gateway. The switch stays locked until a Portal LAN card is chosen. Next to it the page reads Choose the LAN card to turn on the portal. Turning the portal off is always possible. The Server asks you to confirm, because from that moment every device on that card that is not a HandyCafe client needs a code or an account.
The portal answers on a port of its own, set in Portal port. Ports 80 and 443 cannot be used. There is rarely a reason to change the one it comes with.
Portal LAN card
Portal LAN card is the gateway's network card the Wi-Fi access point is plugged into. The portal applies only to devices on this card. Devices on the gateway's other cards, such as the cafe PCs on their own LAN, never see the portal. Set the router to access point (AP) mode.
The list offers every card on the gateway except its Internet lines. A cafe can wire several LANs and only you know which one has the Wi-Fi. Virtual adapters are left out unless one is the LAN. The info button next to the label repeats this in short.
Under the list the page warns you when something is off:
| Message | What it means |
|---|---|
| The portal is on but no LAN card is chosen | The portal was turned on before this setting existed. It applies to every device. Choose the card to limit it. |
| The Wi-Fi card has no link | The cable or the access point is down. The portal stays on and keeps its card. It starts working again once the link is back. |
| The chosen card is no longer on the gateway | The card was removed or replaced. It shows as Adapter not found in the list. Choose the card the access point is plugged into. |
The link status is read again every 15 seconds while a card is chosen.
What a guest sees
- They join the Wi-Fi, the same as anywhere else.
- The portal page opens on its own, the way a hotel's does.
- They type the code from the counter, or sign in as a member.
- They are online for as long as the code or their account allows.
A member signs in with their own HandyCafe account. They do not need a code. They need a Wi-Fi package sold onto their account instead. See Selling to a member.
Codes
Codes are created and sold on the Wi-Fi Vouchers page. A code works on the portal only after it is sold. What matters here is the shape:
Every code is 2 to 6 letters followed by six digits, printed as
ABC-123456. Three letters is the default. More letters make a code
harder to guess and longer to read out over a counter. Change it with
Coupon code shape on the Guest Wi-Fi tab when the cafe is busy
enough to care. Codes already printed keep working either way.
The same tab holds Network name on receipt, the Wi-Fi name printed on each voucher slip.
Keeping the guest side from taking the cafe down
The guest Wi-Fi is the part of the network you have least control over: it is other people's phones, syncing whatever they sync. Two settings keep it from costing your paying customers anything:
- A speed cap on the guest group. See Devices and speed.
- A shared ceiling for the guest network as a whole. Twenty phones together cannot take more than you decided.
Firewall rules, the block list and the Web Filter categories apply to Wi-Fi guests the same as to every other device. Choosing a Portal LAN card does not change that.
When the portal is off
The Wi-Fi page says so plainly: guests are not asked for a code. That is a fine way to run a cafe that gives Wi-Fi away with a coffee. It is worth knowing rather than discovering. Devices still show up in the device list and still obey their speed limits.