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()

2 calls to _update_build_fetch_url()
UpdateCoreUnitTestCase::testUpdateBuildFetchUrl in modules/update/update.test
Tests that _update_build_fetch_url() builds the URL correctly.
_update_process_fetch_task in modules/update/update.fetch.inc
Processes a task to fetch available update data for a single project.

File

modules/update/update.fetch.inc, line 294

Code

function _update_build_fetch_url($project, $site_key = '') {
    $name = $project['name'];
    $url = _update_get_fetch_url_base($project);
    $url .= '/' . $name . '/' . DRUPAL_CORE_COMPATIBILITY;
    // 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.
    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;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.