KSD Contact Form 7 Integration Quickstart

Howdy. We have really wonderful news for you. Contact Form 7, the big dog in contact form management on WordPress and Kanzu Support Desk, the intuitive WordPress help desk met, had a cup of coffee and really liked each other. So much so that you can now integrate Contact Form 7 into Kanzu Support Desk and create tickets directly from your contact forms. Just like that!

Simply head over to your contact form editor and select the Kanzu Support Desk  tab. Yes, we put a ring on it.

Select the Enable ticket creation option to enable Kanzu Support Desk to create tickets directly from all entries into this contact form.

Before tickets can be created directly from your contact form, you must specify which fields in your contact form will correspond to the ticket name, email, subject and message using the inbuilt Contact Form 7 tags.

Simply select and enter which tag you want to use for  Name, Email, Subject and Message. Please note all these fields are required and the integration will not work properly if one or more is missing.

Finally save your contact form and enjoy the match made in heaven, as they say.

With love from the folks at Kanzu Code.

Forwarding your email to Kanzu Mail

Good morning class. Today, we’ll look at the exciting topic, “The life and habitation of fresh water snails”…. Oops. Wrong lesson. We have something way cooler. Let’s figure out how to forward all your top secret support emails to our highly secure Kanzu Mail server.

There are two ways we can get this done depending on where we are starting from (where your support email address is hosted). If your support email’s a Yahoo or Gmail address e.g. yoursupport@gmail.com, method 1 covers you. If your email’s hosted at your domain, you’ll  need to use the Forwarding from a server option:

  • Either from an email client e.g. Gmail, Yahoo etc.
  • Or from a server

Forwarding from an email client

Forwarding from a server

Forwarding emails from cPanel

  1. Ready. Set. Go. Login to your control panel, usually located at www.yourdomain.com/cpanel. Different CPanels use different themes; we’ll share what this’ll look like in 2 very common themes – Retro and Basic.  Click Forwarders under the Email section.
    Retro

     

    Basic
  2. Click Add Forwarder. 
    Retro

    Basic
  3. Fill in the necessary details as shown below and click the Add Forwarder button at the bottom of the form.
    Retro

     

    Basic
  4. Tada! And that’s about it. 

Forwarding emails from Gmail

  1. OK. Lets get the ball rolling. Click on the gear icon in the top right corner in Gmail and select Settings 
  2. In the Settings page head over to the Forwarding and POP/IMAP tab. Under it click the button Add a forwarding address 
  3. In the pop up box that appears enter the Kanzu Mail email address that you created and click Next
  4.  If all is well another browser window should open as shown below. Please click Proceed  so we can go do some more eh.. top secret stuff.
  5. That done. The mini browser window should close now and another pop up will appear in the Gmail settings. Click OK.
  6. Now head over to your WordPress admin dashboard and to Tickets. Yippee you should have your first ticket. If you don’t see it wait a couple of minutes and reload the page.
  7. Sorry to break up your happy dance but its just Gmail with your confirmation code. Copy it to the clipboard.
  8. Head back to the Gmail Settings page and paste it as shown below and click Verify.
  9.  That’s about it. Don’t forget to click the Save Changes button at the bottom of the Gmail Setings page.

KSD Twitter Quick Start

After activating KSD Twitter, navigate to the Twitter tab shown below

Before we get to what those shiny new settings actually do lets first authorize our twitter plugin to exactly what we want it to do. Hit that ‘Authorize Application ‘

If all goes well then you should see the words “Already authorized” next to the “Authorize Application” button.

With that all done we are in the last mile. Specify how often you would like your add on to pull tweets from your Twitter timeline and how many at a time it should pull. We have set sensible defaults for you but hey, one man’s sensible is another man’s completely nuts.

Have fun.

 

KSD Olark quick start

Please note that before you can use KSD Olark you must be a paid subscriber with Olark.

Once you have activated KSD Olark reload the settings page and navigate to the Olark tab as seen above.

Do you want to have the Olark Chat Widget on your site front end? Well we are more than glad to help you out and append it to your site on the front end. Simply select “No” on the option Olark already in use?

Then head over to your Olark dashboard and copy and paste you Site ID over here so we can know who we are talking to.

That done, now follow the step by step instructions on how to complete the integration between KSD Olark and your Olark account. They might look complicated at first but trust us they are all bark and no bite!

KSD HipChat quick start

Once you have successfully activated your KSD HipChat, reload the setting page and a HipChat tab will appear as seen below

Enter the room name and the room token which can be found on your team’s dashboard and save the settings.

To get these details, login to HipChat and click Rooms and select the room you’d want to receive notifications in:

