Deftcoders

<p><strong>DeftCoders – Discount & Fee Rules</strong> is a condition-driven pricing engine for WooCommerce. You build rules, each rule has conditions (when it fires) and an action (what it does). When a customer visits the cart or checkout, every active rule is evaluated automatically — fees and discounts are applied without any coupon codes or manual work.</p>
<p>Rules run in priority order. A “Stop Further Rules” flag lets any rule break the chain once it fires, giving you full control over stacking and exclusivity.</p>
<h4>What You Can Do: Real Examples</h4>
<ul>
<li>Add a $3.00 handling fee on orders under $50 — with a custom message telling the customer how to avoid it</li>
<li>Charge a 2% surcharge when Cash on Delivery is selected at checkout</li>
<li>Apply 10% off automatically every Saturday and Sunday</li>
<li>Give users with the “wholesale” role 15% off every order</li>
<li>Run a tiered bulk deal: 5–9 items get 10% off, 10–19 get 15% off, 20+ get 20% off</li>
<li>Activate a flash sale between two specific dates without touching any code</li>
<li>Add an international processing fee for customers in certain countries</li>
</ul>
<h4>5 Action Types</h4>
<p><strong>Fee Rules</strong> add charges to the cart:</p>
<ul>
<li><strong>Fixed Fee</strong> — a flat currency amount (e.g. $3.00). Optional taxable toggle. Optional custom message shown at checkout explaining the fee.</li>
<li><strong>Percentage Fee</strong> — calculated as a percentage of the cart subtotal (e.g. 2%). Optional taxable toggle.</li>
</ul>
<p><strong>Discount Rules</strong> reduce what the customer pays:</p>
<ul>
<li><strong>Percentage Discount</strong> — percentage off the cart subtotal (e.g. 10%). Can apply to the full cart or product subtotal only. Stackable or non-stackable mode.</li>
<li><strong>Fixed Discount</strong> — flat currency amount off (e.g. $5.00). Always capped at the cart total to prevent a negative balance.</li>
<li><strong>Tiered Discount</strong> — a different percentage for each quantity bracket (e.g. 5–9 items: 10%, 10–19 items: 15%, 20+ items: 20%). The matching tier label displays in the cart.</li>
</ul>
<h4>14 Condition Types</h4>
<p>All conditions on a rule must match simultaneously (AND logic). Combine as many as needed.</p>
<p><strong>Cart & Order</strong></p>
<ul>
<li><strong>Cart Total</strong> — equals, not equals, greater than, greater than or equal, less than, less than or equal</li>
<li><strong>Cart Subtotal</strong> — same operators; evaluates before fees are applied</li>
<li><strong>Cart Quantity</strong> — total item count; same numeric operators</li>
</ul>
<p><strong>Customer & Checkout</strong></p>
<ul>
<li><strong>Payment Method</strong> — equals, not equals, contains, does not contain</li>
<li><strong>Shipping Method</strong> — equals, not equals, contains, does not contain</li>
<li><strong>User Role</strong> — is one of / is not one of; “Guest” is supported for logged-out shoppers</li>
<li><strong>Country</strong> — equals, not equals, contains, does not contain (shipping country, falls back to billing)</li>
<li><strong>State / Province</strong> — same operators (shipping state, falls back to billing)</li>
<li><strong>Coupon Applied</strong> — is one of / is not one of</li>
</ul>
<p><strong>Products</strong></p>
<ul>
<li><strong>Product</strong> — is one of / is not one of; matches product ID and variation ID</li>
<li><strong>Product Category</strong> — is one of / is not one of; uses a single batched query for all cart items</li>
</ul>
<p><strong>Date & Time</strong> (all use your WordPress site timezone)</p>
<ul>
<li><strong>Day of Week</strong> — is one of / is not one of; Monday through Sunday</li>
<li><strong>Time Range</strong> — active between a start time and end time (HH:MM format)</li>
<li><strong>Date Range</strong> — active between a start date and end date (YYYY-MM-DD format)</li>
</ul>
<h4>Per-Rule Settings</h4>
<ul>
<li><strong>Priority</strong> — integer from 1 to 9999; lower number runs first. Drag rows in the rules list to reorder without typing.</li>
<li><strong>Status</strong> — Active or Inactive; toggle without deleting. Pre-build rules and switch them on when ready.</li>
<li><strong>Stop Further Rules</strong> — when this rule fires, no lower-priority rules are evaluated at all.</li>
<li><strong>Optional Label</strong> — overrides the cart line-item label shown to the customer (defaults to the rule name).</li>
</ul>
<h4>Admin Dashboard</h4>
<p>The rules list page shows <strong>8 live stat cards</strong> at the top: Total Rules, Active Rules, Inactive Rules, Discount Rules, Fee Rules, Fee Revenue this month, Discounts Given this month, and all-time Net Impact (fee revenue minus discounts). The revenue figures come from completed and processing orders tracked automatically.</p>
<p>The rules table shows 10 rules per page with full pagination. Each row shows the rule name, type badge, conditions summary, fee/discount amount, priority number, a live status toggle, and Edit/Delete buttons. Drag any row to reorder priority. A search box filters by rule name in real time. Two dropdowns filter the list by condition type or rule type.</p>
<p>Bulk actions at the bottom let you <strong>Activate</strong>, <strong>Deactivate</strong>, <strong>Delete</strong>, or <strong>Export</strong> any selection of rules in one click.</p>
<h4>Rule Simulator</h4>
<p>Test any combination of your rules without touching a real cart. Enter a simulated cart — subtotal, item count, payment method, shipping method, user role, country, coupon code, date, and time — then click Run. The results panel shows every active rule, whether it matched, which conditions were satisfied (or which one failed), the calculated amount, and a complete cart summary: subtotal, total fees, total discounts, and final total. Nothing is written to any real session or order.</p>
<h4>Debug Tools</h4>
<p><strong>Preview Mode</strong> — enable in Settings to run the full rule evaluation engine on every real cart request, but apply nothing to any actual cart. Safe to use on a live production store.</p>
<p><strong>Debug Mode</strong> — writes timestamped log entries to <code>wp-content/uploads/wcdpdr-logs/</code>. One file per day. Each entry shows the cart state at evaluation time, every rule evaluated (conditions met or not, amount applied), any Stop Further Rules trigger, and any execution error. Logs are viewable from the <strong>Debug Logs</strong> admin page and can be cleared with one click. The log directory is protected from direct browser access by a <code>.htaccess</code> file written automatically on first use.</p>
<h4>Import / Export</h4>
<p>Export all rules — or a selected subset via bulk export — to a JSON file. Import on any site. Every rule is validated before saving and all fields are sanitised. The 5-rule free limit is respected automatically; imports are trimmed to available slots.</p>
<h4>Clean Uninstall</h4>
<p>When you delete the plugin via the WordPress admin, it removes everything it created: both database tables, all plugin options, all transients, and the entire log directory. On Multisite, cleanup runs for every sub-site.</p>
<h4>Performance</h4>
<p>Active rules are cached in a 60-second WordPress transient; no database query fires on each cart recalculation. The cache busts immediately whenever a rule is saved, deleted, or its status toggled. Product category conditions use a single batched query across all cart products rather than one query per line item.</p>
<h4>Compatibility</h4>
<ul>
<li><strong>WooCommerce HPOS</strong> — full compatibility declared via <code>FeaturesUtil::declare_compatibility()</code>; all order reads/writes use the WooCommerce order object API</li>
<li><strong>Multisite</strong> — clean uninstall handles every sub-site</li>
<li><strong>WPML</strong> — detected automatically; status shown on the Settings page</li>
<li><strong>PHP 8.x</strong> — tested on PHP 8.0, 8.1, and 8.2</li>
<li><strong>Tax-inclusive stores</strong> — discount and fee bases use the tax-inclusive subtotal when your store displays prices with tax; tax-exclusive stores use the subtotal without tax</li>
<li>All amounts normalised via <code>wc_format_decimal()</code> and rounded with <code>wc_round_tax_total()</code></li>
</ul>


