Snap Affiliates v2.0 for v1.5.0 and later

[lat9]

I'm having a small issue that probably has a really easy fix I just can't see... I would love some help if anyone has a moment. I'm running ZC 1.5.0 and Snap Affiliates 2.2.0

I managed to get a few banner images up and displaying for affiliates to use. My issue is that in their code, the path to the image location is a relative path, not the full path, so it does not display in their pages (so it says something like /images/referrers/ref.207.207.jpg instead of http://mysite.com/zencart/images/ref...ef.207.207.jpg) Is there a way to change this path so it works?

Also, is there a way to choose which page each image points to? So I might have one image point to the main cart page, but another image point to a particular product?

I LOVE this mod, by the way, and I can see how many many hours have gone into it. Thank you, developers, for all the time you've put into it! And thank you in advance for any help you can give me on this :)

Here's a patch to the get_referrer_image function located in /includes/templates/YOUR_TEMPLATE/templates/tpl_referrer_tools_default.php to correct the relative path issue:

function get_referrer_image($width, $height, $filename) {
  $image_html = '';
  $alt = TEXT_IMAGE_ALT_TEXT;
  $filename = HTTP_SERVER . DIR_WS_CATALOG . $filename;  /*v2.3.0a*/
  $image_html .= '<div class="imagewrap">';
  $image_html .= '<div class="imagetitle">' . sprintf(TEXT_X_BY_Y_PIXELS, $width, $height) . '</div>';
  $image_html .= "<img class=\"referrer_image\" src=\"$filename\" width=\"$width\" height=\"$height\" alt=\"$alt\" /><br />";
  $image_html .= '<textarea rows="3" cols="1">&lt;a href="' . get_referrer_link(FILENAME_DEFAULT) . "\"&gt;&lt;img src=\"$filename\" width=\"$width\" height=\"$height\" alt=\"$alt\" /&gt;&lt;/a&gt;</textarea><br />";
  $image_html .= '</div>';

  return $image_html;
}

That update will be included in v2.3.0 of the plugin. Choosing the page (and presumedly alt-text) that a particular image references will take a bit of thinking ...

[treblesand]

Thank you for such a fast response and for fixing this issue for me. Your fix worked like a charm ;) For now, I'll put together a tutorial for my affiliates to teach them how to turn images into direct links to products... I was just hoping there was an easier way to do the work for them and make it easier for them to include their links more often. AWESOME work and thank you so much for the quick fix! :)

[treblesand]

Is there something I can add easily to allow my affiliates to track the clicks they are generating? It would be fantastic if they could see clicks by link, but even if they can just see that between date x and date y they've seen z number of clicks, that would be great. I could probably work this out on my own with a small idea of where to start... Thanks again for all your help!!

[lat9]

Is there something I can add easily to allow my affiliates to track the clicks they are generating? It would be fantastic if they could see clicks by link, but even if they can just see that between date x and date y they've seen z number of clicks, that would be great. I could probably work this out on my own with a small idea of where to start... Thanks again for all your help!!

Reading through the thread on this plugin's parent, I generated the following "wish list" from features requested:

