DemoWolf Blog

Thank you for signing up for a DemoWolf subscription! We’ve gone to great lengths to make the setup process as painless as possible. A quick read through the guide that follows should answer most of the questions you may have.

Whenever you need to make a change to your subscription, you’ll do that in the My Subscriptions section of our Client Area. If we haven’t activated your subscription, you won’t be able to generate your tutorials yet, but you will be able to do everything else.

1) What does “generate” mean?
We will frequently refer to the word generate. This refers to the process of branding the beginning and ending frames of the tutorial files with your logo. As a subscriber, you can generate your tutorials an unlimited number of times, but only the latest copy of the files will be available for display in your subscription.

2) Upload a Logo
Before you can generate your demos, you must upload a logo. Under Subscriptions you’ll notice a red link next to Choose a Logo that states No Logos Uploaded. Click that link. You will be taken to the Add a Logo page. Browse for a logo image on your hard drive. Submit the page, then return to My Subscriptions. You can now use the Choose a Logo feature to assign the logo you just uploaded to your subscription.

3) Choose Your Tutorials
Now it’s time to choose which tutorials you’d like to display. Click the View/Edit Series Selection link. You should see a list of ALL of DemoWolf’s tutorial series, and each one has a checkbox next to it. You’ll need to tick the checkboxes next to each of the series you want, then scroll down and hit Submit. Once you’ve submitted the form, you will see a screen confirming which tutorials you’ve selected; if you see any that you mistakenly chose, tick the Exclude checkbox next to a series and it will be removed from your selection. NOTE – Your selection will not be saved until you hit Submit one more time on this confirmation page.

Some things to remember when editing your Series Selection:

1. Be sure to take note of how many series you’re allowed, and whether you can have voice versions or not.
2. If you’d like the Voice versions of all the demos, deselect Non-Voice at the top of the page and then select the Voice checkbox next to it.
3. If you want to mix and match Voice and Non-Voice and Non-English tutorials, click the + next to a series’ title.
4. When you return to edit your Selection later, you’ll be sent to the confirmation screen first. Click the Modify Selection button to get back to the full series list.

4) Time to Generate!
As soon as you submit the confirmation page, you’ll receive a notice that your “selection has been saved to the database”. Beneath that are buttons that will let you generate your tutorials: Generate Entire Subscription will generate everything you’ve picked, and Generate New Demos Only can save a lot of time if you’ve just added a single new series to your list. (Both of these links are also available on the My Subscriptions page.)

Since you’re just starting out, choose the first one and generate the entire subscription. On the next screen, click Proceed. Your generation request will now be placed in a queue. As soon as any existing generation jobs complete, yours will begin. You will receive status updates, eventually ending with the words Rebrand Complete (that’s how you know the generation process has finished). While you’re waiting, you can go ahead and move on to the next step: setting up your Tutorial Viewer.

5) What is the Tutorial Viewer?
Our subscription system is based around a PHP script called the Tutorial Viewer. The main requirement to run the Tutorial Viewer script is that you have PHP 5.2 or higher installed on your server. Don’t want to mess with setting up the Tutorial Viewer or integrating the script yourself? Our Integration Service has you covered!

You can download the script from the My Subscriptions page by clicking the Download Tutorial Viewer link. Extract this ZIP file, and upload all the files it contains to a NEW folder on your server (you could call it viewer/, or whatever you like).

Now, access the Tutorial Viewer directory in your browser (for example, http://www.yourdomain.com/viewer/). Assuming your tutorials have finished generating, you should see a list of all the tutorials you just selected.

The script will attempt to auto-rename the includes/conf.new.php file to conf.php, but if this fails you will need to manually rename the file.

NOTE: If you notice any errors, you may need to CHMOD one file and one directory (likely because your server doesn’t use suPHP or PHPSuExec):

• CHMOD the includes/conf.php file to 0666
• CHMOD the cache/ directory to 0777

6) Customize your Display Options
Not happy with the default look of the Tutorial Viewer? There are a number of Display Options that change the layout of the tutorials, available to you via a subsection the My Subscriptions page. You’ll find a preview of all the different Display Options here. The Display Options form also lists Run Mode as an option; which one you should use depends upon how you plan to integrate our Viewer with your website (see the following section for details).

Any changes made to your subscription’s Display Options should take effect instantly on your live Tutorial Viewer. If they do not, please go to the Access Settings subsection and verify that the “Complete URL to request.php” corresponds to the location of request.php on your server (for example, http://www.yourdomain.com/viewer/request.php). Alternatively, you can manually delete the contents of the cache/ directory to the same effect.

7) Integrate with your website
You will probably also want to Integrate your Tutorial Viewer with your website. If you use WHMCS, Kayako, or WordPress, you’ll find guides detailing how to integrate with these scripts here, as well as a guide on how to integrate using basic PHP.

You can also approach the integration from a different direction and instead customize the templates/tutorials.tpl file, adding your site’s header and footer HTML, in which case you’d leave the viewer set to the Standalone run mode.