DeftCoders – Discount & Fee Rules for WooCommerce

Automatically add fees and apply discounts in WooCommerce based on cart, payment method, user role, date, time, and location. No coupon codes needed.

scholabook

<p><strong>ScholaBook</strong> integrates your school’s WordPress website with the <a href="https://scholabook.com" rel="nofollow ugc">ScholaBook</a> school management platform. It provides parents and visitors with real-time access to essential school information — all powered by secure API connectivity.</p>
<p>This plugin communicates with the ScholaBook SaaS platform via its REST API. An active ScholaBook account is required. By using this plugin you agree to ScholaBook’s <a href="https://scholabook.com/terms-and-conditions" rel="nofollow ugc">Terms and Conditions</a> and <a href="https://scholabook.com/privacy-policy" rel="nofollow ugc">Privacy Policy</a>.</p>
<h4>Features</h4>
<ul>
<li><strong>School Information Widget & Shortcode</strong> — Display your school’s name, logo, tagline, board affiliation, and contact details.</li>
<li><strong>Fee Dues Lookup</strong> — Parents can check pending fees using their ward’s admission number and registered mobile number. No login required.</li>
<li><strong>Fee Summary & Receipts</strong> — Authenticated parents see a detailed breakdown of fees by category, payment history, and can reference receipt details.</li>
<li><strong>Attendance Summary</strong> — Parents can view their child’s attendance percentage and summary.</li>
<li><strong>Holiday Calendar</strong> — Display the academic year’s holidays publicly on your website.</li>
<li><strong>Notice Board</strong> — Publish school announcements from ScholaBook directly on your WordPress site.</li>
<li><strong>Parent Portal with OTP Login</strong> — Parents log in securely using a mobile OTP, then access a mini-dashboard with fees and attendance at a glance.</li>
<li><strong>Unified Parent Portal</strong> — A single, modern portal page (auto-created on activation) powered by a Preact SPA. Parents log in via OTP and navigate between dashboard, fees, receipts, and attendance — all within one page using hash-based routing.</li>
<li><strong>Module Toggle</strong> — Enable or disable individual features from the admin panel.</li>
<li><strong>Connection Diagnostics</strong> — Built-in connectivity test to verify your ScholaBook API connection.</li>
</ul>
<h4>Security</h4>
<ul>
<li>OAuth2 Client Credentials authentication (industry-standard server-to-server auth)</li>
<li>All credentials encrypted at rest using Sodium / OpenSSL</li>
<li>AJAX forms protected by WordPress nonces</li>
<li>Rate limiting on OTP requests and fee lookups</li>
<li>Guardian sessions use HttpOnly, Secure, SameSite=Strict cookies</li>
<li>All output properly escaped; all input sanitized</li>
</ul>
<h4>Requirements</h4>
<ul>
<li>WordPress 6.2 or later</li>
<li>PHP 7.4 or later with Sodium or OpenSSL extension</li>
<li>An active ScholaBook account with API credentials</li>
</ul>
<h4>Shortcodes</h4>
<ul>
<li><code>[scholabook_school_info]</code> — School information display</li>
<li><code>[scholabook_fee_lookup]</code> — Public fee dues check form</li>
<li><code>[scholabook_fee_summary]</code> — Fee breakdown (requires parent login)</li>
<li><code>[scholabook_fee_receipts]</code> — Payment history (requires parent login)</li>
<li><code>[scholabook_attendance]</code> — Attendance summary (requires parent login)</li>
<li><code>[scholabook_holidays]</code> — Academic holiday calendar</li>
<li><code>[scholabook_notices]</code> — School announcements</li>
<li><code>[scholabook_guardian_login]</code> — Parent OTP login form</li>
<li><code>[scholabook_guardian_dashboard]</code> — Parent mini-dashboard</li>
<li><code>[scholabook_portal]</code> — <strong>Unified Parent Portal</strong> (recommended) — single page that combines login, dashboard, fees, receipts, and attendance into one seamless experience. A “Parent Portal” page with this shortcode is auto-created on plugin activation.</li>
</ul>
<h3>Development</h3>
<p>The minified file <code>public/js/scholabook-portal.js</code> is built from the human-readable source in <code>src/portal/</code> using <a href="https://esbuild.github.io/" rel="nofollow ugc">esbuild</a>.</p>
<p>To rebuild from source:</p>
<ol>
<li><code>npm install</code></li>
<li><code>npm run build</code></li>
</ol>


ScholaBook – School Management Integration

Connect your school website to ScholaBook SaaS for fee lookup, receipts, attendance, holidays, notices, and a parent portal.

DeftCoders – Discount & Fee Rules for WooCommerce vs ScholaBook – School Management Integration