Snap Affiliates v2.0 for v1.5.0 and later

[jcbazemore]

I've read though the whole thread so far and I'm looking forward to adding this to my site. Since our site is being setup so that organizations (booster clubs, youth groups, churches, etx) can sell our products as a fundraiser is there a way to "force" someone shopping on our site to use an affiliate? We do not want to sell the products ourselves but only through the groups that are doing business with us.

[picandnix]

I've read though the whole thread so far and I'm looking forward to adding this to my site. Since our site is being setup so that organizations (booster clubs, youth groups, churches, etx) can sell our products as a fundraiser is there a way to "force" someone shopping on our site to use an affiliate? We do not want to sell the products ourselves but only through the groups that are doing business with us.

This mod, in basic terms, is a way for your affiliates to direct a potential customer to YOUR site to buy the product from YOU, the affiliate then earns a commission on the sale they sent your way.
So how can a customer buy something if YOU aren't selling?

[jcbazemore]

This mod, in basic terms, is a way for your affiliates to direct a potential customer to YOUR site to buy the product from YOU, the affiliate then earns a commission on the sale they sent your way.
So how can a customer buy something if YOU aren't selling?

Sorry, that could have been a bit clearer on my part. It is products that we're selling but since the point of our business is to help organizations raise money we don't want to be in "competition" with them on the sale of our products. Our business is not selling coffee, our business is helping THEM to sell coffee as a fundraiser. For example, our first client is a High School Football team booster club. We want people to come to our site not to buy coffee from us, but to buy coffee from them and we're just the one's handling the transaction. We want to make sure that if someone just stumbles across our site or types in the root site name without using the affiliate link that they have to select that High School Booster club to purchase from. Of course our goal is to have many many of these type booster clubs or other groups signed up with us. Then, if someone comes to our site directly they'll have to "choose" their affiliate. Hopefully that makes things a little clearer than mud!

[lat9]

@jcbazemore, it'll take some custom coding but it should be doable. When a customer comes to your site via an affiliate, their initial link has the affiliate's "key" as part of the link variables. That "key" is stored in a cookie in the client's browser, so it's detectable -- in fact, that's what /includes/init_includes/init_snap.php does, looking for a cookie with your store's defined cookie-prefix and setting a session variable if the cookie's present.

Essentially, my interpretation of what you want is that the store operates like a "normal" Zen Cart if the customer has an affiliate cookie loaded and operates like a showcase with prices otherwise (see the setting Configuration->My Store->Store Status). If you use your admin's Tools->Developers Toolkit and search for STORE_STATUS in all catalog PHP files, you'll see the list (not too many) of files that use and process based on that variable. You'll need to make modifications to (or around) each of those files, replacing the STORE_STATUS processing based on the presence/absence of the affiliate cookie.

My guess at an initial look is that you'd want to go down the path of setting your database's "Store Status" to "Showcase with Prices" and make changes to the necessary core files to switch back to "normal" if the cookie is present.

[buggypy1]

Hello Everyone,
My customers cannot open the affiliate signup page and it is not showing in their accounts also.
I have install all the files as mentioned in the readme file.
I have tried it by using this sample mentioned http://www.mysite.com/index.php?main...r_signup&terms
My website is www.247donny.com
Can someone help me with this please?
Thanks.

[picandnix]

Hello Everyone,
My customers cannot open the affiliate signup page and it is not showing in their accounts also.
I have install all the files as mentioned in the readme file.
I have tried it by using this sample mentioned http://www.mysite.com/index.php?main...r_signup&terms
My website is www.247donny.com
Can someone help me with this please?
Thanks.

I can see that you haven't uploaded all the files fully.

[buggypy1]

I can see that you haven't uploaded all the files fully.

I have upload all the files in Images, Includes and Your admin.

Can you please let me know which one is still missing?

Thanks.

[jcbazemore]

@jcbazemore, it'll take some custom coding but it should be doable. When a customer comes to your site via an affiliate, their initial link has the affiliate's "key" as part of the link variables. That "key" is stored in a cookie in the client's browser, so it's detectable -- in fact, that's what /includes/init_includes/init_snap.php does, looking for a cookie with your store's defined cookie-prefix and setting a session variable if the cookie's present.

