# INSTALL GUIDE

1. Requirements
2. New installation

1. Install POSH on existing web site or application
2. Download and install files
3. First checks
4. Database configuration
5. Preferences
6. Choose the first modules of your application
7. Create the admin account

3. Define your application skin
4. Define the pages of your application
5. Configure your application
6. Manage and build your modules
7. Manage users
8. Add your own functionalities
9. FckEditor security parameters

1. ## Requirements

   POSH installation requires :
   - a MySQL database (4.1 +)
   - PHP (4.1+)
   If an application is already installed on your MySQL database, you need to save that database first.
   You need to give write access to the web server on the following folders and the sub-folders and files of these folders :
   - cache/
   - includes/
   - modules/ and sub-folders
   - portal/selections/
   - styles/
   - styles/themes/
   - temp/
   If you are unsure how to do this, look at your web server documentation or our FAQ.

2. ## New installation

   1. ### Install POSH on existing web site or application

      If you install POSH on an existing database, it could impact its data. You need then to save this database before installing POSH.

   2. ### Download and install files

      Download the POSH files from http://www.portaneo.org
      Uncompress files on your web server (or on your computer and ftp them), and move them to the folder you want to install POSH.
      Start the installation by launching://www.<yourdomain>.com/<posh_path>/install/

   3. ### First checks

      Installer step 1 : POSH checks if the requirements mentioned above are met (software installed, access rigths).
      If all the requirement are met, you can continue installation by clicking on "continue >>>". Else, you will need to make correction on red cross items and refresh the page to check again.

   4. ### Database configuration

      Installer step 2 : Type the database connection parameters that will be used to create database and to make POSH work with this database (users and modules management, ...). Use the connection parameters provided by you hoster or create a new user with database creation, tables creation and data management access rigths.
      If the database already exists, save it first.
      If you want to replace previous POSH installation, check "Replace previous install".

   5. ### Preferences

      Installer step 3 : Set the main configuration parameters value :
      - Name of your application : Name of your web site or application.
      - Manage the users Groups : Do you need to manage users by groups?
      - POSH location : URL of POSH root on your server.
      - Users of your website or application may create modules : Allow users to create their own modules? If unchecked, only the administrators will be allowed to create modules.
      - URL of the RSS feed for the information bar : In personal portals you can publish information from a RSS feed. The RSS feed must be hosted on the same server. Type the relative path of the feed, from path/ folder. Leave blank to not use this option.

   6. ### Choose the first modules of your application

      Installer step 4 : Select the first modules you want to use on your application.
      You will be able to use the admin interface later to add and delete additional modules.

   7. ### Create the admin account

      Installer step 5 : Create the first administrator account for access to administation interface.
   To continue with options below, open the administration interface (either with the link displayed at the end of the installation, or by connecting to the administration interface by loging in with account created above).

3. ## Define your application skin

   Two options for changing the application skin :
   - Modify the file styles/main1.css
   - Use the other users skins available on http://www.portaneo.org. Download a .thm file on your computer. In the POSH adminstration interface, click on the "Configure" tab, then on the "Themes management" link. Add the downloaded skin and click on "upload". Select the skin added in the list and click on "Apply the new theme".

   Add the new images in the images/ folder. The "images/addtoapplication.gif" image can be modified.

   You can set several skins for you application. Create the styles/mainX.css file (X is the incremental number of the skin : 1,2,3,...,9), update the value of the "themeNb" parameter in the "adm_config" MySQL table with the skins number, then in the admin interface, submit the "general settings" ("configure" tab).

4. ## Define the pages of your application

   When a user open your application, one or several tabs are available. You can configure these tabs :
   - Click on the "pages" tabs and on "tabs management" link.
   - Click on "add a page" for a new tab, or on "modify this page" to modify a tab (page type, modules configuration, ...)
   - Type the tab title, and description of the linked page. "Mode" defines if the tab is available on the homepage (anonymous) and/or on the users personal pages (connected). "Type" defines if the page is a personalizable page (modules are configured on the bottom), an HTML page that will be displayed in an IFRAME html object, a javascript function that will be launched by clicking on the tab (this function could be added in a new plugins), or an external link to another web page. Save by clicking on "Save"
   - Sort the tabs by moving the blocs with their grey area on the left of them.
   - Once configured you can save the tab changes by clicking on the "Set Online !" button.

5. ## Configure your application

   In the admin interface, click on the "configure" tab and on the "general settings" link.
   Modify the parameters and submit.

6. ## Manage and build your modules

   You modify, sort and remove modules from "Modules" page.

   You build the modules with the tutorial. If the users are allowed to build their modules, this tutorial is available with the "add your module" link on their personal page. Else, you can access the tutorial from the "module" admin page (with "add module" link").

   New modules must be validated in the "Module" admin page ("modules to validate" link).

7. ## Manage the users

   You modify, sort and suppress users from the "users" admin page.

   You can also create new users or administrators from this page.

   To manage groups, you need to activate the option in the "general settings".

8. ## Add your own functionalities

   Please read the "DEVELOPER GUIDE" of the docs/en/ folder.

9. ## FckEditor security settings

   FCKEditor is a WYSIWYG (What You See Is What You Get) text editor under Opensource licences, used in Portaneo.
   For security matters, the "file upload" functionality is, by default, disabled in Portaneo.
   However, if you want to activate it, you need to edit the file /tools/fckeditor/editor/filemanager/connectors/php/config.php
   Set the value to "true" for the line "$Config['Enabled'] = false;"
   Attention:Make sure the file is only accessible for authenticated users (you could add session control, htaccess file...etc)