Home Forums Plugin Support AffiliateWP MLM Matrix compression

19 replies, 2 voices Last updated by  Christian Freeman 1 month, 1 week ago
  • mkandlad
    Participant
    @mkandlad
    #10752

    I recently purchased the AffiliateWP MLM plug-in and I wondered how the plug-in deals with cancelled accounts in a forced matrix, i.e. does the matrix get compressed or does the cancelled space remain unfilled?

  • Christian Freeman
    Participant
    @christianf
    #10802

    In the current version of the MLM plugin, it will compress the commissions to look for Active affiliates in the Upline. So, if one of the Upline affiliates is in Inactive status, it will skip them and look for the next Active Parent Affiliate above them.

    For cases where a Parent Affiliate is deleted, we are developing a feature for re-assigning their Downline to another affiliate in the Upline. I don’t have an estimate for when this will be ready yet, but we are about halfway finished with this feature as of now.

  • mkandlad
    Participant
    @mkandlad
    #10808

    Thank you for your reply.

    I am doing some testing on a new matrix set up and I have a question relating to the way Direct Referrals and Indirect Referrals are handled.

    I have set up an ecommerce shop on my blog https://duckboardsandstilts.com/shop. I got a friend to purchase one of the $4.97 ebooks. The purchase was conducted via Stripe and everything worked fine in terms of awarding and recording a 25% referral to the Direct Affiliate.

    The Direct Affiliate who referred this sale is one of my first level affiliates, so the purchase was done by my second level affiliate. The attached file is a screen shot of the Referral page of my Affiliates Area. My query is about the transactions recorded on 2nd October.

    Please clarify the following:

    1. I understand the $0.25 on the top line to represent the Indirect referral from my second level sub affiliate. ( I have 7 levels of my matrix set a 5% for all seven levels.)

    2. I do not understand the $0.25 Direct referral on the screen shot. Is this the same $0.25 indirect referral also recorded as a direct referral

    3. When viewing referral information in the AffiliateWP back office in WordPress, I can see information relating to the direct referrals but I do not see any information relating to the indirect referral in the AffilateWP admin information. My concern is making sure I can keep tabs of all earnings (both direct and indirect referrals) for each affiliate, particularly when I have a lot of affiliates in the system, in order that I may pay affiliates accordingly. Is the Referral Tab of the Affiliate Area the only area whenre both direct and indirect referrals are presented together?

    With kind regards,

    Derrick

    Attachments:
    You must be logged in to view attached files.
  • Christian Freeman
    Participant
    @christianf
    #10811

    Hi Derrick,

    To answer your questions:

    1) Yes, that is correct.

    2) Yes, the AffiliateWP Referrals list shows ALL referrals. It doesn’t have the ability to filter out the Indirect Referrals in the current version.

    3) In the WP Admin, it shows ALL referrals as well. It actually shows more than the Affiliate Area, because admin has the ability to view Pending Referrals also. But if you look closely, you’ll see the Indirect Referrals listed there in the Referrals list in WP Admin. You’ll notice that it display’s the Level information in the Description column.

  • mkandlad
    Participant
    @mkandlad
    #10821

    Hi Christian,

    Thank you so much for your prompt reply. Your answerers are clear and I now understand the reporting information relating to affiliate referrals.

    However, taking the screen shot example that I attached to my last message, I am nevertheless still concerned that the way the information is displayed in the Referrals Page of the Affiliate Area is a little ambiguous and may lead affiliates to believe that they have been awarded two commissions of $0.25 – the indirect commission displayed on the first line and the direct commission displayed as the first item on the lists of direct commissions. That is certainly the impression I had when I first saw the report. I wondered if you had come across the problem in the past and whether it would be possible to add some sort of explanatory note to the page, informing affiliates that the Indirect and direct referrals with the identical labels are in fact one ad the same?

    In addition, it appears that a similar problem exists with affiliate email notifications. See the attached example of two notifications I received when one of my direct, first level referrals purchased the same $4.97 ebook. In this case I received an email advising me that I had been awarded a direct referral of $1.24, this being the 25% commission from the $4.97 sale. However, I also received a second email advising me that I had been awarded an Indirect referral of $1.24, which is obviously incorrect and may lead to confusion and disputes. Again, have you been made aware of this causing any in that past and how would you propose to fix it.

    With kind regards,
    Derrick

    Attachments:
    You must be logged in to view attached files.
  • Christian Freeman
    Participant
    @christianf
    #10825

    Hi Derrick,

    There is another way to do this. You can add a customized version of the Referrals Tab (A file called “dashboard-tab-referrals.php”) to your Theme in a custom folder called “affiliatewp”.

    I’m going to put together a quick code snippet for you, which will adjust that file and enable filtering out the Indirect Referrals. I’ll follow up again soon with the code.

  • Christian Freeman
    Participant
    @christianf
    #10826

    Regarding the additional email notification, it is supposed to prevent the New Referral email from being sent, if it’s an Indirect Referral. I’ll investigate this further and get back to you.

  • Christian Freeman
    Participant
    @christianf
    #10827

    Also, here’s AffiliateWP’s instructions on how to modify template files:

    https://docs.affiliatewp.com/article/118-modifying-template-files

  • Christian Freeman
    Participant
    @christianf
    #10830

    Alright, here’s the code snippet for the modified version of the Referrals Tab in the Affiliate Area:

    https://gist.github.com/codelion7/a6fa0918804ff5a626c7e1274122b810

    To use this, click the Download ZIP button on the upper right hand side of the screen. Then, once it’s donwloaded, unpack the file within the zip folder, and add it to your “affiliatewp” folder, which should be uploaded to your site’s active theme folder.

    Let me know how it works for you.

  • mkandlad
    Participant
    @mkandlad
    #10833

    Thanks Christian, I’ll have a go at doing the modifications and get back to you. Will this present a problem with having to re-do the modifications when the plugin is updated?

    Regarding the email notifications, the problem of the additional email seems to apply only with new direct referrals, not with indirect referrals. It seems to me that when one refers a new direct referral, one should not receive an additional email informing then that they also have an indirect referral, as reflected in the second email example that I sent you.

    Kind regards,
    Derrick

  • Christian Freeman
    Participant
    @christianf
    #10835

    If the template for the Referrals Tab is updated in a future version of AffiliateWP core, yes, this template would have to be updated to match as well.

    It’s really just a matter of adding these 2 lines of code (Line 55 and 56):

    https://gist.github.com/codelion7/a6fa0918804ff5a626c7e1274122b810#file-dashboard-tab-referrals-php-L55

    About the email notifications, when I created this notification for Indirect Referrals in version 1.1.4, I predicted that this may occur. So I created a way to prevent the Direct Referral email from being created. I haven’t received both emails in my tests, so I’m going to investigate this further on my end, to see why the function may not be preventing the email on your site.

    Do you have any other AffiliateWP add-ons active, and if so, which ones, and what are their current plugin versions?

  • mkandlad
    Participant
    @mkandlad
    #10839

    Hi Christian,

    I am currently using the affiliatewp-invites-1.1 plugin.

    Just to be clear about the email notification. It is not the case that a new direct referral email is created if it’s an indirect. It is the other way round. An indirect referral email is created when a first level direct referral is created awarding an indirect referral of the same value as the legitimate direct referral.

    Regards,
    Derrick

  • mkandlad
    Participant
    @mkandlad
    #10840

    Presumably, if one was to sponsor a direct referral and that referral spills over a lower level in the matrix, then one would potentially receive a direct referral commission and an indirect level commission when this direct/sub-affiliate made a sale?

  • Christian Freeman
    Participant
    @christianf
    #10841

    Do you have any other AffiliateWP add-ons active, besides Invites?

    You’re saying that it’s sending a New Indirect Referral Notification for Direct Referrals? Hmmm, I may need to investigate this further on your site directly. Can you provide me with admin-level login credentials for your site, so that I can look into this?

    It’s impossible for the same affiliate to receive a Direct Referral and an Indirect Referral commission for the same sale. This is because, the system detects the person that referred the affiliate/customer, and issues the person that referred them a Direct Referral. Then, it looks for the Upline of that affiliate and issues Indirect Referrals accordingly. Indirect Referrals can be issued based on the Direct Affiliate or the Parent Affiliate (Default).

  • mkandlad
    Participant
    @mkandlad
    #10845

    Hi Christian,

    I have no other affilaiteWP plugins apart form Invites.

    I am happy to give you access to my WordPress Admin area. I obviously do not want to do this on this forum. Do you have a private line I can contact you on and some way of verifying it is you?

    Also, I uploaded the modified version of the dashboard-tab-referrals.php file. See attached screen shot of result. Fortunately, I save a copy of the original so I have reinstated that.

    Kind regards,
    Derrick

    Attachments:
    You must be logged in to view attached files.
  • mkandlad
    Participant
    @mkandlad
    #10847

    May I suggest it may be easier to simply modify the statement at the top of the referrals page to clearly indicate that the indirect referrals shown the top of the page are shown again in the table of direct referrals. The present statement does not make it clear and I only realised this after some time trying to understand the information.

  • Christian Freeman
    Participant
    @christianf
    #10848

    There was a typo in the code snippet.

    Download the updated version here:

    https://gist.github.com/codelion7/a6fa0918804ff5a626c7e1274122b810

    You’re probably right about the Label for the Direct Referrals section. I could change it to say “All Referrals” or something similar.

    Let me know how the updated template file works for you. And you can email me at propluginmarketplace(at)gmail.com, where I can securely provide further support when logging into your site.

  • mkandlad
    Participant
    @mkandlad
    #10852

    Hi Christian,

    Thanks for correcting the error in the code snippet. See attached modified referrals page. I would suggest that this is much better as it clearly distinguishes between Direct and Indirect referrals, although, to avoid confusion, it might be better the remove the latter part of the top sentence which states that Indirect referrals are also shown in the direct referrals tab.

    Regards,
    Derrick

    Attachments:
    You must be logged in to view attached files.
  • Christian Freeman
    Participant
    @christianf
    #10861

    Ahhh, I see what you mean. I’ll remove that text in the next MLM update. That was a remnant from older versions when the Indirect Referrals list was shown within the Sub Affiliates tab. Now that it has been moved to the Referrals Tab, there’s no need for it.

    I’m going to follow up with you soon, after I finish reviewing your site.

  • Christian Freeman
    Participant
    @christianf
    #10863

    Alright, I’ve fixed this in the latest update for MLM (1.1.5). I may still make further improvements to this version before I release it, but I’m going to give you an early release, to fix this issue for you immediately.

    I’ve sent the download link to you via email. Please download it, and test it to ensure that you no longer receive those Indirect Referral Emails for Direct Referrals. I also updated that statement above the Indirect Referrals list, as I mentioned.

    Thanks for reporting this.

You must be logged in to reply to this topic.