{"id":380338,"date":"2026-10-09T09:24:47","date_gmt":"2026-10-09T09:24:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/o-okak-staff-commission\/"},"modified":"2026-10-12T09:14:28","modified_gmt":"2026-10-12T09:14:28","slug":"o-okak-staff-commission","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/o-okak-staff-commission\/","author":23578045,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.11","stable_tag":"1.0.11","tested":"7.1.3","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"o_OKak Staff Commission","header_author":"o_OKak","header_description":"Provider compensation reporting for appointment-based businesses, with Amelia as the first supported source adapter.","assets_banners_color":"465652","last_updated":"2026-10-12 09:14:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/o-0kak.com\/staff-commission\/","header_author_uri":"https:\/\/o-0kak.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":125,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.10":{"tag":"1.0.10","author":"o0kak","date":"2026-10-11 07:54:16","revision":3739088},"1.0.11":{"tag":"1.0.11","author":"o0kak","date":"2026-10-12 09:14:28","revision":3740934},"1.0.8":{"tag":"1.0.8","author":"o0kak","date":"2026-10-09 09:24:39","revision":3736284}},"upgrade_notice":{"1.0.11":"<p>Makes the WordPress.org listing easier to understand before installation. Plugin behavior and calculations are unchanged.<\/p>","1.0.10":"<p>Groups Staff Commission with Slot Finder in the admin menu when both plugins are installed. No calculation or data changes.<\/p>","1.0.9":"<p>Makes the Staff Commission menu recognizable when multiple o_OKak plugins are installed; existing data and calculations are unchanged.<\/p>","1.0.8":"<p>Fixes Lite team-rate setup and history display. Install this update before configuring provider compensation rates.<\/p>","1.0.7":"<p>Final manual-review hardening for administrator-only background observation and accurate directory screenshots.<\/p>","1.0.6":"<p>Final WordPress.org review hardening: explicit bundled-font licensing, Lite-only presentation assets and WordPress 6.5 dependency enforcement.<\/p>","1.0.5":"<p>WordPress.org review hardening: Lite now contains only its fully functional free calculation\/runtime surface and no Pro-only calculation gating.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3736284,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3736284,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3736284,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3736284,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.10","1.0.11","1.0.8"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3736284,"resolution":"1","location":"assets","locale":"","width":1024,"height":722},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3736284,"resolution":"2","location":"assets","locale":"","width":1024,"height":722}},"screenshots":{"1":"Start with the current month: see completed procedures, team compensation, calculation coverage and providers that need attention.","2":"Review the monthly result by provider, including completed work, procedure revenue, compensation and calculation status."}},"plugin_section":[],"plugin_tags":[8132,5403,285300,3654,11420],"plugin_category":[],"plugin_contributors":[285301],"plugin_business_model":[],"class_list":["post-380338","plugin","type-plugin","status-publish","hentry","plugin_tags-appointments","plugin_tags-commission","plugin_tags-compensation","plugin_tags-reports","plugin_tags-staff","plugin_contributors-o0kak","plugin_committers-o0kak"],"banners":{"banner":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/banner-772x250.png?rev=3736284","banner_2x":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/banner-1544x500.png?rev=3736284","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/icon-128x128.png?rev=3736284","icon_2x":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/icon-256x256.png?rev=3736284","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/screenshot-1.png?rev=3736284","caption":"Start with the current month: see completed procedures, team compensation, calculation coverage and providers that need attention."},{"src":"https:\/\/ps.w.org\/o-okak-staff-commission\/assets\/screenshot-2.png?rev=3736284","caption":"Review the monthly result by provider, including completed work, procedure revenue, compensation and calculation status."}],"raw_content":"<!--section=description-->\n<p>Paying a team by percentage often means rebuilding the month by hand: which appointments finished, which rate applied, whether tax is included, and whose setup is missing.<\/p>\n\n<p>Staff Commission Lite turns completed Amelia appointments into a monthly compensation report. Set one dated percentage per provider, choose full price or price excluding tax, and Lite shows work, revenue, compensation, and Ready, Partial, or Pending coverage. It is fully functional, free and unlimited.<\/p>\n\n<p>Start in three steps: keep Amelia active, install Staff Commission, save provider rates under Team, then choose a month under Compensation.<\/p>\n\n<p>Staff Commission uses approved Amelia bookings after the appointment ends. It stores settings and protected history in separate o_OKak tables, never writes compensation back to Amelia, and sends no telemetry or license checks.<\/p>\n\n<p>Pro is a separate manual installation for businesses needing overrides, monthly tiers, drilldown, Analytics, exports and statements. Lite never downloads or unlocks Pro.<\/p>\n\n<p>Amelia is required as the booking source. o_OKak Staff Commission is independent and is not affiliated with or endorsed by Amelia or its publisher.<\/p>\n\n<h4>What Lite includes<\/h4>\n\n<ul>\n<li>Monthly provider compensation totals.<\/li>\n<li>Provider default percentage rules.<\/li>\n<li>Full-price or price-excluding-tax compensation basis.<\/li>\n<li>Effective-dated rate history so later changes do not rewrite earlier work.<\/li>\n<li>Protected historical Amelia source facts for completed procedures.<\/li>\n<li>Multi-location reporting and filtering when Amelia records appointment locations.<\/li>\n<li>Exact financial arithmetic and fail-closed handling when required source or tax facts are unresolved.<\/li>\n<li>Fixed Lite package-discount handling: the business absorbs package discounts when Lite calculates compensation.<\/li>\n<li>Current-month calculation coverage and clear Ready, Partial and Pending states.<\/li>\n<\/ul>\n\n<h4>Lite and Pro<\/h4>\n\n<p>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.<\/p>\n\n<p>Staff Commission Pro is distributed separately by o_OKak and replaces the same <code>o-okak-staff-commission<\/code> 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.<\/p>\n\n<p>Pro adds:<\/p>\n\n<ul>\n<li>Procedure-level calculation audit and explanations.<\/li>\n<li>Location, category, category-plus-location and service compensation overrides.<\/li>\n<li>Monthly turnover rate tiers.<\/li>\n<li>Effective-dated inherited package-discount policies.<\/li>\n<li>Analytics and period comparison.<\/li>\n<li>CSV export.<\/li>\n<li>Printable provider statements.<\/li>\n<li>Salon Retained reporting.<\/li>\n<\/ul>\n\n<p>Lite has no trial timer, usage quota or expiring free period.<\/p>\n\n<p>Lite never downloads, installs or updates to Pro. Pro must be obtained separately from o_OKak and manually installed by a WordPress administrator.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>The WordPress.org Lite package does not send usage analytics, telemetry or license checks to o_OKak.<\/p>\n\n<p>Links to documentation or Pro plans open o-0kak.com only after an administrator chooses them.<\/p>\n\n<h4>Amelia dependency<\/h4>\n\n<p>Staff Commission requires an active Amelia installation because Amelia supplies the appointments, providers, services and related source data used for compensation.<\/p>\n\n<p>The WordPress plugin dependency slug is <code>ameliabooking<\/code>. Amelia's free and commercial packages use the <code>ameliabooking<\/code> plugin directory.<\/p>\n\n<p>Amelia is a third-party product. o_OKak Staff Commission is independent and is not affiliated with or endorsed by Amelia or its publisher.<\/p>\n\n<h4>Documentation<\/h4>\n\n<p>Full user manual:\nhttps:\/\/o-0kak.com\/wiki\/staff-commission\/user-manual\/<\/p>\n\n<p>Product documentation:\nhttps:\/\/o-0kak.com\/wiki\/staff-commission\/<\/p>\n\n<p>Pro plans:\nhttps:\/\/o-0kak.com\/staff-commission\/pricing\/<\/p>\n\n<h3>Third-party resources<\/h3>\n\n<p>Manrope Variable Font<\/p>\n\n<ul>\n<li>Copyright 2018 The Manrope Project Authors<\/li>\n<li>License: SIL Open Font License, Version 1.1<\/li>\n<li>Source: https:\/\/github.com\/googlefonts\/manrope<\/li>\n<li>The complete license text is included in <code>assets\/fonts\/OFL-Manrope.txt<\/code>.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate Amelia if it is not already installed.<\/li>\n<li>Install and activate o_OKak Staff Commission.<\/li>\n<li>Open <code>o_OKak Staff Commission &gt; Team<\/code>.<\/li>\n<li>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.<\/li>\n<li>When a rate changes, save the new rate from its first day. Staff Commission keeps the earlier version in Rate history automatically.<\/li>\n<li>Repeat for team members whose completed work needs compensation coverage.<\/li>\n<li>Open <code>o_OKak Staff Commission &gt; Compensation<\/code> and choose a month to review the calculation.<\/li>\n<\/ol>\n\n<p>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.<\/p>\n\n<p>Always validate compensation settings against your own provider agreements, tax treatment and operating process before relying on a report operationally.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20calculate%20monthly%20staff%20commission%20from%20amelia%20appointments%20with%20lite%3F\"><h3>Can I calculate monthly staff commission from Amelia appointments with Lite?<\/h3><\/dt>\n<dd><p>Yes. Save one dated default percentage for each provider, then review approved, completed Amelia appointments in the monthly Compensation report. Lite shows completed work, revenue, compensation and setup coverage without a trial or usage quota.<\/p><\/dd>\n<dt id=\"does%20lite%20stop%20working%20after%20a%20trial%20period%3F\"><h3>Does Lite stop working after a trial period?<\/h3><\/dt>\n<dd><p>No. Lite has no trial timer, usage quota or paid unlock for functionality contained in the WordPress.org package.<\/p><\/dd>\n<dt id=\"does%20staff%20commission%20change%20amelia%20data%3F\"><h3>Does Staff Commission change Amelia data?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"which%20amelia%20work%20counts%20for%20compensation%3F\"><h3>Which Amelia work counts for compensation?<\/h3><\/dt>\n<dd><p>Staff Commission uses approved Amelia bookings whose appointment has ended. Customer payment or deposit timing is not the compensation trigger.<\/p><\/dd>\n<dt id=\"how%20do%20i%20change%20a%20team%20member%27s%20percentage%3F\"><h3>How do I change a team member's percentage?<\/h3><\/dt>\n<dd><p>Open <code>o_OKak Staff Commission &gt; Team<\/code>, 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.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20amelia%20changes%20after%20a%20procedure%20was%20completed%3F\"><h3>What happens if Amelia changes after a procedure was completed?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"does%20staff%20commission%20support%20multiple%20amelia%20locations%3F\"><h3>Does Staff Commission support multiple Amelia locations?<\/h3><\/dt>\n<dd><p>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.<\/p>\n\n<p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20my%20data%20if%20i%20later%20install%20pro%3F\"><h3>What happens to my data if I later install Pro?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20later%20return%20from%20pro%20to%20lite%3F\"><h3>What happens if I later return from Pro to Lite?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"does%20lite%20send%20data%20to%20o_okak%3F\"><h3>Does Lite send data to o_OKak?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"is%20staff%20commission%20payroll%20software%3F\"><h3>Is Staff Commission payroll software?<\/h3><\/dt>\n<dd><p>No. Staff Commission calculates and explains provider compensation. It does not make bank payments, run payroll, or require a month-close \/ approve \/ paid workflow.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.11<\/h4>\n\n<ul>\n<li>Rewrites the directory introduction around the monthly staff-compensation problem, the free Lite workflow and a three-step start.<\/li>\n<li>Clarifies the Amelia dependency, independent product status and separately installed Pro boundary within the first 200 words.<\/li>\n<li>Makes the real Overview and Compensation screenshot captions explain the monthly workflow.<\/li>\n<li>Keeps the focused five-tag set after checking WordPress.org tag relevance; no runtime or calculation behavior changes.<\/li>\n<\/ul>\n\n<h4>1.0.10<\/h4>\n\n<ul>\n<li>Keeps Staff Commission immediately below Slot Finder in the WordPress admin menu when both are installed.<\/li>\n<li>Leaves all other menu items in their existing order; compensation, history, permissions and page addresses are unchanged.<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>Names the WordPress admin menu <code>o_OKak Staff Commission<\/code> so it remains clear beside other o_OKak products.<\/li>\n<li>Keeps the Overview, Compensation and Team pages, admin slugs, permissions and Lite calculation behavior unchanged.<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Fixes Lite provider-rate queries so existing compensation history is read and new rates can be saved on MySQL.<\/li>\n<li>Replaces the manual end-rate control with a clear current rate, change-from-date workflow and visible rate history.<\/li>\n<li>Keeps earlier calculations and stored Pro-era rule data unchanged when Lite creates a later provider-default rate.<\/li>\n<li>Adds a regression fixture for real provider history, automatic version boundaries and valid MySQL identifiers.<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Restricts the hourly historical-source observation to full administrators on normal admin requests.<\/li>\n<li>Removes an outdated Team directory screenshot instead of presenting UI that no longer matches Lite.<\/li>\n<li>Escapes the remaining dynamic CSS-state attributes in the Lite overview.<\/li>\n<li>Keeps compensation arithmetic, effective-dated rules and protected Amelia history unchanged.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Declares the bundled Manrope font copyright, SIL OFL 1.1 license and upstream source.<\/li>\n<li>Removes unused Pro-only and preview presentation assets from the WordPress.org package.<\/li>\n<li>Moves administrator-initiated documentation and pricing links to the Lite admin namespace; no commercial runtime is included.<\/li>\n<li>Requires WordPress 6.5 so WordPress core can enforce the declared Amelia dependency.<\/li>\n<li>Keeps the complete Lite provider-default calculation, effective-dated history, source protection and location reporting behavior unchanged.<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Removes Pro-only compensation-rule and package-policy calculation code from the WordPress.org Lite package instead of gating it.<\/li>\n<li>Fixes fresh Lite installation so it never queries Pro-only service\/location rule tables.<\/li>\n<li>Keeps Lite fully functional with provider-default rules, monthly compensation, source-history protection and location reporting.<\/li>\n<li>Adds review hardening to ensure future Lite packages cannot accidentally include commercial licensing or Pro-only calculation runtime.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Aligns the translation text domain with the public WordPress plugin slug.<\/li>\n<li>Declares Amelia (<code>ameliabooking<\/code>) as the required WordPress plugin dependency.<\/li>\n<li>Corrects Lite installation guidance so first-time setup uses the Lite provider-default workflow.<\/li>\n<li>Polishes the public WordPress.org readme for the current Lite\/Pro product boundary.<\/li>\n<li>Does not change compensation arithmetic, rate precedence, package economics, tax handling or historical calculation semantics.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Adds restrained Documentation and Explore Pro links to Lite.<\/li>\n<li>Adds contextual Pro actions only where Lite reaches a feature boundary.<\/li>\n<li>Removes stale Lite copy referring to the retired closing workflow.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First stable public\/commercial Staff Commission release.<\/li>\n<li>Promotes the accepted pre-1.0 product line without changing compensation mathematics or historical semantics.<\/li>\n<\/ul>","raw_excerpt":"Calculate monthly provider compensation from completed Amelia appointments with dated percentage rules and clear coverage.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/380338","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=380338"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/o0kak"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=380338"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=380338"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=380338"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=380338"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=380338"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=380338"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}