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

[Bèr Kessels]

Wow! great work.

Some question for the docs team too: We need some style guides. 
Anisa talks about "clicking on" and "file extensions" and such. IMO that is 
far too windows centric. I never have problems with extensions, becuase I use 
a real OS with MIME recognition :). 

I like the part where Anisa splits into PHPMyAdmin and command line. But for 
this too, we would need some style guides. 

Bèr

Op zondag 6 maart 2005 18:11, schreef 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.
Regards,
 Bèr
-- 
 [ Bèr Kessels | Drupal services www.webschuur.com ]