—

Any remaining questions? Please don’t hesitate to open a support ticket!

WordPress Integration lets you embed our Tutorial Viewer script within WordPress, 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 WordPress 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 WordPress 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 WordPress installed in /blog/ and the Tutorial Viewer in /blog/viewer/
2. On your local computer, find the Tutorial Viewer files and navigate to the resources/integration/wordpress/ folder.
   1. This folder contains only one file: dw-tutorials.php. 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 WordPress 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 WordPress.
4. Install and Activate the Shortcode Exec PHP plugin for WordPress (Plugins > Add New). This allows you to enter PHP code in your posts and pages.
5. Go to Tools > Shortcode Exec PHP and scroll down to the Shortcodes section. Create a new Shortcode named demowolf and enter the following PHP code:
   
   extract(shortcode_atts(array('series' => '', 'demo' => ''), $atts));
   empty($_GET['series']) and $_GET['series'] = $series;
   empty($_GET['id']) and $_GET['id'] = $demo;

   if (!empty($_GET['id'])) {
   define('DEMO_MODE', true);
   }

   require "dw-tutorials.php";


6. Create a new WordPress page to use for embedding the Tutorial Viewer (Pages > Add New). With the shortcode we created, you can easily display ALL your tutorials simply by typing [demowolf] in a WordPress page. To force a specific series to show up, you will first need to find the ID of the series (view your Series Selection on My Subscriptions or My Purchases in our Client Area if you need a list of IDs). For example, to show ONLY the cPanel series, use the following shortcode in a page: [demowolf series="289"]

• To show ONLY a specific tutorial in the series, you can further specify the tutorial’s ID. For example: [demowolf series="289" demo="6356"].

That’s it! You now know how to integrate the Tutorial Viewer with WordPress!

Integration is for those of you that want the Tutorial Viewer to be integrated seamlessly with your helpdesk. You will essentially be wrapping your existing Kayako theme around the Tutorial Viewer. The Tutorial Viewer script is free for all DemoWolf customers, whether they subscribe to their tutorials or purchase them outright, and Kayako 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 Kayako 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 Kayako installed in /kayako and the Tutorial Viewer in a subfolder of Kayako, /kayako/viewer/
2. On your local computer, find the Tutorial Viewer files and navigate to the resources/integration/kayako4/ folder.
   • You’ll need to upload everything inside this folder to the root directory of your Kayako installation. If your Tutorial Viewer is anywhere except in a subfolder named “viewer/”, you WILL need to update two PHP variables in dw-tutorials.php: $path_to_dw and $uri_to_dw
3. Go to your Kayako Admin Dashboard. In the Options menu at left, click Modules. You will see a new Module called Video Tutorials. Click its name, then click Install. This will create and enable a Video Tutorials widget, which you can control on the Widgets page. By default, the Widget will show up on your Kayako homepage and in the main menu.
   • Each widget has two icons, so you’ll need to upload some for your new Video Tutorials widget. 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. The Kayako 4 integration script requires that the icons be named icon_widget_tutorials.png and icon_widget_tutorials_small.png and be placed in your theme’s images/ path. For the default theme, you’ll want to use the 35×35 and 16×16 transparent PNG files.
4. (Optional) You should add the following code to your Kayako theme’s header template to improve the loading time of the CSS and Javascript used by the Tutorial Viewer script. Again in the Options menu at left, click Templates, then Groups.
   • View the Templates for whichever template group you’re using.
   • Under General, you’ll see a template named header. Edit it.
   • Directly before this line:

     </head>

     Add:

     <{if $dw_head}><{$dw_head}><{/if}>

5. That’s it! Your Tutorial Viewer should now look just like any other area of Kayako.

These instructions apply to Kayako version 3. Click here for Kayako 4 instructions.

Integration is for those of you that want the Tutorial Viewer to be integrated seamlessly with your helpdesk. You will essentially be wrapping your existing Kayako theme around the Tutorial Viewer. The Tutorial Viewer script is free for all DemoWolf customers, whether they subscribe to their tutorials or purchase them outright, and Kayako 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 Kayako 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 Kayako installed in /kayako and the Tutorial Viewer in a subfolder of Kayako, /kayako/viewer/
2. On your local computer, find the Tutorial Viewer files and navigate to the resources/integration/kayako3/ folder.
   • The only file in here is named dw-tutorials.php. This is what you will upload to the Kayako directory for your clients to access. Feel free to rename the file to whatever you want.
     • 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 Kayako 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 Kayako.
4. (Optional) You should add the following code to your Kayako theme’s header template to improve the loading time of the CSS and Javascript used by the Tutorial Viewer script. Go to your Admin Dashboard, then in the Options menu at left, click Templates, then Manage Groups.
   • View the Templates for whichever template group you’re using.
   • Under General, you’ll see a template named header. Edit it.
   • Before this line:

     <{if $ismodernbill == false && $ismodernbillv5 == false && $iswhmcs == false}></head>

     Add:

     <{if $dw_head}><{$dw_head}><{/if}>

      

