Skip to main content

Digital ID Card

This module is used to generate digital ID cards for employees.

Features

  • ID Card Templates: Customizable templates for different card designs
  • QR Code on ID: Generated QR codes for quick employee verification
  • Digital ID Generation: Create digital ID cards accessible on mobile devices
  • ID Card Printing: Print physical ID cards with professional layouts

Requirements

  • Open Core Business Suite (Base System)
  • No additional module dependencies

Installation

  1. Purchase and download the Digital ID Card module
  2. Extract the module files to Modules/DigitalIdCard
  3. Run the installation command:
php artisan module:enable DigitalIdCard
php artisan migrate
  1. Clear the application cache:
php artisan optimize:clear

Configuration

Navigate to Settings > Modules > Digital ID Card to configure:

  • Company Information: Logo, name, address for card display
  • Template Settings: Default template and design options
  • QR Code Settings: Configure QR code content and format
  • Print Settings: Card size and printer configuration

Usage

Creating ID Card Templates

  1. Navigate to ID Cards > Templates
  2. Click Create Template button
  3. Design your card layout with the visual editor
  4. Configure front and back of the card
  5. Save the template

Template Elements

Available elements for card design:

ElementDescription
Company LogoYour organization's logo
Employee PhotoEmployee's profile picture
Employee NameFull name of employee
Employee IDUnique employee identifier
DepartmentDepartment name
DesignationJob title
Join DateEmployment start date
Blood GroupBlood type information
Emergency ContactEmergency contact number
QR CodeScannable verification code
BarcodeLinear barcode option
Custom FieldsAny custom employee fields

QR Code Configuration

The QR code can contain:

  • Employee ID: Quick lookup reference
  • Verification URL: Link to online verification page
  • vCard Data: Contact information for easy saving
  • Custom Data: Any custom JSON payload

Generating ID Cards

Generate ID cards for employees:

  1. Go to ID Cards > Generate
  2. Select employees (individual or bulk)
  3. Choose the template
  4. Click Generate
  5. Preview and download/print

Digital ID Access

Employees can access their digital ID:

  1. Open the mobile app
  2. Navigate to My Profile > Digital ID
  3. View the digital ID card
  4. Show QR code for verification

Verification System

Verify employee IDs by scanning:

  1. Open the verification scanner
  2. Scan the QR code on the ID card
  3. View employee details and verify identity
  4. Check employment status (active/inactive)

Printing ID Cards

Print physical ID cards:

  1. Generate ID cards as described above
  2. Click Print button
  3. Select printer and card stock settings
  4. Print to compatible ID card printer

Supported Print Formats

  • Standard CR80: Credit card size (3.375" x 2.125")
  • CR79: Adhesive back cards
  • Custom Sizes: Configure custom dimensions

API Endpoints

The module provides API endpoints for mobile and external integrations:

  • GET /api/V1/id-card - Get current user's digital ID
  • GET /api/V1/id-card/verify/{code} - Verify ID by QR code
  • GET /api/V1/id-cards - List all ID cards (admin)
  • POST /api/V1/id-cards/generate - Generate ID cards (admin)
  • GET /api/V1/id-cards/templates - List templates

Permissions

The module includes the following permissions:

PermissionDescription
id_cards.viewView own digital ID
id_cards.view_allView all employee ID cards
id_cards.generateGenerate ID cards
id_cards.printPrint ID cards
id_cards.manage_templatesCreate and edit templates
id_cards.verifyVerify ID cards via scanner

Security Features

  • Unique QR Codes: Each employee has a unique verification code
  • Expiration Dates: Optional expiration for periodic renewal
  • Tamper Detection: Verification validates against current data
  • Audit Logging: Track all ID card generations and verifications
  • Revocation: Instantly invalidate compromised cards

Use Cases

  • Access Control: Quick employee identification at entry points
  • Visitor Management: Verify employee identity for visitors
  • Event Check-in: Scan IDs for attendance at company events
  • Security: Visual and digital verification of personnel
  • Compliance: Meet regulatory requirements for employee identification

Best Practices

  • Include essential information only on the card front
  • Place emergency contact and additional details on the back
  • Use high-resolution company logo for professional appearance
  • Test print settings before bulk printing
  • Establish a card renewal cycle for security
  • Train security personnel on verification procedures