[drupal-docs] Troubleshooting faq section (needs to be condensed)

[Anisa]

There was a lot less info in there than I thought.  Here's what I wrote 
up...  It's pretty long, but I think it covers a lot of potential points 
of confusion.  There are a few places in [] I need help, because I don't 
quite get it myself (will explain at the end).  Only thing that is in 
the handbook page (http://drupal.org/node/17473) that isn't in here is 
the bit about the CVS version of modules.

***************************************
How do I install a module?

New to Drupal?  No worries.  Installing a module in Drupal is very easy!

********
In brief. Download the module, extract, upload the folder into your 
Drupal modules folder, run the mysql file if necessary, and enable the 
module in administer/modules.

********

1. Download the new module.  Make sure the version of the module is 
compatible with your version of Drupal. 

2. Extract the module.  When you first get the module, it will probably 
come in a compressed file format like zip or tar.gz.  Use a program like 
WinZip to extract it.  It may be a good idea to save it where you have 
your Drupal files on your computer. [COMMANDLINE thingies?]

3. Read the installation file (usually install.txt).  Sometimes the 
installation file has no extension, so when you try to click on it, your 
computer doesn't know what program to use.  In that case, open Notepad 
(or your favorite text editor) first, and then open the file into it. 

4. When you extracted the module, you should've made a folder with the 
module's name on it.  Upload that folder to the modules directory on 
your Drupal website. 

5. There are modules that modify the database, and modules that do not.  
It should say in the instructions whether it modifies the database or 
not, but you can also tell if there is a modulename.mysql file included 
with the module.  [WHAT TO DO with PostgreSQL?] If you do have to modify 
the database, see the next few steps.  If you do not, please skip to step 7.

6. If you have to modify the database to get your module running, you 
will need to add a bunch of tables to the database you made when you 
installed your drupal website.  The modulename.mysql file contains 
instructions to do that.  You don't need to read them, just upload the 
file to your database.
    ***For phpMyAdmin***
    >If you have phpmyadmin, log in and go to your drupal database.  If 
you have it, but do not know how to access it, please contact your host.
    >Click on the tab that says 'SQL'
    >You should see a text area labeled 'Run SQL query/queries on 
database yourdrupaldatabase'.  Underneath, it says 'Or  Location of the 
textfile:'  Click browse, and find that modulename.mysql file on your 
computer.  Click go, and it will create the tables for you.  Unless your 
instructions for the module says anything else, that should be all you 
have to do to the database.

7. Now your module is uploaded, and your database modified (if 
necessary).  For most modules, all that is left is to activate it!  To 
activate your module, you need to go to administer > modules, check the 
box next to your new module name, and click on 'save configuration' at 
the end.

8. Done!  Maybe. Some modules will require you change permissions or 
settings to get them working as you like them.  Read the instructions!  
If you still run into the problems, search the forums.  If your problem 
hasn't already been addressed, post a new post.

***********************************

Things I don't get personally:

Whenever I see things like the following:

mv drupal-x.x.x/* drupal-x.x.x/.htaccess /var/www/html

I get confused.  ;p

I know that Drupal supports that PostSomething database, but many 
modules just come with a mysql file.  In that case...?

I can probably tone this down to make it more succinct. 

Please let me know what you think.  :)

Not sure where this would go.  It's *Basic*, so it should probably just 
add to the installing modules page.

Anisa.