FAQ:

Does CleanSlate support blogs? Yes.

Can you have multiple blogs on a single site? Yes.

Do you have code examples of a blog index and blog article templates? Absolutely! Check out the blog_index.html and blog_article.html templates in the CleanSlate Toolkit—a boilerplate for making themes in CleanSlate.

Can you have different templates for different blog posts?

Yes. Say, for example, you had different authors and you wanted a bio to appear at the bottom of posts they write. Each author could have his or her own template. Another example could be a blog post that includes a YouTube video. You could have a field for the video in a blog_article--youtube.html template.

How do I pull articles from my blog onto my site's homepage?

Like this:  http://pastie.org/10139861. Note: this pulls blog articles from the same site—not from a different site.

How do I pull blog articles from a different site?

Use the RSS Feed Snippet. You can customize your site's RSS feed output in blog_index.rss.

How do I tag articles in CleanSlate?

Tag a blog article by adding a label to it in Pages. To filter blog posts by tag(s), follow this format: http://example.wvu.edu/blog?tags=example where example is the tag and /blog is the permalink to your blog's homepage. Separate multiple tags with commas in the URL.

How do I add a featured blog post to my homepage (or another page)?

You can add a label or multiple labels to a blog post or blog posts. Put this in your template: http://pastie.org/10188886. Change the blog ID. Then, choose which tag(s) you want included via tags="my-tag". Choose how many posts to display via limit="1". Here's a simplified example if you're looking to break this code down.

Can I exclude a certain label from a blog feed?

This usually happens if you don’t want your “featured stories” repeated next to your regular blog articles. To exclude a certain label from a list of blog articles, use tags_op="none" tags="dont-show-stuff-with-this-label" on the <r:articles> tag. Here’s an example: http://pastie.org/10705780.

Does CleanSlate have comments for blogs?

Not natively; however, we believe services like Disqus, Livefyre and many others accomplish this better than we could. We're planning on deeper integration with the Disqus API in the future and have had good experiences with Disqus in the past (we're even using Disqus for comments on this site's blog!). Expect to see articles/documentation about Disqus in the future.

I'm getting an application error for my blog. What's the deal?

It's likely that you created your blog page as a "Content Page" instead of a "Blog Index" page. In order for a blog to work, you must create the index as a "Blog Index" page. You cannot switch a normal page to all-of-a-sudden be a blog. Pages are different from blogs and have different functionalities.

Wait, I thought you just said I can have any number of templates for my blog posts.

Yup, you can. But your blog index must be created as a "Blog Index" page in Your Site > Pages > Create Page.

Does CleanSlate support blog post thumbnails?

You mean like this? Absolutely! You'll notice the css_selectorattribute on your blog_index.htmlpage. If you want to pull more than just a paragraph, add in the other tags in a comma separated list. In this case, image and paragraph tags: css_selector="img, p".

I have a question you didn't cover here. Where do I get answers?

You can either email CleanSlate@mail.wvu.edu or use the Request Help page. We're happy to hear from you!

Last updated on February 2, 2016.

We welcome all questions, feedback and bug reports. If you're having an issue, we usually need the following information:

  • A brief description of the issue
  • A link to the page where you saw the issue
  • Screenshots that illustrate the problem - How do I take a screenshot?

Kindly email CleanSlate@mail.wvu.edu for help or use the form on the request help page.