[MP] Category Balance lets authors earn a balance from approved threads posted in specific forums on your XenForo site. Users can withdraw their accumulated balance via IBAN, while admins manage the process with advanced reports.
Primary Goal
Encourage high‑quality content submissions and reward contributors.
src/addons/MusaPekel/KatagoriBakiye/ on your server.mp_kb_price column to xf_forum.xf_mp_kb_transactions table (stores all transactions).xf_mp_kb_user_balance table (optional cache)./bakiye./odeme with IBAN info. Amount is deducted immediately./bakiye: Current balance and history./odeme: New withdrawal request form./odeme/submit: Form submit endpoint.admin.php?mpkb-withdraw: Pending withdrawal requests.admin.php?mpkb-reports/payouts: Paid report.admin.php?mpkb-reports/totals: Totals report.All options live under Admin Panel → Options → [MP] Category Balance.
Enable Add‑on: Turn the system on/off.
Currency: Currency to display in UI and reports (TRY, USD, EUR).
Minimum Withdrawal: Minimum balance required to request payout.
Reference Prefix: Prefix for payout reference codes (e.g., KB-).
Use group permissions to grant mpKb_view_balance so selected users can access the balance system.
All balance movements are stored in xf_mp_kb_transactions. Each row represents a credit or withdraw action. Withdrawals have pending and paid states.
A user’s available balance is calculated on the fly as:
Balance = (sum of all 'credit') − (sum of all 'withdraw' with status 'pending' and 'paid')
This prevents re‑using funds while a request is still pending.
Core functionality lives in the Repository layer and can be reused by other add‑ons.
Balance Repository
creditForApprovedThread(): Credits the user when a thread is approved.requestWithdraw(): Validates balance/limits and creates a new withdrawal.getUserBalance(): Computes a user’s real‑time balance.Report Repository
Provides data for admin reports (e.g., getPaidTotals, getTopPaidUsers).
All texts use phrases so they can be localized easily. Phrases start with the mp_kb_ prefix.
mp_kb_balance_indexmp_kb_withdraw_requestmp_kb_admin_withdraw_listmp_kb_admin_report_payoutsmp_kb_admin_report_totalsI get "invalid_action / invalid_controller".
Ensure routes are defined correctly. Check namespace and Controller class names.
User wasn’t credited on thread approval.
Make sure the forum’s mp_kb_price is greater than 0 and the thread is in an approval workflow.
Why is balance deducted immediately when creating a withdrawal?
It prevents the user from re‑using the same funds while the request is still being processed.
Why no PayPal or other methods?
This version focuses on the common scenario in Türkiye: payout requests via IBAN, keeping the UI simple.
What happens if I uninstall the add‑on?
Uninstall removes all tables (xf_mp_kb_*) and the column (xf_forum.mp_kb_price). This deletes all balances and history. Back up your DB if you need the data.