====== How to install Community-ID 2.0.0 RC3 ======


The <del>[[http://source.keyboard-monkeys.org/wiki/communityid|official site of Community-ID]]</del> (Offline) [[http://www.itadmins.net|New official site of Community-ID]] offers a series of simple tutorials for installation of the service but as of version 2.0.0 the installation process has changed a bit. This little howto is constructed from a tutorial that was based on the original tutorial modified and translating it into Spanish (by [[http://grial.usal.es/agora/pfcgrial/tag/community-id/|Alicia García Holgado)]] and, of course, modified even further by yours truly.

For those of you not able to get a copy of Community-ID 2 <del>just let me know and I will provide a copy here on my site</del> just go [[http://www.itadmins.net/blog/2012/03/19/english-community-id-2-0-rc3-now-available-here/#more-357|here]].


==== Requirements ====

    * Web Server version 1.3 is recommended or higher Apache Server . Alternatives can be used as HTTP server lighttpd , Cherokee HTTP server , nginx or other server that you are familiar with.
    * It requires PHP 5.2.4 or higher version of PHP with cURL support, the MySQLi extension installed.
    * Requires MySQL version 4.1 or above.

==== Database ====

Community-ID requires the creation of a MySQL database. For this you can use any of the existing management tools to manage MySQL

<file>
CREATE USER 'openid'@'localhost' IDENTIFIED BY '***';

GRANT USAGE ON * . * TO 'openid'@'localhost' IDENTIFIED BY '***' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;

CREATE DATABASE IF NOT EXISTS `openid` ;

GRANT ALL PRIVILEGES ON `openid` . * TO 'openid'@'localhost';
</file>

==== Prepare Apache ====

Ensure that mod_rewrite is active and that .htaccess files can be read (AllowOverride All).

Create a virtual host file for that name, e.g. /etc/httpd/conf/vhosts/openid.mydomain.com or /etc/apache2/sites-enabled/openid.mydomain.com, containing:

<file>
<VirtualHost *:80>
   ServerName    openid.mydomain.com
   DocumentRoot /var/www/openid

   <Directory /var/www/openid>
      Options FollowSymLinks
      AllowOverride All
   </Directory>
</VirtualHost>
</file>

and restart Apache.

==== Install the source-ID Community ====


Download version 2.0.0 RC3 of Keyboard Monkeys Project download area and decompresses the web server directory.

<file>
 cd /var/www
 tar xvfz cid-2.0.0-RC3.tar.gz
 mv community openid
</file> 

or

<file>
 cd /var/www
 unzip cid-2.0.0-RC3.zip
 mv community openid
</file>

Install the application via a web browser showing the following URL:

<file>
  http://openid.mydomain.com/
</file> 

The installation process for the name of the database previously created and the login to access it. You must also specify the user name and password for the administrator account. This account will not have an OpenID identifier so that it can only be used for administrative tasks.


==== Configuration file ====

The configuration file, config.php, includes a number of variables for configuring the operation of the application. Listed below are some of the most important parameters.

<file>
 # Enable (true) or off (false) the user registration form.
 $ Config ['environment'] ['registrations_enabled'] = false; 

 # Keep a log of the system.  The specified file must be created beforehand and be writable by the web server user.
 $ Config ['logging'] ['location'] = '/var/log/communityid.log';
</file> 

PASSWORDS section contains a number of variables used to define the minimum requirements to be met by user passwords.

<file>
 # Password different user name
 $ Config ['security'] ['password'] ['username_different'] = true;
 # Minimum password length
 $ Config ['security'] ['password'] ['minimum_length'] = 6;
 # True if the password must contain a numeric character
 $ Config ['security'] ['password'] ['include_numbers'] = false;
 # True if the password should contain non-alphanumeric characters
 $ Config ['security'] ['password'] ['include_symbols'] = false;
 # True if the password should contain lowercase and uppercase characters
 $ Config ['security'] ['password'] ['lowercase_and_uppercase'] = false;
</file> 

==== Access Permissions ====

Change the access permissions to the files of the application. On Debian systems this will most likely be www-data.

<file>
 cd /var/www
 chown-R www-data.www-data openid
 find openid -type d -exec chmod 550 {} \;
 find openid -type f -exec chmod 440 {} \;
 cd openid
 chmod u+w captchas 
</file>

==== Configuring SMTP email to Gmail in Community-ID ====

Community-ID is configured to send mail through Sendmail. If we want is that the shipment is made ​​through Gmail's SMTP server you have to make some small modifications in the config.php file.

By default the fields for email are:

<file>
 $ Config ['email'] ['transport'] = 'sendmail';
 $ Config ['email'] ['host'] ='';
 $ Config ['email'] ['auth'] ='';
 $ Config ['email'] ['username'] ='';
 $ Config ['email'] ['password'] ='';
</file> 

First we show smtp transport type, all lowercase, and host smtp.gmail.com. Gmail's SMTP server ssl connection works through the port 465 so we add our two new configuration file options, $ config ['email'] ['ssl'] and $ config ['email'] ['port' ]. Finally the type of authentication should be login, username and password indicating a valid account and password of Gmail for the same.

After these changes to the configuration file should look something like the following:

<file>
 $ Config ['email'] ['transport'] = 'smtp';
 $ Config ['email'] ['host'] = 'smtp.gmail.com';
 $ Config ['email'] ['ssl'] = 'ssl'; 
 $ Config ['email'] ['port'] = '465 '; 
 $ Config ['email'] ['auth'] = 'login';
 $ Config ['email'] ['username'] = 'tu-usuario-de-gmail@gmail.com';
 $ Config ['email'] ['password'] = 'your-password-for-gmail';
</file>