Skip to main content

Location Management

Multi-location management addon for transforming single-location setups into multi-location capable systems.

Features​

  • Location Management: Create and manage business locations with address, contact details, coordinates, and geofence radius
  • Location Types: Define location types (e.g., headquarters, branch, warehouse) with custom ordering
  • Location Assignments: Assign employees to locations with permanent, temporary, or visiting assignment types
  • Location Hierarchy: Organize locations in parent-child relationships with a visual hierarchy view

Requirements​

  • Open Core Business Suite (Base System)

Installation​

Enable via Admin Panel​

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

Enable via Command Line​

php artisan module:enable LocationManagement
php artisan migrate

Usage​

Managing Locations​

Navigate to Location Management > Locations to manage locations:

  • Create locations with name, code, location type, and optional parent location
  • Set address details (address, city, state, country, postal code)
  • Add contact information (phone, email)
  • Configure timezone and currency
  • Set map coordinates (latitude/longitude) and geofence radius
  • Mark a location as headquarters
  • Toggle location active/inactive status
  • View hierarchy with breadcrumb navigation

Location Types​

Navigate to Location Management > Location Types to define types:

  • Create location types with name, code, and description
  • Configure level restrictions for hierarchy control
  • Reorder types via drag-and-drop
  • Toggle type active/inactive status

Location Assignments​

Navigate to Location Management > Assignments to manage employee-location assignments:

  • Assign employees to locations with assignment type (permanent, temporary, visiting)
  • Set effective date range (from/to)
  • Set a primary location for each employee
  • Bulk assign multiple employees to a location at once
  • Transfer employees between locations with a reason
  • View assignment history for any employee
  • Remove employee assignments

Changelog: View version history

Last updated on