Monetary System 0.9.6 [Updated: 1st Dec, 2015]
Nov 5, 2012 10:10:21 GMT -8
Jordan, Chris, and 39 more like this
Post by Peter on Nov 5, 2012 10:10:21 GMT -8
This plugin is no longer available from the library or supported.
You can still download and install this plugin from the GitHub page: Monetary Plugins
Test the Monetary System plugin here: monetary.proboards.com
Monetary System
Please take a moment to like this post and rate the plugin: ProBoards Library Link
Contents
- Introduction
- Help / FAQ
- Integrating Into Custom Mini Profiles & Profiles
- Showing Wallet Amount Anywhere On The Forum
- Plugin Install
- Additional Plugins Worth Checking Out
- Adding The "Bank" Link To The Navigation
- API For Developers
- Features
- Screen Shots
- Plugin Source
- Plugin Changes
Introduction
mon·e·tar·y
Adjective: Of or relating to money or currency.
This plugin will add currency to your forum, allowing your members to earn virtual money (which is fake) when they post, and from other features of the system that are either included or being developed and released later on in the future.
Most parts of the system can be customised, from the text displayed in mini profiles, to the way money is displayed across the whole forum.
Support is also included for mini profiles that have been modified in the template layout.
Please be sure to read all parts of this post, as it contains important information regarding installing and customising the system.
If you do have any issues, questions, or suggestions, please post in this topic, don't contact me directly.
Note: The Monetary System plugin will require 1 super user key
Help / FAQ
- How do I edit a members money?
If the option is enabled to allow staff to edit members money, then all you need to do is go to the members profile, and click on the money value. A box will appear where you can enter the new money value. This also applies to the Bank balance if the Bank is enabled.
If you want other staff members to be able to edit money, you need to add them to the "who can edit" list.
- Can you add support for multiple currencies?
While it could be possible, I won't be adding this feature anytime soon, and am not sure if it would ever be done.
- How often is interest earned?
Interest is earned once per day (every 24 hours). Interest can only be earned when posting, so tell your members to be active.
- How do I add the bank and stock market to the navigation?
Please see the information below regarding the navigation links, it will tell you what they need to be, and shows a screen shot of where you can add them.
- Why can I not set different amounts for the ranks?
Ranks are not searchable like Groups are, so this can not be done at this time.
- How do I gift money using a link?
You can use the gift money link with your unique code on the end... http://yourforum.proboards.com/?monetarygift=YOUR_UNQIUE_CODE.
Don't forget, you can enable the gift icon that will show in the Yootil bar to make it easier for members to get their gifts.
- Wages are not getting paid, what's wrong?
Wages are paid when members actively post, and they must meet a certain amount of posts set by yourself. On the other hand, wages for staff are earned with no restriction.
- Money is not showing in the profile, or mini profiles in threads, why?
Usually this problem is related to your forum having a custom theme where you have altered the structure and / or class names. The plugin does support custom profiles and mini profiles to a degree, however if you modify the class names and the total structure, then the plugin can not traverse over the DOM to find specific areas to apply the monetary features.
- The donation button is not showing on the users profile, how do I get it to show?
In your layout template, you can add in the button manually like so...
<a class="button" href="/user/%24[user.id]?monetarydonation&view=1">Send Donation</a>- Monetary System isn't working now I have updated to the latest version, what's going on?
Make sure you are using the latest version of Yootil, as some API changes were made in 0.9+ for this plugin. Also make sure you have the plugins in the correct order.
- Members aren't getting their donations or other items (i.e trade requests if shop is installed), why?
The Yootil Bar (bottom left corner) contains all the links to the pages for donations, trades, gifts etc, however there is no notification system by default. A notification plugin has been created to help with this problem: www.proboards.com/library/plugins/item/1072
- Can we get notifications when something has happened (i.e user received a donation)?
There is an official notification plugin created for exactly this. Please see this link: support.proboards.com/thread/558404/monetary-notifications-updated-10th-2015
Plugin Install
To use the Monetary System plugin, you will need the Yootil Plugin, without it, this plugin will not work. So please follow the instructions in that thread.
Requires: Yootil Plugin
----
Install: ProBoards Plugin Library
Note: Please check which version you are installing is the latest. You can do that my checking this topic title, as it contains the version number as well as the date it was released.
Additional Plugins Worth Checking Out
Listed here are plugins that have hooked into the Monetary System to provide additional functionality, or ways to earn money.
Integrating Into Custom Mini Profiles & Profiles
Because people like to customise the look of their mini profile, and profile, this can cause an issue with how the money information gets displayed. Below is a video demoing the basic solution I have put in place. Please note, this video is old, since then some new classes have been added for additional information.
Money
money_text
money_symbol
money_amount
Bank
bank_text
bank_symbol
bank_amount
Donations Sent
donations_sent_text
donations_sent_symbol
donations_sent_amount
Donations Received
donations_received_text
donations_received_symbol
donations_received_amount
Showing Wallet Amount Anywhere On The Forum
If you would like to show the members wallet amount on the forum, you can create an element with the below class, and this will get populated by the plugin.
Class Name: money_wallet_amount
Adding The "Bank" Link To The Navigation
The Monetary System doesn't automatically add the "Bank" link to the navigation, this is something that you can do yourself so you have full control over where it appears.
The screen shot below should be enough for you to work how how to do it from the admin area.
API For Developers
The Monetary System has a basic API for other developers to hook into, please look over the docs and source code to see how to use it.
API Documentation
Features
Note: There may be missed features in the current release not mentioned here.
Administration Area (Backend)
- Settings
- Change money text (i.e "Money").
- Change money symbol (i.e "£").
- Change money symbol to an image.
- Show, or not show the money in the mini profile across the whole forum.
- Show, or not show the money text in the mini profile across the whole forum.
- Show, or not show the money symbol in the mini profile across the whole forum.
- Show, or not show the money on the profile for users.
- Show, or not show the money text on the profile for users.
- Show, or not show the money symbol on the profile for users.
- Show, or not show the money on the members list.
- Show, or not show the money text on the members list.
- Change table header text on the members list.
- Set money to include decimals or just be whole numbers.
- Allow editing of money from the users profile if user has permission (i.e staff).
- Disable earning money from the quick reply.
- Earning Settings
- Set the amount of money earned for a new thread.
- Set the amount of money earned for including a poll.
- Set the amount of money earned for replying in a thread (full reply).
- Set the amount of money earned for replying in a thread (quick reply).
- Set the amount of money earned for categories.
- Set the amount of money earned for boards.
- Permissions
- Add categories for where money will be disabled.
- Add boards for where money will be disabled.
- Add members who can no longer earn money.
- Add threads to disable earning money in them.
- Add groups who can no longer earn money.
- Bank
- Enable or disable the Bank.
- Interest Rate amount.
- Minimum amount the user can deposit into the Bank.
- Minimum amount the user can withdraw from the Bank.
- Coin image can be changed.
- Transaction text replacements
- Stock Market
- Enable or disable the Stock Market.
- Enable or Disable the Stock Chart image.
- Compact layout for smaller forum widths.
- Stock block width to fine tune the width of the information.
- Up arrow image can be changed.
- Down arrow image can be changed.
- Stock company name and symbol replacements
- Wages
- Enable or disable the wages system.
- Set how often wages should be paid.
- Enable or disable wage bonuses.
- Set the bonus amount.
- Set where the wages should be paid into.
- Set wage rules for different amounts based on post count.
- Set staff wages.
- Rank Up
- Enable or disable rank up earning.
- Set where the money should be paid into.
- Set the amount of money that can be earned for ranking up.
- Gift Money
- Enable or disable the gift system.
- Set where the money should be paid into.
- Change the gift icons.
- Create gift codes with different amounts, and with different permissions.
- Donation
- Enable or disable the donation system.
- Set min and max values.
- Change text.
Forum Features (Frontend)
- Members can earn money from creating new threads.
- Members can earn money from adding a poll to their threads.
- Members can earn money from replying in threads.
- Members can earn money from replying using the quick reply (if enabled).
- Members can view other members money amount.
- Members can access the Bank feature (if enabled).
- Members can deposit money into the Bank if they meet the minimum amount.
- Members can withdraw money from the Bank if they meet the minimum amount.
- Members can view their last 5 transactions at the Bank
- Members can access the virtual Stock Market (if enabled).
- Members can buy and sell stock from the stock Market.
- Staff can edit members money amount from their profiles (if enabled).
- Staff can edit members bank balance from their profiles (if enabled).
- Members list displays members money amount (if enabled).
- Bank added to Yootil Plugin Bar.
- Stock Marked added to Yootil Plugin Bar
- Earning interest once a day if you post.
- Earning a wage when actively posting.
- Earning money for ranking up when actively posting.
- Staff can earn a wage which doesn't expire like members wages rules.
- Accept gift money.
- Syncing of data between tabs / windows to prevent loss of money.
- Members can donate money to each other.
Screen Shots
Click image to open bigger version in new tab / window.
Plugin Source
If you are interested in seeing how the system works, and how I have put it together, below is an uncompressed dev version. Please don't redistribute it, as a lot of hours have gone into this.
This is the merged version. All the core modules a merged into one file, to look over each module easier, please look at the rep on GitHub.
htt://pixeldepth.net/proboards/plugins/monetary_system/monetary_system.src.js (merged)
github.com/PopThosePringles/ProBoards-Monetary-System
Documentation
Plugin Changes
Here, I will attempt to keep this up to date of what things have been changed so people don't need to look through all the new posts.
Date is UK format.
0.9.6 [11/12/2015]
- Fixed an issue with money not getting applied when interest is added to the bank
0.9.5 [30/11/2015]
- Fixed staff wage expiration bug always set to 0
0.9.4 [25/11/2015]
- after_apply_posting_money
- before_apply_posting_money
- on_close_edit_money
- on_open_edit_money
- stock_market.data_request_done
- bank.deposit
- bank.withdraw
0.9.3 [10/11/2015]
- Fixed wages being paid into bank when bank is disabled.
- Fixed rank up payments being paid into bank when bank is disabled.
0.9.2 [29/09/2015]
- Fixed missing expressions.
0.9.1 [25/08/2015]
- Fixed rejected donation reference issue.
0.9.0 [15/08/2015]
- Fixed issue with dialog title showing HTML due to jQuery UI update. "create" event used to fix it.
- Added in calls to create notifications using the new Yootil Notification API (you will need the monetary notification plugin).
- Fixed double encoding of the users display name, ProBoards already handles making this safe.
- Complete rewrite of docs.
0.8.8 [10/03/2015]
- Removed update checker.
- Can now change icon for the donation image that appears in the Yootil bar.
0.8.7 [08/03/2015]
- Changes to setup in the way it checks "boolean" settings.
- Fixed missing class name on members list (text align was incorrect).
- Fixed rounding issue; more decimal places being used than I wanted (only effected data storage length).
- Changes possible instances that a float could be concatenating with a string.
- Syncing improved so that multiple characters shouldn't get cross over data corruption.
- Fixed an issue if gift codes are blank, it will now show an error message instead of a blank page.
- Added in basic message to the user if the key data is too big. Checks were in place, just not informing the user.
- Fixed wages expire time not being correct. Year was being set (due to no ".getTime()") instead of a timestamp.
0.8.6 [22/12/2014]
- Donation icon in the yootil bar now always shows
- Small tweaks to code
0.8.5 [21/07/2014]
- Fixed issue clearing investments
- Small performance tweaks
0.8.4 [10/07/2014]
- Fixed sending donation issue
- Fixed floating point issue
0.8.3 [04/07/2014]
- Fixed issue with disabling rank up bonus
0.8.2 [25/06/2014]
- Fixed grammar
- Remove "reset" message and changed it to a "set" message
0.8.1 [18/06/2014]
- Fixed members page not setting the money or bank values when changing pages (data table old)
- Fixed some other small things
- Syncing of notification clearing
0.8.0 [16/06/2014]
- Negative money tweaks (edit dialog)
- Notification system for members who get their wallet or bank balance edited (disabled by default under Settings)
0.7.8 [15/06/2014]
- Support for negative money
0.7.7 [12/06/2014]
- Bug fixes
- Small minor changes
- Few methods / properties moved do main module for reuse outside
0.7.6 [05/06/2014]
- Fixed typos and minor fixes
0.7.5 [04/06/2014]
- Fixed regular expression for bank and stock market modules (thanks Chris )
0.7.4 [03/06/2014]
- Add exclude groups option for donations
0.7.3 [29/03/2014]
- Fixed issue when money symbol is set as an image is shown as HTML in the custom wallet.
- Edit money dialog improved with more options.
- Donations received and donations sent now collected as a stat.
- Donations received, donations sent, and bank balance will show in the mini profile as well as profile.
- Bank balance has new options to show for staff only (default), show in mini profile (off by default), and show in profile.
- Donations sent and received have options to show on profile and in the mini profile (these are off by default).
- New classes for those with custom templates, or who wants to display the information in a different place.
0.7.2 [26/02/2014]
- Fixed bugs and compression issue
0.7.1 [26/02/2014]
- Donation feature
- Bank deposit / withdraw validation bug
- Data class to handle setting and getting users data
- Lots of improvements and and tweaks to the code internally
0.7.0 [12/01/2014]
- Minor visual changes to the Bank page.
- Syncing of data cross tabs / windows
0.6.10 [09/01/2014]
- Fixed the permissions for categories, boards, and threads.
- Changed to how the data object is saved. Before it was getting converted to a JSON string twice.
0.6.9 [21/08/2013]
- Fixed an issue with 2 loops when there were custom amounts of boards and categories.
- Added in the option to set the "Bank Balance" column header on the members page.
- Changed validation restriction for a lot of places where you can change text (now anything is accepted).
0.6.8 [20/08/2013]
- Changed the refund all stock dialog to allow the user to decline the message, which then stops showing up for good.
0.6.7 [20/08/2013]
- Fixed an issue where gift money would try to pay into the bank when the bank is disabled.
0.6.6 [19/08/2013]
- If stock market is disabled, a notice to the user will ask them if they want a refund on all investments.
- Bug fix to gift money showing an error to the user if there was no "Show Gift Icon" value set.
- Fixed an issue with wages not correctly looping through groups to find the highest earning amount.
0.6.5 [13/08/2013]
- Edit money now has improved permissions, you can select who can edit the money (by default all staff can).
- You can now ban groups from earning money.
- Bank balance can now be shown on the members list for staff (if bank is enabled). By default this is disabled.
- Staff can now earn a wage that is not depended on posting.
- Bug fix to the edit money icon showing for all people.
- Money for wages and gifts will default to being paid into the wallet (in case the Bank is disabled).
- Gift money to everyone, specific members, and groups. Gifts can only be used once per person.
- Show gift icon (can be turned off incase you want to create a game... Hunt the gift code
) in Yootil bar to the user.- Edit Money setting is now disabled by default.
- Bug fix to update notification checking.
0.6.4 [11/08/2013]
- Can now change the money separator (default is ":").
- Can choose to have a space after the money separator or not.
- No longer restricted to using spans for customising the profile and mini profile.
- Mini profile customising doesn't require custom elements to be inside the "info" div now, can be anywhere in the mini profile.
- Update notification is shown to all staff now.
- Update notification can not be hidden unless it's disabled (people get lazy and hide the message, I want people to update).
- Bug fix to version checking (also method has been moved to Yootil).
- Can show the members wallet amount anywhere on the forum using an element with the class "money_wallet_amount".
- Customising of money and bank on the members profile is now possible. Please see first post for details when 0.6.4 is out.
- Profile money and bank amounts now show a small edit icon, this can be customised or turned off.
- Transaction rows text size has been increased by 1.
- Bug fix with wages where bonus was being paid when it wasn't meant too.
- Members who rank up now earns a fixed amount set in the settings.
- "RANKUP" transaction text added to Bank settings page
0.6.3 [04/08/2013]
- "Posts:" match string changed to "Posts" (some people have removed the colon ":" so this caused issues).
- Bank and Stock Market Yootil Bar icons can now be changed (can be found on the Bank and Stock Market settings pages).
- More options to select for the update checker (2, 3, 4, 5, and 6 days added).
- You can now set different earning amounts for categories and boards.
- Fixed an issue with floats in the title bar of the stock market and bank effecting some forums.
- Improved version update checking showing the message for an older version number.
0.6.2 [02/08/2013]
- Fixed 404 issues with latest ProBoards changes
0.6.1 [30/07/2013]
- Wages
- Bug fix
- Optimisation
- More customising of text that appears
- Bank balance no longer shows on profile if bank is disabled
0.6.0 [14/07/2013]
- Stock Market
- Customise all images that appear
- Money symbol can now be an image
- Quick reply earning enabled by default and set to 5
- Various other things changed and fixed
0.5.3 [09/05/2013]
- Fixed an edit money bug, sometimes it would reset to 0
- Staff can now see how much a user has in their bank on their profile
- Staff can now edit a bank balance
- Staff can no longer edit their own money
0.5.2 [06/05/2013]
- Fixed a balance bug when interest is added
0.5.1 [06/05/2013]
- Fixed bug when no user has a money object
0.5.0 [05/05/2013]
- Fixed an issue with drafts not clearing.
- Interest now can be earned once a day if you post.
- API has changed, instead of "pixeldepth_monetary", it's now "pixeldepth.monetary".
0.4.3 [01/05/2013]
- Bug fix with members getting money in their bank account when editing the users money.
- Bug fix with permissions (categories, boards, and members).
- New feature; Ban earning from specific threads.
0.4.2 [22/02/2013]
- If not logged in, bank page will just show the forum
- Admin tabs have been changed around, some settings combined to 1 tab now
- New setting for the quick reply, you can now set the amount if you want it to be different
- 2 new methods for other plugins: pixeldepth_monetary.disable_earning() & pixeldepth_monetary.enable_earning()
- Minor bug fixes and tweaks to the code
