Document uploads ship in the optional Custom Fields & Student Documents<\/strong> add-on. When installed, files are stored in a private tsm-private\/student-docs\/<\/code> directory inside wp-content\/uploads<\/code>, protected by an .htaccess<\/code> deny rule and SHA-prefixed filenames, with a full upload\/download\/delete audit log for government chain-of-custody.<\/p><\/dd>\nDoes it work with my theme?<\/h3><\/dt>\nYes. The portals render inside your active theme via shortcodes and inherit your theme's colors and typography. Optional portal-theme polish is built in and can be disabled per page.<\/p><\/dd>\n
Is it translation-ready?<\/h3><\/dt>\nYes. All user-facing strings use the tradeschool-manager<\/code> text domain. WordPress 4.6+ auto-loads translations hosted on WordPress.org.<\/p><\/dd>\nCan the Students CSV importer assign existing students to classes?<\/h3><\/dt>\nClass assignments use the separate Class Enrollments<\/strong> tab under TradeSchool > Import \/ Export<\/strong>. Identify a student with student_id<\/code> (TradeSchool Manager's internal ID), student_number<\/code> (your school's ID), or student_email<\/code>. Identify a class with class_id<\/code>, or with both class_name<\/code> and school_year<\/code>. The school_year<\/code> value is the visible school-year name. Imports are additive and never unenroll students whose rows are absent.<\/p><\/dd>\nHow do I migrate existing student numbers from another platform?<\/h3><\/dt>\nDownload the Students template under TradeSchool > Import \/ Export > Students<\/strong>. Leave the id<\/code> column blank for new records and place the previous platform's identifier in student_number<\/code>. Student Numbers are optional text values up to 100 characters, so values such as STU-00087<\/code> are supported. Each nonblank Student Number must be unique. When working in Excel or another spreadsheet application, format the student_number<\/code> column as Text before pasting numeric identifiers so the spreadsheet does not remove leading zeros.<\/p>\n\nWhen Update existing students<\/strong> is selected, matching is performed by internal id<\/code>, then student_number<\/code>, then email. If supplied identifiers point to different students, the row is skipped rather than merging records. After importing students, the same student_number<\/code> values can be used in the Class Enrollments CSV.<\/p><\/dd>\n\n<\/dl>\n\n\n1.1.25<\/h4>\n\n\n- Corrected the WordPress.org release packaging: added all five required PHP files and the program enrollment guide to version control so they are included in the distributed plugin.<\/li>\n
- Aligned the plugin version, runtime version and Stable tag with the release tag. Fixes the missing-file startup fatal error in the incomplete 1.1.22 through 1.1.24 packages.<\/li>\n
- No additional database migration or academic, billing, or add-on behavior changes from the complete 1.1.22 build.<\/li>\n<\/ul>\n\n
1.1.23<\/h4>\n\n\n- Emergency packaging release: includes five required PHP files omitted from the WordPress.org 1.1.22 download, resolving the resulting missing-file fatal error during plugin startup.<\/li>\n
- Restored the program enrollment documentation omitted from that download. No additional database migration or academic, billing, or add-on behavior changes from the complete 1.1.22 build.<\/li>\n<\/ul>\n\n
1.1.22<\/h4>\n\n\n- Addressed Plugin Check findings: escaped exception messages, unslashed and strictly validated portal session cookies, clarified exact-input validation and dynamic prepared-query checks, corrected reset-form scanner annotations, and normalized shortcode line endings. Enrollment, billing, and add-on record identifiers are unchanged.<\/li>\n
- Added Reactivate to completed, withdrawn, and archived program enrollments in the student editor, with or without the Invoicing add-on. Restores the existing enrollment without changing student status, class rosters, or billing; existing archived-year and duplicate-active-enrollment protections still apply.<\/li>\n
- Fixed weighted-category field indexes after removing and adding rows, so valid totals save without one category overwriting another.<\/li>\n
- Wrapped the admin header, notices, and school-year switcher on narrow screens to prevent phone-width horizontal page overflow.<\/li>\n
- Hardened student password resets: save new token digests before returning email links, accept exact single-use credentials, and atomically update the password while consuming the token. Existing unexpired legacy links remain compatible.<\/li>\n
- Invalidated pending reset links when passwords change through the portal or student editor; rejected stale reset submissions and stopped displaying success after failed saves.<\/li>\n
- Built reset-email links from the configured student login page (site-home fallback), not the incoming Host header. Clarified generic email-delivery messaging and reset-save errors.<\/li>\n
- Bound student and teacher portal sessions to their current password: password changes and student resets reject older sessions on their next request. Portal password changes sign out the current browser and return to the configured login page. Existing portal sessions require a fresh sign-in once after upgrading; IDs and add-on relationships are unchanged.<\/li>\n
- Checked session persistence before accepting login, rotated browser session tokens on sign-in, and set HttpOnly\/SameSite cookies (Secure on HTTPS). Sponsor and WordPress user sessions are unchanged.<\/li>\n
- Made student Drop\/Reinstate actions check reads and writes, reject invalid IDs\/dates, and report failure accurately. Conditional status updates prevent stale requests from overwriting a different current status.<\/li>\n
- Made repeated Drop\/Reinstate requests no-ops: preserve the original drop date\/reason and avoid duplicate extension notifications. Existing public drop\/reinstate methods retain boolean results.<\/li>\n
- Clarified that Drop\/Reinstate preserves records and does not cancel class\/program enrollments, billing, payment plans, or student portal access. Reinstatement clears the current drop date\/reason without changing enrollment or financial records.<\/li>\n
- Hardened assignment saves with checked transactions, protected graded assignments from moving classes, and rejected missing\/archived parents and existing class\/year mismatches without migrating history.<\/li>\n
- Preserved omitted assignment fields in partial model\/CSV updates, rejected ambiguous Class + Title CSV matches, and validated real dates, nonnegative finite points, and boolean flags. Teacher-portal input now reaches model validation without silently clearing malformed dates.<\/li>\n
- Added assignment-save notices and class-move guidance; preserved the existing Required flag in the admin editor and retained Pass\/Fail normalization.<\/li>\n
- Prevented class school-year changes from relocating academic\/financial history: assignments, enrollment, attendance, program links, invoices, and class certificates block the move. Completed\/archived classes remain in their original year; use Rollover for a new year.<\/li>\n
- Kept year corrections available for unused classes, validated destination year IDs, and applied the same checks to class CSV updates. Added class-editor guidance; existing mismatched records are not automatically migrated.<\/li>\n
- Made class fields and primary\/co-teacher selections save in one checked transaction. Failed link writes restore the original class and teacher links; class-saved hooks run only after a successful commit.<\/li>\n
- Validated selected teacher IDs, protected archived-year co-teacher editing, and preserved unchanged co-teacher link IDs and omitted teacher selections in class CSV updates. Existing co-teacher dropdown selections now render without JavaScript.<\/li>\n
- Added a visible Active\/Inactive teacher portal-access setting. Inactive teachers cannot log in, and existing sessions are rejected on their next request; teaching history and credentials are retained.<\/li>\n
- Protected teachers linked to classes, co-teaching, or workshops from permanent deletion, including inactive Workshops installations. Unassigned teacher deletion now uses checked transactions and accurate admin notices.<\/li>\n
- Made existing-enrollment billing replacement and signed-contract synchronization transactional; protected invoices with payment\/refund\/closed-history records from automatic regeneration and prevented duplicate charges.<\/li>\n
- Validated signed-contract ownership, dates, and schedule totals; Full billing now charges total tuition rather than subtracting an unbilled deposit.<\/li>\n
- Made program fields and class-link changes atomic, preserved omitted settings and other-year links, and checked enrollment status\/removal results. Programs with historical enrollment\/invoice\/certificate records must be archived instead of deleted.<\/li>\n
- Protected class enrollments with grade\/attendance history and program enrollments linked to invoices\/contracts from removal; clear result notices replace false success.<\/li>\n
- Hardened standalone invoice creation, edits, deletion, and voiding with checked transactions; protected payment history and reported email\/status-save failures accurately.<\/li>\n
- Added keyboard-accessible horizontal scrolling to Students, Teachers, School Years, Classes, Programs, and Assignments tables.<\/li>\n
- Added collapsible mobile navigation with accessible expanded-state and focus handling; navigation remains available without JavaScript.<\/li>\n
- Added visible attendance-pill and navigation\/table keyboard focus, consolidated status-pill styles, and replaced the focus-mode text icon with WordPress Dashicons.<\/li>\n
- Expanded deletion\/removal warnings, moved repeated layout styles into reusable classes, and made bundled documentation navigation responsive. Added Program Enrollments & Billing to the documentation index.<\/li>\n
- Cleaned up Students list\/add\/edit styling: grouped row actions, labeled action columns, consistent photo previews and Drop\/Reinstate cards, and wrapping profile details\/buttons on smaller screens. Associated built-in field labels and help text with their controls. Student fields, save actions, and add-on hooks are unchanged.<\/li>\n
- Cleaned up student enrollment\/billing and document panels with keyboard-scrollable tables, grouped actions, consistent textual status pills, labeled billing\/upload controls, and reusable layout classes. Corrected the empty enrollment row's column span when billing is off. Existing billing defaults, upload\/download actions, and license restrictions are unchanged.<\/li>\n
- Cleaned up Teachers add\/edit\/list screens with associated field labels and password guidance, consistent input widths, wrapping form actions, readable Active\/Inactive badges, grouped row actions, and scoped reusable styles. Teacher access rules, creation locks, and class\/workshop relationships are unchanged.<\/li>\n
- Cleaned up Classes add\/edit\/list and roster layouts: labeled form fields and dynamic row controls, scrollable co-teacher\/category editors, responsive enrollment controls, and an explicit empty-roster message. Category totals now announce updates to assistive technology. Grading calculations, category visibility, teacher selections, school-year protections, and enrollment actions are unchanged.<\/li>\n
- Cleaned up School Years, Year Rollover, and Archive with labeled fields\/class selections, consistent Current\/Archived badges, named scroll regions, reusable spacing, and empty-list messages. Source-year selection now stays on Year Rollover and provides a Load classes button without JavaScript; corrected the database variable scope used to display source assignment counts. Copy, archive, and deletion rules are unchanged.<\/li>\n
- Made new program enrollments transactional across roster links and requested invoices; failed reads, writes, license checks, and commits no longer leave a partially created enrollment or fire success hooks.<\/li>\n
- Requires the rebuilt Invoicing & Contracts 1.1.10 for automatic new-enrollment billing; Manual billing remains available without the add-on. Invoice numbers are reserved before the transaction, so failed attempts may leave numbering gaps.<\/li>\n
- Validated enrollment dates, monetary values, school-year\/class relationships, and signed-contract ownership; rejected duplicate active enrollment in the same program\/year and reuse of an already-linked contract.<\/li>\n
- Preserved the Applications workflow for contracts signed before student creation by binding an unassigned signed contract only to a matching student email and program.<\/li>\n
- Corrected installment cent allocation so the final installment cannot become negative from accumulated rounding; existing stored invoices are not changed.<\/li>\n
- Added program-enrollment failure notices, including when the student was saved but their initial enrollment failed. Contract signing now distinguishes a saved signature from failed automatic enrollment\/billing.<\/li>\n
- Made class\/program completion transactional: checks linked records and school years, rolls back failed cascades, and sends completion hooks only after commit. Requires InnoDB for completion-related tables.<\/li>\n
- Preserved original completion dates on repeat requests and reported failed completion in the admin instead of showing success. Already-completed linked classes remain unchanged; unfinished archived-year classes block program completion.<\/li>\n
- Preserved enrollment IDs and original enrollment dates when reactivating class enrollments, and added an admin enrollment result notice.<\/li>\n
- Coordinated with Certificates 1.3.19 to connect automatic issuance to core's actual completion hooks while retaining legacy integration hooks.<\/li>\n
- Validated attendance relationships, dates, and statuses; archived years are read-only in both the admin and teacher portal, and failed writes no longer display success.<\/li>\n
- Fixed teacher attendance notes not being saved and preserved existing notes\/record IDs for status-only updates.<\/li>\n
- Preserved omitted class settings during edits\/imports and expanded class CSV exports to include description, status, passing threshold, credits, and weighted-category configuration.<\/li>\n
- Rejected invalid or ambiguous class-definition CSV identifiers instead of silently updating another class; checked class save results.<\/li>\n
- Restricted school-year deletion to empty years so classes, assignments, and program enrollments cannot be orphaned; added date\/save validation and recovery from a deleted active-year selection.<\/li>\n
- Preserved passing thresholds and credits during year rollover and reported incomplete copies with a warning instead of implying all records were copied.<\/li>\n
- Validated teacher profile emails before saving, handled failed photo\/profile\/password saves, preserved omitted teacher fields, and rejected deleted-teacher sessions.<\/li>\n
- Hardened deletion across core and updated add-ons: checks database operations and commit results, requires transactional tables, blocks missing cleanup providers, and defers file removal until commit using a durable retry queue.<\/li>\n
- Protected archived academic history from permanent student\/class\/assignment deletion, including assignments cascaded from a class and student-linked audit records.<\/li>\n
- Fixed class certificate cleanup so workshop certificates with the same numeric scope ID are preserved; shared certificate files and certificate template files are retained.<\/li>\n
- Consolidated both assignment CSV import screens onto one strict class resolver; invalid or conflicting supplied IDs no longer fall back to another record.<\/li>\n
- Preserved omitted student fields during partial imports, allowed Student Number-only updates, and added reversible formula-safe CSV export encoding.<\/li>\n
- Checked assignment and grade persistence results, corrected import\/rollover counts, and suppressed successful grade notifications when a write fails.<\/li>\n
- Revoked deleted-student sessions, validated profile emails before sanitizing, and retained failed profile form values privately for ten minutes.<\/li>\n
- Added an optional, unique Student Number for school-assigned or legacy platform identifiers without changing TradeSchool Manager's internal student IDs.<\/li>\n
- Added Student Number to student forms, profiles, admin tables, and Students CSV import\/export while preserving leading zeros and alphanumeric values.<\/li>\n
- Added Student Number matching to Class Enrollments imports and exports.<\/li>\n
- Added safe import conflict detection so mismatched internal IDs, Student Numbers, and email addresses cannot merge different students.<\/li>\n
- Kept all core and add-on relationships on the existing internal student ID for backward compatibility.<\/li>\n
- Fixed permanent student deletion so core enrollments, grades, attendance, billing records, notes, custom values, program enrollments, and parent links are removed before the student record.<\/li>\n
- Added coordinated add-on deletion providers and post-commit lifecycle hooks for related records and files.<\/li>\n
- Added clear success and failure notices for permanent deletion.<\/li>\n
- Fixed permanent class deletion so enrollments, assignments, grades, attendance, program mappings, announcements, and active add-on records are cleaned up while financial history is preserved.<\/li>\n
- Replaced the vague class deletion prompt with an explicit description of what is removed and retained.<\/li>\n
- Fixed permanent assignment deletion so associated grades and audit history are removed before the assignment.<\/li>\n
- Added post-commit assignment-deletion hooks (also used during class deletion), clear result notices, and an explicit irreversible-action warning.<\/li>\n
- Fixed assignment CSV matching so class names must be paired with the visible school-year name when class_id is not supplied, preventing assignments from being imported into a same-named class from another year.<\/li>\n
- Added school_year to assignment CSV templates and exports and rejects ambiguous duplicate class matches instead of guessing.<\/li>\n
- Added central grade relationship validation so CSV and other grade writes reject missing assignments, missing students, and students who are not enrolled in the assignment class.<\/li>\n
- Allows grades for inactive historical enrollment records while preventing unrelated student and class IDs from creating orphaned grade data.<\/li>\n
- Fixed student portal profile updates so success appears only after the database update succeeds.<\/li>\n
- Added clear portal errors for invalid or duplicate email addresses, failed photo uploads, and database failures, and removes a newly uploaded photo if its profile update cannot be saved.<\/li>\n<\/ul>\n\n
1.1.21<\/h4>\n\n\n- Added Class Enrollments CSV import and export for linking existing students to existing classes.<\/li>\n
- Added student and class IDs to the first column of their admin tables for CSV reference, and made Class Enrollments use the visible school-year name instead of requiring its internal ID.<\/li>\n
- Added ID-first matching with email and class-name\/year fallbacks, archived-year protection, and safe handling of existing enrollments.<\/li>\n
- Reworked the admin Setup Checklist with clean completion indicators and properly spaced action links.<\/li>\n
- Fixed the Focus Mode \"Exit to WordPress\" button so its security nonce and dashboard redirect are handled correctly.<\/li>\n
- Updated Class Enrollments queries to use WordPress-recognized fixed plugin table names for Plugin Check compliance.<\/li>\n
- Updated tested compatibility for WordPress 7.1.<\/li>\n<\/ul>\n\n
1.1.19<\/h4>\n\n\n- Fixed PDF generation when the saved school logo URL cannot be read by TCPDF on the server.<\/li>\n
- Shared PDF headers now resolve Media Library images to local upload paths and fall back to the school name when needed.<\/li>\n
- Added admin download buttons for core report-card PDFs and class roster PDFs under Gradebook > Class Reports.<\/li>\n
- Kept student-facing report-card downloads reserved for the Reports & Transcripts add-on.<\/li>\n<\/ul>\n\n
1.1.18<\/h4>\n\n\n- Reordered the branded admin sidebar into Manage, Add-ons, and System sections.<\/li>\n
- Added core fallback sidebar entries for installed add-ons so Certificates and Applications appear consistently.<\/li>\n
- Hid the default WordPress admin footer on TradeSchool Manager screens.<\/li>\n<\/ul>\n\n
1.1.17<\/h4>\n\n\n- Fixed student portal tab actions so links and panels initialize reliably in the focused portal layout.<\/li>\n
- Fixed teacher portal subtab initialization timing for class and add-on views.<\/li>\n<\/ul>\n\n
1.1.16<\/h4>\n\n\n- Converted remaining first-party inline portal, sponsor, email, add-on, and admin UI assets to WordPress enqueue APIs.<\/li>\n
- Updated extension hook names and uninstall cleanup symbols to the long
tradeschool_manager_<\/code> prefix for Plugin Check.<\/li>\n- Updated bundled Chart.js to 4.5.1 and TCPDF to 6.11.3.<\/li>\n
- Kept first-run and add-on notices limited to TradeSchool Manager admin screens.<\/li>\n<\/ul>\n\n
1.1.15<\/h4>\n\n\n- Limited first-run and add-on data notices to TradeSchool Manager admin screens.<\/li>\n
- Converted reviewer-named inline portal\/theme, feedback, attendance, page-title, and focus-mode assets to WordPress enqueue APIs.<\/li>\n
- Sanitized grade, class, student, and program hook payloads before passing data to extension hooks.<\/li>\n
- Sanitized preserved active-year request values before reuse.<\/li>\n
- Added the requested WordPress.org contributor username to the readme.<\/li>\n<\/ul>\n\n
1.1.14<\/h4>\n\n\n- Added narrow PHPCS suppressions for intentional public extension hooks that Plugin Check does not accept through its inferred prefix.<\/li>\n<\/ul>\n\n
1.1.13<\/h4>\n\n\n- Updated custom extension hooks to start with the literal
tradeschool-manager<\/code> plugin slug used by Plugin Check.<\/li>\n- Scoped uninstall cleanup variables inside a local closure so the uninstall routine does not declare temporary globals.<\/li>\n<\/ul>\n\n
1.1.12<\/h4>\n\n\n- Updated extension hook names and uninstall helper names to the long
tradeschoolmanager_<\/code> prefix used for Plugin Check inference.<\/li>\n<\/ul>\n\n1.1.11<\/h4>\n\n\n- Renamed core extension hooks to a registered plugin prefix for WordPress Plugin Check compliance.<\/li>\n
- Cleaned uninstall-only variable and helper names so the uninstall routine passes prefix checks.<\/li>\n<\/ul>\n\n
1.1.10<\/h4>\n\n\n- Updated the Add-ons settings screen to use stable Freemius license routes for Reports & Transcripts and Workshops.<\/li>\n<\/ul>\n\n
1.1.9<\/h4>\n\n\n- Resolved WordPress Plugin Check naming warnings for core teacher portal and grade-save hooks.<\/li>\n
- Cleaned uninstall helper naming to use the full TradeSchool Manager prefix.<\/li>\n
- Normalized the main plugin file line endings for repository checks.<\/li>\n<\/ul>\n\n
1.1.8<\/h4>\n\n\n- Added invoice context fields so add-ons can link invoices to a specific workshop instance or other future record.<\/li>\n<\/ul>\n\n
1.1.7<\/h4>\n\n\n- Moved the core class report into a Gradebook tab.<\/li>\n
- The dedicated Reports navigation now appears only when the Reports & Transcripts add-on is installed.<\/li>\n<\/ul>\n\n
1.1.6<\/h4>\n\n\n- Added teacher portal extension hooks for add-ons.<\/li>\n
- Enables the Workshops add-on to show assigned workshop dashboards inside the teacher portal.<\/li>\n<\/ul>\n\n
1.1.5<\/h4>\n\n\n- Improved the shared PDF engine so add-ons can render wide reports in landscape layout.<\/li>\n
- Aligned the plugin header version and runtime version constant.<\/li>\n<\/ul>\n\n
1.1.4<\/h4>\n\n\n- Moved Stripe setup out of core Settings navigation and pointed administrators to Invoicing > Stripe.<\/li>\n<\/ul>\n\n
1.1.3<\/h4>\n\n\n- Updated the Add-ons settings screen to use Freemius license popup triggers for inactive registered add-ons, matching the working Plugins screen activation flow.<\/li>\n<\/ul>\n\n
1.1.2<\/h4>\n\n\n- Improved the Add-ons settings screen so inactive Freemius add-ons point to license-key activation and show the correct inactive state.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Updated the Add-ons dashboard to use stable add-on license management pages instead of direct Freemius account URLs.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n