Description
o_OKak Staff Commission helps appointment-based businesses calculate and review provider compensation from completed work recorded in Amelia.
Staff Commission Lite is a complete, unlimited free plugin. It includes:
- Monthly provider compensation totals.
- Provider default percentage rules.
- Full-price or price-excluding-tax compensation basis.
- Effective-dated rate history so later changes do not rewrite earlier work.
- Protected historical Amelia source facts for completed procedures.
- Multi-location reporting and filtering when Amelia records appointment locations.
- Exact financial arithmetic and fail-closed handling when required source or tax facts are unresolved.
- Fixed Lite package-discount handling: the business absorbs package discounts when Lite calculates compensation.
- Current-month calculation coverage and clear Ready, Partial and Pending states.
Staff Commission reads Amelia data and stores its compensation configuration and protected history in separate o_OKak tables. It does not modify Amelia core files and does not write compensation back into Amelia.
Lite and Pro
Lite contains only the free product runtime. Commercial licensing and Pro-only calculation, configuration, Analytics, export and statement code are not included in the WordPress.org package.
Staff Commission Pro is distributed separately by o_OKak and replaces the same o-okak-staff-commission plugin directory in place. Lite and Pro use the same plugin directory and preserve Staff Commission data when one replaces the other. Lite calculates only its free provider-default rule model; Pro-only rule semantics are implemented only in the separately distributed Pro package.
Pro adds:
- Procedure-level calculation audit and explanations.
- Location, category, category-plus-location and service compensation overrides.
- Monthly turnover rate tiers.
- Effective-dated inherited package-discount policies.
- Analytics and period comparison.
- CSV export.
- Printable provider statements.
- Salon Retained reporting.
Lite has no trial timer, usage quota or expiring free period.
Lite never downloads, installs or updates to Pro. Pro must be obtained separately from o_OKak and manually installed by a WordPress administrator.
Privacy
The WordPress.org Lite package does not send usage analytics, telemetry or license checks to o_OKak.
Links to documentation or Pro plans open o-0kak.com only after an administrator chooses them.
Amelia dependency
Staff Commission requires an active Amelia installation because Amelia supplies the appointments, providers, services and related source data used for compensation.
The WordPress plugin dependency slug is ameliabooking. Amelia’s free and commercial packages use the ameliabooking plugin directory.
Amelia is a third-party product. o_OKak Staff Commission is independent and is not affiliated with or endorsed by Amelia or its publisher.
Documentation
Full user manual:
https://o-0kak.com/wiki/staff-commission/user-manual/
Product documentation:
https://o-0kak.com/wiki/staff-commission/
Pro plans:
https://o-0kak.com/staff-commission/pricing/
Third-party resources
Manrope Variable Font
- Copyright 2018 The Manrope Project Authors
- License: SIL Open Font License, Version 1.1
- Source: https://github.com/googlefonts/manrope
- The complete license text is included in
assets/fonts/OFL-Manrope.txt.
Screenshots
Installation
- Install and activate Amelia if it is not already installed.
- Install and activate o_OKak Staff Commission.
- Open
o_OKak > Team. - Choose a team member, enter the percentage, select whether it is calculated from the full price or the price excluding tax, and choose the first day the rate applies.
- When a rate changes, save the new rate from its first day. Staff Commission keeps the earlier version in Rate history automatically.
- Repeat for team members whose completed work needs compensation coverage.
- Open
o_OKak > Compensationand choose a month to review the calculation.
If Lite replaces an existing Pro installation, Staff Commission data remains stored, but Lite does not interpret Pro-only rule or package-policy semantics. Reinstall Pro to review periods that depend on Pro-only configuration.
Always validate compensation settings against your own provider agreements, tax treatment and operating process before relying on a report operationally.
FAQ
-
Does Lite stop working after a trial period?
-
No. Lite has no trial timer, usage quota or paid unlock for functionality contained in the WordPress.org package.
-
Does Staff Commission change Amelia data?
-
No. Staff Commission reads Amelia as its booking source and stores o_OKak compensation configuration/history separately. It does not modify Amelia core code or write compensation back into Amelia.
-
Which Amelia work counts for compensation?
-
Staff Commission uses approved Amelia bookings whose appointment has ended. Customer payment or deposit timing is not the compensation trigger.
-
How do I change a team member’s percentage?
-
Open
o_OKak > Team, choose the team member, enter the new percentage and select the first day it should apply. Save the rate from that date. The previous rate stays in Rate history, and completed work continues to use the rate that applied on its own date. -
What happens if Amelia changes after a procedure was completed?
-
Staff Commission protects the recorded Amelia facts used for completed procedures. Later Amelia changes can apply to later procedures, including later procedures in the same month, without silently rewriting earlier compensation history.
-
Does Staff Commission support multiple Amelia locations?
-
Yes. Lite can report and filter completed work by the recorded Amelia location. Pro additionally supports effective-dated location and category-plus-location compensation rules.
Location filtering does not create a separate rounding calculation. Staff Commission first calculates authoritative provider compensation and then allocates already-rounded compensation to location views so the totals reconcile.
-
What happens to my data if I later install Pro?
-
Pro uses the same plugin directory and shared Staff Commission data model. It is designed to replace Lite in place, preserving Staff Commission settings and history.
-
What happens if I later return from Pro to Lite?
-
Shared Staff Commission data remains. Lite uses only its provider-default calculation model and does not execute Pro-only rule or package-policy logic. Reinstall Pro to review historical periods that depend on Pro-only configuration.
-
Does Lite send data to o_OKak?
-
No automatic telemetry, analytics or license checks are sent by the WordPress.org Lite package. Administrator-initiated documentation and Pro links open the o_OKak website in the browser.
-
Is Staff Commission payroll software?
-
No. Staff Commission calculates and explains provider compensation. It does not make bank payments, run payroll, or require a month-close / approve / paid workflow.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“o_OKak Staff Commission” is open source software. The following people have contributed to this plugin.
Contributors
Translate “o_OKak Staff Commission” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.8
- Fixes Lite provider-rate queries so existing compensation history is read and new rates can be saved on MySQL.
- Replaces the manual end-rate control with a clear current rate, change-from-date workflow and visible rate history.
- Keeps earlier calculations and stored Pro-era rule data unchanged when Lite creates a later provider-default rate.
- Adds a regression fixture for real provider history, automatic version boundaries and valid MySQL identifiers.
1.0.7
- Restricts the hourly historical-source observation to full administrators on normal admin requests.
- Removes an outdated Team directory screenshot instead of presenting UI that no longer matches Lite.
- Escapes the remaining dynamic CSS-state attributes in the Lite overview.
- Keeps compensation arithmetic, effective-dated rules and protected Amelia history unchanged.
1.0.6
- Declares the bundled Manrope font copyright, SIL OFL 1.1 license and upstream source.
- Removes unused Pro-only and preview presentation assets from the WordPress.org package.
- Moves administrator-initiated documentation and pricing links to the Lite admin namespace; no commercial runtime is included.
- Requires WordPress 6.5 so WordPress core can enforce the declared Amelia dependency.
- Keeps the complete Lite provider-default calculation, effective-dated history, source protection and location reporting behavior unchanged.
1.0.5
- Removes Pro-only compensation-rule and package-policy calculation code from the WordPress.org Lite package instead of gating it.
- Fixes fresh Lite installation so it never queries Pro-only service/location rule tables.
- Keeps Lite fully functional with provider-default rules, monthly compensation, source-history protection and location reporting.
- Adds review hardening to ensure future Lite packages cannot accidentally include commercial licensing or Pro-only calculation runtime.
1.0.4
- Aligns the translation text domain with the public WordPress plugin slug.
- Declares Amelia (
ameliabooking) as the required WordPress plugin dependency. - Corrects Lite installation guidance so first-time setup uses the Lite provider-default workflow.
- Polishes the public WordPress.org readme for the current Lite/Pro product boundary.
- Does not change compensation arithmetic, rate precedence, package economics, tax handling or historical calculation semantics.
1.0.1
- Adds restrained Documentation and Explore Pro links to Lite.
- Adds contextual Pro actions only where Lite reaches a feature boundary.
- Removes stale Lite copy referring to the retired closing workflow.
1.0.0
- First stable public/commercial Staff Commission release.
- Promotes the accepted pre-1.0 product line without changing compensation mathematics or historical semantics.