Using your own theme assets for Help Center (Guide Professional and Enterprise)

Have more questions? Submit a request

27 Comments

  • DJ Yoder

    Is there any way to roll back once we've gone to the theming center beta?  We're having all kinds of issues. 

    0
  • Zac

    @DJ what kind of issues are you having and are you reporting them in the community? I myself am curious as we have it in our Sandbox and think it's awesome so far. I didn't see any posts from you there and I think the product team would like to know about it too so they can be resolved before this is released for general availability. Sorry if I just missed them!

    1
  • DJ Yoder

    It looks like PDF assets are no longer supported.  That's my main issue right now.

    1
  • Zac

    Ouch. I recommend posting it to the community if you haven't already. This is very valuable information.

    0
  • Philip Golander

    All of our assets are hidden somewhere and I can't find them, but they are still "live". Also, we're having issues publishing bigger PNG images 2000x1000 for example. 

    1
  • Trapta

    I cannot see any option to rename asset in new TC. Here is the screenshot of my account -

    Please take a look.

    Thanks

    0
  • Ryan McGrew

    Hi @Trapta,

    We actually never built the rename asset functionality and this screen shot is just old. We'll update it shortly. You should be able to the upload the file under a new name to rename it.

    Thanks!

    0
  • Trapta

    Thanks for the update @Ryan McGrew!

    0
  • Biscuit

    Hi,

    I'm having issues using this new asset format in the html email template. 

    I'm using the following code

    <img src="{{asset 'MyLogo.png'}}" alt="My Logo" width="124" height="17">

    It continues just to show the alternative text. I've tried using other asset references here and haven't been able to successfully display any logo in an email notification. Can anyone suggest what I might be doing wrong here? Is there an option of finding what the true URL of this image is, like we did in the olden days?

    1
  • Ryan McGrew

    Hi @Biscuit,

    Unfortunately our Email template system and the Help Center template system are totally different. The {{asset ...}} helper is available for use in Help Center templates not for Email templates.

    We have additional information on customizing your email templates here.

    0
  • Jehan

    First of all not a fan of this new theme interface. Looks way confusing. I have been customizing Zendesk themes since 2011. I know how Zendesk has grown and what has become right now. I think Zendesk development team is always struggling to give user a friendly interface for customizing theme. So far I haven't switch to this new theme interface for many of my clients and I am still using the old one. But today, I have an encounter with this new theme interface and duh. I couldn't find an intuitive way of linking css bootstrap file. I uploaded it in assets and it shows three options "Template", "CSS", and "JavaScript". In my opinion, at least it should have given an example of how to use this asset, because there is plenty of space in that window. Secondly, when Zendesk renders the asset link <link href="{{asset 'bootstrap-grid.min.css'}}" rel="stylesheet" />, it completely changes the name of asset. Why? I was looking at the Document Head template in developer tool where I linked the css bootstrap using the above statement, I was thinking that the CSS file is not linked, instead it was linked but it was rename by Zendesk, bravo. There is also no Save button, only Publish button. What if I want to only Save the theme but not publish it. Suppose I want to publish it on a certain date. I think there might be such option in this new theme interface, but they not so obvious and not very intuitive.

    0
  • Nicole - Community Manager

    Hey Jehan - 

    Thanks for the feedback. I encourage you to share it in the Product Feedback topic in the Community, so that our Product Managers will see it. They don't typically see all of the comments on KB articles. 

    0
  • Rogelio Padida Jr.

    @Biscuit Here's how can you find the true URL of your assets.

    http://theme.zdassets.com/theme_assets/<SubdomainID>/<SHA-1 encrypted file>.<file extension>

    For example;

    http://theme.zdassets.com/theme_assets/237111/5566aedb35b572018773985617b108eddbbbcf05.png

    0
  • Nicole - Community Manager

    Thanks for sharing that answer, Rogelio! I see that this is your first post - Welcome to the Zendesk Community! I encourage you to head over to the The Lounge to familiarize yourself with our Community Guidelines and to post in the Introductions thread to introduce yourself to everyone. 

    We look forward to seeing you around the Community. Happy Zendesking!

    0
  • Ryan McGrew

    Hi Jehan and Rogello,

    Thanks for the feedback. Just wanted to chime in here.

    We've built the {{asset}} helper in Curlybars to allow customers to link to their assets dynamically. Because we store assets on a CDN we want to be able to cache those so we can serve them as fast as possible. However this has drawbacks when it comes to updating files. By using the {{asset}} helper we can dynamically serve the latest version of a file as soon as it's uploaded.

    We've given you instruction how to use it int templates, CSS and JavaScript view the asset view in the editor. By using this, you'll be able to update, export, import and distribute your theme as you'd like. I know it's a change, but I believe once you get used to it you'll see the benefit.

    Jehan to your point about previewing and saving in a currently published theme, we recommend that you either duplicate your current theme or export it and work offline when making changes. This will allow you to make a series of changes, preview and verify the behavior and everything is working as expected and then publish it live.

    There's some documentation on working with your live theme here and some more documentation with working on your theme locally here and here.

    Thanks!

     

     

    0
  • Elad Franklin

    Hi all,

    first time here :)

    I've added an xml file as an asset and I have a javascript code that should access the asset and read its content. I tried pasting the "Javascript (via template)" code into my source code but when I try to read it I just get a "{{asset 'file.xml'}}" as a string.

    Any ideas how to accomplish this?

    Thanks

    0
  • Ryan McGrew

    Hey Elad,

    Can you tell where you've pasted the code? The {{asset 'file.xml'}} will only be rendered properly if it is in a template (header.hbs for example).

    Thanks!

    0
  • Elad Franklin

    Hi Ryan,

    I've pasted the code in my article source code:

    <script>// <![CDATA[
    var assetsClarizenFunctions = "{{asset 'ClarizenFunctions.xml'}}";
    //code that reads the resource will go here//
    // ]]></script>

     

    Thanks

    0
  • Ryan McGrew

    Hi Elad,

    Thanks for getting back to me. You'll need to use it as part of a template like article_page.hbs or header.hbs rather than the source view of an article. I hope that helps clarify.

    Thanks!

    0
  • Brett Goodwin

    We had previously uploaded assets centrally and used the source URL to call those images directly in various articles.  The images are used for the numbers on numbered lists, so not really something that can be added to a standard template.  Is there a better way of accomplishing this so that we don't have to add the same images to every article that uses them?  (Apologies if I'm missing something obvious!)

    0
  • Ryan McGrew

    Hey Brett,

    This sounds like something that should be achievable by CSS styles on ordered lists and assets hosted in your theme. Maybe I'm missing something? Forgive my poor css-ing but something like this:

    li.class-name { list-style-image: url($asset-file-name); }

    Does that make sense? 

    Thanks!

    0
  • Brett Goodwin

    Thanks so much, Ryan - it seems pretty clear we weren't really calling images in an optimal manner before.  I got looped in but am not our normal ZenDesk theme owner or very knowledgeable in CSS, so thanks again for providing the answer to what was probably a silly question!

    0
  • Ryan McGrew

    Hey Brett!

    No worries. We've all gotta wear a few extra hats sometimes ;) Glad you got it sorted out. 

    Thanks!

    0
  • Dan Ross

    What's the correct method to reference an asset in the scripts.js file? We have a JSON file loaded as an asset that I want to feed to a script. The placeholders don't seem to pickup. Can we use a direct URL to the asset? 

    0
  • Ryan McGrew

    Hey Dan,

    In any template you can use the following snippet to assign to a variable for use in JavaScript.

    <script> var assetsFoo = {{asset 'foo.jpg'}}</script>

    From there you can then reference that asset in JavaScript.

    Thanks!

    0
  • Michael Goh

    Heya,

    Is there anyway I can create a folder structure to organise my assets in the Help Centre themes? We're doing a highly customised page with heaps of photos and font types, and it's getting a bit unruly.

    Thanks in advance.

    0
  • Ryan McGrew

    Hey Michael,

    Unfortunately we don't support subfolder structures in the assets directory at this time.

    Thanks!

    0

Please sign in to leave a comment.

Powered by Zendesk