From URL to Link

[taufik-nurrohman]

The goal is to cut down on the use of abbreviations. This will deprecate and/or remove the following:

1. The URL class.
2. The $var->url methods and properties.
3. The $url variable.

Before

$url = new URL('http://127.0.0.1/asdf');

echo $page->url;

echo $url->query;

After

$link = new Link('http://127.0.0.1/asdf');

echo $page->link;

echo $link->query;

Case for page link property that previously was a custom:

<a href="<?= $page->link ?? $page->url; ?>">...</a>

Now I will consider to put the link value to links container instead:

<a href="<?= $page->links[0] ?? $page->link; ?>">…</a>

Or, if link keys can be anything:

<?php $links = (array) ($page->links ?? []); ?>
<a href="<?= $links ? reset($links) : $page->link; ?>">…</a>

<a href="<?= array_first((array) ($page->links ?? [])) ?? $page->link; ?>">…</a>

---

The introduction of links property gives page makers the ability to have more than one external link, which is ideal for download or product pages with various custom actions:

title: Liger Zero Panzer
description: HMM zoids released by Kotobukiya.
links:
  reference: /link/to/manual/liger-zero-panzer.pdf
  related:
    - /liger-zero
    - /liger-zero-empire
    - /liger-zero-jager
    - /liger-zero-schneider
    - /liger-zero-x
  store: /link/to/store/product/liger-zero-panzer
content: |

  Lorem ipsum dolor sit amet.

<?php if ($links = $page->links): ?>
  <p role="group">
    <a href="<?= $links['store']; ?>">Buy this kit</a>
    <a href="<?= $links['reference']; ?>">Read the manual</a>
  </p>
  <?php if (!empty($links['related'])): ?>
    <h3>Related model kits</h3>
    <ul>
      <?php if (is_array($links['related'])): ?>
        <?php foreach ($links['related'] as $v): ?>
          <li>
            <a href="<?= $v; ?>">
              <?= $v; ?>
            </a>
          </li>
        <?php endforeach; ?>
      <?php else: ?>
        <li>
          <a href="<?= $links['related']; ?>">
            <?= $links['related']; ?>
          </a>
        </li>
      <?php endif; ?>
    </ul>
  <?php endif; ?>
<?php endif; ?>