When using the multiple {articles} tag, you will have a number of articles being output.

Articles Anywhere offers several numbers based on what place the article has in the list of articles. You can output these numbers via Data Tags, and you can also use them in the If Structures.

This way you can conditionally output html/content/data based on these dynamic values, such as: the number of the article in the list, If this is the "first" or "last" article, if it's an "even" or "uneven" article, etc...

Note: If you use Pagination, the Numbers values will be based on the articles returned in the current page. To get the overall Numbers values regardless of pagination, you can append the respective Data Tag with a -no-pagination suffix.

Totals

The total value contains the number of the articles returned by the {articles} tag on the page.

If you use pagination, you can get the overall number of articles returned with the total-no-pagination value.

When you use the limit="..." attribute, to - for instance - only return 40 articles overall, then you might also want to know (and use) the total number of articles that would have been returned if there was no limit. You can get this value with the total-no-limit value.

Count

The count value contains the number of the article in that set of articles.
So the first article on the page will have a count value of 1. The seventh article on the page will have a count value of 7.

You can - for example - use this count tag to create id or class names. In the HTML/code view of the editor, you could place:

<div class="my-article-[count]">[title]</div>

This example will show the linked title and introtext of the first 3 articles, and only the linked title of the rest:

{articles category="Mice"}[link][title][/link]
{if count <= 3}[introtext]{/if}{/articles}

If you use pagination, you can get the overall number of the article with the count-no-pagination value.
So, if you show 10 articles per page, the first article in the second page will have a count value of 1, and a count-no-pagination value of 11.

Previous / Next

The previous value gives the number of the previous article in the list. This will return the number of the last article when the current is the first on the page.

The next value gives the number of the next article in the list. This will return the number of the first article (1) when the current is the last article on the page.

You can use these to create custom article navigation, or simple anchor links to the previous/next articles.
This is an html example of a blog page with previous/next links:

<p>{articles category="My Category}</p>
<h1><a href="/article-[count]"></a>[title]</h1>
<p>[text]</p>
<p><a href="#article-[previous]">previous</a> <a href="#article-[next]">next</a></p>
<p>{/articles}</p>

The has-next and has-previous values will return a true/false value based on whether there is a next/previous article on the page.
This means that has-previous will only be false for the first article on the page, and the has-next will only be false for the last article on the page.

If you use pagination, you can get the number of the overall previous and next articles with the previous-no-pagination and next-no-pagination values.
This means that has-previous-no-pagination will only be false for the first article on the first page, and the has-next-no-pagination will only be false for the last article on the last page.

Is First / Last

The is-first and is-last will return a true/false value based on whether the article is the first/last article on the page.

This example shows how to add a different class name for the first and last articles in the output (in html view):

<div class="my-article {if is-first}my-first-article{/if} {if is-last}my-last-article{/if}">

You can of course use this for other things as well, like conditionally showing extra data or html for the first and/or last article.

If you use pagination, you can get the overall first and last article with the is-first-no-pagination and is-last-no-pagination values.
So the is-last value will be true for every last article in each page, while the is-last-no-pagination value will only be true for the very last article in the last page.

Is Even / Uneven

The is-even and is-uneven values are handy for creating lists that have an alternating class. Like a "zebra-striped" table.

This example shows how to add a different class name for the even and uneven articles in the output (in html view):

<div class="my-article {if even}my-article-even{/if}{if uneven}my-article-uneven{/if}">

The same can be done with an else:

<div class="my-article {if even}my-article-even{else}my-article-uneven{/if}">

Or even shorter with the same result:

<div class="my-article my-article-{if uneven}un{/if}even">

You can of course use this for other things as well, like conditionally showing extra data or html for the even or uneven articles.

Every ...

The every-... values are useful to add extra html or a class name for every n. articles.

Let's say you want to create columns. Then you will need to add extra html or class names to mark the beginning or end of each row.
For this purpose you can use the every-... value.

This example shows how to add an extra closing and opening <div> after every 4th article in the output (in html view):

{if every-4}</div><div>{/if}

Columns

An even more flexible value is the is-...-of-... value.

Just some examples:

• The is-1-of-3 value will be true for the 1st, 4th, 7th, etc article.
• The is-3-of-3 value will be true for the 3rd, 6th, 9th, etc article.
• And the is-2-of-5 value will be true for the 2nd, 7th, 12th, etc article.

This example shows how to add a different class name for every 2nd article when splitting the result in groups of 5:

<div class="my-article {if is-2-of-5}my-special-article{/if}">

See the If Structures section for more information on the {if} tags.

Page Numbers

If you use Pagination, you can output special pagination-based Number Values.

The per-page value contains the number of articles per page set to be returned.

The pages value contains the total number of pages generated by the results. And you can use the page value to return the number of the current page.

The previous-page value gives the number of the previous page. This will return the number of the last page when the current is the first page.
The next-page value gives the number of the next page. This will return the number of the first page (1) when the current is the last page.

The is-first-page and is-last-page will return a true/false value based on whether the current page is the first/last.

The has-next-page and has-previous-page values will return a true/false value based on whether there is a next/previous page.
This means that has-previous-page will only be false for the first page, and the has-next-page will only be false for the last page.

Calculations J4

Articles Anywhere can even do calculations on numeric values! It can't make you coffee yet, but we're working on it.

The calculations work on any data that outputs a numeric value. This means that not only it works on Number data tags such as [total], [count], [next], [previous], etc, but it can also work on things like [hits], and even custom fields.

Here is how it works, using [count] as an example, where [count] is 10. You can use the following arithmetic operators:

[count]				= 10
[count calc="+10"]	= 20
[count calc="-3"]	= 7
[count calc="*3"]	= 30
[count calc="/2"]	= 5
[count calc="%4"]	= 2

List of Data Tags

{articles category="Animals" limit="40" per-page="10"}...{/articles}