Download zen-gizmo for Zen Cart
The connector and installation is successfully tested with Zen Cart 1.3.8, running on PHP 5.2.11
The installation is straight forward and can be done in a couple of minutes by following these 4 steps:
- copy new files
- modify existing files
- enable remote authentication in zendesk
- install and configure the connector in Zen Cart
Requirements
You need to be able to upload new files to your Zen Cart Shop and modify existing ones.
FTP access to your Zen Cart Installation
PHP 4 > 4.0.4
Listing of open Tickets in “my Account page” : PHP 5 >= 5.1.3 with curl
Step 1 – copy new files
Download the Zen-Gizmo connector and unpack the zip-archive.
New files (just copy them to your Zen Cart installation):
zencart_zendesk_install.php
zencart_zendesk_remote_authentication.php
images/account_helpdesk.gif
includes/languages/english/account_helpdesk.php
includes/modules/pages/account_helpdesk/header_php.php(new directory)
includes/templates/template_default/templates/tpl_account_helpdesk_default.php
Step 2 – modify existing files
modify these files according the installation-manual as part of the package:
includes/filenames.php(add one line)
includes/languages/english/account.php(add two lines)
includes/templates/template_default/templates/tpl_account_default.php(add one block of html)
Step 3 – enable remote authentication
open your Zendesk-Administration and navigate to “Account > Security” and check “Enable remote authentication”:
Remember: When this option is active you are no longer able to login to zendesk as before, but you can always you this URL to login manually:
http://<yourzendesk>.zendesk.com/access/normal/
Enter the URL which handles the remote authentication. Zendesk will call this URL to authenticate users.
http://<yourshop.com>/zencart_zendesk_remote_authentication.php
The Remote logout URL is called by zendesk when a user clicks on “logout” in the zendesk application. Could be any URL but I like to redirect the customers to their account-page
http://<yourshop.com>/index.php?main_page=account
or
http://<yourshop.com>/index.php?main_page=account_helpdesk
The Authentication token is automatically generated by zendesk. You need to copy the token and paste it into the configuration of your Shop (next step)
Step 4 – install and configure the connector
Run the installation routine:
http://<yourshop.com>/zencart_zendesk_install.php
Result:
In you osCommerce Administration you will now find a Configuration-Group “Zendesk Connector”
Please copy the Authentication Token into the Connector-Configuration.
Enter the Domain of your Zendesk.
Enter Agent Email & password you would like to use for the connector. We recommend to set up a new account in the zendesk administration, but it is safe to utilized an existing one.
Decide if you would like to show the helpdesk in the “my account” page.
Decide if you would like to list open requests.
How to test
For the initial testing please disable “show helpdesk” – this allows you to test the remote authentication before providing this feature to your customers.
When everything is set-up try to open
http://<yourzendesk>.zendesk.com
This request should redirect you to the login-page of your shop. Please login with your (test) customer credentials.
After login you should automatically be redirected to zendesk – and greeted with your name (right corner).
Done!
Now your are done with the installation and test. Please enable “show helpdesk” and any customer will be able to access zendesk from their account page. You can easily test the connector by doing a login into the account-page of your osCommerce shop and then try to open a new request.
Since remote authentication is now enabled in zendesk, you need to use this URL to login into zendesk without a customer account in your osCommerce shop:
http://<yourzendesk>.zendesk.com/access/normal/
I hope you enjoy your Zen-Gizmo connector and your customers will love your helpdesk!
Trouble?
The installation is straight forward and should work instantly. If you should have issues please contact us.
Download zen-gizmo for Zen Cart
zendesk, osCommerce, Zen Cart are trademarks or registered trademarks (in respective order)
of zendesk.com, Harald Ponce de Leon, zencart.com.