HandyCafe Docs
owner it-admin

Settings Overview

The Settings page is the central configuration hub for your HandyCafe server. All operational parameters for your internet cafe or gaming center are managed here, including pricing, network configuration, client appearance, and authentication.

Accessing Settings

Open the Settings page from the main navigation sidebar. The page displays a category list on the left and the active category's configuration panel on the right.

Settings Categories

There are nine categories available in the settings sidebar:

Category Description
General Country, language, font, currency, and calendar preferences
Pricing Hourly rates, fees, VAT, rounding, and session presets
Pricing Schedule Time-based pricing multipliers with a visual weekly grid
Network TCP, UDP, and file transfer port configuration plus connection key
Management Customize the management action menu items and layout
Sounds Notification sounds for cashier calls, orders, and session events
Clients Client device settings with four sub-tabs: General, Content/Menu, Appearance, and Idle Screen
OAuth OAuth provider configuration for device-flow member login
Sync Explorer File synchronization to push updates and files to client PCs

Saving and Canceling Changes

Global Save and Cancel buttons are displayed at the bottom of every settings panel.

  • Change detection -- The Save button is only enabled when you have made modifications to the current category. If no changes are detected, the button remains disabled.
  • Cancel -- Reverts all unsaved changes in the current category back to the last saved state.
  • Validation feedback -- If any field contains an invalid value (for example, a port number outside the allowed range), the Save button is disabled and the problematic field is highlighted with an error message.
  • Notification on save -- After a successful save, a confirmation notification appears briefly at the top of the panel. If the save fails (for example, due to a database write error), an error notification is shown instead.

Tips

  • Changes to network settings (ports and connection key) require a server restart and corresponding updates on every client device.
  • Pricing and schedule changes take effect for new sessions immediately; active sessions continue under the pricing terms that were in place when they started, with new pricing segments created at schedule slot boundaries.
  • Client appearance and menu changes are pushed to all connected clients in real time. No manual sync is required.