That’s about it. You are now all set to receive notifications in your cool chat rooms among your hip roomies.

KSD Facebook quick start

After activating your KSD Facebook license, reload the settings page and a Facebook tab should appear as seen below.

ksd_tut_facebook_settings

Awesome. Now head over to your Facebook page and copy and paste the URL into the text box. That done one more step to go.

Hit the login button to integrate your shiny new add on with Facebook and that’s about it.

KSD Mail quick start

After installing and activating the KSD Mail plugin head over to the Tickets > Settings > Licenses tab and enter your license and click the Activate License button

Once your license has been activated click  create a free Kanzu Mail account set up an email account with Kanzu Mail to which you shall forward your emails. But that’s for later. Let’s move on.

On clicking the link a new window shall be opened at http://kanzucode.com/create-mail-account.  Fill out the form and click Create Account. Remember to note down your username and password for later.

Now head over to the Tickets > Settings > Kanzu Mail tab.

Awesome. Let’s use that username and password you made up earlier so we can log  into Kanzu Mail from the add-on so that it can retrieve your forwarded emails. Hang in there we’re almost done.

OK. Once you have successfully logged in the add-on can successfully retrieve emails from the Kanzu Mail server.

But how do my emails get to the Kanzu Mail server?

Yes. Great question Einstein. Well all you need to do is set up the email account that receives your support email e.g. support@acme.com to forward your emails to your Kanzu Mail account at username@ksdmail.kanzucode.com. In case you’re not sure how to do that here’s a nice guide that will help you out.

One more thing. We need the forwarding email address so that everything can work nice and smooth in the background. Fill out the From( Name ) and From( Email Address ) under the General tab and click the Update button in the bottom right corner.

And that’s it. Pour a cup of coffee, put your feet up and watch some cat videos on YouTube and let Kanzu Mail do everything. Every support mail that comes into your email account shall be automatically forwarded and a ticket created inside Kanzu Support Desk.

Talk about making customer support easy!

How to Enable IMAP support in PHP

The IMAP extension in PHP enables you to communicate with email servers via both the IMAP and POP protocols. Without it enabled, all plugins that use imap_* functions won’t work. KSD Mail is one such plugin. To allow you to seamlessly manage your customer support tickets from one pretty interface ( including tickets logged by sending emails to your-support-email@your-domain.com), KSD Mail interacts with your email server using IMAP.

As handy as it is, the extension isn’t always enabled by default by all web hosts. The method you’ll need to use to enable IMAP support in PHP will depend on your access level, expertise and preference. We highly, highly recommend method 1

1. Ask for it

Your host ought to have the extension enabled; if they don’t, they should be able to enable it without you jumping through hoops. Here’s a (tried & tested) letter:

Hi {hosting company} support,I hope this finds you kicking dragons, taking names and being super awesome. I’d like you to enable the PHP IMAP extension for my account. It’ll go a long way to further cement this long-running (hosting) relationship of ours. Thanks!

Then sit back and watch your (hosting) relationship grow. If that fails, you have two options – start hosting with us or move on to the next steps

2. Modify php.ini

Php.ini holds PHP’s configuration. You’ll need to modify this. You can do this in different ways but we’ll go through how to do it using your account’s FTP credentials.

Put this in a file:
<?php phpinfo(); ?>

Save it as info.php. Use your FTP credentials and upload that file to the public_html (or www) directory on your account.

In your browser, navigate to www.yourdomain.com/info.php. Copy the line that contains Loaded Configuration File

phpini_copying

Also, copy the line that contains DOCUMENT_ROOT
php_enable_imap_doc_root
Put this in another file:
<?php system( "cp /path1/copied/in/the/previous/step/php.ini /home/yourusername/public_html/php.ini");?>

Replace /path/copied/in/the/previous/step/php.ini with the first path you copied in the previous step. Replace /home/yourusername/public_html/php.ini with the second path

Save that file as copy.php and upload it to your server. Navigate to www.yourdomain.com/copy.php

Congratulations! We are almost done. You’ve successfully copied your web host’s PHP configuration. Now, FTP into your account and navigate to the public_html (or www) directory. There should be a php.ini file in there. Download that file and open it with Notepad. Search for ‘imap’. You’ll find this line:

;extension=php_imap.so

Remove the semi-colon at the beginning of that line.

If that line doesn’t exist, find any line that starts with extension= and below it, add extension=php_imap.so

Save the file and upload it to your account. That’s it. All is well – you are done. IMAP is enabled. Have a drink on us and send the bill using a carrier pigeon

NB: Be sure to delete copy.php and info.php created during this process