View source for Projects/kde.org/Staging Setup

__TOC__

==Needed Software==

On the machine you use for this setup, you need to have installed a
Linux/*BSD with a working Apache (1 or 2) with mod_php4. You will need at least the PHP4 modules pcre (for Perl compatible regular expressions) and xml (for the UTF-8 encoding).

==Getting the needed module from SVN==

You need to checkout the www module from our SVN, it's located in /trunk.
The www module will be the documentroot of your apache, therefor keep
care that the apache process can read this dir.

==Setup of the Apache vHost for the Staging==

You need to setup a vHost for the staging, here an example to have some
vHost for your localhost running on port 8080.

  # listen on this port, too (mostly in file "listen.conf")
  Listen 8080
  
  # staging vhost in a conf file
  <VirtualHost 127.0.0.1:8080>
      # set documentroot + 404 handler
      DocumentRoot <path_to_www>
      ErrorDocument 404 /media/404.php
  
      # php part
      php_value short_open_tag Off
      php_value register_globals No
      php_value safe_mode On
      php_value include_path ".:<path_to_www>/media/includes"
      
      # enable .php, add .html here, for developer.kde.org
      AddType application/x-httpd-php .php
  </VirtualHost>

==Using the Staging==

After restarting your Apache, you should have a running staging
area on http://127.0.0.1:8080. You can now simply access and test
all *.kde.org sites within this vhost. They all will behave like
they are on their own domain, in their own vhost.

www.kde.org is now available under:
  http://127.0.0.1:8080/sites/www

pim.kde.org is now available under:
  http://127.0.0.1:8080/areas/pim