=== myCRED === Contributors: designbymerovingi Tags: point, points, tokens, credit, management, reward, charge, community, contest, buddypress, jetpack, bbpress, simple press, woocommerce, marketpress, wp e-commerce, contact-form-7 Requires at least: 4.0 Tested up to: 4.6 Stable tag: 1.7 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html An adaptive and powerful points management system for WordPress powered websites. == Description == > #### Updating to 1.7 > If you are using the Banking add-on, Sell Content add-on or the Badge add-on, I highly recommend you read [these](https://mycred.me/news/) update guides before you update to 1.7 from older versions! > #### Plugin Support > Free support is offered via the [myCRED support forum](https://mycred.me/support/). No support is provided here on the wordpress.org support forum. myCRED is an adaptive points management system that lets you build a broad range of point related applications for your WordPress powered website. Store reward systems, community leaderboards, online banking or monetizing your websites content, these are some of the ways you can use myCRED. = Points = Each user on your WordPress websites gets their own point balance which you can manually [adjust](https://mycred.me/about/features/#points-management) at any time. As of version 1.4, myCRED also supports [multiple point types](https://mycred.me/about/features/#multiple-point-types) for those who need more then one type of points on their website. = Log = Each time myCRED adds or deducts points from a user, the adjustment is [logged](https://mycred.me/about/features/#account-history) in a dedicated log, allowing your users to browse their history. The log is also used to provide you with statistics, accountability, badges, ranks and to enforce limits you might set. = Awarding or Deducting Points Automatically = myCRED supports a vast set of ways you can automatically give / take points from a user. Everything from new comments to store purchases. These automatic adjustments are managed by so called [Hooks](https://mycred.me/about/features/#automatic-points) which you can setup in your admin area. = Third-party plugin Support = myCRED supports some of the most [popular plugins](https://mycred.me/about/supported-plugins/) for WordPress like BuddyPress, WooCommerce, Jetpack, Contact Form 7 etc. To prevent to much cluttering in the admin area with settings, myCRED will only show features/settings for third-party plugins that are installed and enabled. = Add-ons = There is so much more to myCRED then just adjusting balances. The plugin comes with several [built-in add-ons](https://mycred.me/add-ons/) which enabled more complex features such as allowing point transfers, buying points for real money, allow payments in stores etc. = Documentation = You can find extensive [documentation](http://codex.mycred.me/) on everything myCRED related in the myCRED Codex. You can also find a list of [frequently asked](https://mycred.me/about/faq/) questions on the myCRED website. = Customizations = myCRED was not built to "do-it-all". Instead a lot of effort has been made to make the plugin as developer friendly as possible. If you need a custom feature built, you can submit a [request for a quote](https://mycred.me/customize/request-quote/) via the myCRED website. = Code Snippets = The most commonly asked customizations for myCRED are available as code snippets on the [myCRED website](https://mycred.me/code-snippets/), free to use by anyone. = Support = I provide free support via the myCRED website if you can't get myCRED to work as described in the documentation. I do not offer support here on the wordpress.org support forum or via social media sites. You can also ask questions in the community forum to fellow myCRED users. == Installation == = myCRED Guides = [Chapter I - Introduction](http://codex.mycred.me/chapter-i/) [Chapter II - Getting Started](http://codex.mycred.me/chapter-ii/) [Chapter III - Add-ons](http://codex.mycred.me/chapter-iii/) [Chapter IV - Premium Add-ons](http://codex.mycred.me/chapter-iv/) [Chapter V - For Developers](http://codex.mycred.me/chapter-v/) [Chapter VI - Reference Guides](http://codex.mycred.me/chapter-vi/) == Frequently Asked Questions == You can find a list of [frequently asked questions](https://mycred.me/about/faq/) on the myCRED website. == Screenshots == 1. **Add-ons** - Add-ons are managed just like themes in WordPress. 2. **Edit Balances** - Administrators can edit any users balance at any time via the Users page in the admin area. 3. **Hooks** - Hooks are managed just like widgets in WordPress. 4. **Edit Log Entries** - Administrators can edit any log entry at any time via the admin area. == Upgrade Notice == = 1.7 = Improved Badges add-on, Banking add-on and Sell Content add-on. Redesigned admin area and improved performance. == Other Notes == = Requirements = * WordPress 4.0 or greater * PHP version 5.3 or greater * PHP mcrypt library enabled * MySQL version 5.0 or greater = Language Contributors = * Swedish - Gabriel S Merovingi * French - Chouf1 [Dan - BuddyPress France](http://bp-fr.net/) * Persian - Mani Akhtar * Spanish - Robert Rowshan [Website](http://robertrowshan.com) * Russian - Skladchik * Chinese - suifengtec [Website](http://coolwp.com) * Portuguese (Brazil) - Guilherme * Japanese - Mochizuki Hiroshi == Changelog == = 1.7 = * NEW - Adjusted how Hooks are managed in the wp-admin area. It now mimics the Widgets management setup. * NEW - Updated the balance editor on the Users page in the wp-admin area. Added option to see a users latest activity in a form of an excerpt from their log. * NEW - Re-write the administration module and removed the points tabs when editing a user in the wp-admin area. Structured up myCRED related details to seem more WordPress native. * NEW - The mycred_send shortcode has been updated to be used in a BuddyPress profile or a bbPress forum reply loop. The to="" attribute now also supports besides "author", "bbprofile" and "replyauthor" as values. * NEW - Added new shortcode: mycred_show_if to hide content from those who do not fulfil a certain point related requirement. * NEW - Added new shortcode: mycred_hide_if to show content to those who do not fulfil a certain point related requirement. * NEW - Added new shortcode: mycred_total_since to show the total number of points a user has gained or lost in a specific timeframe. * NEW - Added new function: mycred_get_user_id which returns either the current users ID, bbPress forum reply user ID, BuddyPress profile user ID. * NEW - Added class to leaderboard row if the user is the current user. * NEW - Added support for BuddyPress Cover Photo uploads (profiles and groups) and adding / removing activity from favourites. * NEW - Added new mycred_ordinal_suffix function for ordinal suffixes. * NEW - Added Bootstrap support. * NEW - The myCRED Log layout and filter options has been updated. * NEW - The myCRED Admin Logs table columns can not be hidden just like with posts and taxonomies. * NEW - Updated log entry editor to allow changing the reference and the amount as well as the log entry. * NEW - Added the mycred_admin_show_history_{$point_type} filter to disable insertions of a users points history under the Users menu in the wp-admin area and in the toolbar. * NEW - Added Bank Transfer manual payment gateway to buyCRED. * NEW - Added new standard styling for pending payments in wp-admin area. * NEW - Added option for coupon minimum and maximum balance requirements to support multiple point types. * NEW - Added new standard styling for coupons in wp-admin area. * NEW - Added new standard styling for ranks in wp-admin area. * NEW - mycred_link shortcode now supports shortcodes to be used in link title. * NEW - Added myCRED_Account Object. * NEW - Added new mycred_delete_point_type and mycred_delete_point_type_{point_type} action hooks for cleaning up the database when a point type is deleted. * NEW - Introduced new constant MYCRED_DEFAULT_TYPE_KEY to adjust the key of the default point type from 'mycred_default'. * NEW - The sell content add-on now supports sales using multiple point types. * NEW - Added option to enable sales of posts automatically for all post types. * NEW - Added option to reload page after content purchases. * NEW - Added new mycred_content_buyer_count shortcode for the Sell Content add-on. * NEW - Added new export module with options to select if front-end or back-end exports should be enabled. Also includes the new myCRED_Query_Export class for quick and easy exports. * NEW - Added options to change the colors used for each point type by the statistics add-on. * NEW - Updated the setup screen for myCRED. * NEW - Added new MYCRED_BUYCRED_PENDING_COMMENTS constant to disable comments on pending buyCRED purchases. * NEW - Added new MYCRED_MIN_TIME_LIMIT constant to set the minimum time required between ajax calls. * NEW - Added new MYCRED_UNINSTALL_LOG constant. If set to false, when myCRED is uninstalled, the log will not be deleted. Defaults to true. * NEW - Added new MYCRED_UNINSTALL_CREDS constant. If set to false, when myCRED is uninstalled, the balances and balance related user meta will not be deleted. Defaults to true. * NEW - Added new hook for content deletions. * NEW - The MYCRED_SLUG constant can now be used to white-label menu slugs in the admin area. * NEW - Re-write the Banking add-on to allow better management of interest payouts and to allow multiple recurring payouts scheduled for each point type. * TWEAK - Updated all rank related functions. * TWEAK - Updated all rank shortcodes. * TWEAK - Improved code for the mycred_buy and mycred_buy_form shortcodes. * TWEAK - Moved gateway processor from init to template_redirect. * TWEAK - Adjusted how gateway comments are logged and displayed in the admin area. * TWEAK - Adjusted the coupon load processor to make customizations easier. * TWEAK - New mycred_leaderboard_position shortcode replaces the mycred_my_ranking shortcode. * TWEAK - Improved DB Query for users leaderboard position. * TWEAK - By default the mycred_leaderboard shortcode will return the top 25 users instead of all users. * TWEAK - Badges in the wp-admin area will no longer show all badge images but just the main image and the top-level image (if used). * TWEAK - The mycred_badges shortcode can now be wrapped around a template to design how each badge is shown. * TWEAK - Added bootstrap support to the mycred_transfer shortcode. Added option to set a pre-set amount to transfer which disabled the option to select the amount to transfer. * TWEAK - Cleaned up the transfer processor code to improve logic and customizations. * TWEAK - The transfer widget now supports the same attributes as the mycred_transfer shortcode. * TWEAK - Updated parsecsv library to version 0.4.2. * TWEAK - Shortcodes are now loaded during "after_theme_setup" to allow shortcode replacements via a theme or plugin. * TWEAK - Moved Network module from mycred-network.php file to mycred-module-network.php in the modules folder. * TWEAK - Cleaned up all admin screen ids myCRED uses. Replaced underscores with hyphens, shortened some string and implemented the use of MYCRED_SLUG. * TWEAK - Re-labeled BuddyPress profile hooks. * TWEAK - Updated myCRED Overview Dashboard widget. * FIX - Fixed the mycred_send shortcode button not updating as the transaction is executed. * FIX - Removed built-in add-ons file paths. This will make sure you can migrate installations without the issue or add-ons disappearing. * FIX - Number of payments to show in buyCRED payment histories are not saved. * FIX - Menu issue when editing certain custom post types. Fixed so the appropriate menu is kept open and if on WP 4.4 or higher, highlight the post type when editing / adding a new post. * FIX - When sorting users by points in the admin area, the sorting will not work if a specific role has been selected. * FIX - "Show Limits" settings for transfer widget is not getting saved. * FIX - Log times not honouring timezone settings on certain setups. * FIX - Emails are not sent to event owner in Events Manager Pro gateway on successful payments. * FIX - Non admins should not see the myCRED Setup notification in the admin area. * FIX - The myCRED gateway shows up twice when using Event Espresso 3.x.x. * FIX - Added support for rtMedia version 4.0 or higher. * FIX - Leaderboard should respect multisite installations by only showing members for a particular site (unless central logging is enabled). * REMOVED - mycred_user_got_demoted and mycred_user_got_promoted functions as the new version of the mycred_find_users_rank function no longer needs it. * REMOVED - mycred_get_badges function. * REMOVED - The mycred_sell_this_ajax shortcode has been depreciated and will be removed in the next major version. * REMOVED - Removed charge_from shortcode attribute from the mycred_transfer shortcode. * REMOVED - GD Star rating support. This will be available in a separate free plugin. * REMOVED - BuddyPress Gallery+ support. This will be available in a separate free plugin. * REMOVED - BuddyPress Links support. This will be available in a separate free plugin. = Previous Versions = https://mycred.me/support/changelog/