CleanRoster
Free WordPress plugin by axistudio
Manage customers, cleaning jobs, staff, quotes, invoices, recurring visits and reports from your WordPress site. Account and authentication behavior CleanRoster customer and staff portals require Wor…
About CleanRoster
CleanRoster 1.0.5 is a free WordPress plugin by axistudio. It is active on 0 WordPress sites. The latest version is 1.0.5, last updated on 18 Nov 2026. You can download it free from WordPress.org — no account or payment needed.
Manage customers, cleaning jobs, staff, quotes, invoices, recurring visits and reports from your WordPress site.
Account and authentication behavior
CleanRoster customer and staff portals require WordPress user accounts so WordPress core can manage password hashing, password reset, roles, authentication filters, and compatibility with site security plugins. Staff accounts are created only by users with CleanRoster management permissions and a valid WordPress nonce. Customer self-registration is an explicit portal feature, protected by a WordPress nonce, input validation, password requirements, and IP-based rate limiting. Portal sign-in uses wp_signon() so WordPress authentication hooks and security controls can participate. Customer and staff accounts receive dedicated, limited CleanRoster roles. CleanRoster does not delete WordPress user accounts when a CleanRoster record is removed or an account-linking operation fails.
Features
- Customer management for residential and commercial accounts.
- Multiple service properties per customer, including addresses and access notes.
- Job scheduling, assignment, status tracking and job instructions.
- Edit existing customer, property, staff and job records from their directory/list rows.
- Reusable per-job cleaning checklists.
- Restricted cleaning staff accounts and a front-end staff portal for assigned work.
- Customer portal with a responsive dashboard, default sign-in page, separate self-registration, service requests, saved properties, service history, quote review, invoices and online payment actions.
- Customers can edit their own requests while they remain Requested or Scheduled. Scheduled edits update service details/location but never change the confirmed arrival/departure times or assigned cleaner; preferred date/time can be changed only before scheduling.
- Service progress cards display request time, assigned cleaner, scheduling milestones, expected arrival/departure and estimated time on site based on scheduled start/end.
- Customer portal sidebar switches between focused overview, services, properties, billing, quotes and request views.
- Quote records with draft, sent, approved and declined statuses.
- Invoice records, partial payments, payment history and outstanding balances.
- Invoice payment actions are displayed prominently on each unpaid invoice card, without requiring the customer to expand invoice details; the action is also repeated inside the expanded invoice view.
- External payment portal mode shows a customer-specific, nonce-protected Pay now link only when the business has configured a valid HTTPS payment URL. WooCommerce mode shows a nonce-protected checkout form when WooCommerce and matching currency are available. Manual mode displays the configured payment instructions.
- Unconfigured online payment modes show a visible explanation instead of silently omitting the payment action. Fully paid invoices show a paid-in-full state and no further payment button.
- Customer invoice detail views with invoice totals, amount paid, outstanding balance, due date, payment history and a Pay now action.
- Per-site payment settings: WooCommerce checkout, an external HTTPS hosted payment portal URL template, or manual payment instructions. Each cleaning company configures its own payment destination under CleanRoster > Payment settings.
- External payment URLs can receive invoice number/reference, remaining amount, total, paid amount, currency, customer name/email and invoice description through documented placeholders. WooCommerce remains available for automatic payment reconciliation when a supported gateway is configured.
- Service contracts and recurring cleaning schedules.
- Automatic recurring job creation through WordPress scheduled tasks.
- Configurable email notifications for job scheduling and assignments, upcoming-job reminders, quotes, invoices, payment receipts and quote responses.
- Email Notifications admin page with per-event on/off controls and a test email action, including new-request notifications to the administrator and request confirmations to customers.
- Excel .xlsx report workbooks with a business summary sheet and a selected records sheet for the chosen date range.
- Expense tracking for supplies, equipment, transport, contractors and other operating costs.
- Dashboard with operational counts, outstanding balances and monthly cash summaries.
- Redesigned CleanRoster administrator workspace with modern page headers, responsive metric cards, clean forms and consistent data tables.
- Redesigned staff portal with a matching blue navigation rail, assigned-work overview, active/completed job metrics, upcoming visit summary, access/instruction cards, job checklist and responsive status-update forms.
- Staff portal retains strict assignment-scoped job visibility and the existing nonce-protected job/checklist update handlers; staff cannot edit assignments or access the administrator workspace.
- Date-range business reports and Excel .xlsx exports for customers, properties, jobs, invoices, payments and expenses.
- WordPress personal-data exporter and eraser integration for customer contact data.
- Configurable currency and WordPress timezone support.
- Existing CleanRoster 2.x database tables are retained and upgraded in place.
Recurring schedules and email
Recurring schedules are processed by WP-Cron. WordPress cron runs when the site receives traffic, so low-traffic sites should configure a real server cron to call wp-cron.php at a regular interval. Email delivery uses wp_mail(); open CleanRoster > Email notifications to choose which events send email and send a test message. Configure authenticated SMTP or a transactional email provider before relying on reminders. Reminders are scheduled hourly for jobs roughly 24–25 hours ahead; WP-Cron requires site traffic unless a real server cron is configured. Reminder emails are marked sent only after at least one recipient accepts the mail request.
Important scope notes
- CleanRoster is designed for one cleaning company per WordPress installation. It is not a hosted multi-tenant SaaS dashboard.
- WooCommerce checkout can create a site-local order and reconcile successful payments through WooCommerce payment-complete events. An external hosted payment URL redirects the customer to the provider but does not automatically confirm or reconcile payment; the business must verify receipt and record the payment in CleanRoster unless a separately developed, verified provider webhook is installed. Manual mode displays the business’s payment instructions. Gateway availability, fees, payment methods and regional eligibility depend on the provider. CleanRoster never stores card details.
- PDF invoice generation, provider-specific signed API integrations/webhooks for arbitrary external payment portals, SMS, route optimization, GPS tracking, time-clock/payroll, inventory purchasing, accounting/tax filing, multi-branch consolidation and third-party calendar sync are not included in this release.
- Cash reports summarize payments recorded in CleanRoster less expenses entered in CleanRoster. They are not accrual accounting, tax statements or a substitute for an accounting system.
- Customer and staff portals require WordPress user accounts. New customers can self-register from the portal; the plugin creates a restricted customer-role account and a linked CleanRoster customer record. Existing customer records can also be linked to an account.
- The plugin stores names, contact details, service addresses, access instructions, job details and financial records in the site’s database. The site owner is responsible for backups, user permissions, retention periods, privacy notices and applicable privacy laws.
- The WordPress privacy eraser anonymizes customer contact details and clears identifying property details, job instructions, quote/invoice descriptions and contract notes. Financial amounts and payment records are retained for business recordkeeping; confirm retention requirements before processing a request.
- Always test on a staging site before using it for live operations. No software can be certified against every WordPress theme, plugin, host or mail provider without testing in that environment.
Upgrade notes
Version 4.0.9 keeps the existing cleanops_ customer, property, job, quote, invoice, contract, recurring, expense, payment-history and job-checklist tables. No business table data is deleted by this update. Back up before updating. Deactivating the plugin does not delete business records. Uninstalling is not intended to erase the business database automatically.
Privacy
CleanRoster does not send customer or business records to an external CleanRoster server. Email notifications are sent through the WordPress site’s configured mail service. Excel workbooks are generated by the local WordPress site and should be handled as confidential business data.
Customer portal accounts in 4.0.5
When adding a customer, select “Create customer portal login and email a secure password-setup link”. For an existing customer without a linked account, open Edit and select the same option. CleanRoster creates a WordPress user with the restricted Cleaning Customer role and links the user ID to the customer record. WordPress sends the new user its password-setup email. Existing WordPress accounts with another role are never silently linked. The customer signs in at the normal WordPress login URL and opens the page containing [cleanops_portal].
4.0.6
- Added customer self-registration through the public CleanRoster Portal shortcode.
- New customers can create their own WordPress customer account and optional first service location.
- Signed-in customers can submit service requests, choose one of their own saved properties, or add a new service location.
- Requests are saved as Requested jobs for the cleaning company to review in the Jobs screen.
4.0.7
- Fixed customer self-registration being rejected when browsers or password managers autofilled the hidden anti-spam field.
- Retained WordPress nonce verification, input validation, password confirmation and duplicate-email checks.
4.0.9
- Redesigned the signed-in customer portal with a responsive blue sidebar, customer overview, service and request summary, next-service panel, billing snapshot, service history, properties, quote actions and invoice payment actions.
- Added real-time summary values from the signed-in customer’s own CleanRoster records. No other customer’s records are queried or rendered.
- Kept all customer actions connected to existing WordPress admin-post handlers and customer-scoped database queries.
- Added responsive layout for tablets and mobile screens.
4.0.8
- Changed the public CleanRoster Portal’s default unauthenticated view to a dedicated email/username and password login form.
- Added a clear “Don’t have an account? Create an account” link that opens the existing registration form separately.
- Added a return link from registration to sign-in and retained password reset access.
- Added a portal login handler that accepts either email address or WordPress username and only allows CleanRoster customer or cleaning-staff roles into the portal.
4.1.0
- Expanded the customer dashboard across the available desktop viewport with 24px side gutters, escaping narrow theme content containers.
- Preserved the responsive tablet/mobile layout and left the surrounding WordPress theme layout unchanged.
4.1.1
- Customer service cards now show the request submission time, assigned cleaner, current progress milestones, expected arrival, expected departure, and estimated time on site calculated from the scheduled start/end times.
- Customers can edit their own requests while the request remains in Requested status; edits are checked against the signed-in customer record and property ownership.
- Customers can add a new service location when editing a pending request and can set an optional preferred date and time when submitting or editing a request.
- Customer portal sidebar items now switch between focused dashboard views instead of scrolling through a single long page.
- Job scheduling, staff assignment, start and completion milestone timestamps are stored for new status changes.
- Existing job data is preserved; the jobs table is upgraded in place with dbDelta.
4.1.3
- Added customer-side editing for saved service properties, restricted to the authenticated customer’s own property records.
- Made the Edit request action more visible on requests that are still awaiting review.
- Made overview metric cards clickable links to services, properties and billing views.
4.1.3
- Fixed the missing service edit control on Scheduled customer jobs: the 4.1.2 rendering condition had only displayed the button for Requested jobs.
- Moved the edit action beside the status at the top of eligible service cards.
- Scheduled customers can update service type, service location, request title and instructions. Confirmed appointment times and staff assignment are protected.
- Edit saves verify login, nonce, linked-customer ownership, property ownership and unchanged job status. Admin and assigned staff can be notified of changes.
- In-progress, completed and cancelled services display a clear editing restriction.
4.1.4
- Added per-site customer payment settings: WooCommerce checkout, an external HTTPS payment portal URL template, or manual instructions. Settings are stored locally by each WordPress installation.
- Added supported invoice URL placeholders for invoice number/id/reference, outstanding amount/balance, total, paid amount, currency, customer name/email and description. Values are URL-encoded.
- Added a customer-scoped external-payment redirect with nonce, linked-customer ownership, unpaid-balance and HTTPS destination validation.
- Expanded customer invoice cards with a detailed invoice view, amount breakdown, due date, payment history, payment instructions and Pay now action.
- Kept WooCommerce checkout as an option for businesses that want supported automatic payment reconciliation. External hosted payment links do not automatically reconcile payments; businesses must confirm and record external payments unless they build a verified provider webhook integration.
- Added Payment settings under CleanRoster. No customer payment credentials or financial data are sent to a CleanRoster central server.
Version 4.1.6
- Removed the duplicate WordPress theme page title on pages containing the CleanRoster Portal shortcode, using a scoped body class so unrelated pages are unchanged.
- Refreshed customer dashboard typography with a modern system sans-serif stack and stronger heading hierarchy.
- Restyled sidebar navigation links to remove underlines and retain white default text on the blue sidebar, with a clear high-contrast active state.
- Scoped presentation updates to the CleanRoster portal and preserved existing customer, staff, invoice and service workflows.
Questions about CleanRoster
Is CleanRoster free?
Yes. CleanRoster is free to download and use from the official WordPress.org directory. There is no payment and no account needed — the download on this page goes straight to WordPress.org.
What is the latest version of CleanRoster?
The latest version is 1.0.5, last updated on 18 Nov 2026.
How popular is CleanRoster?
It is active on 0 WordPress sites.
How do I install CleanRoster?
From your WordPress dashboard, go to Plugins → Add New, search for CleanRoster, then Install and Activate. You can also download the ZIP from WordPress.org and upload it under Plugins → Add New → Upload Plugin.
Where do I download CleanRoster?
Directly from WordPress.org. The Download button on this page goes straight to the official WordPress.org download, and GPLWPClub does not store the file.