Returns the appropriate message text when site is out of date or insecure.

These error messages are shared by both update_requirements() for the site-wide status report at admin/reports/status and in the body of the notification email messages generated by update_cron().

Parameters

string $msg_type: String to indicate what kind of message to generate. Can be either 'core' or 'contrib'.

int $msg_reason: Integer constant specifying why message is generated.

string $langcode: (optional) A language code to use. Defaults to NULL.

bool $is_email: (optional) Controls if this function is used for generating mail. If TRUE, URLs will be absolute and will be included without access checks. If FALSE, links will be relative and will only be included if the current user can access them. Defaults to FALSE.

Return value

string|\Drupal\Core\StringTranslation\TranslatableMarkup The properly translated error message for the given key.

File

core/modules/update/src/UpdateMessageTrait.php, line 50

Class

UpdateMessageTrait

Provides helpers for update messages.

Namespace

Drupal\update

Code

protected function getText(string $msg_type, int $msg_reason, ?string $langcode = NULL, bool $is_email = FALSE) : string|TranslatableMarkup {
  $text = '';
  switch ($msg_reason) {
    case UpdateManagerInterface::NOT_SECURE:
      if ($msg_type == 'core') {
        $text = t('There is a security update available for your version of Drupal. To ensure the security of your server, you should update immediately!', [], [
          'langcode' => $langcode,
        ]);
      }
      else {
        $text = t('There are security updates available for one or more of your modules or themes. To ensure the security of your server, you should update immediately!', [], [
          'langcode' => $langcode,
        ]);
      }
      break;

    case UpdateManagerInterface::REVOKED:
      if ($msg_type == 'core') {
        $text = t('Your version of Drupal has been revoked and is no longer available for download. Upgrading is strongly recommended!', [], [
          'langcode' => $langcode,
        ]);
      }
      else {
        $text = t('The installed version of at least one of your modules or themes has been revoked and is no longer available for download. Upgrading or uninstalling is strongly recommended!', [], [
          'langcode' => $langcode,
        ]);
      }
      break;

    case UpdateManagerInterface::NOT_SUPPORTED:
      if ($msg_type == 'core') {
        $text = t('Your version of Drupal is no longer supported. Upgrading is strongly recommended!', [], [
          'langcode' => $langcode,
        ]);
      }
      else {
        $text = t('The installed version of at least one of your modules or themes is no longer supported. Upgrading or uninstalling is strongly recommended. See the project homepage for more details.', [], [
          'langcode' => $langcode,
        ]);
      }
      break;

    case UpdateManagerInterface::NOT_CURRENT:
      if ($msg_type == 'core') {
        $text = t('There are updates available for your version of Drupal. To ensure the proper functioning of your site, you should update as soon as possible.', [], [
          'langcode' => $langcode,
        ]);
      }
      else {
        $text = t('There are updates available for one or more of your modules or themes. To ensure the proper functioning of your site, you should update as soon as possible.', [], [
          'langcode' => $langcode,
        ]);
      }
      break;

    case UpdateFetcherInterface::UNKNOWN:
    case UpdateFetcherInterface::NOT_CHECKED:
    case UpdateFetcherInterface::NOT_FETCHED:
    case UpdateFetcherInterface::FETCH_PENDING:
      $url = Url::fromRoute('update.status', [], [
        'absolute' => $is_email,
        'language' => $langcode,
      ]);
      if ($msg_type == 'core') {
        if ($url->access() || $is_email) {
          return t('There was a problem checking <a href=":update-report">available updates</a> for Drupal.', [
            ':update-report' => $url->toString(),
          ], [
            'langcode' => $langcode,
          ]);
        }
        return t('There was a problem checking available updates for Drupal.', [], [
          'langcode' => $langcode,
        ]);
      }
      else {
        if ($url->access() || $is_email) {
          return t('There was a problem checking <a href=":update-report">available updates</a> for your modules or themes.', [
            ':update-report' => $url->toString(),
          ], [
            'langcode' => $langcode,
          ]);
        }
        return t('There was a problem checking available updates for Drupal.', [], [
          'langcode' => $langcode,
        ]);
      }
      break;

  }
  return $text;
}

---