Help Center templating cookbook (Guide Professional) Follow

Comments

21 comments

  • Avatar
    Peter Lynch

    FYI - the template formatting is messed up for: "Add sorting for subscription types in the My Activities Following"

     

  • Avatar
    Jessie Schutz

    Thanks for the heads-up, Peter! I'll send this over to our Documentation team. 

  • Avatar
    Corrin Duque

    I tested this in our Sandbox and the CC appears in two places on the Request page. In addition, the CC is off to the left of the comment box.  Is there a way to get the CC to show up only once?  See screen prints:

    Appears only to left when clicking into a request.

    appears both on Left and above comment once I click into the comment field.

    I tested this on our live Help Center and the appearance and double CC is the same as in our Sandbox as seen in the above screen prints.

    Any way to have the CC show up only once (preferably above the comment instead of to the left as seen on submit a request form)?

  • Avatar
    Jessie Schutz

    Hey Corrin! I'm going to see if I can find somebody to look over this with you.

  • Avatar
    Corrin Duque

    Thanks Jessica!  That would be great!

  • Avatar
    Michael Streeter

    I have added {{related_articles}} and ⁠⁠⁠{{recent_activity}} helpers to my article page. One displays a list with a h2 tag and the other displays a list with a h3 tag!

    Also my {{recent_activity}} is showing just a '0' instead of '0 comments' I'd like to change that too.

    Can I get to these templates and alter one of them so the headings are both the same size?

     

    Can I get to these templates and alter one of them so the headings are both the same size and the comment count has extra text?

    Thanks,

    Michael

  • Avatar
    Rebecca

    Hi Michael- 

    By design the various helpers and objects of Curlybars have different default formatting, they are not related to each other but instead intended to provide different customization opportunities. However Help Center is highly customizable and it is possible to customize the CSS or implement JS/jQuery to change the default behavior. The recent activity formatting, for example, has its own section of CSS that can be easily customized directly within Help Center: 

    The Related articles helper has less options but is also customizable within the CSS: 

    This can however vary depending on the theme you're using the Help Center therefore it is recommended to use your browser's developer tools to locate the CSS class for the various Helpers. In regards to the 0 in the recent activity helper, this count is associated to the number of comments on an article, however it should hide itself if the comment count is 0. Therefore,  I'd recommend submitting a ticket to support@zendesk.com including your code and the page it's added to in your Help Center and we'd be happy to take a look into this behavior. 

  • Avatar
    Brenden Prazner

    Hey.This is awesome! Is there plans to make Instant Search available via the search API?

  • Avatar
    Jessie Schutz

    Hey Brenden!

    Instant Search is really just a visual/UI type of feature; It's returning the same results you'd get in a regular search; it just surfaces them without needing to click "Search". That being the case, the regular search endpoints should get you the information you need. Unless I'm misunderstanding your question, in which case please let me know!

  • Avatar
    Liam

    Hey don't know if any one has any ideas, or if this is the place to ask (sorry newbie question!):

    Is it possible to use Curlybars to display a block of HTML depending on the language the user is currently on? So for example, in the Homepage template, I'd only like to show a block of HTML if the user is visiting the page in English, all other languages, don't show the block of HTML.

  • Avatar
    Eura Szuwalski

    I've found that the customizing page templates for specific categories, sections or articles is really helpful. However, I'd like to customize all articles within one category with the same content. Is that possible?   Or do I have to use the "is helper" and list every article's id on the article template page? 

  • Avatar
    Jacob J Christensen

    @Liam

    You can use Dynamic Content to insert html into the Help Center.

    @Eura

    Are you trying to have different article templates depending on the Category they belong to? It's way out of my skill level, but an interesting use case, hope someone here can give a real answer.

  • Avatar
    Kevin Lamenzo (Edited )

    @Eura,

    Currently working on the same problem: multiple categories I'd like to put into different groups of styles. I tried listing out their IDs on the category template using the #is helper, but I can only get this to work for a single ID.

    I also tried nesting #is helpers, building an array of helpers and using #each and #is, and trying to combine #is helpers and parameters with OR and AND statements, but I couldn't get anything to work.

    Zooming out, the idea is to have a one off landing page for a special theme of articles that share a specific style, and then to have another one off category that serves as a news/updates page, also with a separate style.

    Appreciate any advice and/or solutions.

    Thanks.

  • Avatar
    Eura Szuwalski (Edited )

    @jacob - yes, that was the use case. It would be really great if you could use #is tags wth category ids in the article page. 

    @kevin we were even trying do something simple like have a button that only shows up on the article pages within one category! We ended up going another direction, but wish there was more customization that could be done to the article pages. 

  • Avatar
    Kevin Lamenzo

    @Eura

    Sounds like the same issue. I've been testing on a sandbox instance by going through all available properties in a template page. For example, I'll open up the editor, go to the category page, and the referencing the API docs I'll list out each property in {{property}} to see what works. Not all of them go through.

    For your specific issue, it looks like the Article template can reference a section property. So if all of the articles you wanted to include a button on were in a single section, I think you could have a separate article template by splitting the article template code as follows:

    ##Article template source:

    {{#isnt section.id <insert section id you want to be custom>}}
    ...
    regular article template code
    ...
    {{/isnt}}
    {{#is section.id <insert same section id as above>}}
    ...
    custom article template code
    ...
    {{/is}}

    I didn't have time to fully test this.

    Thanks,

    Kevin

  • Avatar
    Vassilios Lourdas

    Hello, I would like to know if I can include a dynamic content placeholder in a '#is name' statement. So, instead of specifying the name here, if I can have a dynamic placeholder, something like

    {{#is name 'dc placeholder'}}
      English
    {{else}}
      {{name}}
    {{/is}}

    Thanks!

  • Avatar
    Trapta

    Hey @Vassillios,

    Sorry but you cannot use DC in a '#is name' statement.

    Can you please elaborate what is the reason behind using DC in a '#is' statement?

    Thanks

  • Avatar
    Vassilios Lourdas

    This is the reason:

    I have adapted the homepage as following:

    1, 2 and 3 are different categories that belong to a specific product. In total I have 9 of those special categories, 3 per product: ETS Professional, Manufacturer Tool and ETS Inside. I have a code which checks if the names of the categories are one of those 9 and does not display them as the standard categories of my help desk. I have created 9 dynamic content items for the 'Get Started', 'User Guide' and 'Help' because we need them in several languages. However, what I have done now is this:

    The dynamic content I have created for showing the 'Get Started' in Greek. is the following:

    But all those hacks make the code big and ugly and difficult to manage. Therefore I was looking that possibility to use the dynamic content. Unless you have better ideas how to achieve that.

  • Avatar
    Trapta

    @Vassillios,

    I recommend you to use categories ID instead of name. This way you do not have to worry about language.

    Thanks

  • Avatar
    Vassilios Lourdas

    Brilliant @Trapta!!

     

    Thanks a lot!!! You made my life easier today :)

  • Avatar
    Trapta

    @Vassillios,

    Glad to hear that. Enjoy! :)

Please sign in to leave a comment.

Powered by Zendesk