Recent searches
No recent searches
How to put all sections and articles on home page
The Wise One - 2022Community Moderator
Posted Feb 23, 2017
Please follow this short tutorial about how to put all sections and articles on the home page of your Help Center (according to this post). There are few ways to achieve that, but I will explain one of them, probably the most easiest.
Example: https://support.twilio.com/hc/en-us
So:
-
Put all the content (all sections) in just one category (how to do that)
- Go to editor for design changes (General / Customize design / Home page)
- Find code row provided under, and remove it and whole code in this section (if you can't find it, just skip this step):
<section class="knowledge-base">
- Put here this code
<section class="knowledge-base">
{{#if categories}}
<div class="category-tree">
{{#each categories}}
<section class="category">
{{#if ../has_multiple_categories}}
<h2><a href="{{url}}">{{name}}</a></h2>
{{/if}}
{{#each sections}}
<section class="section">
<h3>
{{#if internal}}
<span class="visibility-internal" data-title="{{t 'internal'}}">
<span class="visibility-internal-icon"></span>
</span>
{{/if}}
<a href="{{url}}">{{name}}</a>
</h3>
{{#if articles}}
<ul class="article-list">
{{#each articles}}
<li {{#if promoted}} class="article-promoted" {{/if}}>
{{#if promoted}}
<span data-title="{{t 'promoted'}}">★</span>
{{/if}}
<a href="{{url}}">{{title}}</a>
</li>
{{/each}}
</ul>
{{#if more_articles}}
<a href="{{url}}" class="see-all-articles">
{{t 'show_all_articles' count=article_count}}
</a>
{{/if}}
{{else}}
<i class="section-empty">
<a href="{{url}}">{{t 'empty'}}</a>
</i>
{{/if}}
</section>
{{else}}
<i class="category-empty">
<a href="{{url}}">{{t 'empty'}}</a>
</i>
{{/each}}
{{#if more_sections}}
<div>
<a href="{{url}}">{{t 'see_all_sections'}}</a>
</div>
{{/if}}
</section>
{{/each}}
{{pagination}}
</div>
{{/if}}
</section> - Save and Publish changes. You should get your sections and articles on the home page of your Help Center.
Hope this helps, if not, feel free to put a comment under!
1
26
26 comments
Patrick Hogan
Thank for posting this, Vladan. This is a great help for those who wants to have this on their homepage. Really easy to follow, too. Thumbs up!
0
Jennifer Rowe
Awesome tip, Vladan. Thanks for sharing!
0
Isabelle
Thank you very much for this snippet. May I ask you how you would split the content into two columns?
Thanks a lot,
0
Tami Settergren
A big thanks to you, Vladan! I've been trying to do this and learn HTML5 at the same time by looking things up on the web. Should have known to start with Zendesk Support articles first, you guys are great!
0
Matthew Elijah
Hey there, also wondering how to split the content into two columns? Thanks!
0
Vlad
Hi Matthew, Welcome to the Community!
Just to check are you on Copenhagen theme? Could you share a screenshot of what you got there?
0
Team Mudrex
Is there a way to split it into 2 columns?
0
Vlad
Hi Edul! Yes, that is possible.
Open CSS file of your Help Center theme (Guide admin / Themes / Select active theme / Edit code),
and find this value (should be the 812th line in this ZD default Copenhagen theme):
Just make a little change so it looks on this way:
That should be all. If it doesn't work, please provide me here with a link to your help center.
Thanks!
0
Caroline Johnson
Hi Vladan - Thanks for the info!
Do you happen to know a way to have the "View all XX articles" expand on the homepage, rather than click thru to the category page?
Thanks in advance!
0
Vlad
Hi Caroline, Yes that is doable and requires much more coding.
If you have a front-end developer in your team just direct him to the Zendesk API documentation, a part which applies to the listing of all articles within a section: https://developer.zendesk.com/rest_api/docs/help_center/articles#list-articles
Hope this helps.
0
Caroline Johnson
Thanks Vladan! Will give this a try.
0
Guillaume Zurbach
Thanks for sharing this Vladan! One minor detail: I had to wrap {{#each sections}} with <div class="section-tree"> to get everything working perfectly. It fixed a bunch of margins and made the whole thing show up with two columns without even tweaking the CSS code.
0
Vlad
Thanks for the update, Guillaume!
0
Mário Silva
[SOLVED]
Hello, I am doing some fetch from the API to get all categories and sections, but I have some sections that are private. Is there a way to filter does private categories/sections on the API?
https://developer.zendesk.com/rest_api/docs/help_center/sections
0
Nicole Saunders
Have you tried looking at the user_segment_id attribute?
0
Kathrina Rivera
Hello i followed all the tips mentioned even in the comments. The section appeared as columns however there's no margin on the left column
0
Pulkit Pandey
Hey Kathrina Rivera
Can you please share the URL of your HC where you implemented this so that I can go through it and provide you the exact solution to your problem.
Thanks
Pulkit
Team Diziana
0
Ifra Saqlain
Hey Kathrina,
You can try this.
Paste this code on home page:
Paste this CSS code on your stylesheet at the bottom side:
And
Here is section class so if you need to add margin in section columns, you can add like this:
Thanks
Team
0
Jeffrey Stone
Hi there. This no longer works "out of the box" for Copenhagen theme 2.8. Has anyone updated theirs to work with the new theme? Thanks!
0
Shweta
Is there anyway I could filter out articles tagged with a specific label instead of showing promoted articles. Thanks in advance,
1
Jake Bantz
Hi Shweta, with the native functionality it is not possible to filter by article labels and present only those articles.
0
Anne-Flore Caire
Hello. I am trying to display all the articles in the sections of a category on the home page, but there is a configuration system which limits the number of articles to 6. What parameter in the code includes and influences this limit?
Because in addition I can reduce this number via ".article-list-item:nth-child(n+3)", 3 for example, but I cannot increase the number by this parameter (by putting .article-list- item:nth-child(n+8) for example, I still only have 6 displayed). Thanks in advance
0
Ifra Saqlain
Hi Anne-Flore Caire,
It is doable by using API as Vlad said above. You can reduce the number of articles using CSS but cannot increase.
Thanks
0
Anne-Flore Caire
Thanks for the quick feedback! Ifra Saqlain
I was hoping there might be another solution since 2018. There are two issues with the solution: the development effort to implement it, and the fact that maintainability is outside the scope of Zendesk Help Centre administrators alone. So we won't be launching this workaround.
0
Ifra Saqlain
@Anne-Flore Caire, I understand your requirement and concern.
But you can give your feedback here:
https://support.zendesk.com/hc/en-us/community/topics/1260801308530-Feedback-Help-Center-Guide-
Thanks :)
1
Destiny
In its default configuration, the homepage is designed to exhibit a maximum of 6 articles, and at present, there is no native functionality to augment that limit. Furthermore, expanding this limit is not scheduled in our development roadmap at the moment. Please do share your feedback on the link that Ifra provided.
Hoping for your understanding on this matter. Thank you~!
0