Installation

[Yankidank]

Reserved for future use.

Read this Wiki entry on installation and upgrading to better understand the process. Always read through all steps of the installation or upgrade before beginning and ensure that you have a proper database and file backup.

System requirements

* PHP version x.x or newer (developed and tested with: x.x.)
* MySQL version 4 or newer (developed and tested with: 9.0). Pligg 9.0 will not run with MySQL versions 3.x or lower.
* GD graphics library version x.x or newer (developed and tested with: x.x).
Pligg requires the GD graphics library to be available in PHP, e.g. to present a captcha during user registration. With most Linux distributions this requires the package php5-gd, php4-gd or similar to be installed.

New installation

1. Create a mysql database. Have your database name, username, password and hostname handy before installing Pligg. If you don't know the hostname, it's probably 'localhost'.
2. Rename settings.php.default to settings.php. Rename /libs/dbconnect.php.default to /libs/dbconnect.php. These files have a different name in the distribution to prevent you from overwriting your settings when you upgrade Pligg to a new release.
3. Upload the files to the web root directory on your server. We assume the owner of the files is the user id of your web server process (e.g. apache, httpd, www-data, ...).
4. Make sure the following directories are accessible and writable to the web server process (chmod 755):

* /templates
* /templates_c
* /backup
* /avatars/user_uploaded
5. Make sure the following files are accessible and writable to the web server process (chmod 644):

* settings.php
* /libs/dbconnect.php
* /libs/options.php
* config.php
6. Open www..com/install/ in your web browser.

Step 1: Make sure to read the entire page and click continue at the bottom when finished
Step 2: Fill out your database name, username, password, hostname, and your desired table prefix.
Step 3: Make sure there are no error messages!
7. Delete your /install folder.
8. Make /libs/dbconnect.php read-only (chmod 444)
9. Open www..com
10. Make sure to look at the very top of the page for any notifications. Use the god account. Login: god - Password: 12345 to make the changes needed.
11. Change god's password from 12345 to something different as soon as possible.
For instructions on a quick-and-easy Windows installation, suitable for playing with Pligg on your personal computer before moving to your hosting provider, see these instructions.

Upgrading an existing installation

You can upgrade from any version of Pligg to the current version.
1. Be sure to make a backup of your MySQL databases before upgrading to the newest version of Pligg. Some upgrades might require that you upgrade your MySQL database, so please keep backups available.
2. Make a backup copy of your entire site, especially config.php and settings.php (or config2.php for older versions) libs/lang.conf
3. Upload the new build over the current build. Make sure the above mentioned directories and files are writable to the web server process.
4. Open www.yoursite.com/install/upgrade.php in your browser.
5. Delete everything inside your templates_c directory.
6. Login to pligg, go into the admin panel, and set pligg to your liking.
Note: There is currently no way to import an existing config.php file. Any manual changes to settings.php will be overwritten the next time you use the admin panel, so use t to make your changes instead of manually.