July 10, 2012

WHMCS Integration GUIDE

Instructions/Guides | Written By Sean
Share on FacebookTweet about this on TwitterShare on LinkedInShare on Google+Email this to someone

Our WHMCS Integration method is perfect for embedding the Tutorial Viewer script within your WHMCS theme, making it look just like any other part of your site. The Tutorial Viewer script is free for all DemoWolf customers, whether they subscribe to their tutorials or purchase them outright, and WHMCS Integration is a part of that script.

This article assumes you have already downloaded and extracted the latest Tutorial Viewer ZIP file, available in the My Subscriptions and My Purchases section of our Client Area. If you have not yet configured or downloaded your Tutorial Viewer and need help getting started, please see this article.

You can have your tutorials up and running inside WHMCS within minutes by following these simple steps:

  1. Upload all the Tutorial Viewer files to a new folder on your server. For the purpose of these instructions, we have WHMCS installed in /clients/ and the Tutorial Viewer in a subfolder of WHMCS, /clients/viewer/
  2. On your local computer, find the Tutorial Viewer files and navigate to the resources/integration/whmcs/ folder.
    1. Upload dw-tutorials.tpl to your WHMCS theme’s templates folder, for example: /clients/templates/default/
      • If you aren’t sure what your template is called, go to the WHMCS Admin Panel and see the Settings > General Settings page.
    2. The file dw-tutorials.php is what you will upload to the WHMCS directory for your clients to access. Feel free to rename this file to whatever you want. Please note that special care must be taken if you want to call this file tutorials.php, since WHMCS has its own file with this name and our file is NOT the same and will likely be overwritten when you update WHMCS.
      • There are two variables at the top of this file that you may need to edit: $uri_to_dw and $path_to_dw. If you have your Tutorial Viewer script uploaded anywhere other than a subdirectory of the WHMCS directory called viewer/, you WILL need to customize both of these variables.
  3. After making any modifications to dw-tutorials.php, upload the file to the root directory of WHMCS.
  4. (Optional) If you’re running a version of WHMCS prior to version 5.0, you should add the following code to your header.tpl file to improve the loading time of the CSS and Javascript used by the Tutorial Viewer script. Right before the </head> tag, add the following:
    {if $dw_head}
  5. (Optional) Depending on your theme, you might want to add an entry to the homepage.tpl file linking to dw-tutorials.php (or whatever you’ve called it). Simply copy and paste one of the other blocks on this page (such as Knowledgebase) and modify it. If you need any assistance with this, let us know.
      a. We’ve provided you two possible icons in several different sizes and formats, on either a transparent or white background. You might want to use one of those, or feel free to use your own. See the resources/integration/icons/ folder.

That’s it! Your Tutorial Viewer has now been integrated with WHMCS!

Share on FacebookTweet about this on TwitterShare on LinkedInShare on Google+Email this to someone