Description
WPChef Employee Attendance Tracker is a standalone employee time clock, attendance, and timesheet tracker for WordPress. Developed by WPChef (https://wpchef.online). It helps small businesses, agencies, offices, field teams, clinics, contractors, nonprofits, and service companies track employee work hours directly inside WordPress.
Add a simple shortcode to any page and employees can clock in, clock out, start and end breaks, and review their recent attendance. Administrators can view attendance entries, adjust times manually, review event evidence, run basic daily reports, and export records to CSV.
WPChef Employee Attendance Tracker does not require Gravity Forms, GravityView, WooCommerce, or any other form plugin. It uses custom database tables built for attendance tracking.
Features
- Custom database tables for attendance records and event evidence.
- Employee clock in and clock out.
- Break in/out with optional break notes.
- Frontend employee dashboard using shortcode.
- Admin attendance list.
- Basic daily and weekly reporting through date filters.
- IP address capture for clock events.
- Simple device type capture such as Mobile, Tablet, or Desktop.
- Optional browser GPS location capture for Clock In, Start Break, and Clock Out.
- Optional Google Maps Platform address lookup when a Google Maps API key with the Geocoding API is configured.
- Manual admin adjustment for attendance entries.
- Company location, timezone, and shift start/end settings.
- CSV export.
- WordPress user role support.
Shortcode
Use this shortcode on any protected employee page:
[wpchef_attendance]
Location Capture
Location capture is optional and can be enabled from WPChef Tracker > Settings. When enabled, the employee browser asks for location permission during Clock In, Start Break, and Clock Out. The plugin records latitude, longitude, accuracy, readable address when available, event time, IP address, and simple device type as attendance evidence.
This plugin does not include geofencing, radius restriction, or distance-based blocking.
External Services
If you add a Google Maps Platform API key in the plugin settings and enable the Geocoding API for that key, the plugin can send captured GPS coordinates to Google Maps Platform to convert those coordinates into a readable address for attendance evidence. The free plugin does not require this service for basic attendance tracking, and it does not enforce geofencing.
Google Maps Platform Terms of Service: https://cloud.google.com/maps-platform/terms
Google Privacy Policy: https://policies.google.com/privacy
Google Maps API key setup documentation: https://developers.google.com/maps/documentation/javascript/get-api-key
Google Maps Geocoding API documentation: https://developers.google.com/maps/documentation/geocoding/start
Who Can Use WPChef Employee Attendance Tracker?
WPChef Employee Attendance Tracker is designed for general business use, including:
- Small businesses and offices.
- Remote teams.
- Field service companies.
- Cleaning companies.
- Staffing agencies.
- Home care and healthcare agencies.
- Therapy offices and clinics.
- Delivery teams.
- Security teams.
- Nonprofits and volunteer teams.
- Contractors and service teams.
Privacy Notes
WPChef Attendance stores attendance records in your WordPress database. Clock events may store the employee’s WordPress user ID, clock event time, IP address, simple device type, browser user agent for internal evidence, and browser GPS coordinates when location capture is enabled.
This plugin does not send attendance data to a third-party service unless a site administrator configures a Google Maps Platform API key for address lookup. When address lookup is configured, captured GPS coordinates may be sent to Google Maps Platform to retrieve a readable address. Site owners are responsible for informing employees about attendance monitoring according to their local employment, labor, privacy, and data retention requirements.
Installation
- Upload the plugin ZIP through Plugins > Add New > Upload Plugin, or install it from the WordPress.org plugin directory when available.
- Activate the plugin.
- Go to WPChef Tracker > Settings.
- Set your company location name, timezone, and shift start/end time.
- Choose whether to enable browser GPS location capture.
- Optionally add a Google Maps Platform API key with the Geocoding API enabled for readable address evidence.
- Choose which WordPress roles can use the time clock.
- Create or edit a protected employee page.
- Add the shortcode
[wpchef_attendance]. - Ask employees to log in and use the dashboard to clock in and out.
FAQ
-
Does WPChef Attendance require Gravity Forms?
-
No. WPChef Employee Attendance Tracker is a standalone time clock plugin and stores attendance in its own custom database tables.
-
Can employees use the dashboard from the frontend?
-
Yes. Add
[wpchef_attendance]to any page. Employees must be logged in and must have an allowed WordPress role. -
Does this plugin use GPS tracking?
-
Yes, optionally. Browser GPS location capture can be enabled from the plugin settings. It is also enabled when a Google Maps API key is saved because the site is preparing to capture address evidence. It captures location evidence during Clock In, Start Break, and Clock Out only. It requires HTTPS and browser location permission, and it does not include geofence restrictions.
-
Is a Google Maps API key required?
-
No. Browser GPS capture can save coordinates without a Google Maps API key when location capture is enabled. A Google Maps API key with the Geocoding API enabled is only needed when you want the plugin to convert captured coordinates into readable addresses.
-
Can admins edit attendance records?
-
Yes. Administrators can manually adjust clock in/out and break times from the WPChef Attendance attendance screen.
-
Can I export attendance data?
-
Yes. The attendance list includes CSV export with employee, date, time, break, total, status, device, and location evidence columns.
-
Does WPChef Attendance delete data when deactivated?
-
No. Deactivation preserves your data. You can choose whether to delete WPChef Attendance data on uninstall from WPChef Tracker > Settings.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“WPChef Employee Attendance Tracker” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “WPChef Employee Attendance Tracker” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4.5
- Cleaned the WordPress.org review package and kept the free plugin fully functional.
- Confirmed old brand references were removed from the plugin package.
- Kept the plugin folder, main plugin file, text domain, and slug as wpchef-employee-attendance-tracker.
- Kept only the documented
[wpchef_attendance]shortcode in the readme and plugin code. - Removed old shortcode compatibility aliases and restricted/locked feature preview code.
- Added timezone dropdown labels with UTC offset and current time reference.
- Added live selected-timezone reference on the settings page.
- Added live current time beside the timezone on the employee tracker header so employees can verify the current clock time before clocking in/out.
- Removed shift hours from the tracker header because shift information already appears in the tracker body.
- Added shift start and shift end settings.
- Saved shift start/end values with new attendance entries.
- Added optional browser GPS location capture for Clock In, Start Break, and Clock Out.
- Improved GPS capture handling with HTTPS and browser permission messages.
- Enabled GPS capture when location capture is checked or when a Google Maps API key is configured.
- Added Google Maps API key setting and setup help popup.
- Replaced map-link display with clean readable address evidence when Google Geocoding is configured.
- Cleaned location display so plus codes, GPS coordinates, and accuracy values are not shown in the frontend table, admin tables, reports, or CSV export.
- Added simple device type capture for Mobile, Tablet, or Desktop.
- Added device and readable address evidence columns to the frontend recent attendance table.
- Made the frontend recent attendance table 95% flexible under the tracker.
- Added device and readable address evidence columns to admin attendance, reports, and CSV export.
- Added a redesigned informational Tracker Pro page that compares the free plugin with the separate WPChef Tracker Pro plugin.
- Kept the Tracker Pro page informational only, with no locked local features, license checks, disabled feature screens, or trialware restrictions.
- Updated break handling so employees can take additional breaks during the same shift.
- Improved admin UI styling for attendance, settings, and Pro information pages.
1.3.2
- Updated WordPress admin menu label from WPChef Attendance to WPChef Tracker.
- Fixed Attendance page title so it displays as WPChef Attendance.
- Fixed admin stylesheet loading on WPChef admin pages.
- Improved Attendance admin dashboard summary cards, filter layout, and table styling.
1.3.1
- Renamed plugin to WPChef Employee Attendance Tracker for WordPress.org review.
- Updated plugin slug, text domain, readme title, contributor username, internal prefixes, and public shortcode.
1.2.6
- Fixed Plugin Check warnings in uninstall.php by using prepared identifier placeholders for table deletion queries.
1.0.0
- Initial release.
- Added standalone custom database tables.
- Added employee clock in/out.
- Added break in/out with note.
- Added frontend shortcode dashboard.
- Added admin attendance list and manual adjustment.
- Added IP address and device details capture.
- Added basic reports and CSV export.
- Added single location/timezone settings.
- Added WordPress role support.