function _update_build_fetch_url

Generates the URL to fetch information about project updates.

This figures out the right URL to use, based on the project's .info file and the global defaults. Appends optional query arguments when the site is configured to report usage stats.

Parameters

$project: The array of project information from update_get_projects().

$site_key: (optional) The anonymous site key hash. Defaults to an empty string.

Return value

The URL for fetching information about updates to the specified project.:

See also

update_fetch_data()

_update_process_fetch_task()

update_get_projects()

File

core/modules/update/update.fetch.inc, line 302

Code required only when fetching information about available updates.

Code

function _update_build_fetch_url($project, $site_key = '') {
  $name = $project['name'];

  if (empty($project['project status url'])) {
    $url = _update_get_fetch_url_base($project);
    $url .= '/' . $name . '/' . BACKDROP_CORE_COMPATIBILITY;
  }
  else {
    $url = $project['project status url'];
  }

  // Only append usage information if we have a site key and the project is
  // enabled. We do not want to record usage statistics for disabled projects.
  // Only append a site_key and the version information if we have a site_key
  // in the first place, and if this is not a disabled module, theme, or layout. We do
  // not want to record usage statistics for disabled code.
  if (!empty($site_key) && (strpos($project['project_type'], 'disabled') === FALSE)) {
    // Append the site key.
    $url .= (strpos($url, '?') !== FALSE) ? '&' : '?';
    $url .= 'site_key=';
    $url .= rawurlencode($site_key);

    // Append the version.
    if (!empty($project['info']['version'])) {
      $url .= '&version=';
      $url .= rawurlencode($project['info']['version']);
    }

    // Append the list of modules or themes enabled.
    $list = array_keys($project['includes']);
    $url .= '&list=';
    $url .= rawurlencode(implode(',', $list));
  }
  return $url;
}