- (2.0.0) Move language-specific constants to language files to allow language translation
- (2.0.0) Use built-in currency formatting so that the amounts show in the store's default currency
- (2.1.0) Allow customization to control which order-status values should "trigger" a commission, e.g. no commission on 'Pending' order status.
- Better email system
- More detailed application (payment choice)
- The ability to create an affiliate account without needed a store account.
- (2.1.0) A configuration switch that identifies whether or not an affiliate gets commission when placing an order with their affiliate key.
- Commission Rate by category: This will need a code rewrite.
- Better stats such as Click tracking
- (2.1.1) SEO Support : Certain SEO modules work with this as is right now. (Like Ultimate SEO's). Others, it's tricky.
- Ability to edit details in ACP.
- Ability to deny applications in ACP.
- Ability to edit details on the customer side. (Some might change websites.)
- Ability to add "Where to send my check?"
- (2.2.0) Customization of cookie lifetime
- Customer Purchases per Cookie - All vs. One

No promises on when these would be implemented, but if current users would "chime in" with their priority order I'd have a better idea of where to focus; at this time I'm handling the low-hanging (i.e. easiest) fruit first!

[lat9]

I've submitted v2.3.0 to the plugins area:

1. Starting with this version, there is one core-file overwrite.
2. Added an Order ID column to the detailed view in the admin's Customers->Referrers page, to allow the store administrator to have an easy way to see the order for which the commission was paid.
3. Added an indicator to the admin's Customers->Orders page, to allow the store administrator to quickly see that the order was based on a commission. A link-back to the referrer's details is also included
4. BUGFIX: When using the affiliate banners, the image-link produced was relative instead of absolute so it didn't reference the actual store.
5. Added "Purchases Per Cookie" configuration variable

[picandnix]

Hi there Lat9
luvin' the latest editions.
Noticed on the upgrade info data that there's a file path missing, (nit picking I know but somebody is bound to get lost one day)

Files changed:

/includes/classes/observers/class.snap_order_observer.php
/includes/templates/YOUR_TEMPLATE/**templates**/tpl_referrer_tools_default.php
/YOUR_ADMIN/referrers.php
/YOUR_ADMIN/includes/functions/extra_functions/init_referrers.php
/YOUR_ADMIN/includes/languages/english/referrers.php

[picandnix]

what has been changed to this file since v2.10 please?
/includes/classes/observers/class.snap_order_observer.php

[picandnix]

Yes it's me again...
which file or files are responsible for allowing the affiliate to edit their website details on their affiliate account page please, I can't seem to find it mentioned in the upgrade (2.2>2.3) changed/new files list.

[lat9]

Hi there Lat9
luvin' the latest editions.
Noticed on the upgrade info data that there's a file path missing, (nit picking I know but somebody is bound to get lost one day)

Files changed:

/includes/classes/observers/class.snap_order_observer.php
/includes/templates/YOUR_TEMPLATE/**templates**/tpl_referrer_tools_default.php
/YOUR_ADMIN/referrers.php
/YOUR_ADMIN/includes/functions/extra_functions/init_referrers.php
/YOUR_ADMIN/includes/languages/english/referrers.php

Thanks, picandnix, I'll get that into the updated readme.html.

what has been changed to this file since v2.10 please?
/includes/classes/observers/class.snap_order_observer.php

Er, in my local copy, the support for the purchases-per-cookie; in the distribution, nada. Here's the file that should be in the v2.3.0 version:

<?php
// +----------------------------------------------------------------------+
// |Snap Affiliates for Zen Cart                                          |
// +----------------------------------------------------------------------+
// | Copyright (c) 2013, Vinos de Frutas Tropicales (lat9) for ZC 1.5.0+  |
// +----------------------------------------------------------------------+
// | This source file is subject to version 2.0 of the GPL license.       |
// +----------------------------------------------------------------------+

if (!defined('IS_ADMIN_FLAG')) {
  die('Illegal Access');
}

class snap_order_observer extends base {

  function snap_order_observer() {
    $this->attach($this, array('NOTIFY_ORDER_DURING_CREATE_ADDED_ORDER_HEADER'));
  }
  
  function update(&$class, $eventID, $paramsArray) {
    global $db;
    $commission = 0;
    
    if (isset($_SESSION['referrer_key']) && zen_not_null($_SESSION['referrer_key'])) {
      $sql = "SELECT referrer_customers_id, referrer_approved, referrer_banned, referrer_commission 
                FROM " . TABLE_REFERRERS . " 
               WHERE referrer_key = '" . $_SESSION['referrer_key'] . "'";
      $query = $db->Execute($sql);

      if (!$query->EOF) {
        $commission = floatval($query->fields['referrer_commission']);
        if ($commission < 0) {
          $commission = 0;
        }
      }
    } 
    
    /*----
    ** Allow the commission so long as the referrer has been approved, is not banned and (unless specified by the store's
    ** Configuration->Affiliate Program options) is not the customer associated with the referral!
    */
    if ($commission > 0 && 
        $query->fields['referrer_approved'] != 0 && 
        $query->fields['referrer_banned'] == 0 && 
        (SNAP_AFFILIATE_KEY_USE === 'true' || $query->fields['referrer_customers_id'] != $_SESSION['customer_id'])) {  /*v2.1.0c*/
      $sql_data_array = array('commission_orders_id' => $paramsArray['orders_id'],
                              'commission_referrer_key' => $_SESSION['referrer_key'],
                              'commission_rate' => $commission,
                              'commission_paid' => 0);

      zen_db_perform(TABLE_COMMISSION, $sql_data_array);
      
//-bof-a-v2.3.0      
      // -----
      // If an affiliate's referral_key cookie is to be deleted on a customer's first purchase ... delete the cookie.
      //
      if (SNAP_AFFILIATE_COOKIE_PURCHASES == 'One') {
        setcookie('referrer_key', '', time() - 3600, '/');
      }
//-eof-a-v2.3.0

    }
  }
 
}

Yes it's me again...
which file or files are responsible for allowing the affiliate to edit their website details on their affiliate account page please, I can't seem to find it mentioned in the upgrade (2.2>2.3) changed/new files list.

I don't have that feature implemented ... yet.

[lat9]

Reading through the thread on this plugin's parent, I generated the following "wish list" from features requested:

- (2.0.0) Move language-specific constants to language files to allow language translation
- (2.0.0) Use built-in currency formatting so that the amounts show in the store's default currency
- (2.1.0) Allow customization to control which order-status values should "trigger" a commission, e.g. no commission on 'Pending' order status.
- Better email system
- More detailed application (payment choice)
- The ability to create an affiliate account without needed a store account.
- (2.1.0) A configuration switch that identifies whether or not an affiliate gets commission when placing an order with their affiliate key.
- Commission Rate by category: This will need a code rewrite.
- Better stats such as Click tracking
- (2.1.1) SEO Support : Certain SEO modules work with this as is right now. (Like Ultimate SEO's). Others, it's tricky.
- Ability to edit details in ACP.
- Ability to deny applications in ACP.
- Ability to edit details on the customer side. (Some might change websites.)
- Ability to add "Where to send my check?"
- (2.2.0) Customization of cookie lifetime
- (2.3.0) Customer Purchases per Cookie - All vs. One

No promises on when these would be implemented, but if current users would "chime in" with their priority order I'd have a better idea of where to focus; at this time I'm handling the low-hanging (i.e. easiest) fruit first!

Wishlist updates shown above.