= How To: Set up a development site =

You can get a copy of the Drupal site and modules from SVN and a sample database and files to be able to run your own development copy of nabuur.

== Requirements ==

 * Apache (do we need to specify version?). You will need mod_rewrite.
 * with PHP (version 5.2 or higher)
 * MySQL (need to make sure mysqldump version compatible)

== Configuring Apache ==

At the minimum you will want a standard Drupal virtual host set up with mod_rewrite on, AllowOverride ALL, and ''which php flags - memory size for example''.

== Code ==

The code can be checked out of SVN anonymously. The url of the [wiki:RepositoryStructure repository] is http://svn.nabuurtest.com/svn/nabuur. You'll best one to check out a developers copy is [source:branches/theme/drupal-6], which include most testing changes and the developer modules, or maybe [source:branches/kester/drupal-6]. Or download the [attachment:wiki:HowToDevelSite:nabuur-dev.tar.gz nightly tarball]

{{{
> cd [DOCROOT] // On linux systems mostly /var/www or /var/www/htdocs

> svn checkout \
    --username anonymous --password anonymous \
    http://svn.nabuurtest.com/svn/nabuur/drupal-6

> ln -s drupal-6/drupal drupal

> vim drupal-6/sites/default/.ht_settings.php   // edit the database settings here
}}}

The content of '''.ht_settings.php''' is:

{{{
<?php
$db_url = 'mysql://username:password@localhost/databasename';
$db_prefix = '';
}}}


Note that drupal core and the sites directory are both at the top level with a symlink to sites in drupal. 


== Database ==

Make a user and database for Drupal to use. [http://www.debuntu.org/how-to-create-a-mysql-database-and-set-privileges-to-a-user Helpful how to if your not sure about doing this]

The database details aren't checked into svn either. They are expected to be in a file called .ht_config.php in sites/default. Copy ht_config.example.php and change the last lines to have the correct details for you mysql database.

The latest sample of the database [attachment:wiki:HowToDevelSite:nabuur-dev.nightly.mysql.gz in this gzipped file]. Download this, ungzip it and put it into the database that you made.

{{{
> gunzip nabuur-dev.nightly.mysql.gz
> mysql -u user_name -puser_password database_name < nabuur-dev.nightly.mysql
}}}

The user 1 (super user) has the username: admin and the password: password.
Note on [wiki:sanitizing_database Sanitizing the database]

== Files ==

You don't actually need this, but without it you have no images. There is a small sample [attachment:wiki:HowToDevelSite:nabuur-dev.files.tar.gz tarball of a files directory]. Unpack it in the drupal root directory and symlink it there.

Note: for the moment this is missing a lot of the 'furniture' files for the site that are not referenced in the database.

{{{
> tar -zx -C the_directory_where_you_want_the_code/drupal -f nabuur-dev.files.tar.gz
}}}

== Start using the site ==

Point your browser at the virtual host name that you used above. Pop it in your [http://en.wikipedia.org/wiki/Hosts_file hosts file] if it doesn't exist. And you can start browsing.

You can log in as the user 1, the superuser, with the username: {{{admin}}} and password: {{{password}}} 

== Drupal 5 nabuur.com site ==

If you are interested in the code and the data for the Drupal 5 site you can use the [http://svn.nabuurtest.com/trac/wiki/HowToDevelSite?version=3 Drupal 5 nabuur.com developer installation and files]. 

== Help! ==

Still want help? Come and [wiki:jabber chat with us]