Blog, Article and Comment Objects

Access any blog by handle from any template.

{% for article in blogs['news'].articles limit: 3 %}
  {{ article.title }}
{% endfor %}

Core identifiers and the blog's URL.

<a href="{{ blog.url }}">{{ blog.title }}</a>

The blog's articles, and how many there are. Paginate large blogs.

{{ blog.articles_count }} articles

Whether comments are allowed, and whether they need approval before appearing.

{% if blog.comments_enabled? %}…{% endif %}

On an article page, the adjacent articles — use for next/previous navigation.

{% if blog.next_article %}
  <a href="{{ blog.next_article.url }}">{{ blog.next_article.title }}</a>
{% endif %}

all_tags lists every tag used in the blog; tags lists tags on the articles currently shown.

{% for tag in blog.all_tags %}{{ tag | link_to_tag: tag }}{% endfor %}

Core article details.

<h1>{{ article.title }}</h1>
<p>By {{ article.author }}</p>

The full body, and the summary entered in the Excerpt field. Use article.excerpt_or_content as a fallback.

{{ article.excerpt_or_content }}

Timestamps — format with the date filter.

{{ article.published_at | date: '%d %b %Y' }}

The article's featured image.

{% if article.image %}
  {{ article.image | image_url: width: 1200 | image_tag }}
{% endif %}

The article's tags.

{{ article.tags | join: ', ' }}

Published comments, their count, and the URL comment forms post to.

{{ article.comments_count }} comments

Comment settings inherited from the blog.

{% if article.comments_enabled? %}{% form 'new_comment', article %}…{% endform %}{% endif %}

Details of a single comment. status reflects moderation.

{% for comment in article.comments %}
  <p><strong>{{ comment.author }}</strong>: {{ comment.content }}</p>
{% endfor %}