Essentially, my interpretation of what you want is that the store operates like a "normal" Zen Cart if the customer has an affiliate cookie loaded and operates like a showcase with prices otherwise (see the setting Configuration->My Store->Store Status). If you use your admin's Tools->Developers Toolkit and search for STORE_STATUS in all catalog PHP files, you'll see the list (not too many) of files that use and process based on that variable. You'll need to make modifications to (or around) each of those files, replacing the STORE_STATUS processing based on the presence/absence of the affiliate cookie.

My guess at an initial look is that you'd want to go down the path of setting your database's "Store Status" to "Showcase with Prices" and make changes to the necessary core files to switch back to "normal" if the cookie is present.

@lat9 I'm glad to hear it's doable and I'm sure I'll be bothering you more for details as I get stuck. Until I've got it worked out my workaround is to duplicate each item for each client adding "-client id" to the end of the product Model Number. Luckily we just have the one client so far and only four items. It won't be trackable via their affiliate page, but they'll at least get credit from us when someone buys "Irish Crème-fchstdc" vs "Irish Crème-fchscheer"

[jcbazemore]

Hey Lat9 I just found out last night that instead of four products we're going to have about 15 products at launch. This being said I have a feature request for future versions (unless there's something I can modify to make this happen now.) Is it possible to have the referrer code listed somewhere on the invoice? We offer custom labeling for our coffee's and the label is determined by which organization the order is placed for. I know I can tell that by clicking on the referrer link next to the order in the Admin section, but it would be easier if we could see it on the invoices that are printed out and not be tied to a computer when slapping on labels!

[lat9]

Hey Lat9 I just found out last night that instead of four products we're going to have about 15 products at launch. This being said I have a feature request for future versions (unless there's something I can modify to make this happen now.) Is it possible to have the referrer code listed somewhere on the invoice? We offer custom labeling for our coffee's and the label is determined by which organization the order is placed for. I know I can tell that by clicking on the referrer link next to the order in the Admin section, but it would be easier if we could see it on the invoices that are printed out and not be tied to a computer when slapping on labels!

Here's a snippet of code that determines whether an order included a commission and returns the referrer's code (or false if no code was found):

function get_referrer_key($oID) {
    // -----
    // Check to see if the specified order has an associated referrer commission ...
    //
    $sa_sql = 'SELECT r.referrer_key 
                 FROM ' . TABLE_REFERRERS . ' r, ' . TABLE_COMMISSION . ' rc 
                 WHERE rc.commission_orders_id = ' . (int)$oID . '
                 AND rc.commission_referrer_key = r.referrer_key;

    $sa_info = $db->Execute($sa_sql);

    return ($sa_info->EOF) ? false : $sa_info->fields['referrer_key'];
}

and then use that function in /YOUR_ADMIN/invoice.php (for v1.5.1 around line 132), changing:

  <tr>
    <td><?php echo zen_draw_separator('pixel_trans.gif', '1', '10'); ?></td>
  </tr>
  <tr>
    <td class="main"><b><?php echo ENTRY_ORDER_ID . $oID; ?></b></td>
  </tr>
  <tr>
    <td><table border="0" cellspacing="0" cellpadding="2">
      <tr>
        <td class="main"><strong><?php echo ENTRY_DATE_PURCHASED; ?></strong></td>
        <td class="main"><?php echo zen_date_long($order->info['date_purchased']); ?></td>
      </tr>
      <tr>
        <td class="main"><b><?php echo ENTRY_PAYMENT_METHOD; ?></b></td>
        <td class="main"><?php echo $order->info['payment_method']; ?></td>
      </tr>

to

  <tr>
    <td><?php echo zen_draw_separator('pixel_trans.gif', '1', '10'); ?></td>
  </tr>
  <tr>
    <td class="main"><b><?php echo ENTRY_ORDER_ID . $oID; ?></b></td>
  </tr>
  <tr>
    <td><table border="0" cellspacing="0" cellpadding="2">
      <tr>
        <td class="main"><strong><?php echo ENTRY_DATE_PURCHASED; ?></strong></td>
        <td class="main"><?php echo zen_date_long($order->info['date_purchased']); ?></td>
      </tr>
      <tr>
        <td class="main"><b><?php echo ENTRY_PAYMENT_METHOD; ?></b></td>
        <td class="main"><?php echo $order->info['payment_method']; ?></td>
      </tr>
<?php
if (get_referrer_key($oID) !== false) {
?>
      <tr>
        <td class="main"><b>Affiliate Code:</b></td>
        <td class="main"><?php echo get_referrer_key($oID); ?></td>
      </tr>
<?php
}
?>

You can place the function definition at the top of invoice.php, just after the "require" statement for application_top.php.