Farahabadi Staff Attendance

Farahabadi Staff Attendance adds a front-end attendance form for logged-in WordPress users and an administration area for attendance records. Features include:

• Entry and exit registration from a shortcode.
• A secure self-service attendance report for each logged-in user.
• Date-range totals for both employee and administrator reports.
• Browser geolocation and configurable workplace radius validation.
• Jalali date pickers for logs and report filters.
• Manual entry and exit records for administrators.
• Daily work-time summaries with multiple entry and exit pairs.
• CSV export with UTF-8 Persian text support.
• Optional storage of coordinates, IP address, device type, and browser information; these storage options are disabled by default.
• WordPress personal data export integration.
• No remote API calls, telemetry, advertisements, or external asset loading.

Use the [farastat_attendance] shortcode on a published page for attendance registration. Use [farastat_my_attendance_report] on another published page to show each logged-in user only their own records, daily work time, and selected-range total. Browser geolocation normally requires HTTPS or localhost. The plugin checks the submitted coordinates against the workplace coordinates stored in WordPress settings. Privacy The plugin always stores the WordPress user ID, event type, and event time for each attendance record. Depending on administrator settings, it can also store:

• Latitude and longitude.
• IP address.
• Device type.
• Browser user-agent string.

All records are stored in the site's own WordPress database. The plugin does not transmit attendance data to an external service. Suggested privacy-policy text is added to WordPress under Settings > Privacy. Site administrators are responsible for informing users and applying any local employment, privacy, and retention requirements. Source code The deployed plugin contains its readable PHP, JavaScript, and CSS source. The Jalali date picker is implemented locally without a remote service or bundled third-party JavaScript library.

1. Upload the plugin ZIP from Plugins > Add New > Upload Plugin, or place the plugin directory in /wp-content/plugins/.
2. Activate Farahabadi Staff Attendance.
3. Open Attendance > Settings.
4. Enter the workplace latitude, longitude, and allowed radius.
5. Add [farastat_attendance] to a published page.
6. Add [farastat_my_attendance_report] to another published page for employee self-service reports.
7. Ensure the site uses HTTPS so browsers can provide geolocation.

Existing records from private versions 1.0.x are copied into the new prefixed database table, and the old location settings are migrated. The legacy table is retained as a non-destructive backup.

1.2.2

• Added the Jalali calendar picker to the front-end employee report date fields.
• Removed report form font shorthand so typography is controlled by the active theme.
• Normalized inherited letter spacing inside the Persian report interface.

1.2.1

• Restored migration support for records stored in the intermediate pamgr_attendance_records table.
• Forced the database migration to run after updating from 1.1.x or 1.2.0.
• Prevented data loss when old and new tables contain overlapping primary-key IDs.
• Made migration idempotent by skipping records already present with the same user, event type, and timestamp.

1.2.0

• Added [farastat_my_attendance_report] so logged-in users can view only their own attendance records.
• Added Jalali date filters, daily entry and exit times, daily work duration, and a selected-range total to the employee report.
• Added total work duration and report statistics to the administrator report dashboard.
• Corrected internal PHP, JavaScript, and CSS filenames to match the FARASTAT bootstrap references.
• Corrected the WordPress Tested up to value.

1.1.1

• Renamed the plugin to Farahabadi Staff Attendance for a distinctive WordPress.org directory identity.
• Updated the plugin text domain and directory slug references to farahabadi-staff-attendance.
• Corrected the WordPress.org contributor username.

1.1.0

• Prepared the plugin for WordPress.org directory submission.
• Added unique prefixes, plugin capabilities, nonces, validation, sanitization, and late escaping.
• Moved inline scripts and styles into enqueued local files.
• Replaced the deprecated jQuery date-picker dependency with a readable, dependency-free Jalali picker.
• Added privacy-policy text and personal data export support.
• Added configurable storage of coordinates and technical metadata, disabled by default for new installations.
• Changed destructive record deletion to a nonce-protected POST action.
• Added pagination to the raw logs screen.
• Added formula-injection protection to CSV exports.
• Removed automatic modification of the Subscriber role.
• Removed external map links and all external runtime requests.
• Migrated records and settings from private 1.0.x releases into uniquely prefixed storage.
• Removed the generic legacy [attendance] shortcode to prevent collisions; use [farastat_attendance].