Campsite: HowToDoArticlePagination

How to do article pagination?

This example will show you how to split an article on multiple pages. We assume the article type is fastnews and has three fields: date (date field type), intro (body field type) and Full_text (body field type). You'll find this example implemented in the Campsite demo package here. The field Full_text is the one that contains the pagination (subheads).

Here is the code:

{{ list_subtitles field_name="Full_text" }}

```
  <p>
```

  {{ if $campsite->article->full_text->subtitle_is_current }}

    <b>{{ $campsite->current_list->index }}. {{ $campsite->subtitle->name }}</b>

```
  {{ else }}
```

    <a href="{{ uri }}">{{ $campsite->current_list->index }}. {{ $campsite->subtitle->name }}</a>

```
  {{ /if }}
```
```
  </p>
```
```
{{ /list_subtitles }}
```
```
<p>View subtitle:
```

{{ if $campsite->article->full_text->has_previous_subtitles }}

  <a href="{{ uri options="previous_subtitle full_text" }}">Previous</a>

```
{{ else }}
```
```
  Previous
```
```
{{ /if }}
```
```
|
```

{{ if $campsite->article->full_text->has_next_subtitles }}

  <a href="{{ uri options="next_subtitle full_text" }}">Next</a>

```
{{ else }}
```
```
  Next
```
```
{{ /if }}
```
```
|
```

{{ if $campsite->article->full_text->has_next_subtitles || $campsite->article->full_text->has_previous_subtitles }}

  <a href="{{ uri options="all_subtitles full_text" }}">All</a>

```
{{ else }}
```
```
  All
```
```
{{ /if }}
```
```
</p>
```

<p>{{ $campsite->article->full_text }}</p>

Lines 1-9 display the list of article subtitles (see "List of Subtitles" in "Template Language Reference" chapter):

display the subtitle name as simple text for the current subtitle - the one that's being viewed - (if $campsite->article->full_text->subtitle_is_current)
display the subtitle name as link for other subtitles (else branch)

Lines 11-27 create links to navigate to the previous or next subtitle (uri options="previous_subtitle full_text", uri options="previous_subtitle full_text"), or to display all subtitles (uri options="all_subtitles full_text").

Line 29 displays the actual article content, in this case the current subtitle ($campsite->article->full_text).

The example given above will make your page look something like this:

Article pagination

Note: CSS styles have been removed from the example to make it easier to read, so if you use the code above it will not look exactly as shown; the colors will not be there, and the spacing will be a bit different.

Another way would be to only show the numbers and not display anything if there is no pagination in the field, i.e. it is a normal article. Note: the count of subheads (sub titles) will be one if there is no subheads in the article field.

{{ list_subtitles field_name="Body" }}
{{ if $campsite->current_list->count > 1 }}
    {{ if $campsite->current_list->at_beginning }}
    <div     <ul>
        {{ if $campsite->article->body->has_previous_subtitles }}
        <li><a href="{{ uri options="previous_subtitle body" }}">&laquo;</a></li>
        {{ else }}
        {{ /if }}
    {{ /if }}
    {{ if $campsite->article->body->subtitle_is_current }}
        <li><a     {{ else }}
        <li><a href="{{ uri }}">{{ $campsite->current_list->index }}<!--{{ $campsite->subtitle->name }}--></a></li>
    {{ /if }}
    {{ if $campsite->current_list->at_end }}
        {{ if $campsite->article->body->has_next_subtitles }}
        <li><a href="{{ uri options="next_subtitle body" }}">&raquo;</a></li>
        {{ else }}
        {{ /if }}
    </ul>
    </div>
    {{ /if }}
{{ /if }}
{{ /list_subtitles }}

There might be some fields in the article that you only want to display at the beginning of the article. On the following pages of the pagination you don't want them to show. This is a way to do this:

{{ * print lead only if article pagination is on page one *}}
{{ list_subtitles field_name="Body" }}
    {{ if $campsite->current_list->at_beginning }}
        {{ if $campsite->article->body->has_previous_subtitles }}
        {{ else }}
        <span         {{ /if }}
    {{ /if }}
{{ /list_subtitles }}

As you can see, this is making use of the fact that even without actual pagination (subheads in the text, set with the editor), the article has one subhead in the list: itself.

EDIT

Campsite 3.4

How to do article pagination?