Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
vBulletin and iDevAffiliate Integration Details »
vBulletin and iDevAffiliate Integration
Mod Version: 1.00, by vb_mp (Member) vb_mp is offline
Developer Last Online: Sep 2010 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.7.2 Rating: (3 votes - 3.67 average) Installs: 15
Released: 14 Sep 2008 Last Update: Never Downloads: 65
Not Supported Uses Plugins Code Changes Re-usable Code Translations Is in Beta Stage  

NOTE: I have it installed on 3.7x, I haven't tried earlier versions.

Description: I have been searching around for a plugin to allow vBulletin and iDevIntegration (for affiliate management of vbulletin paid subscriptions) and could not find any.

I contacted iDevAffiliate and their response was that they did not know enough
about vbulletin to create a plugin themselves but they explain what I had to do
on the iDevAffiliate side to make things work.

Thanks to vbulletin.org members Marco van Herwaarden, Dismounted, Delphiprogrammi, Opserty for pointing me in the right direction as this is my first vbulletin plugin.

This mod integrates iDevAffiliate commission tracking.

NOTE: Keep in mind, I assume that you are fairly well versed and comfortable with editing files/templates and following the flow of things.

Installing:

*********************************
STEP 1
*********************************
In payments.php in your forum root find the following code lines:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Replace them with the following:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

