=== InterviewNea – Virtual Interview Queue, Check-in & Reminders ===
Contributors: hmbashar
Tags: interview, recruitment, hiring, queue, reminders
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Verified candidate check-in, a live single-panel interview queue, staff-confirmed Google Meet admission and optional email reminders.

== Description ==

InterviewNea runs virtual interview days for one interview team. Candidates check in on a page of your site, wait in a live queue, and receive the Google Meet link only when the interviewer calls them. Staff control everything from one fast admin screen.

**For candidates**

* Check in with the email and phone number from their application (nothing to register).
* See their queue position, the number of people ahead and an estimated wait, updated automatically.
* A clear "It is your turn" alert (sound, vibration and an optional browser notification) with a 90 second countdown.
* The Meet link is released only to the candidate whose turn it is.

**For interviewers**

* Live dashboard: Call next, Confirm joined, Complete & call next, Skip, Mark late, No-show and Requeue. Opening the Meet link is never treated as proof of attendance; staff confirm after seeing the candidate in Google Meet.
* Start, pause (with duration and reason shown to candidates), resume and close a session.
* Sessions, candidates (add, edit, delete), CSV import and export, search and status filters.
* Email log with the exact HTML of every message and an activity log of every queue action.
* Only one interview is active at a time: queue changes are serialised with database row locks.

**Reminders (off by default)**

* A reminder email 10 minutes before each candidate's reporting time and a "check in now" email 3 minutes before.
* A test email before you switch anything on.

**Privacy and safety**

* Email logs are deleted automatically after the number of days you choose.
* WordPress personal-data export and erase are supported.
* Candidate check-in tokens are random and stored only as hashes. Check-in attempts and requests with unknown tokens are rate limited.
* No tracking, no ads, nothing is loaded from other websites.

Verification is by matching application records, not by proving identity. Email one-time codes are not part of this version.

== Installation ==

1. Upload the plugin through Plugins > Add New > Upload Plugin, or install it from the plugin directory, and activate it.
2. Open InterviewNea > Settings and press "Create the page for me" (or add the shortcode `[interviewnea_waiting_room]` to a page and choose it).
3. Create a session under Sessions, then add candidates one by one or import a CSV.
4. Share the session's check-in link with candidates (Sessions > Copy link).
5. On the interview day open the Live Dashboard and press Call next.

Set your site timezone in Settings > General first: session times use it. For reliable reminders use a real server cron that runs `wp-cron.php`.

== Frequently Asked Questions ==

= Does InterviewNea verify who the candidate really is? =

It matches the email and phone number against the list you entered. That is record matching, not strong identity proof. The interviewer confirms the person in Google Meet before the interview starts.

= What happens if a candidate does not click Join in time? =

After 90 seconds the candidate is skipped and the next ready candidate is called. Skipped candidates can rejoin the end of the queue while the session is open. A No-show is only ever set by staff.

= Can candidates share the Meet link? =

The link is shown only to the called candidate, but anyone who has it can try to use it. Use Google Meet host controls (knock to join, host admits) for access control.

= Which CSV columns are needed? =

`name`, `email`, `phone` and optionally `report_time` (HH:MM). Download the sample file from the Import CSV dialog. Up to 500 rows and 1 MB per file.

= Where is my data kept and how do I delete it? =

In tables prefixed `interviewnea_` in your own database. Deleting a candidate removes their email and activity records. Switch on "Delete all data when the plugin is deleted" in Settings if you want the tables removed on uninstall.

= Does it work with page builders and caching plugins? =

Yes. The check-in page is a normal page with a shortcode. Exclude it and `/wp-json/interviewnea/` from full-page caching.

= Which public endpoints does the plugin add? =

The check-in, status, rejoin and join routes under `/wp-json/interviewnea/v1/` are public on purpose, because candidates have no WordPress account. Check-in matches the candidate against the list you entered and is rate limited; the other three routes need the random token that check-in returns. Every other route requires a logged-in user with permission to manage the interview queue.

== Source code ==

The admin screens and the candidate waiting room are React apps. The compiled files in `assets/build/` are generated from the readable source that ships inside this plugin: the `assets/src/` folder, together with `package.json` and `webpack.config.js`. To build it yourself, run `npm install` and then `npm run build` in the plugin folder.

== Privacy ==

InterviewNea stores the names, email addresses, phone numbers and interview status of the candidates you add, together with the times of their check-in and interview, in your own WordPress database (tables prefixed `interviewnea_`). Copies of the reminder emails it sends are kept in an email log for the number of days you choose in Settings. A candidate's browser keeps a random check-in token in local storage so the waiting room can reconnect after a page refresh. The plugin supports the WordPress personal data export and erase tools and adds suggested text to the privacy policy guide. Nothing is sent to the plugin author or to any third party.

== External services ==

InterviewNea does not connect to any external service. Reminder emails are handed to the WordPress mailer (`wp_mail()`) that your site already uses. Google Meet links are only shown to candidates as links; InterviewNea does not call any Google API.

== Trademarks ==

"InterviewNea" is an original name: "Interview" is the English word and "Nea" is a Bengali word. The plugin does not use any other company's name or logo. Google Meet is named only to describe the kind of meeting link the plugin works with.

== Screenshots ==

1. Live dashboard with the control room and the candidate queue.
2. Candidate waiting room showing the queue position.
3. It is your turn: the Join Google Meet screen.
4. Candidates with reminder status, CSV import and export.
5. Email log with the exact message preview.
6. Settings: check-in page, reminders and privacy.

== Changelog ==

= 0.1.0 =
* Initial release: live interview queue, candidate check-in, Google Meet admission, email reminders, React admin app and waiting room, REST API.
* Names and pause reasons are measured in characters, so long Bangla text is accepted.
* Paged lists, email log retention, WordPress privacy export and erase, organization name setting, optional name matching.
* No external scripts or services: everything is bundled with the plugin.

== Upgrade Notice ==

= 0.1.0 =
First release of InterviewNea.
