====== Installing on 1and1 ======

===== Prologue =====

After logging into your personal administration interface on [[http://1and1.fr]], go to  **Manage pack** tab to access information about your FTP access (Domain configuration), as well as database creation and configuration (MySQL administration).

===== Prepare the environment =====

You need a MySQL v5 database. If you don't have any yet, you should create one.

You also need to allow PHP 5 to run on your site. To do this, place an ''.htacess'' file in the root directory of your web site, containing:

  AddType x-mapp-php5 .php


===== Configuration file =====

You should now rename ''inc/config.php.in'' to ''inc/config.php'', then fill in the database details 1and1 provided.

This file configures access to the database.

<code php>

<?php
# ***** BEGIN LICENSE BLOCK *****
# This file is part of DotClear.
# Copyright (c) 2005 Olivier Meunier. All rights
# reserved.
#
# DotClear is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# DotClear is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with DotClear; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# ***** END LICENSE BLOCK *****

// Database driver (mysql, pgsql, sqlite)
define('DC_DBDRIVER','mysql');

// Database hostname (usually "localhost")
define('DC_DBHOST','name of the database server');

// Database user
define('DC_DBUSER','username');

// Database password
define('DC_DBPASSWORD','password');

// Database name
define('DC_DBNAME','name of the database');

// Crypt key (password storage)
define('DC_MASTER_KEY','you MUST edit this value');


// Admin URL. You need to set it for some features.
define('DC_ADMIN_URL','full URL of the admin directory');

// Cookie's name
define('DC_SESSION_NAME','dcxd');
 
// Plugins root
define('DC_PLUGINS_ROOT',dirname(__FILE__).'/../plugins');


// Template cache directory
define('DC_TPL_CACHE',dirname(__FILE__).'/../cache');


// If you have PATH_INFO issue, uncomment following lines
//if (!isset($_SERVER['ORIG_PATH_INFO'])) {
//   $_SERVER['ORIG_PATH_INFO'] = '';
//}
//$_SERVER['PATH_INFO'] = $_SERVER['ORIG_PATH_INFO'];

?>

</code>

The ''DC_ADMIN_URL'' should be the complete path to the administration interface of your Dotclear installation.

===== Installation =====

Open your browser and go to the ''admin/install'' directory of your Dotclear installation and fill out the form. Dotclear is now installed!

===== Completion =====

When your installation is finished and you have confirmed everything works, you can choose ''PATH_INFO'' format for your URLs and remove //index.php// from your blog URLs.

==== Using ''PATH_INFO'' URLs ====

In the ''inc/config.php'' file, uncomment the four ''PATH_INFO'' lines near the end of the file, by deleting the double slashes ('/') at the beginning of each line.

==== Removing ''index.php/'' from URLs ====

Add the following lines to your ''.htaccess'' file:

  # Get nice URLs with DotClear 2
  RewriteEngine On
  RewriteBase /
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule (.*) index.php/$1
  RewriteRule ^index.php$  index.php/

//Note: If you have placed DC2 in a subdirectory, replace the line//
  RewriteBase /
//with//
  RewriteBase /subdirectory/

Go to your Dashboard, then to the **Blog settings** screen, and delete ''index.php/'' from the end of the URL in the **Blog URL** field.