Skip to main content

Geofence System

This module allows you to create, edit, delete, and view geofences. Define circular virtual boundaries around physical locations using GPS coordinates and a radius to validate employee attendance from the mobile app.

Features​

  • Geofence Group Management - Create and manage groups of geofence locations
  • Circular Geofence Locations - Define locations with latitude, longitude, and radius
  • Location Validation API - Mobile app validates employee GPS location against configured geofences
  • Status Management - Activate or deactivate geofence groups and individual locations

Requirements​

  • Open Core Business Suite (Base System)
  • GPS-enabled mobile devices
  • Mobile app with location permissions

Installation​

Enable via Admin Panel​

  1. Log in as administrator
  2. Navigate to Settings > Addons
  3. Find Geofence System and click Enable
  4. Run migrations if prompted

Enable via Command Line​

php artisan module:enable GeofenceSystem
php artisan migrate

Usage​

Creating Geofence Groups​

  1. Navigate to Attendance Management > Geofence Groups
  2. Click to add a new geofence group
  3. Enter group details:
    • Name
    • Code (unique identifier)
    • Description (optional)
  4. Save the group

Adding Geofence Locations to a Group​

  1. Navigate to Attendance Management > Geofence Groups
  2. Click on a group to view its details
  3. Add geofence locations with:
    • Name
    • Description (optional)
    • Latitude
    • Longitude
    • Radius (defines the circular boundary in meters)
    • Enabled/disabled status
  4. Save the location

Managing Geofence Groups​

  • View - See all geofence groups with their location counts
  • Edit - Modify group name, code, and description
  • Toggle Status - Activate or deactivate groups
  • Delete - Remove groups (only if they contain no locations)

Managing Geofence Locations​

  • Enable/Disable - Toggle individual locations within a group
  • Edit - Update location coordinates, radius, and details
  • Delete - Remove individual locations from a group

Linking to Sites​

Geofence groups are assigned to sites through the Site Attendance module:

  1. Go to Attendance Management > Sites
  2. View a site and enable attendance
  3. Select Geofence as the attendance type
  4. Choose the appropriate geofence group

Attendance Validation​

When employees record attendance via the mobile app:

  1. The app captures the employee's GPS location
  2. The location is sent to the server for validation
  3. The server checks if the location falls within any geofence in the assigned group
  4. Attendance is validated or rejected based on the result

Changelog: View version history

Last updated on