Support

Theme Integration Process

Integration Instructions

You can install the theme just by following the below instruction.

Follow 3 simple steps to install the theme. You need admin access to the Zendesk® Help Center to be able to perform the installation process.

Step 1. Prepare

  • Unzip the file you downloaded from Diziana/Diziana Zendesk® Theme

    Download ScreenshotFile ScreenshotFile Screenshot

  • Login as admin into your Zendesk® instance.

    (eg: https://yoursubdomain.zendesk.com/hc/en-us)

  • Click Customize design in the Tools panel on the lower-right side of the page.

    Customize Panel

  • Under the Theme section of the panel, click Edit Theme.
    The Theme editor appears with the Home Page code showing.
    Click

    Zendesk® make a copy of the existing theme. Any changes you make are applied to the copy, not the original. You can revert to the original theme at any time.

    Edit Theme Options

Step 2: Load HTML, CSS, JS

Customizing the HTML

Select a template to modify from the HTML menu in the Theme editor.

  • Click “Document Head” tab and delete all the content from code view.

    Document Head SectionDocument Head Section

  • Open package “Zendesk® Deployment Files” and go to html.

    Files Preview

  • Drag and drop HTML-code : Find document-head.html, open the file, copy its content and paste it to the corresponding code view.

    All HTML Files Preview

  • Click “Save”.

    Save Button

  • Repeat with the same step for each html page type in Zendesk® theme editor.

Customizing the CSS

  • Click “CSS” tab and delete all the content from code view.
  • Drag and drop CSS-code : Open “css” folder in existing package. Open file theme.css, copy its content and past it to “CSS” tab code view.

    CSS Section

  • Click “Save”.

Customizing the JS

  • Click “JS” tab and delete all the content from code view.
  • Drag and drop JS-code : Open “css” folder in existing package. Open file theme.js , copy its content and paste it to “JS” tab code view.

    JS Section

  • Click “Save”.

Upload Assets

  • Click Assets tab.
  • Open “assets” folder in existing package and upload all the files.

    Assets Folder

  • Copy the generated URL, go to document-head and replace ‘assets’ with the uploaded assets path

    var __hc_assets_path_uri = 'assets';      and     @hc_assets: 'assets';
    with generated assets url
    for example
    : "//p3.zdassets.com/hc/theme_assets/602825/200095532" i.e var __hc_assets_path_uri = '/p3.zdassets.com/hc/theme_assets/602825/200095532'; @hc_assets: '//p3.zdassets.com/hc/theme_assets/602825/200095532';

    URL Update

Step 3. Publish

When you’re ready to deploy your changes, click Publish changes at the top of the sidebar.

Publish Section

Congratulations!! You published your help center.

Help Center Screen Shot

Making Branding Changes

Set the options in the Branding to update your logo and favicon

  • Click at Branding

  • Upload logo and favicon from assets folder

  • Publish the changes

Adding more articles to your Knowledge-base

You need to copy paste the article-1.html to create articles page.

  • Click Add Content

    Panel View

  • Select article

    Article Section

  • Open source code and copy-paste the code
    article-1.html and click OK.

    Articles OK

Contact us at [email protected] if you encounter any problems.


Using Plugins

Installing the Plugin

Smart Search

Follow these steps to install the plugin. You need admin access to the Zendesk Help Center to be able to perform the installation process.

Presently, there isnít an automatic process to follow the instructions carefully. Itís not complicated and only should take a couple of minutes.

  • Unzip the file you downloaded from Diziana.

    Unzip Files

  • Login as admin into your Zendesk instance.

    (eg: https://yoursubdomain.zendesk.com/hc/en-us)
  • Click Customize design in the Tools panel on the lower-right side of the page.

    Customize Design

  • Under the Theme section of the panel, click Edit theme.

    Edit Theme

  • Click and select “document.head”.
  • Copy paste the following at bottom of the your document.head editor.

    Document Head

    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/magnific-popup.js/0.9.9/jquery.magnific-popup.min.js">
  • Click the CSS tab in the Theme editor.
  • Open the downloaded file “Lightbox_CSS.txt” in a text editor.
  • Copy and paste the full contents of the file in the code view after all the existing code.

    Lightbox CSS

  • Click the JS tab in the Theme editor.
  • Open the downloaded file Lightbox_JS.txt in a text editor.
    Copy and paste the full contents of the file in the code view after all the existing code.

    Lightbox JS

  • Click the Assets tab in the Theme editor.
  • Open the downloaded folder assets and upload the image file “zoom-image-popup.png”
  • Copy the full image path for eg. “//p3.zdassets.com/hc/theme_assets/701504/200119982/zoom-image-icon.png”

    Update Assets

  • Click CSS tab and find the line

    a.image-popup {
    /* Required to update the background image path with the uploaded image path */
    	background: url('assets/zoom-image-icon.png') no-repeat scroll center #000;
    	display: inline-block;
    }

    Update CSS

  • Replace the path ‘assets/zoom-image-icon.png’ with the copied path.
    i.e

    a.image-popup {
    /* Required to update the background image path with the uploaded image path */
     background: url('assets/zoom-image-icon.png') no-repeat scroll center #000;
     display: inline-block;
    }
    with
    a.image-popup {
    /* Required to update the background image path with the uploaded image path */
     background: url('//p3.zdassets.com/hc/theme_assets/701504/200119982/zoom-image-icon.png') no-repeat scroll center #000;
     display: inline-block;
    }
    
  • To save your changes, click the Save button at the top of the sidebar.

    Save Changes

How to Use the Plugin when Authoring

This section explains how to use the plugin when authoring.

  • Open the Zendesk Help Center article for editing.
  • Insert the image you want to show as a pop-up.
  • Click the Source code button in the Content toolbar.
  • Find the inserted graphic that will look something like this:

     

    <img src="/path/name.png" alt="" />

    Save Changes

  • Replace the line above with the following. You will need to use the same path and file name in the new code.

    <a href="INSERTED-IMAGE-Full-PATH" class="image-popup">
    	<img src="INSERTED-IMAGE-PATH" width="YOUR-THUMB-IMAGE-WIDTH" height="YOUR-THUMB-IMAGE-HEIGHT" />
    </a>
    				

    Updated Image Path

    In our case, if we want our thumbnail picture to have a height of 100 pixels and width of 50 pixels, the line would show as this:

    <a href="INSERTED-IMAGE-Full-PATH" class="image-popup">
    	<img src="INSERTED-IMAGE-PATH" width="50" height="100" />
    </a>
    				 

    You only need to specify either width or height to resize the thumbnail.
    The top line contains the link to the picture that will show in the Lightbox.
    The second line, with the “src”, is the thumbnail picture. Normally it’s the same picture. You have the option of putting another picture there.

  • Update your article

     

    <img src="/path/name.png" alt="" />

    Save Changes

    Image Popup

To show images in gallery

  • Open the Zendesk Help Center article for editing.
  • Insert the image you want to show as a pop-up.
  • Click the Source code button in the Content toolbar.
  • Find the inserted graphic that will look something like this:

    <p><img src="/path/name.png" alt="" /></p> 
    <p><img src="/path/name.png" alt="" /></p> 
    <p><img src="/path/name.png" alt="" /></p> 
    <p><img src="/path/name.png" alt="" /></p> 
    				
  • Replace the line above with the following. You will need to use the same path and file name in the new code.

    <div class="gallery-image-popup">
      <a href="INSERTED-IMAGE-PATH" title="TITLE-DISPLAY-JUST-BELOW-THE-IMAGE-1">	
      	<img src="INSERTED-IMAGE-PATH" width="YOUR-THUMB-IMAGE-WIDTH" height="YOUR-THUMB-IMAGE-HEIGHT" />
      </a>	
    </div>
    <div class="gallery-image-popup">
      <a href="INSERTED-IMAGE-PATH" title="TITLE-DISPLAY-JUST-BELOW-THE-IMAGE-1">
    	<img src="INSERTED-IMAGE-PATH" width="YOUR-THUMB-IMAGE-WIDTH" height="YOUR-THUMB-IMAGE-HEIGHT" />
      </a>
    </div>
    <div class="gallery-image-popup">
      <a href="INSERTED-IMAGE-PATH" title="TITLE-DISPLAY-JUST-BELOW-THE-IMAGE-1">
    	<img src="INSERTED-IMAGE-PATH" width="YOUR-THUMB-IMAGE-WIDTH" height="YOUR-THUMB-IMAGE-HEIGHT" />
      </a>
    </div>
    <div class="gallery-image-popup">
      <a href="INSERTED-IMAGE-PATH" title="TITLE-DISPLAY-JUST-BELOW-THE-IMAGE-1">
    	<img src="INSERTED-IMAGE-PATH" width="YOUR-THUMB-IMAGE-WIDTH" height="YOUR-THUMB-IMAGE-HEIGHT" />
      </a>
    </div>
    			
  • Update your article

     

    <img src="/path/name.png" alt="" />

    Image Gallery

Contact us at [email protected] if you encounter any problems.


Sales FAQs

Is your Diziana Zendesk® Theme SEO-Friendly?

Yes we have made our best effort to make themes SEO friendly by using semantic markup, and valid standard code. However, there’s always more to improve because content is the king when it comes to search-engines, and user-enagement.


Which Payment Methods or Gateways are Currently Supported?

We currently support Paypal, a commonly used method for online payments. Secure and trusted. In future, we would add support to PayUMoney, and other gateways which works at places (such as India) where PayPal doesn’t. If you are from India or countries (where PayPal doesn’t work), please get in touch ([email protected]), and we would work out a way to get our premium Diziana Zendesk® Theme in your hands.


Do I receive standard html/css/javascript files along my Purchase?


Yes. We provide two different set of files:

  • Standard HTML, CSS, Javascript files for themes (you can run in browser and preview themes).
  • Zendesk Deployment Files which can be uploaded to Zendesk® Help Center, and used.

All static assets (png, jpg, js, css) are optimized for web. We have taken care of that.


Do you have membership or annual subscription options?

At present, we don’t have that. However, we understand content writers, and web agencies can benefit from a membership or subscription options where they get access to all themes at a flat annual price. We have that in mind, and we are working on it.

 

Please subscribe to our newsletter, and we would keep you posted.

 

You can always get in touch with us ([email protected]) to discuss your requirements (bulk licensing, or unlimited usage of themes for your client projects, and so on).


If I buy themes in bulk, can i receive a discount?

Yes, please get in touch with us ([email protected]).


If I lose my theme files, is there a way to retrieve that?

Yes. You can download the file from your account section on zendesktheme.com, or you can send your order-id or invoice-id to us ([email protected]), and we would send you the files.


Do you have tutorials for customizing or integrating your theme?

We are working on Video tutorial, and also on improving our documentation. Hopefully, very soon it would be ready, and with help of that even content writers or designers can download and integrate themes with Zendesk® Help Center.


Do you offer free support or do i have to purchase a support plan?

Please feel free to contact us ([email protected]), and we would help you. If you want dedicated support, we recommend you purchase one while buying the theme.


Where do I host my theme?

On the Zendesk® Help Center. You need a license, and right plan to use Custom Theme with your Zendesk® Help Center. We can help you getting you Zendesk® license, please feel free to contact us ([email protected]).


Do you offer a free trial for your Themes?

You can use one of our free themes before you plan to buy a premium ones. That should give you good idea. You can always get in touch with us ([email protected]) for any questions or information.


Can I use your theme for multiple sites (zendesk® help centers)?

Yes, you can provided you have bought separate licenses for each site.


Can I use the theme with the Zendesk® hub-spoke approach or multi-branding?

Yes you can as long as it’s recognized by Zendesk® as part of the same company.


Can I integrate the theme myself?

Sure you can. However, if you need any help, we can integrate that for you. All premium themes come with free integration service. If you are using our free themes, you can buy integration services.


How long does it take to integrate a theme?

For an empty Help Center, it takes just less than 30 minutes. To integrate a custom theme with existing content, it’s more involved process and depends on the architecture and selected template.


How long will it take you to add my branding to my theme?

Generally, 2-3 working days after the specification has been defined.


Can I use the theme design for other marketing material?

Please contact us if you wish to do so as the license is specifically for Zendesk®. We can be flexible depending on your needs.


How do i receive my theme?

Once you have completed the purchase, you can download the theme files from your account section on https://www.zendesktheme.com/account/.


Can I add videos to my theme?

Yes, you can. Using the same features in the Zendesk® Help Center.


Do the theme support non-english characters?

Yes they do. The same as in the Zendesk® Help Center.


Contact us at [email protected] if you encounter any problems.