*********************************
STEP 2
*********************************
In payment_gateway.php file in your forum root find the following code lines:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Add the following code under the above code ( make sure you replace YOURDOMAINNAME with your domain name and YOURIDEVINSTALLATIONFOLDER with your idev installation folder:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

*********************************
STEP 3
*********************************
Install the idevaffiliate_integration Product via the Plugin Manager

*********************************
STEP 4
*********************************
Go to AdminCP -> vBulletin Options -> iDevAffiliate Integration Settings and enable use of iDevAffiliate by selecting 'Yes' and saving.

That's it, you are ready to use iDevAffiliate with vBulletin.

Dont Forget To MARK AS INSTALLED
And Also Don't Forget To Visit DNXpert.com

Download Now

Only licensed members can download files, Click Here for more information.

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Jpilot / Vbulletin Integration for Vbulletin 3 d3nnis vBulletin 3.0 Full Releases 36 14 Dec 2005 00:25

  #16  
Old 15 Sep 2008, 23:29
jasculs jasculs is offline
 
Join Date: Jun 2007
Originally Posted by vb_mp View Post
Yea I have tested it - it is currently working and functional on my forum ( link is above in the original post ). People are spreading the affiliate link around and commissions are being generated on subscription purchases.

The things to note - according to iDevAffiliate they will be releasing a new release that will enable deletion of commissions on payment reversal... currently when a payment is reversed (for example on a refund) you have to manually cancel the subscription in iDevAffiliate... this is not a vBulletin problem though, rather a iDevAffiliate deficiency.

The guys from iDevAffiliate have promised that this payment reversal curl target url will be released in new upgrade, once that's there I will add it to this mod.
Great Thank You!!...I just wanted to be sure before I purchased the software. I know it may be a little off topic, but how do you like the affiliate software?

Also if I have people on recurring billing can I have it work with recurring commissions?

Thanks a lot!!
Jason
Reply With Quote
  #17  
Old 15 Sep 2008, 23:50
vb_mp vb_mp is offline
 
Join Date: Feb 2008
I like iDevAffiliate, easy to install, works well.

Paypal recurring commissions (I have them on my forum) are treated as individual payments each month - it works quite well.

User signs up - iDevAffiliate records payment information, affiliate gets commission. Next month, PayPal triggers IPN on recurring payment, idevaffiliate checks payment info and credits affiliate with another commission - and so on.

iDevAffiliate has some internal recurring commissions setup - make sure you ignore that - it's some manual recurring commissions crap.

Also, once you install iDevAffiliate, make sure you download this patch that fixes a bug of approving/unapproving commissions:
http://www.idevsupport.com/index.php...temid=16&nav=0

Cheers
Reply With Quote
  #18  
Old 16 Sep 2008, 02:50
Quarterbore Quarterbore is offline
 
Join Date: Mar 2005
You listed some pros in your credits but I likewise really would prefer not install this until it is plugin based. I would rather add a couple queries on the occasion where I get a purchase then to have to risk that there is an upgrade out and I need to deal with hardcoded file edits.
Reply With Quote
  #19  
Old 16 Sep 2008, 12:57
vb_mp vb_mp is offline
 
Join Date: Feb 2008
Originally Posted by Quarterbore View Post
You listed some pros in your credits but I likewise really would prefer not install this until it is plugin based. I would rather add a couple queries on the occasion where I get a purchase then to have to risk that there is an upgrade out and I need to deal with hardcoded file edits.
That's totally cool with me. I posted this mod to allow the people that have been searching for a mod for this for ages to get it and use it.

I will however fix it to use hooks as soon as some hooks are made available by vBulletin.com
Reply With Quote
  #20  
Old 17 Sep 2008, 00:23
mambomouth mambomouth is offline
 
Join Date: May 2005
I have installed but have not recorded any sales.
Wait traffic site to send a sale .
Reply With Quote
  #21  
Old 17 Sep 2008, 03:19
yahoooh yahoooh is offline
 
Join Date: Oct 2002
is integrated for users in vbulletin?
Reply With Quote
  #22  
Old 17 Sep 2008, 03:53
Quarterbore Quarterbore is offline
 
Join Date: Mar 2005
OK, I am looking at the code and I do not have an iDevAffilaite package (yet) so I need to guess a little what is going on here so bear with me as I try to summarize what this is doing.

Step 1: payments.php simply adds the IP address of the person who has purchased the subscription.

Comment: It really is too bad vBulletin doesn't have a hook right after the code you quote as we could simply run an update where "hash" = $hash. The hook that is in the while loop could be used however if we added a variable for example:

paidsub_order_paymentbit Plugin:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Question - Is this IP information important and required (remember I don't use the script)? I ask as with vBulletin we know more about a user then just the IP they used to pay including registration IP, all IPs they used, plus e-mail, etc. Again, I have not used the affiliate script so just curious why this matters as we know who the user is and that is the most important matter for us.

Step 2: payment_gateway.php saves the sale in the affiliate script

This is really an amazing file in vBulletin as there is not a single hook in this file There is no way around a file edit in this file but I am not convinced we have to use the file to do this. I say this as we do have hooks in class file that does subscriptions:

./includes/class_paid_subscription.php

I am curious why we can't use the paidsub_build hook to log the sale into the affiliate script? There could also be a plugin added to paidsub_delete to handle reversals too (I think).

Summary:

I am really not trying to be critical as I am very thankful you shared your work as I have been considering adding an affiliate script to my own premium site. I am really not going to be able to test this without buying the software but I think that if you look at the possibility of moving the STEP 2 of this to the Class that you may be able to remove the file edits.

Also, as I said above, I don't see the value in the "Step 1" addition as vBulletin allows us to know a whole lot about our users that are far above the IP they are using when they pay for a subscription

I welcome feedback on my humble oppinions as I know there are developers and coders on here with far more skill then I have.

Cheers,
Ken
Reply With Quote
  #23  
Old 17 Sep 2008, 15:59
vb_mp vb_mp is offline
 
Join Date: Feb 2008
Thanks for your comments Ken.

I have left my answers below each part of yours:

Step 1: payments.php simply adds the IP address of the person who has purchased the subscription.
iDevAffiliate tracks recurring commissions by IP. Since we can't guarantee the same IP on each recurring payment, the only way to solve this is to save the IP on initial payment in the vbulletin database and pull it out on recurring payment to pass to iDevAffiliate.
(In iDevAffiliate they use the IP on recurring payment to give the commission to the right person since on recurring payment there is no other way to figure out what belongs to whom). I guess they could have solved it by just using a payment id or hash or whatnot but that is up to idevaffiliate not vbulletin.

It is also important that the IP is stored on the initial payment and not on the recurring payments... hence the insert at the point in payments.php where the insert to paymentinfo table happens.


Step 2: payment_gateway.php saves the sale in the affiliate script
Excellent observation here. As I mentioned in my original post I am new to vBulletin and I could not find the hooks to do that part.

I will modify the plugin to include the calls to the two hooks - this will eliminate 1 file edit and leave us with just the one file edit in payments.php

Thanks!
Reply With Quote
  #24  
Old 17 Sep 2008, 16:06
mambomouth mambomouth is offline
 
Join Date: May 2005
Hello Ken,

idevaffiliate is limited to what one can do with extra information.
Most of the files are encoded so there not much on the Idev script that one can edit.

There are three Optional Variables that one can pass to the sales.php page
which records the sales of products etc.

See Variables setting page:
http://demo.idevdirect.com/admin/set...tion=37&type=4

I own another script called Jam:
http://jam.jrox.com/

Which I think is a better script because you can reverse charge backs plus
it more secure because it uses a key API to make sure that it your script calling
the sales page.

Personally I love to see an affiliate system finished in VB it has a refer hook built in.
I think they started it but did not finish it.

If a hook in the payment class etc. and there was maybe another two to three tables added to VB this could be done.



By the way still testing this mod but it has not record any sales on it at this point.

As you can see I have been at this for some time old post:
http://www.vbulletin.org/forum/showthread.php?t=140446

Again thanks vb_mp and all for taking the steps to get this done

Cheers,
Brian

Last edited by mambomouth; 17 Sep 2008 at 16:09. Reason: my fine spelling skills:)
Reply With Quote
  #25  
Old 17 Sep 2008, 16:09
vb_mp vb_mp is offline
 
Join Date: Feb 2008
Hi Brian,

You can test it with a family member's paypal.

Clear your cookies and reset your IP (switch DSL OFF and ON) then purchase through your affiliate link.

I have got affiliates making commissions on my forum.
Reply With Quote
  #26  
Old 17 Sep 2008, 16:23
mambomouth mambomouth is offline
 
Join Date: May 2005
Hi VB_MP,

Thanks believe it works I have been getting sales.
But its just not been recorded I'll wait a day or two more.
Where I setup aff's links are on Google ad and other links so It should work etc.

Cheers,
Brian
Reply With Quote
  #27  
Old 17 Sep 2008, 16:50
mambomouth mambomouth is offline
 
Join Date: May 2005
You know that another good mod for this is to add Google analytics code for sale
on ROI for ad's.
Reply With Quote
  #28  
Old 17 Sep 2008, 19:59
vb_mp vb_mp is offline
 
Join Date: Feb 2008
Hm @Quarterbore,

I am trying to move the payment_gateway edit code above into a plugin on the paidsub_build hook.

When in the build_user_subscription method in class_paid_subscriptions, we don't have direct access to paymentinfo data including

paymentinfo['amount']
paymentinfo['ipaddress']
paymentinfo['paymentinfoid'];

How do you suggest I retrieve them? With an extra query?
Reply With Quote
  #29  
Old 17 Sep 2008, 20:16
Quarterbore Quarterbore is offline
 
Join Date: Mar 2005
Originally Posted by vb_mp View Post
Hm @Quarterbore,

I am trying to move the payment_gateway edit code above into a plugin on the paidsub_build hook.

When in the build_user_subscription method in class_paid_subscriptions, we don't have direct access to paymentinfo data including

paymentinfo['amount']
paymentinfo['ipaddress']
paymentinfo['paymentinfoid'];

How do you suggest I retrieve them? With an extra query?
I can help with that tonight after work as I don't need to have the idevaffiliate script to work on that

Now, I do see that the hook is inside of a function so the only values I expect we have to work in there are the ones defined:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

That will likely mean a query would be needed but I would need to drop some test code into that hook to see what variables are in memory that we can use. I hope I didn't waste a bunch of your time with my suggestion and I will see what I can get out of here after work.
Reply With Quote
  #30  
Old 17 Sep 2008, 20:38
Quarterbore Quarterbore is offline
 
Join Date: Mar 2005
Edit - never mind I had the wrong hook

You can get the variables in memory from this code if you add it to a plugin off the hook we need to test but it didn't work for me when I just did a test subscription via PayPal so I am not sure why...


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

I need to look at this later.

Last edited by Quarterbore; 17 Sep 2008 at 20:45.
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 15:29.

Layout Options | Width: Wide Color: