Beruang Budget

=== Beruang Budget === Contributors: turtlepod Donate link: https://pandaplugin.com/donate/ Tags: budget, finance, transactions, expense, income Requires at least: 6.0 Tested up to: 7.0 Stable tag: 0.7.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 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 for the companion theme, setup guide, and more.

== Changelog ==

= 0.7.0 =

• Update and fixes for WordPress.org repository.

= 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