Step 1 – copy new files

Download the Zen-Gizmo connector and unpack the zip-archive.

New files (just copy them to your osCommerce installation):

osc_zendesk_install.phposc_zendesk_remote_authentication.phpaccount_helpdesk.phpimages/account_helpdesk.gifincludes/languages/english/account_helpdesk.phpincludes/languages/espanol/account_helpdesk.phpincludes/languages/german/account_helpdesk.php

Step 2 – modify existing files

Modify these files according the installation-manual as part of the package:

account.php (add one block of html)includes/filenames.php (add one line)includes/languages/english/account.php (add two lines)includes/languages/espanol/account.php (add two lines)includes/languages/german/account.php (add two lines)

Step 3 – enable remote authentication

open your Zendesk-Administration and navigate to Manage > Security and check Enable Single Sign-On:

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/

Select Zendesk Remote Auth as the Mode and enter the URL which handles the remote authentication. Zendesk will call this URL to authenticate users.

http://<yourshop.com>/osc_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>/account.phporhttp://<yourshop.com>/accoount_helpdesk.php

The Authentication token is automatically generated by Zendesk (Shared Secret). 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>/osc_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.

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!