hr_lite 0.22.0 → 0.22.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6db8fc763b744461b7e4d52e484bc3a74a82fe95f9d35b51025d4eedb453e6c
-  data.tar.gz: 44a8caeed2447b02ffcf465befb0e965f101a79e5bb6d721cf138d53a1063f63
+  metadata.gz: b224591c52bc41368791e59547fe81b69fe9765462b998f9e23ffc47ee286a27
+  data.tar.gz: 62300f5cad84aa9c3c710e533943ebb84c9775c20941f40fbbb80b6eeee2e2a8
 SHA512:
-  metadata.gz: 6190cb5ca0db661d5aeb3e3c1bd6d359c1a10c6a798c7f99e67b20f27e9890fe6caa130fbf08fb6c5b1727b7aadde38ccff63285a41d9a403555d6befdc821eb
-  data.tar.gz: 39faf582aebd8d31c427da5bc1aeb118e1e750ef12a731ef6336be72b1c58f40a45a4b443843371058fa2a2f04a50f176198237fcbd122234fa45e734088eeca
+  metadata.gz: ad4011c24f0534b96301e647c1e3c6a908036917f4640ec934acd543787464554dbadaf94ce20724f7f8826c48dd81b89c2c450addf63ebf3750e8fcda070b5d
+  data.tar.gz: 564668224c10513104b7f5b05326a7c3a1c1e052e5f0ad4f045b19c23a50d9f6f4c2d67b387fb291bc4a45610eb6f0384d9b861a0a51556393603f56f5acabb5

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.22.1] - 2026-10-09
+
+### Added
+- Location help on the punch card: when a punch has no GPS, the card lists the steps to turn location on for the device in use (iPhone and iPad in Safari, Chrome, Firefox or Edge; Android in Chrome or Samsung Internet; desktop Chrome, Edge, Brave, Firefox or Safari, plus the macOS or Windows location switch). A web page cannot open device settings, so the steps say where to tap. New `.hrl-geo-help` list.
+
+### Changed
+- With `config.require_punch_location`, the punch form carries `data-hrl-geo-required` and the browser holds a timed-out or unavailable fix on the page, with the same steps, instead of submitting a punch the server refuses.
+
 ## [0.22.0] - 2026-10-09
 
 The HRMS UI/UX pass: Keka/greytHR patterns and a ui-ux-pro-max review of every screen, phone first. No migrations. Hosts that theme through `--hrl-*` variables keep their values; the engine defaults for radius, info background and muted text change (see Changed).

data/app/assets/javascripts/hr_lite/geo_punch.js

@@ -1,16 +1,64 @@
 // Dependency-free geolocation capture for punch forms.
 // Markup contract:
-//   <form data-hrl-geo-punch>
+//   <form data-hrl-geo-punch [data-hrl-geo-required]>
 //     <input type="hidden" name="lat"><input type="hidden" name="lng">
 //     <input type="hidden" name="accuracy_m"><input type="hidden" name="geo_status">
 //     <button type="submit">…</button>
 //     <p data-hrl-geo-status role="status" aria-live="polite"></p>  (not hidden, or the first message is missed)
 //   </form>
 // A denied permission holds the punch; timeout/unavailable submit anyway
