Integration HOWTO package
Before Installation
TeleSign Zen Cart Module v1.0 package is created for Zen Cart version 1.3.8a and might now work with older or newer versions. During installation process you will have to modify some original Zen Cart files,
if you would like to see detailed list of changes in patch format
visit diffs page .
If you do not have current Zen Cart installation and you want to create new website store you can download our pre-integrated package. In that case right after installation (work exactly the same as for normal Zen Cart)
you might proceed to the
Configuration section of this site
Download Zen Cart v1.3.9d + Telesign Zen Cart module v1.0 (api update).
Simple Installation
Copy
telesign_zen_cart_module directory content to your
ZEN_CART parent directory.
Notice: Use cp command with b option to backup existing Zen Cart files.
Example:
[blaze ~]$ cp -rvb ./telesign_zen_cart_module/* ./zencart/
`./telesign_zen_cart_module/get_pin.php' -> `./zencart/get_pin.php'
`./telesign_zen_cart_module/includes' -> `./zencart/includes'
`./telesign_zen_cart_module/includes/functions' -> `./zencart/includes/functions'
`./telesign_zen_cart_module/includes/functions/sessions.php' -> `./zencart/includes/functions/sessions.php'
`./telesign_zen_cart_module/includes/modules' -> `./zencart/includes/modules'
.
.
.
`./telesign_zen_cart_module/zen_countries_example.sql' -> `./zencart/zen_countries_example.sql'
[blaze ~]$
Installation with modification of existing files
If you do not wish to override your existing files you can modify them using
patch application. In order to do so, copy
telesign_module directory content to your ZEN_CART parent directory as in the example code below:
[blaze ~]$ cp -bvr ./telesign_module/* ./zencart/
`./telesign_module/generate_codes.php' -> `./zencart/generate_codes.php'
`./telesign_module/get_pin.php' -> `./zencart/get_pin.php'
.
.
.
`./telesign_module/telesign_lib/telesign_sms_request.php' -> `./zencart/telesign_lib/telesign_sms_request.php'
`./telesign_module/telesign_lib/telesign_status_request.php' -> `./zencart/telesign_lib/telesign_status_request.php'
`./telesign_module/zen_countries_example.sql' -> `./zencart/zen_countries_example.sql'
[blaze ~]$
Notice: The telesign_module directory does not contain files you will patch and should not override any existing files.
Then visit the
diffs page to download necessary patches (those with .patch extension). You should save them to the directory where original Zen Cart file exists. Then run patch command as in the example code below:
[blaze zencart_patch]$ ls
on_load_main.js.patch on_load_main_org.js
[blaze zencart_patch]$ cat on_load_main_org.js
update_zone(document.create_account);
[blaze zencart_patch]$ patch -p1 < on_load_main.js.patch
patching file on_load_main_org.js
[blaze zencart_patch]$ cat on_load_main_org.js
update_zone(document.create_account);update_code(document.create_account);
[blaze zencart_patch]$
Do this for every file listed with diff patch.
Updating SQL tables
Next step is to create SQL file that will modify your countries table (by adding country-specific phone prefixes). If you wish, you can make a backup of your countries table before doing it. To do so, click
here to see screenshot of example phpMyAdmin settings for creating a backup file.
Use
generate_codes.php php script (included in
telesign_tools directory) to generate sql file for your database. To do so, enter your console and type:
[blaze telesign_zen_cart_module]$ php generate_codes.php [prefix] > countries.sql
Change prefix into your database table prefix (for example
zen_, you should have set this up during installation) or omit this argument if your prefix is empty. Now you should import created file (countries.sql) into your database. You can see our
example screenshot to see default settings for phpMyAdmin.
Configuration
Open your Admin panel and navigate to
tools -> template selection. Click the Edit button, then choose
TeleSign Template from the drop down menu and click the Update button. Now, navigate to
tools -> layout boxes controller and at the bottom of the page click the Reset button.
Click to see
example
Your new template is now enabled and ready for you to customize. Please configure it and try to create a new account.
Click to see
example
There are two more configuration options that you have to set up before module will be ready to work - CustomerID and AuthorizationID. To change those please open ZEN_CART/telesign_lib/telesign_conf.php file. You will be able to change several more settings as well, each of them closely described.
Who can help in the installation
Please contact me at:
tomw@telesign.com
Downloads
