FinanceBuddy v1.3.0 — per-board currency shipped. All clean (php -l, ASCII, README + TODO synced)

Helper/FinanceHelper.php

@@ -19,6 +19,12 @@ class FinanceHelper extends Base
     const INSTALLMENT_CURRENT_KEY = 'financebuddy_installment_current';
     const INSTALLMENT_TOTAL_KEY = 'financebuddy_installment_total';
 
+    // Per-board currency symbol shown before every amount (default "R$"). Up to 4 chars; the stored
+    // value is trimmed, capped, and defaulted on read, so an empty or oversized value is harmless.
+    const CURRENCY_KEY = 'financebuddy_currency';
+    const CURRENCY_DEFAULT = 'R$';
+    const CURRENCY_MAX_LENGTH = 4;
+
     // Per-column opt-out of the header total. Stored per column in PROJECT metadata as
     // financebuddy_hide_total_<column_id> = 'on' (hidden) or 'off' (shown, the default). Literal
     // on/off, never 1/0, so the flag is never dropped by the metadata save (PHP empty("0") === true).
@@ -33,6 +39,9 @@ class FinanceHelper extends Base
     // Memoized per project_id: the board hooks below call isEnabled() once per card.
     private static $enabledCache = array();
 
+    // Memoized per project_id: currency() is likewise resolved once per card/column render.
+    private static $currencyCache = array();
+
     /**
      * Is FinanceBuddy enabled for this board?
      *
@@ -50,6 +59,26 @@ class FinanceHelper extends Base
         return self::$enabledCache[$project_id];
     }
 
+    /**
+     * Per-board currency symbol shown before amounts: the stored value trimmed and capped to
+     * CURRENCY_MAX_LENGTH, or CURRENCY_DEFAULT ("R$") when empty. Memoized per project.
+     *
+     * @param  integer $project_id
+     * @return string
+     */
+    public function currency($project_id)
+    {
+        $project_id = (int) $project_id;
+
+        if (! isset(self::$currencyCache[$project_id])) {
+            $symbol = trim((string) $this->projectMetadataModel->get($project_id, self::CURRENCY_KEY, ''));
+            $symbol = mb_substr($symbol, 0, self::CURRENCY_MAX_LENGTH);
+            self::$currencyCache[$project_id] = $symbol === '' ? self::CURRENCY_DEFAULT : $symbol;
+        }
+
+        return self::$currencyCache[$project_id];
+    }
+
     /**
      * Stored finance values for a task, with defaults. One query (getAll) since the board renders
      * this per card.

Plugin.php

@@ -85,7 +85,7 @@ class Plugin extends Base
 
     public function getPluginVersion()
     {
-        return '1.2.0';
+        return '1.3.0';
     }
 
     public function getPluginHomepage()

README.md

@@ -30,7 +30,7 @@ Once a board is enabled:
 
 The task edit/create form gains a **Finance** section in the middle column:
 
-- **Amount** in R$.
+- **Amount** in the board's currency (default R$).
 - **Debit** or **Credit** (money out vs money in).
 - **Installment** current / total (for example `2` of `10`). Leave the total blank for an
   open-ended recurring bill.
@@ -66,9 +66,13 @@ counting.
 
 ## Money format
 
-Amounts show in R$ with a comma decimal and no thousand separator (for example `R$1234,56`).
-Input accepts either a dot or a comma as the decimal separator, so `1234.56` and `1234,56` are
-the same value.
+Amounts show with a comma decimal and no thousand separator (for example `R$1234,56`). Input
+accepts either a dot or a comma as the decimal separator, so `1234.56` and `1234,56` are the same
+value.
+
+The currency symbol shown before every amount is **per board**: set it under
+Settings -> Integrations next to the enable checkbox (up to 4 characters, e.g. `US$`, `EUR`, `GBP`).
+Leave it empty for the default `R$`.
 
 ## How it stores data
 
@@ -92,13 +96,16 @@ Settings -> Integrations and tick "Enable FinanceBuddy on this board".
 
 AGPL-3.0. See LICENSE.
 
-## More Kanboard plugins by Ruben (drbeco)
+## More Kanboard plugins by Dr. Beco
 
 All free and AGPL-3.0, at [code.beco.cc](https://code.beco.cc/beco):
 
 - **[RecoReco](https://code.beco.cc/beco/RecoReco)** -- calendar-scheduled recurring cards (yearly,
-  monthly, weekly, daily), driven by the card due date. Pairs directly with FinanceBuddy: recurring
-  bills spawn on schedule and their installments count down until the plan is paid off.
+  monthly, weekly, daily), driven by the card due date.
+- **[QualKard](https://code.beco.cc/beco/QualKard)** -- flashcard spaced repetition: grade a card by
+  dragging it to a column, and it comes back when due (needs RecoReco).
+- **[WorkspaceOrg](https://code.beco.cc/beco/WorkspaceOrg)** -- group your projects into personal
+  per-user workspaces, shown on a "My workspaces" dashboard page with a badge on each project.
 - **[OrganonTweaks](https://code.beco.cc/beco/OrganonTweaks)** -- an umbrella of small
   quality-of-life board tweaks: remove an empty column, always show the comment icon, emphasize due
   dates, extra search keywords and shared board filters, and more.

Template/board/column_total.php

@@ -26,5 +26,5 @@ if ($net > 0) {
 }
 ?>
 <div class="fb-column-total">
-    <span class="fb-total-pill"><?= t('Total') ?>: <span class="fb-amount <?= $amount_class ?>"><?= $sign ?>R$<?= \Kanboard\Plugin\FinanceBuddy\Helper\FinanceHelper::money(abs($net)) ?></span></span>
+    <span class="fb-total-pill"><?= t('Total') ?>: <span class="fb-amount <?= $amount_class ?>"><?= $sign ?><?= $this->text->e($this->FinanceHelper->currency($column['project_id'])) ?><?= \Kanboard\Plugin\FinanceBuddy\Helper\FinanceHelper::money(abs($net)) ?></span></span>
 </div>

Template/board/task_money.php

@@ -24,7 +24,7 @@ $current_display = $current !== '' ? $current : '1';
 ?>
 <div class="fb-line">
     <span class="fb-badge <?= $credit ? 'fb-badge-credit' : 'fb-badge-debit' ?>">
-        <?= $sign ?>R$<?= \Kanboard\Plugin\FinanceBuddy\Helper\FinanceHelper::money($fb['amount']) ?>
+        <?= $sign ?><?= $this->text->e($this->FinanceHelper->currency($task['project_id'])) ?><?= \Kanboard\Plugin\FinanceBuddy\Helper\FinanceHelper::money($fb['amount']) ?>
     </span>
     <?php if ($show_installments): ?>
         <span class="fb-installments">p<?= $this->text->e($current_display) ?><?= $total !== '' ? '/'.$this->text->e($total) : '' ?></span>

Template/project/integration.php

@@ -13,6 +13,12 @@
     <p class="form-help">
         <?= t('When enabled, cards on this board can carry a money value (debit or credit, with optional installments), shown on the card and totalled per column. Boards left disabled are unaffected.') ?>
     </p>
+
+    <?= $this->form->label(t('Currency symbol'), 'financebuddy_currency') ?>
+    <?= $this->form->text('financebuddy_currency', $values, array(), array('maxlength="4"', 'placeholder="R$"')) ?>
+    <p class="form-help">
+        <?= t('Shown before every amount on this board (up to 4 characters). Leave empty for the default R$.') ?>
+    </p>
 </div>
 
 <div class="form-actions">

Template/task/form_fields.php

@@ -5,7 +5,7 @@
 <div class="fb-form">
     <input type="hidden" name="<?= \Kanboard\Plugin\FinanceBuddy\Helper\FinanceHelper::FORM_MARKER ?>" value="1">
 
-    <label for="financebuddy_amount"><?= t('Amount (R$)') ?></label>
+    <label for="financebuddy_amount"><?= $this->text->e(t('Amount (%s)', $this->FinanceHelper->currency($values['project_id']))) ?></label>
     <input type="text" id="financebuddy_amount" name="financebuddy_amount" value="<?= $this->text->e($fb['amount']) ?>" placeholder="0,00" autocomplete="off">
 
     <label><?= t('Type') ?></label>

VERSION

@@ -1 +1 @@
-FinanceBuddy v1.2.0
+FinanceBuddy v1.3.0