FrameBeurk documentation

Vous devez disposer d’un serveur http avec un module PHP 5 actif et d’un serveur mysql, par exemple chez un hébergeur, ou en local sur votre ordinateur (comme avec WAMP sur Windows et LAMP sur Linux).

Si vous utilisez WAMP, pour ne pas que le serveur mysql passe les noms de tables en minuscule lors de leur création, éditez le fichier my.ini, positionnez le paramètre « lower_case_table_names=2 », sauvez le fichier et faite un arrêt-relance du service.

Hypothèses : L’URI de votre site sous FrameBeurk sera « http://localhost:80/Fmbk/ » (pour un serveur local) et le nom de la database sera Fmbk.

• Créez dans le dossier /www un répertoire /Fmbk
• Décompressez le fichier .zip de FrameBeurk dedans.
• Sur le serveur mysql (interface phpmyadmin) :
• Créez la database Fmbk,
• Dans cette database, exécutez les scripts embarqués dans les dossiers « /modules/*/_sql/*.sql » en commençant par le module Beurk, puis Uzers.
• Editez le fichier /modules/bootstrap.php et modifiez si besoin :
• L’interface DB choisie (mysql_layer.php ou mysqli_layer.php)
• $TRANSAC['Db'][‘Fmbk’] : Les paramètres de connexion à la DB.
• Editez le fichier /modules/config.php et modifiez le contenu des éléments de $CONFIG['Params'] :
• 'DomaineUrl' et 'UrlSite' : Selon votre installation
• Remplacez les « Xxx Xxxx » du fichier par votre nom ou votre pseudo
• 'DomaineMail' : Doit correspondre au domaine du serveur d’email sortant paramétré sur votre serveur.

Attention : Par défaut, WAMP/LAMP utilise le port 80, qui est aussi utilisé par Skype. Si vous souhaitez utiliser les 2, basculez Apache sur le port 8080 et modifiez le fichier de configuration du framework en conséquence.

8.1. Premiers pas

L’installation du logiciel étant achevée, les serveurs mysql et http lancés, ouvrez un navigateur et connectez-vous à votre site. A ce moment, pour avoir un premier aperçu du fonctionnement du framework du point de vue de l'utilisateur, vous voudrez certainement :

8.1.1 Vous loguer en tant qu’Administrateur

(user=admin, mot de passe= admin)

• En haut du menu latéral, saisissez user, mot de passe et cliquez sur Connexion.
• Il est recommandé de changer le mot-de-passe par défaut.

8.1.2 Vous créer un compte personnel

2 cas :

1. Si vous êtes logués avec des droits administrateurs :
• Dans le menu latéral, cliquez sur « Utilisateurs »
• La liste des utilisateurs s’affiche. Elle ne devrait alors contenir qu’admin et anonymous.
• En bas à droite de la liste, cliquez sur « Créer un utilisateur… »
2. Si vous n’êtes pas logués :
• Dans le menu latéral en haut, cliquez sur « S’inscrire »

Soyez vigilant lors de la saisie de votre compte. Mémorisez votre mot de passe et ne vous trompez pas dans votre adresse e-mail, car un message va vous y être envoyé.

Vous ne pourrez vous loguer sur le compte que vous venez de créer qu’après avoir cliqué sur le lien d’activation contenu dans l’e-mail qui a été envoyé.

8.1.3 Attribuer les droits administrateurs à votre compte

• Loguez-vous avec le user admin
• Affichez la liste des Utilisateurs, cliquez sur votre user
• La liste des groupes associée apparait vide. Cliquez sur « Associer à un groupe… »
• Sélectionner le groupe « ADMIN » et cliquez sur « Envoyer ».

Pour vérification, déconnectez-vous et reconnectez-vous avec votre user personnel. Les choix « Utilisateurs », « Groupes », « Permissions », « Modération » doivent apparaître dans le menu latéral.

8.1.4 Ajouter un message de bienvenue dans les News

Nécessite d’être logué avec les droits administrateur.

• Dans le menu latéral, cliquez sur « News »
• La liste de news apparaît vide. Cliquez sur « Ajouter un commentaire… »
• Un formulaire de saisie apparaît dans lequelle vous pouvez saisir votre message
• Vous pouvez insérer des BBcodes dans la textBox « Données » : Sélectionner le texte à enjoliver, puis sélectionner l’option désirée dans les listes déroulantes juste au-dessus
• Le bouton « Prévisualiser » permet de voir comment s’affichera votre saisie, sans la valider.

8.1.5 Créer une section dans le forum

• Dans le menu latéral, cliquez sur « Forum »
• La liste des sections apparaît vide. Cliquez sur « Créer une section… »
• Saisissez les informations souhaitées dans le formulaire de saisie qui apparaît.

Lorsque vous avez créé plusieurs sections, vous pouvez gérer leur ordre d’affichage en cliquant sur les boutons « Monter » et « Descendre » de chaque section.

8.1.6 Remarques sur le champ « Import »

• Celui-ci apparaît sur les formulaires de création ou modification des sections, sujets et commentaires, lorsque l’utilisateur connecté est administrateur (c’est-à-dire membre du groupe « ADMIN »)
• Il permet de saisir le chemin d’un fichier .php présent sur le serveur –chemin relatif au dossier /imports/ du répertoire d’installation.
• Ce fichier sera inclus à l’affichage des vues de détail de l’entité à laquelle il est associé, (pas dans les vues où l’entité apparaît dans une liste).

La saisie n’est possible que pour un administrateur, mais l’affichage sera fait pour tous.