Basic blog questions

1

I’m adding my first blog to a site. I’ve followed this Cookbook Creating a blog | Kirby CMS

I have some basic questions:

I’ve created a few test article pages. In the Contents > Blog folder they are numbered like this:

1_your-first-article
2_your-first-article
3_your-first-article
4_your-first-article

And in the Panel the position of the articles can be reordered, by simply dragging the pages up or down.

Is this standard practise to be able to reorder blog articles, or should they be arranged by date?

I’ve updated the Blueprint so that in the panel the articles are now sorted by date

articles:
	type: pages
	label: Articles
	status: listed
	template: article_template
	image: false
	sortBy: date desc
	info: "{{ page.date.toDate('d/m/Y') }}"

But in the frontend the articles are still being displayed by the ‘old’ numbering:

1_your-first-article
2_your-first-article
3_your-first-article
4_your-first-article

If it is standard practise to display blog articles by date, how do I do this? They are displayed in the Panel by date order, but not in the frontend.

Would the name of the articles need to change from

1_your-first-article

to

2025-01-11_your_first_article

In my article blueprint I allow the editor to add a date to the article

fields:
	type: fields
	fields:
		date:
			type: date
			display: DD/MM/YYYY
			label: Published date
			default: now
			required: true

I presume this is determining the order of the pages in the Panel? But how do I get it to determine the order of the pages in the frontend?

2

Okay, this works

<?php foreach($page->children()->listed()->sortBy('date', 'desc') as $article): ?>

It does not change / add the date to the filenames, but I presume it doesn’t have to?

3

See: Page blueprint | Kirby CMS

The numbering scheme would be set in the child blueprint (article.yml or post.yml or whatever those blog children are using a blueprint)

4

There seems to be two ways of doing this:

In the Blog template
<?php foreach($page->children()->listed()->sortBy('date', 'desc') as $article): ?>

Or, in the Article Blueprint
num: '{{ page.date.toDate("Ymd") }}'

Which is best? Are there pros and cons?

5

These are two different things. What you do in the template is just sorting them by a property.

Setting the num prop in the blueprint prepends the date instead of a sorting number to the folder.

6

Yeah, I’m wondering which options is the “normal” approach for a blog? Or does it not matter that much?