I was a Drupal noob not long ago. Installing a contributed module is second nature to anyone who maintains a site or develops modules. However, this information is very important and not very obvious to a noob. I just saw an excellent explanation on how to install a contributed module on the XMLSiteMap documentation page at http://drupal.org/node/264650. This is an excellent write up. Simple and to the point.

A page like this should be standard in the documentation for every project. Every spot in the documentation that says something like "Install this module in the normal way" should be replaced with the 3 steps from this page.

Regards,

Steve Halleman

Comments

trevjs’s picture

There is this: http://drupal.org/node/120641

There are probably some improvements that could be made, and there are some new options with Drupal 7.

Perhaps it isn't easy enough to find.

arianek’s picture

Title: Contributed Module Documentation Recommendation » Review Module install instructions
Component: Other documentation issues » Correction/Clarification
Category: feature » task
Issue tags: +Novice, +modules, +handbook

indeed thanks trev - that section within the cookbook (which is the beginners resource).

i'm going to rename this as a reminder to review this once the critical D7 docs are done (and tag it as a novice task in case someone else has time before then)

arianek’s picture

Issue tags: +cookbook

tags

batigolix’s picture

Assigned: Unassigned » batigolix

on it

batigolix’s picture

Assigned: batigolix » Unassigned
Status: Active » Needs review
matthews’s picture

Status: Needs review » Needs work

I would add the instructions for "Installing a Module from a URL" for Drupal 7 - how to use this page: admin/modules/install

Something like:

1) navigate to the module project page and copy the link address for the gz or zip file
2) navigate, on your site, to admin/modules/install
3) put the module URL into "Install from a URL"
4) click install
5) You may then enable your module from this page or navigate to admin/modules

You may also add a module from your computer.

1) navigate, on your site, to admin/modules/install
2) click choose file
3) navigate to the location the module has been downloaded to your desktop
4) click install
5) You may then enable your module from this page or navigate to admin/modules

matthews’s picture

I've added the above, please review.

heather’s picture

Status: Needs work » Closed (fixed)

Reviewed!

Just added the additional step of having Update Manager module enabled, and capitalized the steps.

Looks like some comments to be rolled in on that page. Not sure if this issue should be "needs work" - but the OP's suggestion is complete.

Nice!

heather’s picture

Status: Closed (fixed) » Reviewed & tested by the community

Oops, I meant RTBC :)

cleverington’s picture

Assigned: Unassigned » cleverington
Status: Reviewed & tested by the community » Needs work

Actually, after review I believe this is on the incorrect link.

As this is part of the 'Drupal Cookbook', it would be proper for the information on installing modules currently on the page to be shifted to http://drupal.org/node/120642 and the current page rewritten as an Overview to the Drupal Core modules and themes and navigating between them.

As the Cookbook is intended for absolute beginners, we are currently telling them all about installing modules before telling them how to evaluate whether they even need modules at all.

Many microsites can be built and hosted with the Core provided modules.

I'll work to get all three pages updated simultaneously and submitted for review.

xjm’s picture

Hi @cleverington,

Thanks for taking this on. Are you still working on this issue? If not, we'll unassign it in a day or two so that someone else can give it a try. (Feel free to assign it back to yourself if you'd still like to work on it, as well.) Thanks!

jhodgdon’s picture

Issue summary: View changes
Status: Needs work » Fixed

Actually it looks like all of the above was added to the referenced pages, so I'm just going to mark this as "fixed".

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.