What Is The Difference Between $page->id(), uid() and uri()?

Kirby 3 Solved ✅
1

Just wondering whether there is an ‘official’ criteria for when to use each?

2

id() returns either the uid, or if the page has a parent, the parent’s id + the UID;

uid() returns the slug, i.e. in a multi-lang install the translated slug.

uri will return the translated id in multi-lang sites.

1 Like
3

So, for single-language sites, for some pages the id(), uid() and uri() will be the same, right?

4

First level pages, yes.

5

would be awesome to have these kind of infos in the docs…

4 Likes
6

I agree the descriptions like “Returns the ID” are sort of useless…

2 Likes
7

I agree, the docs could benefit from some further details here. Even the short description of uid() commented in the source code could be a welcome addition to the docs: https://github.com/getkirby/kirby/blob/3.4.3/src/Cms/Page.php#L1511

2 Likes