metatag-8.x-1.x-dev/metatag_mobile/src/Plugin/metatag/Tag/AndroidAppLinkAlternative.php

<?php

namespace Drupal\metatag_mobile\Plugin\metatag\Tag;

use Drupal\metatag\Plugin\metatag\Tag\LinkRelBase;

/**
 * The Android app link alternative for Android mobile metatag.
 *
 * @MetatagTag(
 *   id = "android_app_link_alternative",
 *   label = @Translation("Android app link alternative"),
 *   description = @Translation("A custom string for deeplinking to an Android mobile app. Should be in the format 'package_name/host_path', e.g. 'com.example.android/example/hello-screen'. The 'android-app://' prefix will be included automatically."),
 *   name = "alternate",
 *   group = "android_mobile",
 *   weight = 91,
 *   type = "uri",
 *   secure = FALSE,
 *   multiple = FALSE
 * )
 */
class AndroidAppLinkAlternative extends LinkRelBase {

  /**
   * {@inheritdoc}
   */
  public function output(): array {
    $element = parent::output();

    // Add the "android-app://" prefix on the href value.
    if (isset($element['#attributes']['href']) && $element['#attributes']['href'] != '') {
      // Don't add the prefix if it's already present.
      if (strpos($element['#attributes']['href'], 'android-app://') === FALSE) {
        $element['#attributes']['href'] = 'android-app://' . (string) $element['#attributes']['href'];
      }
    }

    return $element;
  }

  /**
   * {@inheritdoc}
   */
  public function getTestOutputExistsXpath(): array {
    return ["//link[@rel='alternate' and starts-with(@href, 'android-app:')]"];
  }

  /**
   * {@inheritdoc}
   */
  public function getTestOutputValuesXpath(array $values): array {
    $xpath_strings = [];
    foreach ($values as $value) {
      $xpath_strings[] = "//link[@rel='alternate' and @href='android-app://{$value}']";
    }
    return $xpath_strings;
  }

}