-// with geo_status set; the server flags them.
+// with geo_status set (the server flags them) — unless the form is marked
+// data-hrl-geo-required, which holds those too. A held punch shows how to
+// turn location on for this device: no web page can open device settings.
 (function () {
   "use strict";
 
+  // Steps per device, matched on the user agent. iPadOS reports a Mac UA, so a
+  // touch-capable "Mac" counts as iOS.
+  function locationSteps() {
+    var ua = navigator.userAgent;
+    var ios = /iPhone|iPad|iPod/.test(ua) || (/Macintosh/.test(ua) && navigator.maxTouchPoints > 1);
+    if (ios) {
+      var app = /CriOS/.test(ua) ? "Chrome" : /FxiOS/.test(ua) ? "Firefox" : /EdgiOS/.test(ua) ? "Edge" : null;
+      return [
+        "Open Settings → Privacy & Security → Location Services and turn it on.",
+        app ? "In Settings, open Apps → " + app + " → Location and choose While Using the App."
+            : "In Settings, open Apps → Safari → Location and choose Allow (or Ask).",
+        "Come back here, reload the page and tap again."
+      ];
+    }
+    if (/Android/.test(ua)) {
+      var samsung = /SamsungBrowser/.test(ua);
+      return [
+        "Swipe down from the top of the screen and turn Location on.",
+        samsung ? "In Samsung Internet, tap ☰ → Settings → Sites and downloads → Site permissions → Location, and allow this site."
+                : "Tap the icon left of the web address → Permissions → Location → Allow. (Or ⋮ → Settings → Site settings → Location.)",
+        "Reload the page and tap again."
+      ];
+    }
+    var steps = [];
+    if (/Firefox/.test(ua)) steps.push("Click the icon left of the web address and remove the blocked Location permission.");
+    else if (/Safari/.test(ua) && !/Chrome|Chromium|Edg/.test(ua)) steps.push("Open Safari → Settings → Websites → Location and set this site to Allow.");
+    else steps.push("Click the icon left of the web address → Location → Allow.");
+    if (/Mac OS X|Macintosh/.test(ua)) steps.push("On the Mac, open System Settings → Privacy & Security → Location Services and turn it on for this browser.");
+    else if (/Windows/.test(ua)) steps.push("In Windows, open Settings → Privacy & security → Location and turn on location access.");
+    steps.push("Reload the page and tap again.");
+    return steps;
+  }
+
+  function showHelp(label, headline) {
+    if (!label) return;
+    label.textContent = headline;
+    var list = document.createElement("ol");
+    list.className = "hrl-geo-help";
+    locationSteps().forEach(function (step) {
+      var item = document.createElement("li");
+      item.textContent = step;
+      list.appendChild(item);
+    });
+    label.appendChild(list);
+  }
+
   function setup(form) {
     var fields = {
       lat: form.querySelector("[name=lat]"),
@@ -20,6 +68,7 @@
     };
     var button = form.querySelector("[type=submit]");
     var label = form.querySelector("[data-hrl-geo-status]");
+    var required = form.hasAttribute("data-hrl-geo-required");
     var locating = false;
 
     function send(status) {
@@ -28,6 +77,12 @@
       form.submit();
     }
 
+    function hold(headline) {
+      locating = false;
+      if (button) { button.disabled = false; button.removeAttribute("aria-busy"); }
+      showHelp(label, headline);
+    }
+
     form.addEventListener("submit", function (event) {
       if (locating || fields.status.value) return; // second pass: let it through
       event.preventDefault();
@@ -35,7 +90,11 @@
       if (button) { button.disabled = true; button.setAttribute("aria-busy", "true"); }
       if (label) { label.hidden = false; label.textContent = "Getting location…"; }
 
-      if (!navigator.geolocation) { send("unavailable"); return; }
+      if (!navigator.geolocation) {
+        if (required) hold("This browser cannot share your location. Open this page in Chrome or Safari.");
+        else send("unavailable");
+        return;
+      }
 
       navigator.geolocation.getCurrentPosition(
         function (pos) {
@@ -47,12 +106,8 @@
         function (err) {
           // Browsers ask only once; a past "Don't allow" denies silently forever.
           // Hold the punch so it is never filed (and flagged) without GPS.
-          if (err && err.code === 1) {
-            locating = false;
-            if (button) { button.disabled = false; button.removeAttribute("aria-busy"); }
-            if (label) label.textContent = "Location is blocked. Allow location for this site in your browser settings, then tap again.";
-            return;
-          }
+          if (err && err.code === 1) { hold("Location is blocked. To allow it:"); return; }
+          if (required) { hold("Couldn't get your location. Check that location is on:"); return; }
           send("timeout");
         },
         { enableHighAccuracy: true, timeout: 10000, maximumAge: 60000 }

data/app/assets/stylesheets/hr_lite/hr_lite.css

@@ -240,6 +240,8 @@ html:has(.hrl-body) { scroll-padding-top: 4rem; scroll-padding-bottom: calc(4.4r
 .hrl-listrow > :first-child { display: inline-flex; align-items: center; gap: var(--hrl-s-1); line-height: var(--hrl-lh-tight); }
 /* The punch status stays in the accessibility tree (no `hidden`) so its first message is announced; empty, it takes no space. */
 [data-hrl-geo-status]:empty { margin: 0; }
+.hrl-geo-help { margin: var(--hrl-s-2) 0 0; padding-left: var(--hrl-s-4); color: var(--hrl-ink); }
+.hrl-geo-help li + li { margin-top: var(--hrl-s-1); }
 .hrl-grid { display: grid; gap: .85rem; grid-template-columns: 1fr; margin-bottom: .85rem; }
 .hrl-grid > * { min-width: 0; }
 .hrl-grid > .hrl-card { margin-bottom: 0; }

data/app/views/hr_lite/attendance/_punch_card.html.erb

@@ -34,7 +34,7 @@
 
   <% if open_yesterday %>
     <%= form_with url: hr_lite.check_out_attendance_path, method: :post, local: true,
-                  html: { data: { "hrl-geo-punch": true } } do %>
+                  html: { data: { "hrl-geo-punch": true, "hrl-geo-required": HrLite.config.require_punch_location.presence } } do %>
       <input type="hidden" name="lat"><input type="hidden" name="lng">
       <input type="hidden" name="accuracy_m"><input type="hidden" name="geo_status">
       <button type="submit" class="hrl-btn hrl-btn--big hrl-btn--block">
@@ -44,7 +44,7 @@
     <% end %>
   <% elsif record&.check_in_at.blank? %>
     <%= form_with url: hr_lite.check_in_attendance_path, method: :post, local: true,
-                  html: { data: { "hrl-geo-punch": true } } do %>
+                  html: { data: { "hrl-geo-punch": true, "hrl-geo-required": HrLite.config.require_punch_location.presence } } do %>
       <input type="hidden" name="lat"><input type="hidden" name="lng">
       <input type="hidden" name="accuracy_m"><input type="hidden" name="geo_status">
       <button type="submit" class="hrl-btn hrl-btn--primary hrl-btn--big hrl-btn--block">Check in</button>
@@ -52,7 +52,7 @@
     <% end %>
   <% else %>
     <%= form_with url: hr_lite.check_out_attendance_path, method: :post, local: true,
-                  html: { data: { "hrl-geo-punch": true } } do %>
+                  html: { data: { "hrl-geo-punch": true, "hrl-geo-required": HrLite.config.require_punch_location.presence } } do %>
       <input type="hidden" name="lat"><input type="hidden" name="lng">
       <input type="hidden" name="accuracy_m"><input type="hidden" name="geo_status">
       <button type="submit" class="hrl-btn hrl-btn--big hrl-btn--block">

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.22.0"
+  VERSION = "0.22.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.22.1
 platform: ruby
 authors:
 - kshitiz sinha