Unexpected issue with sorting on setting the num prop when creating pages in code.

[SeriousKen]

Description

The following two pieces of code do not produce the same results:

<?php

use Kirby\Cms\Page;

require __DIR__ . '/vendor/autoload.php';

$faker = \Faker\Factory::create();
$faker->seed(29670);

$kirby = new \Kirby\Cms\App();
$kirby->impersonate('kirby');

for ($i = 1; $i <= 10; $i++) {
    $page = Page::create([
        'slug'     => join('-', $faker->words(5)),
        'draft'    => false,
    ])->changeStatus('listed', 1);
}

<?php

use Kirby\Cms\Page;

require __DIR__ . '/vendor/autoload.php';

$faker = \Faker\Factory::create();
$faker->seed(29670);

$kirby = new \Kirby\Cms\App();
$kirby->impersonate('kirby');

for ($i = 1; $i <= 10; $i++) {
    $page = Page::create([
        'slug'     => join('-', $faker->words(5)),
        'draft'    => false,
        'num'      => 1,
    ]);
}

Expected behavior

I would expect both pieces of code to create a series of pages, inserting each page with sort number of 1 so the pages should be in the reverse order they were created.

The first one works, the second prefixes all pages with 1. Which is odd, because the last thing the create method does is call changeStatus('listed', $props['num']) before returning the page object.

I presume that setting num on the array is doing something internally that is causing an issue when calling the changeStatus method before returning the object.

Screenshots

To reproduce

1. Create a project from plainkit
2. Create two php files in the root, on for each for the above code.
3. Run one file on the CLI and observe the results
4. Clean up and run the other one

Your setup

Kirby Version

Kirby 4.2.0

Console output

Your system (please complete the following information)

• Device:
• OS:
• Browser:
• Version:
  Linux Ubuntu 20.04 LTS running on WSL2 on Windows 11 Dell laptop

Additional context

[SeriousKen]

Figured out where the difference occurs - line 281 in the PageActions trait. When setting the num prop directly the logic says that it doesn't need sorting.

kirby/src/Cms/PageActions.php

Lines 280 to 283 in c1e6ff7

	// don't sort if not necessary
	if ($this->status() === 'listed' && $num === $this->num()) {
	return $this;
	}

[afbora]

I have not an idea about the fixing the issue but as workaround you can use 'num' => 0 to create pages with reverse order.

[SeriousKen]

@afbora yes, setting num to 0 does work but I just needed some example code to highlight the issue. Something needs fixing somewhere, but not sure if it is code or documentation. There is an inconsistency in using num in the props vs setting it after creation with changeStatus, and I think changeStatus after creation is probably the more understandable way, but num is documented as a prop and the difference in the behaviour is not obvious.

[SeriousKen]

Seems that setting draft to false in conjuction with setting num is causing the issue, setting num doesn't need draft as false anyway as it sets the status to listed so should there be a warning in the docs about not using both settings together?