=== Beruang Budget ===
Contributors: turtlepod
Donate link: https://pandaplugin.com/donate/
Tags: budget, finance, transactions, expense, income
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 0.6.0
Requires PHP: 8.2
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Track money, transactions, and budgets.

== Description ==

Beruang Budget is a WordPress plugin for per-user money, transaction, and budget tracking. All data is scoped by logged-in user. Use shortcodes on front-end pages to add transactions, view lists, display charts, and manage budgets.

Visit [pandaplugin.com/beruang](https://pandaplugin.com/beruang/) for the companion theme and setup guide.

= Features =

* **Transactions** – Add and list transactions with date, time, description, category, amount, and type (expense/income)
* **Categories** – Hierarchical categories with optional parent; default "Uncategorized"
* **Budgets** – Create budgets with target amounts, link to categories, track progress (monthly or yearly)
* **Charts** – Graph data by month or by category using Chart.js
* **Admin** – Settings (currency, decimal/thousands separators), transaction/category/budget management, export/import JSON
* **WP-CLI** – List transactions, categories, budgets, and budget-category links via command line

= Requirements =

* WordPress 6.0+
* Logged-in users (data is scoped by user)

== Installation ==

1. Upload the `beruang-budget` folder to `wp-content/plugins/`.
2. Activate the plugin in **Plugins**.
3. Tables are created on activation: `beruang_category`, `beruang_transaction`, `beruang_budget`, `beruang_budget_category`.

Run `npm install && npm run build` in the plugin directory before use. The plugin loads built assets from `dist/`.

= Shortcodes =

Use on pages where users are logged in:

* `[beruang-form]` – Add transaction form with optional calculator
* `[beruang-list]` – Monthly transaction list in an accordion with filter
* `[beruang-graph]` – Chart (by month or by category) with year selector
* `[beruang-budget]` – List budgets with progress; add/edit budget modal
* `[beruang-wallet]` – List and manage your wallets.
* `[beruang-install-button]` – PWA install button/link (enable PWA in Settings first)
  * `label` – button text (default: "Install App")
  * `tag` – `button` (default) or `a` for a link
  * `class` – extra CSS class

== Resources ==

Font Awesome Free Icons
* Icons: https://fontawesome.com/icons
* License: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/
* The plugin uses inline SVG paths derived from Font Awesome Free icons: xmark (close), calculator (calc), list-ul (list), filter (filter), file-circle-plus (add), pen-to-square (edit), trash-can (trash).

== Upgrade Notice ==

Maintenance update.

== Screenshots ==

1. Settings.
2. Screenshot.

== Frequently Asked Questions ==

= Where are the plugin settings? =

Go to **Beruang > Settings** in your WordPress admin. Configure currency, decimal separators, PWA, and more.

= How do I use the plugin? =

Add shortcodes to any page (users must be logged in): `[beruang-form]` for transactions, `[beruang-list]` to view them, `[beruang-budget]` for budgets, `[beruang-graph]` for charts, and `[beruang-wallet]` for wallets.

= Where can I find more documentation? =

Visit [pandaplugin.com](https://pandaplugin.com) for the companion theme, setup guide, and more.

== Changelog ==

= 0.6.0 =
* Renamed `[beruang_install_button]` to `[beruang-install-button]` for consistency with other shortcodes.
* Added `npm version` postversion hook to sync all version references automatically.
* Replaced GPLv2 license with GPLv3.
* Fixed cancel button using `.hidden` class instead of inline `.style.display`.
* Code quality improvements across CSS, JS, and templates.

= 0.5.0 =
* Transfer wallet.
* **Beruang Pro features absorbed:** `[beruang-install-button]` shortcode, user locale on frontend,
  Beruang Theme available separately, Theme Settings admin page.
* Various fixes.

= 0.4.0-beta =
* Several fixes
* Wallet feature
* Notes feature
* Add unit tests
* Add Playwright tests
* Restructure CSS and HTML using component based approach.

= 0.3.0-beta =
* Refactored front-end CSS into component-based stylesheets and improved responsive rules.
* Refactored front-end JavaScript into modular files for form, list, graph, budget, config, and shared utilities.
* Updated admin management screens to use dedicated WP List Table classes for transactions, categories, and budgets.
* Reworked templates into partials (including shared modals and transaction form partial).
* Improved form UX with loading states, clearer error messages, calculator behavior, and focus/style fixes.
* Improved asset/manifest loading behavior and refreshed plugin icons.

= 0.2.0-beta =
* Use REST API instead of admin-ajax
* Minify JS and CSS via 10up-toolkit
* Add ESLint, stylelint, PHPCS
* Reset form after submit
* Convert to vanilla JavaScript (remove jQuery)

= 0.1.0-beta =
* Initial beta release
* Transaction, category, and budget management
* Shortcodes: form, list, graph, budget
* Admin pages: Settings, Transactions, Categories, Budgets
* WP-CLI support
* Export/import JSON
