# Pligg Content Management System

## Version 1.0.3

## Installation

Requirements: Pligg requires a modern version of PHP and MySQL and some PHP functions. To test if your server is capable of running Pligg please view the Troubleshooter. If any elements appear in red on that page you may have a problem with either installing or running Pligg.

1. Create a mysql database. If you are unfamiliar with how to create a mysql database, please contact your web host or search their support site. Please pay careful attention when creating a database and write down your database name, username, password, and host somewhere.
2. Rename the /language/lang_english.conf.default file to lang_english.conf. Same instructions apply to any other language file that you might use that are located in the /languages directory.
3. Rename the file settings.php.default to settings.php
4. Rename the /languages/lang_english.conf.default file to lang_english.conf
5. Rename the /libs/dbconnect.php.default file to dbconnect.php
6. Upload the files to your server.
7. CHMOD 755 the following folders, if they give you errors try 777.
   - /admin/backup/
   - /avatars/groups_uploaded/
   - /avatars/user_uploaded/
   - /cache/
   - /cache/admin_c/
   - /cache/templates_c/
   - /languages/ (And all of the files contained in this folder should be CHMOD 777)
8. CHMOD 666 the following files
   - /libs/dbconnect.php
   - settings.php
9. Open /install/index.php in your web browser. If you are reading this document after you uploaded it to your server, click on the install link at the top of the page.
   - Select a language from the list.
   - Fill out your database name, username, password, host, and your desired table prefix.
   - Create an admin account. Please write down the login credentials for future reference.
   - Make sure there are no error messages!
10. Delete your /install folder.
11. CHMOD 644 libs/dbconnect.php
12. Open /index.php
13. Log in to the admin account using the credentials generated during the install process.
14. Log in to the admin panel ( /admin ) and you will then be presented with information intruducing you to Pligg.
15. Configure your Pligg site to your liking. Don't forget to use the Modify Language page to change your site's name.

## Backup

1. Log into your site as admin
2. Click on admin panel link
3. Click on File and MySQL backup link
4. Backup your files (and avatars) and your database
5. Download the backup .zip files to your computer
6. Delete the files from the backup manager

## Upgrading

`Please be sure to make a backup of your MySQL databases and files before upgrading to the latest version of Pligg. Some upgrades might require that you upgrade your MySQL database, so please make backups whenever upgrading.
These instructions do not support upgrading your template. Template upgrades require manual changes and should be carefully handled by the template author.`

1. Backup your mysql database
2. Backup your old pligg files
3. Rename your template folder from any default names that might cause the data to be overwritten. For example if you have a custom template still in the "wistie" directory it will be overwritten when upgrading.
4. Disable all of the modules from your admin panel.
   You will need to re-enable them after upgrade.
5. Delete all of the files from your server EXCEPT:
   1. /avatars/ (entire directory)
   2. /libs/dbconnect.php
   3. /.htaccess
   4. /favicon.ico
   5. /settings.php
6. Upload all of the 1.0 files to your server.
   If you are able to I suggest uploading a zip file to the server and extracting it server-side.
   This is both the fastest and most full-proof method.
7. Confirm that the CHMOD permissions for the following files or folders are all set to 777.
   - settings.php
   - /admin/backup/
   - /avatars/groups_uploaded/
   - /avatars/user_uploaded/
   - /cache/
   - /cache/admin_c/
   - /cache/templates_c/
   - /languages/
   - /languages/lang_english.conf
8. Run the upgrade from /install/upgrade.php
   If there are no error messages, delete the /install directory from your web server.
9. Log in as a "god" level user.
   In some cases you may already be logged in from your previous version of Pligg.
10. Either update your template to work with the latest version or navigate to /admin/admin_config.php?page=Template and change the template name to "wistie"
11. Re-activate the disabled modules from step 4, navigate to /admin/admin_modules.php

## Support

Pligg is an Open source project, but that doesn't stop us from having a rock-solid support team. Pliggers from all across the world are watching the forum 24 hours a day helping each other out. If you have any questions, ideas, modifications or bugs to discuss please let us know through the Pligg forum.

Creating a forum account is also important because it allows you to download additional free templates and modules from Pligg.com. Not only can you download free files, but you can keep track of updates for your modules and templates by marking them as "installed". You will then be notified automatically when a developer updates any of your installed files.

Another form of support is found under the Pligg Admin panel. If you have installed the Admin Help English module you will see little blue question mark icons on several admin panel pages near the top right of the page. By clicking on this icon you should be presented with details that will help you understand the page that you are on, along with definitions for words used frequently throughout Pligg.

## Credits

This code was originally written by Ricardo Galli for the open source project known as Meneame.

Many thanks to those who donated time and money to the Pligg project. Without their support we wouldn't be able to keep this project alive. If you are interested in becoming a part of the development team please contact us through the forum.

A special thank you to all of the Pligg developers and translators.

## License

Pligg's source code is published under the Affero General Public License. You can view the license in the file LICENSE.txt and in the default "About" page that is included when you install Pligg.

## Questions / Comments?

Support questions should be posted as a thread on the Pligg Forum

Please report security flaws to the Security Issue Contact Form on pligg.com.

If you would like to translate Pligg to another language you can apply to do so here, and please join the Translate Pligg Group on Google Groups.

### Help!

For support and additional free downloads to enhance your Pligg install please visit Pligg.com and the Pligg Forum.