# GUIDE D'INSTALLATION

1. Pré-requis
2. Nouvelle installation

1. Installer POSH sur une application ou un site internet existant
2. Téléchargez et installez les fichiers
3. Vérifications préliminaires à l'installation
4. Installation de la base de données
5. Configuration primaire
6. Choix des premiers modules
7. Création du compte administrateur

3. Définir votre thème graphique
4. Définir les pages de votre application
5. Configurer votre application
6. Définir vos modules
7. Gérer les utilisateurs
8. Créer vos propres fonctionnalités
9. Paramètres de sécurité de FckEditor

1. ## Pré-requis

   L'installation de POSH requière les éléments suivants:
   - Une base de données MySQL (4.1 +)
   - PHP (4.1+)
   Si une application est déjà installée sur la base de données MySQL, il est important de sauvegarder cette base de données.
   Vous devez donner les droits d'écriture à votre serveur web sur les répertoires suivants, ainsi qu'aux fichiers qu'ils contiennent :
   - cache/
   - includes/
   - modules/ et ses sous répertoires
   - portal/selections/
   - styles/
   - styles/themes/
   - temp/
   Pour cela, référez-vous à la documentation de votre serveur web ou à notre FAQ.

2. ## Nouvelle installation

   1. ### Installer POSH sur une application ou un site internet existant

      Si vous installez POSH sur une base de données existante, il n'est pas exclu qu'il y ait des impacts sur les tables déjà existantes. Il est donc important de sauvegarder cette base de données avant d'installer POSH.

   2. ### Téléchargez et installez les fichiers

      Téléchargez les fichiers POSH à partir de http://www.portaneo.org
      Décompressez les fichiers sur votre serveur web (ou sur votre ordinateur et envoyez les par ftp sur votre serveur), et placez les dans le répertoire où vous voulez installer POSH.
      Commencez l'installation en lançant http://www.<votrenomdedomaine>.com/<chemin_d_installation_de_posh>/install/

   3. ### Vérifications préliminaires à l'installation

      Etape 1 de l'installateur : POSH vérifie si les pré-requis cités plus haut sont respectés (composants logiciels installés, accès sur les répertoires).
      Si tous les critères sont respectés, vous pouvez continuer l'installation en cliquant sur "suite >>>". Sinon, il vous faudra résoudre les problèmes soulevés (croix rouges) et rafraîchir la page pour continuer.

   4. ### Installation de la base de données

      Etape 2 de l'installateur : Entrez les paramètres de connexion à la base de données qui seront utilisés pour installer les tables et pour faire fonctionner POSH (gestion des utilisateurs, des modules, ...). Utilisez les informations fournies par votre hébergeur ou créez un nouvel utilisateur avec les droits de création de bases et de tables et de gestion des données MySQL.
      Si la base de données existe déjà, sauvegardez là auparavant.
      Si vous avez déjà installé POSH et que vous voulez écraser l'installation précédente, cochez "Remplacer l'installation précédente".

   5. ### Configuration primaire

      Etape 3 de l'installateur : Entrez les premiers éléments de configuration de l'application:
      - Nom de l'application : Nom de votre site internet ou de votre application.
      - Gérer des groupes d'utilisateurs : Voulez-vous regrouper les utilisateurs de votre site sous des groupes que vous définirez.
      - Emplacement de Portaneo : URL de la racine de POSH sur votre serveur.
      - Les utilisateurs de votre site peuvent créer des modules : Permettez-vous aux utilisateurs de votre site de créer des modules ? Si décoché, seuls les administrateurs pourront créer des modules.
      - URL du flux RSS de la barre d'information : Dans les portails personnels, vous pouvez faire défiler les éléments d'un flux RSS. Pour cela, le flux RSS doit être hébergé sur votre serveur. Dans ce cas là, indiquez le chemin relatif du flux à partir du répertoire portal/. Le laisser vide si vous ne voulez utiliser cette option.

   6. ### Choix des premiers modules

      Etape 4 de l'installateur : Sélectionnez les premiers modules qui seront proposés aux utilisateurs de votre application.
      Vous pourrez ensuite, via l'interface d'administration, les supprimer, les déplacer dans votre hiérarchie de modules, en créer de nouveaux ...

   7. ### Création du compte administrateur

      Etape 5 de l'installateur : Création du premier compte administrateur qui vous permettra d'accéder à l'interface d'administration de votre application.
   Pour continuer avec les options ci-dessous, ouvrez l'interface d'administration (soit via le lien de fin d'installation, soit en vous connectant avec le compte créé ci-dessus).

3. ## Définir votre thème graphique

   Deux solutions pour changer de thème graphique :
   - Soit vous modifiez le fichier styles/main1.css
   - Soit vous utilisez un thème disponible sur http://www.portaneo.org : téléchargez le .thm sur votre ordinateur. Dans l'interface d'administration de POSH, cliquez sur l'onglet "configuration", puis sur "Gestion des thèmes graphiques". Ajoutez le thème graphique téléchargé, et cliquez sur "télécharger". Sélectionnez le thème ajouté dans la liste déroulante et cliquez sur "appliquer le nouveau thème".
   Ajoutez les images utilisées dans le répertoire images/. L'image "images/addtoapplication.gif" peut également être modifiée.
   Vous pouvez proposer plusieurs thèmes à vos utilisateurs. Pour cela, créez les fichiers styles/mainX.css (ou X représente le numéro d'ordre du thème : 1,2,3,...,9), modifier la valeur du paramètre "themeNb" de la table MySQL "adm_config" avec le nombre de thèmes proposés puis dans l'interface d'administration, validez la "configuration générale de l'application" (onglet "configuration").

4. ## Définir les pages de votre application

   A l'ouverture de votre application par un utilisateur, plusieurs onglets sont disponibles. Voici la marche à suivre pour configurer ces onglets :
   - Cliquez sur l'onglet "pages", puis sur "Gestion des onglets".
   - Cliquez sur "ajouter une page" pour un nouvel onglet, ou sur "modifier cette page" pour modifier l'onglet concernée (type de page, configuration des modules, ...)
   - Entrez le titre de l'onglet, la description de la page liée. Le "mode" indique si cette page sera disponible sur la page d'accueil (anonyme) et/ou sur les portails personnels des utilisateurs (connecté). Le "type" indique si la page est un portail personnalisable (les modules sont configurés dans la partie inférieure), une page HTML dont vous indiquez l'URL et qui sera affichée dans une frame, une fonction javascript qui sera lancée en cliquant sur l'onglet (Cette fonction pourrait être gérée dans un plugins), ou une redirection vers une autre page web. Validez en cliquant sur "enregistrer".
   - Classez vos onglets en déplaçant les blocs au moyen de la surface grisée à gauche de chaque bloc.
   - Une fois les pages configurées, validez les modifications en cliquant sur le bouton "Mettre en ligne !".

5. ## Configurer votre application

   Dans l'interface d'administration, cliquez sur l'onglet "configuration" puis sur "configuration générale de l'application".
   Modifiez ensuite les paramètres désirés et validez.

6. ## Définir vos modules

   Vous modifiez, classez et supprimez les modules via la page "Modules".
   Vous créez vos modules via le tutoriel. Si les utilisateurs sont autorisés à créer des modules, ce tutoriel est disponible dans son portail personnel (via le lien "ajouter un module"). Sinon, vous pouvez y accéder via le lien "ajouter un module" dans la page "Module".
   Un module créé devra être validé dans la page "Module".

7. ## Gérer les utilisateurs

   Vous modifiez, classez et supprimez les utilisateurs via la page "Utilisateurs".
   Vous pouvez également créer des utilisateurs et administrateurs via cette interface.
   Pour gérer les utilisateurs via des groupes, vous devez activer l'option dans la "configuration générale".

8. ## Créer vos propres fonctionnalités

   Référez-vous au "GUIDE DU DEVELOPPEUR" disponible dans le répertoire docs/fr/.

9. ## Paramètres de sécurité de FckEditor

   FCKEditor est un éditeur de texte WYSIWYG (What You See Is What You Get) Opensource utilisé dans Portaneo.
   Pour des raisons de sécurité, la fonctionnalité d'upload de contenu est par défaut désactivée dans Portaneo.
   Si toutefois vous désirez l'activer, il vous faut éditer le fichier /tools/fckeditor/editor/filemanager/connectors/php/config.php
   Passer la valeur à "true" pour la ligne "$Config['Enabled'] = false;"
   Attention: Il est important de s'assurer que seul les utilisateurs authentifiés peuvent accéder à ce fichier (contrôle de session,fichier htaccess...etc)