{"id":81067,"date":"2018-02-01T09:10:47","date_gmt":"2018-02-01T09:10:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/easy-digital-downloads-commission-notes\/"},"modified":"2018-02-01T09:18:17","modified_gmt":"2018-02-01T09:18:17","slug":"edd-commission-notes","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/edd-commission-notes\/","author":15868593,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"trunk","tested":"4.9.29","requires":"4.0","requires_php":"","requires_plugins":"","header_name":"Easy Digital Downloads - Commission Notes","header_author":"Sell Comet","header_description":"Record commission notes and allow your vendors to easily view them.","assets_banners_color":"4ea0b0","last_updated":"2018-02-01 09:18:17","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=LLR26ABB7C39Q","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/edd-commission-notes\/","header_author_uri":"https:\/\/sellcomet.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":667,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog","faq"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1813311","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1813309","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"1813307","resolution":"1544x500","location":"assets"},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"1813308","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[8387,568,5440,5484,2665],"plugin_category":[45],"plugin_contributors":[151730,151729],"plugin_business_model":[],"class_list":["post-81067","plugin","type-plugin","status-closed","hentry","plugin_tags-digital","plugin_tags-download","plugin_tags-downloads","plugin_tags-easy-digital-downloads","plugin_tags-edd","plugin_category-ecommerce","plugin_contributors-mandyjonesmusic","plugin_contributors-sellcomet","plugin_committers-sellcomet"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/edd-commission-notes_4ea0b0.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>Commission Notes<\/strong> for Easy Digital Downloads allows you to record and store important notes alongside your commission records. Vendors can view the notes via the <code>{edd_commissions}<\/code> short code, and notes can be recorded automatically when a discount code is applied at the checkout, or when commissions are revoked.<\/p>\n\n<h3>Use-case Examples<\/h3>\n\n<p>Let\u2019s look at some real-world examples of how Commission Notes could potentially be utilised in different scenarios:<\/p>\n\n<ul>\n<li>You want to provide your vendors with detailed information relating to how and why the commission record was revoked, including relational data such as the payment and transaction IDs.<\/li>\n<li>You want to let your vendors view when a discount code was used on an order they receive commissions for, helping them make more sense of the final amount rewarded<\/li>\n<li>You want to add a commission note when an order looks suspicious or fraudulent, giving your vendors prior warning that the commission may be revoked<\/li>\n<\/ul>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Record commission notes on a per-commission basis<\/li>\n<li>Store an unlimited number of notes on a per-commission basis<\/li>\n<li>Automatically record a note, including the payment ID, when an order is refunded<\/li>\n<li>Automatically record a note containing any discount codes used on the order where commissions were rewarded<\/li>\n<li>All notes are viewable by your vendors via a responsive, lightweight modal-box on the front-end <code>{edd_commissions}<\/code> short code<\/li>\n<li>Seamless integration with Easy Digital Downloads and Commissions settings<\/li>\n<li>Translation-ready and contains a POT file to help get you started translating into your own native language<\/li>\n<li>Have a specific use-case? Commission Notes includes plenty of developer-ready filters and action hooks to make it possible!<\/li>\n<li>Developed using the best practices, with security, extensibility, and readability in mind<\/li>\n<\/ul>\n\n<p>This plugin requires <a href=\"http:\/\/wordpress.org\/extend\/plugins\/easy-digital-downloads\/\" title=\"Easy Digital Downloads\">Easy Digital Downloads<\/a> and <a href=\"https:\/\/easydigitaldownloads.com\/downloads\/commissions\/\" title=\"Commissions\">Commissions<\/a>.<\/p>\n\n<h3>Developers<\/h3>\n\n<p>Commission Notes was developed with developers and third party integrations in mind, here are a few examples of how to use the <code>EDDC_Notes<\/code> class.<\/p>\n\n<p><strong>get_notes()<\/strong><\/p>\n\n<p>Get the parsed notes for a commission as an array.<\/p>\n\n<pre><code>$notes = new EDDC_Notes( $commission-&gt;id );\n$notes-&gt;get_notes();\n<\/code><\/pre>\n\n<p><strong>add_note( $note = '' )<\/strong><\/p>\n\n<p>Add a note to the commission record. Returns the new note if added successfully, false otherwise.<\/p>\n\n<pre><code>$notes = new EDDC_Notes( $commission-&gt;id );\n$notes-&gt;add_note( 'Hello Friend' );\n<\/code><\/pre>\n\n<p><strong>get_notes_count()<\/strong><\/p>\n\n<p>Get the total number of notes we have after parsing.<\/p>\n\n<pre><code>$notes = new EDDC_Notes( $commission-&gt;id );\n$notes-&gt;get_notes_count;\n<\/code><\/pre>\n\n<h3>Bugs<\/h3>\n\n<p>If you find an issue, let us know <a href=\"https:\/\/github.com\/davidsherlock\/edd-commission-notes\/issues?state=open\">here<\/a>!<\/p>\n\n<h3>Support<\/h3>\n\n<p>Please visit the <a href=\"https:\/\/wordpress.org\/support\/plugin\/edd-commission-notes\">support page<\/a> if you need to submit a support request.<\/p>\n\n<h3>Contributions<\/h3>\n\n<p>Anyone is welcome to contribute to Commission Fees.<\/p>\n\n<p>There are various ways you can contribute:<\/p>\n\n<ul>\n<li>Raise an <a href=\"https:\/\/github.com\/davidsherlock\/edd-commission-notes\/issues\">Issue<\/a> on GitHub<\/li>\n<li>Send us a Pull Request with your bug fixes and\/or new features. Please open an issue beforehand if one does not currently exist.<\/li>\n<li>Provide feedback and suggestions on <a href=\"https:\/\/github.com\/davidsherlock\/edd-commission-notes\/issues?direction=desc&amp;labels=Enhancement&amp;page=1&amp;sort=created&amp;state=open\">enhancements<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Unpack the entire contents of this plugin zip file into your <code>wp-content\/plugins\/<\/code> folder locally<\/li>\n<li>Upload to your site<\/li>\n<li>Navigate to <code>wp-admin\/plugins.php<\/code> on your site (your WP Admin plugin page)<\/li>\n<li>Activate this plugin<\/li>\n<li>That's it!<\/li>\n<\/ol>\n\n<p>OR you can just install it with WordPress by going to Plugins &gt;&gt; Add New &gt;&gt; and type this plugin's name<\/p>\n\n<!--section=changelog-->\n<h4>1.0.0, January 31, 2018<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt>Installation Instructions<\/dt>\n<dd><ol>\n<li>Unpack the entire contents of this plugin zip file into your <code>wp-content\/plugins\/<\/code> folder locally<\/li>\n<li>Upload to your site<\/li>\n<li>Navigate to <code>wp-admin\/plugins.php<\/code> on your site (your WP Admin plugin page)<\/li>\n<li>Activate this plugin<\/li>\n<li>That's it!<\/li>\n<\/ol>\n\n<p>OR you can just install it with WordPress by going to Plugins &gt;&gt; Add New &gt;&gt; and type this plugin's name<\/p><\/dd>\n\n<\/dl>","raw_excerpt":"Record commission notes and allow your vendors to easily view them.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/81067","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=81067"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sellcomet"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=81067"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=81067"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=81067"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=81067"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=81067"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=81067"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}