5. (Optional) You may want to add an entry to Kayako’s index page linking to dw-tutorials.php (or whatever you’ve called it). You’d do this by editing one of Kayako’s files: includes/Widgets/widgets.php. Open this file. Roughly halfway down the page, you will see code similar to the following. You will need to add everything after: // DemoWolf Integration

   // ======= KNOWLEDGEBASE =======
if ($module->isRegistered(MODULE_KNOWLEDGEBASE) && $_SWIFT["settings"]["kb_enableclient"] == 1 && $_SWIFT["user"]["permissions"]["perm_canviewknowledgebase"] != "0")
{
$_widgets[$index]["icon"] = $_SWIFT["themepath"]."knowledgebase.gif";
$_widgets[$index]["title"] = $_SWIFT["language"]["knowledgebase"];
$_widgets[$index]["description"] = $_SWIFT["language"]["desc_knowledgebase"];
$_widgets[$index]["link"] = iif(defined("ISMODERNBILL"), "user.php?op=menu&tile=faq&_m=knowledgebase&_a=view", "index.php?_m=knowledgebase&_a=view"); 

   $template->assign("cansearch", true);
$template->assign("kbcansearch", true);

   $index++;

   // DemoWolf Integration
$_widgets[$index]["icon"] = $_SWIFT["themepath"] . "tutorials.gif";
$_widgets[$index]["title"] = $_SWIFT["language"]["tutorials"];
$_widgets[$index]["description"] = $_SWIFT["language"]["desc_tutorials"];
$_widgets[$index]["link"] = "dw-tutorials.php";

   $index++;
   }
   

   • Customize $_widgets[$index]["icon"] to whatever image you'd like to use. It should go in your theme's image folder, i.e. themes/your_theme/.
   • 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.
   • Customize $_widgets[$index]["link"] to whatever you named dw-tutorials.php.
6. (Optional) Finally, you must enter the text to show for the Widget you just added to your Kayako homepage. Return to the Admin panel, then go to Options > Languages > Manage Phrases.
   • Click Insert Phrase.
   • Create a new phrase with Identifier set to tutorials. Section should be default. Text is whatever title you want, such as "Video Tutorials".
   • Then create another new phrase. Identifier: desc_tutorials, Section: default. Text could be something like "Watch video tutorials on a variety of topics."
7. That's it! Your Tutorial Viewer should now look just like any other area of Kayako.

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}
{$dw_head}
{/if}
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!

In this article, you will find an overview of the latest version of the DemoWolf Importer (version 2.0, released 2012-07-10). The importer is a tool that creates articles for your tutorials in WHMCS, Kayako or WordPress, making it easier for your support staff to link to the tutorials when answering support tickets and providing the tutorials more exposure to your clients.

This tool is available to all DemoWolf customers free of charge in the ZIP file you download when setting up your Tutorial Viewer or DemoWolf subscription.

If you still have unanswered questions after reading this article, please check the Importer category of our FAQ section. Don’t hesitate to open a support ticket if you still need assistance!

1. When you downloaded the Tutorial Viewer ZIP archive, the Importer was located in the resources/importer/ directory within that archive. If you have not uploaded this directory, please do so now. The importer can only function when uploaded to this location, since it uses many of the Tutorial Viewer files, so be sure to maintain this directory structure.

2. Each time you run the importer, you must remove the importer.lock file (in the resources/importer/ folder). This is a security precaution to prevent unauthorized use of the Importer tool.

3. Navigate to the resources/importer/ folder in your web browser when you are ready to run the importer.

4. The importer is a four-step process. Read over the on-screen instructions carefully and fill out the fields appropriately.

1. Step One asks you where you’ll be importing and (if you’ve purchased any tutorials) where your tutorial files are located and which formats you would like to import.
   • When submitting Step One, you will be shown an intermediate screen that allows you to confirm your settings are correct. The importer will automatically detect the web address of your WHMCS/Kayako/WordPress installation and force all HTTP requests to be made from that location. If the sample tutorials do not load or you are unable to submit the page via the Continue button, please go back to Step One and check that the value entered for #2 is correct.
2. Step Two lets you customize where and how the tutorials will show up in your Knowledgebase.
   • NOTE – If you choose the Play Button option for #3, the image that will be used is the templates/play.png image within your Tutorial Viewer directory. There are a few more versions of this button in the resources/importer/images/ directory, or feel free to use your own.
3. Step Three is where you choose which series to import. We recommend you start by importing only one series, in case of any problems and to ensure you like your chosen settings.
4. Step Four is the importing phase. If there are no errors, your demos should now be imported into the script of your choice!

The importer will attempt to lock itself down, but if you receive an error that this failed to happen you should probably delete the resources/importer/ folder. But be sure to leave the rest of your Tutorial Viewer files on the server, as the articles created by the Importer rely heavily on files in that directory!

If you still have unanswered questions after reading this article, please check the Importer category of our FAQ section. Don’t hesitate to open a support ticket if you still need assistance!