PPS Implant Passport: settings reference
Updated November 10, 2026
Configure clinic details and the shared access PIN in Passports > Settings before creating records. Pro needs the active Free parent and paid entitlement. Shared clinic access, permanent patient links and public Media Library references have the limits described below; this is not a certified clinical system.
Release in preparation. This reference is not confirmation of download or Pro purchase availability.
Where to configure it
Settings and access
Open Passports > Settings with an administrator account (manage_options). Save settings checks a nonce and saves the whole form.
| Setting / submitted key | Default | Format, validation and effect |
|---|---|---|
| Access PIN (4-6 digits), pps_ip_pin | None | Exactly 4-6 digits; a valid replacement is password-hashed. Blank preserves the old PIN. An invalid PIN produces an error, while the other settings can still save. There is no PIN-clear control. |
| Dashboard active, pps_ip_dashboard_enabled | On | Checkbox saves 1/0. The frontend dashboard also requires a saved PIN. |
| Session duration (hours), pps_ip_session_hours | 8 | Absolute integer clamped to 1-72. Applies when a new PIN session is created, not by rewriting existing cookie expiry. |
| Clinic name, pps_ip_clinic_name | WordPress site name | Plain text; branding on dashboard and printouts. Saving blank keeps it blank. |
| Clinic details (address, phone, web), pps_ip_clinic_info | Blank | Plain multiline text on the admin print layout. |
| Logo attachment ID, pps_ip_logo_id | 0 | Absolute integer; Media Library image ID. 0 means no logo; unavailable images do not produce a usable logo. |
| Doctors, pps_ip_doctors | Blank | One entry per line; trimmed nonempty suggestions for the surgeon field. Free text is still allowed. |
| Clinic locations, pps_ip_locations | Blank | Same line format; suggestions for location, not a restriction to that list. |
| Implant brands, pps_ip_brands | Straumann, Nobel Biocare, Dentsply Sirona, Zimmer Biomet, Osstem, MegaGen, Neodent, Dentium, Bredent, Other | One entry per line populates implant brand selectors. Existing admin records retain their old selected brand even if removed from the list. |
The lists and branding are saved in pps_ip_branding. Saving settings also flushes the dashboard rewrite rules.
Passport record editor
Use Passports > Add Passport or edit an existing passport. The implant_passport post type supports a title and custom boxes, not a public archive or REST editor. Its wp-admin read/edit/create/delete capabilities require manage_options, not an ordinary editor role. Record saves also check the metadata nonce and skip autosaves. Clinic PIN sessions do not authorize the wp-admin editor or bulk tools.
Unless shown otherwise below, initial values are blank. Field names in the form begin pps_ip_; storage keys begin _pps_ip_.
| Group and field suffix | Format / default | Save and use |
|---|---|---|
| Patient: patient_name, Full name | Text; browser-required | Plain text. An empty/default record title is generated from this name and intervention date. |
| patient_dob, Date of birth | Date | Stored as plain text, not server-validated as a calendar date. Used for display, not patient authorization. |
| patient_id_no, National ID / patient number (optional) | Text | Plain text, searchable in the admin list and included in the patient-summary export. |
| patient_phone, Phone | Telephone input | Plain text, not normalized or verified; displayed as a telephone link. |
| patient_email, Email | Email input | Saved as plain text, not server-validated at record save. Pro email actions separately require a valid address. |
| patient_addr, Address (optional) | Text | Plain text, displayed in details and printouts. |
| Intervention: intervention_date | Date; browser-required | Plain text; controls intervention sorting, export date bounds and statistics month. |
| doctor_name, Surgeon | Text with doctor suggestions; browser-required | Plain text; free-form names are accepted. |
| clinic_location, Clinic / location | Text with location suggestions | Plain text. |
| diagnosis, Diagnosis / reason for intervention | Multiline text | Textarea sanitation; printed with the record. |
| Procedures: bone_grafting | Yes/No; No | Only exact yes saves yes; anything else saves no. |
| sinus_lift | Yes/No; No | Same yes/no handling. |
| prf_used, PRF used | Admin No; frontend creation Yes | Same save handling. Check this deliberate difference before saving a new passport. |
| gbr, GBR (guided bone regeneration) | Yes/No; No | Same save handling. |
| grafting_notes, Procedure details / materials | Multiline text | Textarea sanitation. Not a structured materials inventory. |
| Notes: warranty_years, Clinical warranty (years) | 5; browser range 0-99 | Saved as an absolute integer without the 99 server clamp. This is a recorded value, not a warranty granted or verified by the plugin. |
| next_control_date, Next check-up | Date | Plain text; retained for display and the Pro reminder query. |
| notes, Notes / recommendations | Multiline text | Textarea sanitation; included in detail and print views. |
Browser-required labels do not mean the admin save handler rejects missing names, dates or surgeon values. Verify the record before issuing it.
Implants placed repeater
Each pps_ip_implants[i] row contains these seven blank fields:
| Row key | Input and units | Save behavior |
|---|---|---|
| position | Text, browser maxlength 4; UI suggests FDI notation such as 16 | Plain text; no server FDI validation. |
| brand | Choose / configured brand list | Plain text, not a server-enforced whitelist. |
| model | Text | Plain text. |
| serial | Serial / LOT text | Plain text. |
| diameter | Text, millimetres | No numeric conversion or measurement validation. |
| length | Text, millimetres | Same handling. |
| torque | Text, Ncm | Same handling. |
Add implant appends a blank row. The admin remove control asks before deleting a row; the last row is cleared instead. Rows with neither position nor brand are dropped even if another column contains data. Saved rows are reindexed. The frontend form uses the same seven fields and row filtering, but allows removing every row.
Staff frontend dashboard
The generated route is /passport-dashboard/, not a shortcode or a page you must create. It is available only while Dashboard active is on and a PIN exists. The six PIN boxes accept a 4-6 digit PIN; Sign in creates a cookie session for the configured duration. Five failed attempts from the same server-observed IP trigger a 15-minute lockout. Log out clears the browser session.
A PIN session grants access to the full staff dashboard, including published, draft and private passports, not one assigned patient. Search filters the already-rendered rows by patient name, phone, email or passport code; All doctors filters by exact stored surgeon name. Details, Close and Print passport use those loaded details. The dashboard print window is distinct from the admin print layout.
New passport exposes the patient, intervention, implant, procedure and notes fields above. Back to dashboard leaves the form; Save passport creates a private record. Reads and creation recheck administrator permission or a valid clinic session; creation also requires its nonce and rejects empty patient name or intervention date. Surgeon is required by the browser only. There is no frontend edit, delete, attachment picker, Pro patient-email action or per-record access selector in this template.
Changing the PIN invalidates old clinic cookies because their signature includes the stored PIN hash. A blank settings save retains that hash. Old pre-upgrade cookies require sign-in again. Disable the dashboard to stop that route. This remains a shared clinic PIN, not individual staff accounts or an audit trail; no privacy/security certification is implied.
Find, print and export
The administrator list offers WordPress search, status/bulk actions, an All doctors selector and sortable Patient, Intervention date and Doctor columns. Search also looks in patient name, phone, patient number and email metadata. Print or Print / Save as PDF requires its nonce plus administrator permission or a valid clinic session; a record-bound Pro patient signature is the separate patient route. A nonce alone does not authorize a record. Use the browser's print dialog for PDF; no PDF file is generated on the server. The print view's Close button asks the browser to close its tab.
Passports > Export CSV requires manage_options for the menu and execution. It contains From date and To date, both blank date inputs, plus Format: One row per implant (default) or One row per patient (summary). Bounds are inclusive on intervention date. Submitted date text is sanitized but not calendar-validated. Download CSV also checks its nonce. A clinic PIN session does not authorize bulk export.
Both formats include patient contact data, intervention, doctor, clinic and procedure flags. Implant mode includes position, brand, model, LOT and measurements; a passport without implants still produces one empty-implant row. Patient mode adds patient number, implant count, brands, positions, warranty years and next check-up. The export includes publish/draft/private records and is not a complete backup of all notes or media.
Pro patient access and public document references
In the administrator Actions box, Patient link (Pro) is a read-only selectable URL. Anyone holding it can open that passport's print view without staff login. This is a permanent, record-bound bearer credential with no expiry or individual revoke/rotate button. Changing WordPress auth salts invalidates all such links. PIN rotation and identity-field clearing do not revoke them. Paid denial stops Pro authorization while denied; it is not permanent revocation. Share links privately.
Email passport to patient appears only for a valid stored patient email. It requires current Pro entitlement, manage_options, the correct record type and its nonce, then sends the name, clinic and patient link through wp_mail. Only a strict true mail return records an acceptance timestamp; it does not prove delivery.
The Pro shortcode [pps_implant_passport_lookup] has no configurable attributes or code/date-of-birth form. It only reopens the requested record when the URL already carries that record's valid pps_ip_print and pps_ip_token credential, then offers Open your implant passport. Otherwise it asks the visitor to use the clinic's supplied signed link. A passport number, birth date or another record's signature does not issue a new credential. This is not a patient account or a new identity-verification service.
Public document references (Pro, not private storage) is administrator-only. Add files opens a multiple-selection Media Library picker with per-file remove controls. The hidden pps_ip_attachments field saves comma-separated absolute IDs, initially blank, after the record nonce and entitlement/administrator checks. These are references to public, non-confidential documents: WordPress media URLs can be public. Do not upload patient photos, X-rays or confidential scans here. Removing a selection detaches its ID; it does not delete or privatize the file. Existing media is not moved. No private delivery or print attachment renderer is connected, and patient lookup does not expose this administrator-only list.
Pro Statistics and Tools
Passports > Statistics (Pro) requires manage_options. Read-only tables count implants by the last 12 recorded month keys, brand and doctor across published, draft and private passports. They are counts of entered rows, not clinical outcomes.
The Check-up reminders form saves pps_ip_pro_options after nonce/administrator checks:
| Control / key | Default | Save and intended runtime input |
|---|---|---|
| Enable reminders / reminders_enabled | Off | Checkbox yes/no; enables the daily worker. |
| Clinic notification email / notify_email | WordPress admin email | Email sanitation; blank/invalid prevents clinic mail, without fallback after saving. |
| Days before the check-up / days_ahead | 7 | Absolute integer clamped 1-90. Selects the inclusive window from today through today plus this many calendar days in the configured WordPress site timezone, not an exact UTC target. |
| Remind patients too / patient_reminders | Off | Checkbox yes/no; requires reminders enabled and a valid stored patient address. |
The daily worker samples current_datetime once, normalizes that immutable site-zone instant to midnight, then modifies calendar days for the upper bound. Both dates use that same snapshot, including across local midnight and DST. It selects published/draft/private records whose check-up date lies within the inclusive window, without the former 50-record cutoff or a pre-existing aggregate marker requirement. This fixes selection; it is not a production capacity or cron-timing guarantee.
Clinic and patient acceptance are tracked separately for each record's actual check-up date, only after wp_mail returns strict true. In sequential runs, an accepted channel is not resent while a failed requested channel retries within the due window. Invalid/missing requested recipients stay incomplete. Legacy aggregate markers are ignored and can cause a one-time resend after upgrade. Changing the check-up date makes the old date's acceptance inapplicable. Retries stop once the local check-up date has passed. There is no manual retry/backfill control or proved crash/overlap exactly-once guarantee. Mail acceptance is not delivery, a bounce check or confirmed patient receipt. Check live WordPress cron and the mail provider separately before relying on reminders.
Clear six identity fields and replace the record title contains a blank, positive Passport ID (passport_id) and Clear six identity fields and title, with an irreversible-action confirmation. After entitlement, manage_options, nonce and record-type checks, it replaces patient name, birth date, ID number, phone, email and address with REDACTED and replaces the title. Notes, clinical/implant data, media, revisions, emails, exports, backups and other copies remain. Existing signed links remain valid. The legacy route name does not make this complete anonymization, GDPR erasure or a legal-compliance tool. There is no undo here; back up and verify the exact record ID first.
Troubleshooting
For a dashboard 404, save settings to refresh rewrite rules; for Access disabled, check the checkbox and PIN. After PIN rotation, sign in again. A staff print link needs a current nonce and administrator/clinic-session authority; a patient link needs Pro entitlement and that record's signature, not a birth date. For a missing reminder, check the saved check-up date against the site-calendar window, recipient validity, separate acceptance state and the scheduler. An accepted send is not delivery evidence.
Disable or roll back safely
Disable the frontend dashboard and reminders before removing access. Deactivating Pro removes its patient-token authorization/lookup and stops its registered reminder event, but does not erase records or media. Free uninstall deletes plugin settings; passport records are retained unless the separate PPS_IP_DELETE_DATA_ON_UNINSTALL configuration constant is deliberately enabled. Do not use uninstall as a reversible settings reset.
Services and data
The plugin stores sensitive entered records in WordPress posts/meta and files in the Media Library. Pro mail sends patient links or reminder/contact details through the site's mail system. Print/PDF/CSV copies leave the site's access controls. No feature-specific remote API was found in these paths; hosting, mail transport, media storage and Freemius traffic are separate. Establish appropriate access and retention practices independently.
Related documentation
Setup: https://propluginstack.com/docs/implant-passport-setup-reference/
Changelog: https://propluginstack.com/changelog/implant-passport-source-changelog/