Affiliates WooCommerce Views

Views toolbox for the Affiliates WooCommerce integrations.

Description

Views toolbox for the Affiliates WooCommerce integrations.

This plugin requires:

  • Affiliates, Affiliates Pro or Affiliates Enterprise
  • WooCommerce

This currently provides the [affiliates_woocommerce_orders] shortcode which is used to show order details for an affiliate’s referrals.

Recommended usage: Use it along with the stats shortcode provided by Affiliates Pro (and Enterprise):

Your referrals overview: 

Related orders: [affiliates_woocommerce_orders]

The date fields provided by the  shortcode affect what is displayed with the[affiliates_woocommerce_orders] shortcode, so that an affiliate can see a summary of referral results and the details of the corresponding orders.

The [affiliates_woocommerce_orders] shortcode supports the following attributes:

  • status – defaults to “accepted”
  • from – from date
  • until – until date
  • for – show data for the current “day”, “week” or “month”, not provided by default
  • order_by – “date” (default” or “amount”
  • order – “ASC” or “DESC” for ascending or descending order
  • limit – to limit the number of results displayed, no limit is used by default
  • auto_limit – to limit the number of results displayed when no from or until dates are given, “20” by default
  • show_limit – a message shown before results stating “Showing up to %d orders.”, %d is a placeholder for the limit used

Download

You can get the plugin on GitHub (download the ZIP file).

Installation

  1. Upload or extract the affiliates-woocommerce-views folder to your site’s /wp-content/plugins/ directory. You can also use the Add new option found in the Plugins menu in WordPress.
  2. Enable the plugin from the Plugins menu in WordPress.

Frequently Asked Questions

= Why would I want this? =

Currently you would want it to show order information to affiliates.

Screenshots

None available. Try it out.

Changelog

= 1.0.0 =

  • Provides the [affiliates_woocommerce_orders] shortcode.

Upgrade Notice

= 1.0.0 =

  • Initial release.

55 Responses to Affiliates WooCommerce Views

  1. maiky15 July 19, 2013 at 6:05 pm #

    Hello,
    I add this plugin because I want that my affiliates can see the pending orders when they log into their panel.

    I use this shortcode: [affiliates_woocommerce_orders status=”pending”]

    The problem is that the pending order show 2 times, It shows duplicated the same order, I see the box of the pending order and below the same order…

    some idea please?
    Regards,
    Maiky

  2. maiky15 July 20, 2013 at 11:40 am #

    Hi again!
    Solved, affiliates see duplicated orders until admin change status to “pending” with this shortcode:
    [affiliates_woocommerce_orders status=”pending”] affiliates see duplicated the orders in “waiting” status.

    Sorry,
    Maiky

  3. maiky15 July 20, 2013 at 11:50 am #

    Hello,

    Is there any way to add an attribute to the shortcode [affiliates_woocommerce_orders status=”pending”] to add the shipping address?

    I can pay for this modification if necessary.

    Regards,
    Miguel

    • antonio July 22, 2013 at 7:39 am #

      Hi,
      I sent you a customized solution.
      But beware of the data privacy laws.
      cheers

  4. alexus July 25, 2013 at 7:27 am #

    Hi! When product is variable in top of page appearce variations. Can you resolve that bug? Thanks!

    • antonio July 26, 2013 at 4:49 pm #

      Hi, you can resolve it, in line 129 of affiliates-woocommerce-view-master / affiliates-woocommerce-views.php

      //$item_meta->display();
      $output .= $item_meta->display(false, true);

      Thanks for the feedback

      • alexus July 27, 2013 at 7:27 am #

        Big thanks! Resolved

  5. Maiky15 July 29, 2013 at 8:31 am #

    Hello,

    I add this code in line 129 and returns fatal error…

    //$item_meta->display();
    $output .= $item_meta->display(false, true);

    I have to add in line 129 right?

    Regards,
    Maiky15

    • antonio July 29, 2013 at 8:59 am #

      I do not know if it is exactly that line. Where have $item_meta->display(); replace it with the new lines. cheers

  6. Maiky15 July 30, 2013 at 8:52 am #

    Hi Antonio,

    SOLVED! thanks a lot.
    Maiky15

  7. cdoylend August 14, 2013 at 12:16 am #

    Hello,
    Is there any way to add an attribute to the shortcode [affiliates_woocommerce_orders status=”pending”] to add the name and company name of the person who made the orde runder the referral purchase?

    I can pay for this modification if necessary as well.

    Cheers and thanks,

    c.

    • antonio August 14, 2013 at 8:33 am #

      Hi,
      if you add:
      $output .= "<p>" . $order->billing_company . "-" . $order->billing_first_name . "</p>";
      in affiliates-woocommerce-views.php line 100, you can view the company and name of the person who made the order.
      cheers

      • uk October 8, 2013 at 4:14 am #

        Hi antonio,

        How to add referral’s userid as well? It’d be good for the affiliates to know not just the first name of the person who made the purchase but also her userid at the site so that we can do a better job tracking and providing closer support to the referrals.

        I tried to add the line to line 100 of affiliates-woocommerce-views.php file. It shows buyer’s first name above the order form. Is there a way to add this information to the form?

        Thank you so much!

        • antonio October 8, 2013 at 6:08 am #

          Hi,
          you can use:
          $output .= "" . $order->billing_company . "-" . $order->billing_first_name . "-" . $order->user_id . "";
          More info in woocommerce documentation.

          In this case, I have used , but you can use others html label, and use css to custom your appearance.

  8. uk October 2, 2013 at 9:22 am #

    Hi,

    If I want to display data for the current month, is it correct to use [affiliates_woocommerce_orders for=”month”]?

    What if I want to show data for the last two months? What would be the correct syntax to use with the [affiliates_woocommerce_orders] shortcode?

    Thank you,

    • kento October 3, 2013 at 11:49 am #

      Hi uk,

      Yes that would be the correct syntax, it doesn’t allow you to show data for the last two months though.

      Cheers

  9. uk October 3, 2013 at 5:13 pm #

    Hi Kento,

    Thanks for your reply.

    Is there a way to show data for the last two months? And, what’s the difference between [affiliates_woocommerce_orders for=”month”] and [affiliates_woocommerce_orders]?

    And, what would be the max number allowed with “auto_limit” attribute and what is the max number you would suggest us to use?

    thank you,

    • kento October 7, 2013 at 6:48 pm #

      Hi,

      If you specify for=”month”, it will limit it to orders from within the current month. There’s no alternative to show show for x months in the past, that would require someone to implement it – GitHub forks are welcome 🙂

      I would leave the auto_limit at its default, it will only be used if no date range applies.

      Cheers

  10. maiky15 October 4, 2013 at 5:54 pm #

    Hi Kento,

    Sorry but I still have problems with products with variations, I use the php file that you send me, the one that shows client address, and I put the line that fix the problem with variations, but I still have problems with products with variations…

    The affiliates-woocommerce-views.php code is this:

    (Edited : please don’t post huge chunks of code)

    In affiliates control panel I use this string:

    [affiliates_woocommerce_orders status=”pending”]

    I try to solved, but I can’t, sorry.
    I hope you can help me with this.

    Regards,
    Maiky

    • kento October 7, 2013 at 10:43 am #

      Hi there,

      Please fork the project on GitHub, it’s impractical to review your changes here.

      • Maiky15 October 7, 2013 at 3:29 pm #

        Hi,

        I create an account: https://github.com/maiky15/affiliates-woocommerce-views/

        But I don’t know were/how to paste the code… 🙁

        Regards,
        Maiky

        • Maiky15 October 7, 2013 at 5:03 pm #

          Hi,

          I think that I put the code right in github…

          https://github.com/maiky15/affiliates-woocommerce-views/compare/itthinx:master…patch-1?quick_pull=1

          Thanks,
          Maiky

          • kento October 7, 2013 at 7:06 pm #

            Ok thanks, but that’s the exact same code as in the master 🙂

            Anyway, what exactly is the problem you mentioned earlier please?

          • Maiky15 October 8, 2013 at 7:50 am #

            Hi Kento,

            Thanks for your patience…

            The problem is that affiliates don’t see the products with variations. I changed the code (with //$item_meta->display();
            $output .= $item_meta->display(false, true);…
            but still don’t appear in the list products that have variations.

            Maybe I don’t put the code in the correct line, but I can’t take the file from github because you send me one file with a modification that send the customer address to my affiliates and I want that too, so I need a file that send customer’s address and shows products with variations…

            Regards,
            Maiky

            • antonio October 10, 2013 at 3:04 pm #

              Hi Maiky15,
              please change line 131 to:

              $output .= $item_meta->display(false, true);

              cheers

  11. Emil October 6, 2013 at 8:02 am #

    Hello,

    Thank you so much for the great service! The program is top-notch and I got it going. There is one bug I encountered, though. When I use the [affiliates_woocommerce_orders] code to provide the affiliates with more specific information, the meta description of the products that they’ve sold (basically in this case the “size” of the product that the customers choose before ordering) is not showing in the report fields of the product, but as plain text one under another on the very top of the page. I do hope it can be fixed.

    Thank you so much again!

    • antonio October 7, 2013 at 9:26 am #

      Hi,
      maybe there is a problem with you css files. Can you give us a url to have a look?
      cheers

  12. Maiky15 October 15, 2013 at 10:02 am #

    Hi Antonio,

    Only say thanks for the great support you offer.

    Regards,
    Maiky

    • antonio October 15, 2013 at 4:37 pm #

      thank you

  13. snehal October 23, 2013 at 1:31 pm #

    how i can display affiliates extra tokens shortcodes on page. I want to display it on page also.

    • antonio October 23, 2013 at 2:46 pm #

      Hi,
      Affiliates Extra Tokens is used to have available more tokens on affiliates notifications. There isn’t a shortcode to show this extra tokens.

  14. snehal October 23, 2013 at 1:55 pm #

    How to display Affiliate ranking – display ambassador ranking on sales compared to other ambassadors.Affiliates API (http://api.itthinx.com/affiliates/) to create shortcode is not useful.Please help me.

    • antonio October 25, 2013 at 5:17 am #

      Sorry, there isn’t an affiliates comparator, you can do it using Affiliates API.
      If you would like to ask for a quote on custom projects, please use the contact section.
      cheers

  15. Snehal October 29, 2013 at 6:16 am #

    In affiliate notification code is
    Account: affiliate [affiliate_name] (ID [affiliate_id])
    User: [user_displayname]
    Email: [user_email]
    Order ID: [order_id]
    Total Purchase Amt: [order_total]

    And email i got this output:
    Account: affiliate Direct(ID1)
    User: [user_displayname]
    Email: [user_email]
    Order ID:0
    Total Purchase Amt:0.00

    why this happen?shortcodes display as it is. I installed both plugin i.e. Affiliates Extra Tokens and Affiliates WooCommerce Views

    • antonio October 29, 2013 at 6:29 am #

      Hi,
      please be sure you have activated Affiliates Extra Tokens.

  16. Snehal October 29, 2013 at 7:50 am #

    hi,
    these plugins are activated.

    • antonio October 29, 2013 at 8:59 am #

      Hi,
      if you want, you can send us admin dashboard access to support at itthinx dot com (please indicate this comment in the email), and we’ll have a look.
      cheers

  17. Snehal October 31, 2013 at 7:14 am #

    hi,
    sorry for late.How can i send u details.Can u give Email Id?

    • antonio October 31, 2013 at 9:40 am #

      Hi,
      you can send us to support at itthinx dot com (please indicates this comment in the email).

  18. Snehal October 31, 2013 at 11:16 am #

    hi,
    i send you details.Please check it.

    • antonio October 31, 2013 at 12:05 pm #

      Hi,
      the problem is because you use Affiliates Member to generate commissions, and in this case “referral” has not “user_id” and “order_id” so the tokens are not replaced.
      These tokens work with commissions generated with woocommerce or other e-commerce system.
      If you look at Affiliates->Referrals and expand details, on “Data” you can see that there isn’t user_id.
      cheers

  19. Snehal October 31, 2013 at 12:11 pm #

    Hi,
    Thanx.Then what’s the solution.

    • kento November 18, 2013 at 5:44 pm #

      You can’t use these tokens because the information required to use them is not recorded with that plugin.

  20. Alex foster April 3, 2017 at 3:12 pm #

    Hey,
    I have put the shortcode and it works perfectly fine.

    But when there are no refferals, it just shows Showing up to 20 orders.”

    It shpuld show something like “You havent reffered any one yet.” or something like that.

    I would really appreciate if you could provide some custom code for this.

    • antonio April 4, 2017 at 6:19 am #

      Hi Alex,
      You can use the ‘show_limit’ param. If you leave it empty, this message is not displayed.
      If you only want to display this message when there are referrals, you could change this line:
      if ( !empty( $show_limit ) && $limit > 0 ) {
      for this one:
      if ( !empty( $show_limit ) && ( $limit > 0 ) && ( sizeof($referrals) > 0 ) ) {
      Kind Regards,
      Antonio B.

      • Alex foster May 1, 2017 at 6:36 am #

        Hey Antonio,
        Thank you for the custom code.

        Recently after the woocommerce update, now “[affiliates_woocommerce_orders]” also prints contact form 7 referrals.
        I guess it should only show woo-commerce orders and not any other referral details.
        It shows the referral amount and order#0

        • antonio May 8, 2017 at 8:05 am #

          Hi Alex,
          We are working on an update. While you can download a pre-1.1.0 version from here.
          Thank you for letting me know.
          Kind Regards,
          Antonio B.

  21. Giacomo May 19, 2017 at 9:03 am #

    In WooCommerce Affiliate Pro plugin can do a job of MLM powerline UP
    I’ll explain
    A member is affiliated, and uses a link to join and affiliate:
    1 member is his
    2 member passes to his sponsor
    3 member is his
    4 member passes to his sponsor
    5 member and his
    6 member passes to his sponsor
    From 7 to 11 members is his
    The 12 member goes to the sponsor
    From 13 to 17 member is his
    The 18 member goes to the sponsor
    And so to infinity
     
    Thank you

    • antonio May 20, 2017 at 7:24 am #

      Hi Giacomo,
      If you want multi-level, you need Affiliates Enterprise version. Documentation page is available here.
      Kind Regards,
      Antonio B.

  22. Giacomo May 20, 2017 at 7:56 am #

    Hi Antonio,
    Thanks for your prompt reply.
    Ok for business affiliates I see that does MLM
    But does this make the powerline pass up as an example I sent you?
    I looked but I can not see if it does this function.
    Also the cost of the $ 129 lifetime license has? I see that it should be renewed but I do not see how much time

    • antonio May 20, 2017 at 8:35 am #

      Hi Giacomo,
      sorry, I don’t understand your example.
      With the plugin, if you have:
      Affiliate_A
      — Affiliate_B (is referred by A)
      — — Affiliate_C (is referred by B)
      — — — Affiliate_D (is referred by C)
      If Affiliate_D gets a commission, then Aff_C, Aff_B and Aff_A gets commissions, than can be fixed rates or relative rates.
      I hope that my example can help you.
      Each purchased download includes one year of access to downloads, support and updates. Please have a look at the Terms and Conditions page.
      Kind Regards,
      Antonio B.

  23. Joël September 26, 2017 at 1:44 pm #

    I am full losed.

    How can i make that
    Referer one become 1€
    Tiers one become 20% of referer one
    Tiers two become 5% of Tiers one

    • Kento September 27, 2017 at 9:13 am #

      Hi Joël,

      You can set this up using the tier rates and combined with fixed commissions, but it depends a bit on whether you want this fixed commission in general or just for a particular product or case. Can you please post this in the support forum http://itthinx.com/forum/affiliates-enterprise/ so that our support team can help you further? You’ve posted on an unrelated plugin page and that forum is for premium support which you have access to.

      You might also be interested in getting access to our new version 3.x, I’ll be happy to provide you with the plugin files, I’ll follow up with an email in a few minutes.

      Cheers

  24. Troy September 27, 2017 at 9:29 pm #

    Hope this is the right place to ask this question. I would like to know if your Affiliate plug-in tracks affiliate sales of products. In other words, does the plug-in store the product(s) that were sold?

    • Kento October 4, 2017 at 2:59 pm #

      Hi Troy,

      Yes you’re welcome to ask about that here 🙂

      The Affiliates plugins (also applies to Affiliates Pro and Enterprise) record referred sales, they record the order number that corresponds to a referral. With that you can track back a commission to its related order and thus its products. The system doesn’t need to keep an extra record for that as it ‘knows’ to which order it refers. The Affiliates WooCommerce Views plugin helps to show additional information based on the order data.

      Cheers

Leave a Reply