Preview tokens 3: Preview URL refactoring

[lukasbestle]

🚨 Merge first

• Preview tokens 1: Groundwork A (Testing) #6821
• Preview tokens 2: Groundwork B (Core) #6822

Description

Summary of changes

A PR with three related refactoring changes to the existing preview URL logic.

Reasoning

• Duplicated code in $page->previewUrl() and $site->previewUrl() would become even more in following PRs if we wouldn't DRY it
• v5 is a good opportunity to rename the token query param in draft preview URLs to _token as the generation logic of those tokens will change anyway (in PR 8)

Additional context

$page->previewUrl() and $site->previewUrl() can stay as aliases/shortcuts as they do no harm and might be useful to devs as well.

Changelog

Housekeeping

• Consolidate duplicated logic from $page->previewUrl() and $site->previewUrl() in $version->url() (with aliases to the existing methods)

Breaking changes

• Rename token query param for preview URLs to _token for consistency with the new _version param

Breaking changes (since alphas)

• Rename parameter name $page->previewUrl($version) to $page->previewUrl($versionId) for consistency with other methods

Ready?

• In-code documentation (wherever needed)
• Unit tests for fixed bug/feature
• Tests and CI checks all pass

For review team

• Add lab and/or sandbox examples (wherever helpful)
• Add changes & docs to release notes draft in Notion

[lukasbestle]

Coverage seems to be another PHPUnit issue. If I rename Version::url() to another name, the coverage is detected properly.

[distantnative]

@lukasbestle Had that problem with Uuid::url() before, really seems to be that method name.

[bastianallgeier]

Nice! The new solution with Version::url() works really well.