So here is an email I sent to a few other people regarding integrating with Zencart, that tries to explain it more. Until I write another blog update and spend a little more time on it, this is all I have I am afraid. But hopefully explains how it works.. If you email me for the file and more info, you wont get anything more than this at the moment I am afraid, so I hope you can make some sense of this and it is helpful.

The key to find out what functions you can call is to look into the subscribers.php file and find out the all the function names. Then you can call these using an XML call.

******************************************

I think I have had a good breakthrough tonight… I needed to work on the site I originally did when I wrote the blog. I originally had to change some IEM files to make updating Custom fields work. But I updated IEM to the latest version recently for which my code did not work… so I decided to see if I can get away with not changing IEM code (so future updates work OK).

It turns out you can use the XML API to call the PHP API functions found in /admin/functions/api/subscribers.php. So you can see all the possible functions in this file such as “SaveSubscriberCustomField()”. The problem I had was how to call this PHP function using the XML call. If you have the system on the same server you are integrating I think you can include the Interspire PHP files into your other system so you can call this PHP function directly… but my systems are on a different server so I need to use the XML via CURL. In the xml.php file within the “switch ($handlerMethod)” for the default case, is a little script that says “if the XML method does not exist, use the PHP function of same name”. So I just found out how to use the XML to call the functions in the subscribers.php file such as “SaveSubscriberCustomField()”. This means I do NOT need to modify IEM files which I wanted to avoid, and why I dont want to give the files out.

One problem though is to update Custom Fields only one XML call can be made per custom field (I think) so I have to loop through an array of all the custom field data and send the XML call each time. This is not good due to multiple CURL operations each time a change is made, it would probably increase time and resources, but I cant see how to pass all the data in one XML call.

So I should update the blog sometime to describe this with an example, although I am really busy. But i get a lot of people asking so I should get round to it sometime.

In the meantime I have attached a class file I have created that I include in my Zencart files, in each page for creating an account, editing an account, changing newsletter subscriptions and updating address book and contact details. On each of these page files I call the relevant class methods. I include the file as follows:-

require(‘iem_subscriber_update.php’);
$iem_update = new IemUpdater();

Then I can call the functions in my system as follows:-

$iem_update->iemEditExistingUser($iem_newsletter_user, $customer);

You can see I pass some arrays of data to these functions which is passed to IEM.

I also do a lot of coding before calling these functions to process the data into correct formats, check if the email address has changed etc. These are in specific Zencart files and may be different for every system to integrate with.

It STILL needs improvement… for example… I have not yet used the function to get the subscriber ID based on Email address, I have been storing the subscriber ID in my Zencart database for use when changing newsletter data, which is not good. I need to use the email address to retrieve the ID from IEM. Also, I store Custom Data in my Zencart database, but there may be a function to get it from IEM which is also the best way.

There is also some customer specific code in the file, such as in the iemAddSubscriberToList() function. I need to streamline this function like the others and take the customer specific code out back into Zencart.

*********************************************************

Hope this helps until I am able to write an explanation on my blog.