Documentation

Note: if you would like to upload a module check out the instructions here.

Installing a CMA Module

  1. Go to the Github repository for the module. These links for all the repositories are listed in the right column of this page.
  2. Click on the Releases tab and download the zipped or tar version of the latest release.
  3. Click the download link and get the download URL for the module. Here is the URL for the Reservations Operator History Module as an example: https://github.com/cm-advanced/reservations_operator_history/archive/7.x-1.1.zip or https://github.com/cm-advanced/reservations_operator_history/archive/7.x-1.1.tar.gz
  4. After downloading and uncompressing the module change the name of the directory and place under /sites/all/modules. Using Reservations Operator History as an example, the directory downloaded and uncompressed is named reservations_operator_history-1.x/. It should then be changed to reservations_operator_history
  5. Enable the module, either via the modules page (admin/modules) or via drush: Drush en reservations_operator_history
  6. If you have an existing module for the same project, you will need to remove the directory for the existing module (rm -rf /path/to/the/directory/directory_name) and then clear all caches (drush cc all).

Download and install the External Repository Update Status (ERUS) module

If you install this module you will be aware of updates to your freshly installed CMA module. This step, although optional for the module to work, is extremely important, otherwise you may miss important security updates for the module
  1. Either go to https://www.drupal.org/project/erus and download the latest version of the Drupal 7 module or simply use the drush command: drush dl erus
  2. Enable the module, either via the modules page (admin/modules) or via Drush: drush en erusNow if you go to the available updates page (/admin/reports/updates) and view your CMA module, if there are any available updates for the module, they will be displayed on this page.

Update a CMA Module using the ERUS module

When developers in the CMA project release a new version of the module and you have the ERUS modules enabled, you will see the available updates on /admin/reports/updates or by using drush.

For Drush, simply use: drush upc   –package-handler=erus_wget .  It is important to add in the package handler flag, otherwise you will get an MD5 error and Drush will fail to update the module. 

If not Drush, do the following

  1. Click the “Download” link on the available updates page for your CMA module.
  2. Download the module, uncompress it, and rename it. Using Reservations Operator History as an example, the directory downloaded and uncompressed is named reservations_operator_history-1.x/. It should then be changed to reservations_operator_history
  3. Either go to /update.php and run the updater, or use Drush: drush updb