Getting Started

Connecting the iOS App

The iOS app connects to your WordPress site over the internet using the MBS Attendance REST API. Setup takes about two minutes.

Step 1 — Enter your site URL

When you open the app for the first time you will see the setup screen. Enter your WordPress site URL exactly as it appears in a browser — including https://. For example:

https://greengracefarmstall.com

Do not include a trailing slash or any path after the domain. The app appends /wp-json/mbs-attendance/v1 automatically to reach the API.

⚠️
Use the public URL

Enter the URL that works from outside your local network. Local addresses like 192.168.1.x will only work when the phone is on the same Wi-Fi network as the server. For reliable remote site use, always use the public domain name.

Step 2 — Sign in

After the app verifies it can reach your site, you will see the sign in screen. Enter your WordPress username and password — the same credentials you use to log into the WordPress dashboard. The account must be a WordPress administrator or have an MBS Attendance role assigned.

The app stores an authentication token securely. You will not need to sign in again unless you sign out manually or the token expires.

Step 3 — App settings

After signing in, go to the Settings tab in the app. You will see:

  • Site URL — shown for reference. Tap to change if you move to a new server.
  • License key — enter your license key here if not already entered on the WordPress side. Shows masked after saving.
  • Offline queue — shows how many clock events are waiting to sync. Should be 0 when connected.
  • Refresh All Data — force a full sync of employees, departments and settings.

Step 4 — Test the connection

Go to the Clock In tab. You should see your list of employees. If the list is empty, tap the refresh button at the top right. If employees still don't appear, check:

  • Are there active employees in the WordPress dashboard?
  • Is the site URL correct in Settings?
  • Is the WordPress site reachable from the phone's internet connection (not just Wi-Fi)?
  • Are there any errors in the Xcode console if running a development build?
Multiple devices

You can install the app on as many iPhones and iPads as you need. Each supervisor signs in with their own WordPress credentials. All devices sync to the same central database on your WordPress server.