Usage statistics for distributions

Last updated on
23 December 2016

Drupal 7 will no longer be supported after January 5, 2025. Learn more and find resources for Drupal 7 sites

Usage statistics are linked from drupal.org's project and release pages of each distribution, and are the basis for the default Sort by: Most installed search filter on the installation profiles / distributions listing.

To obtain usage statistics on drupal.org, distributions need:

  1. Releases of the distribution available on its project at drupal.org, in order to collect release statistics.
  2. Core modules Update Status (D6), or Update Manager (D7), enabled. It's advisable to have them enabled by default, for information and usage tracking, with a possible notice -if needed- to use only the compatible updates provided by the distribution maintainers.
    Distributions can use hook_update_status_alter() (also in Drupal 6) so that update module can remain enabled but still hide warnings about releases from projects managed by the distribution. That's better than using hook_update_projects_alter() since removing projects from the list at that point would prevent those modules from getting proper usage tracking. It's better for update module to keep fetching info for those, but just not display warnings for new releases.
    This is as well a feature request for the update_advanced contributed module, that would provide an easy to use solution for distributions. The issue is #1425522: Help manage updates for distributions.
  3. For Drupal 6 only, because of the lack of .info files for D6 versions of distributions, one or more custom modules such as features should be committed directly to the profile directory, on the Drupal git repository, before the packaging system adds core and contrib. The drupal.org packaging script writes metadata in the .info files of the custom modules or features, telling the Update Status module to query the distribution project at drupal.org for available releases, which triggers usage tracking. For example:
     
    ; Information added by drupal.org packaging script on 2012-01-18
    version = "6.x-2.4"
    core = "6.x"
    project = "distribution_name"
    datestamp = "1326924940"
    

For Drupal 6, all items on the list, #1, #2, and #3, are needed.
For Drupal 7, just #1 and #2 are all that is needed for usage statistics.

Download statistics

Update: In addition to the usage stats, and since April 6, 2012, download count has been deployed on the project pages, including distributions. The default sort order is still by usage.

Help improve this page

Page status: No known problems

You can: