Project

General

Profile

README-NEW-INSTALL.txt

Version française du README-NEW-INSTALL de Community Builder - Scottux, 04 February 2011 01:10 PM

 
1
+-------------------------------------------------------------------------+
2
|                                                                         |
3
| Nouveau ReadMe d'instalation de Community Builder Suite, CB 1.3.1       |
4
| Ce fichier contient les instructions qu'il faudra suivre pour une       |
5
| première installation de CB.                                            |
6
|                                                                         |
7
| Copyright 2004-2010 Beat, MamboJoe/JoomlaJoe and CB team on             |
8
| joomlapolis.com.                                                        |
9
| License :                                                               |
10
| This component is released under the GNU/GPL version 2 License and      |
11
| parts under Community Builder Free License.                             |
12
| All copyright statements must be kept and derivate work must            |
13
| prominently acknowledge original work on web interface and on website   |
14
| where downloaded.                                                       |
15
|                                                                         |
16
|               Joomla/Mambo Community Builder 1.3.1 Stable               |
17
|          native for Joomla! 1.0.0 - 1.0.15, 1.5.3 - 1.5.22 and          |
18
|                        Mambo 4.5.0 - 4.6.5.                             |
19
|                                                                         |
20
|            Experimental support for Joomla 1.6 b15 or better            |
21
|              (since Joomla 1.6 is still work in progress)               |
22
+-------------------------------------------------------------------------+
23

    
24
IMPORTANT - CB 1.3.1 doit être installé sous PHP version 5.0 minimum
25
(PHP 5.2+ recommandé). CB 1.3.1 **ne fonctionnera pas** s'il est 
26
installé sous PHP 4.0. 
27
MYSQL 4.0 minimum requis (MYSQL 5.0+ recommandé).
28

    
29
IMPORTANT - CB 1.3.1 ne fonctionnera peut être pas correctement sous 
30
les versions beta de Joomla 1.6 beta qui doivent être considérées comme
31
des versions aux fins de tests et en cours de développement. S'il vous 
32
plaît, visitez le forum **Joomlapolis** pour suivre les progrès des 
33
compatibilités entre Joomla 1.6 et CB.
34
Une liste de questions liées à l'utilisation de Joomla 1.6 beta avec CB
35
est disponible à cette adresse : http://bit.ly/aVmRTd
36

    
37
IMPORTANT - Ce composant ne fonctionne pas avec d'autres modules de 
38
Login ou Hack. Il est recommandé de désinstaller toutes les 
39
modifications apportées dont les effets d'utilisation avec CB ne sont 
40
pas connus.
41

    
42
IMPORTANT - Comme pour toute installation: COMMENCER PAR UN BACKUP 
43
complet de votre site et de votre base de données.
44

    
45
SOMMAIRE POUR l'INSTALLATION
46
----------------
47
1)  Installer composant com_comprofiler (également appelé composant CB).
48
2)  Installer module mod_cblogin (également appelé CB Login module).
49
3)  Installer module mod_comprofilerModerator (également appelé Workflow
50
    module).
51
4)  Installer module mod_comprofilerOnline module (également appelé 
52
    CB Online module)
53
5)  Activer les modules CB Login, CB Workflows, et CB Online
54
6)  Sélectionner vos préférences (Style de nom, paramètres) dans le 
55
    gestionnaire de configuration de Community Builder et enregistrer
56
    vos modifications.
57
    Lancer l'outil de synchronisation des utilisateurs de Community 
58
    Builder.
59
7)  Désactiver le module de login Joomla
60
8)  Ajouter un nouveau lien de menu (Niveau accès = public) vers le 
61
    composant Community Builder
62
9)  Ajouter un nouveau lien de menu vers la liste des utilisateurs
63
10) Dans Outils CB,lancer le chargement des données exemples (optionnel)
64
11) Ajuster vos paramètres Community Builder et Joomla pour autoriser 
65
    les inscriptions uniquement par Community Builder
66
12) C'est fini !
67

    
68
Vous pouvez aussi lire le document CB1.3.1_Installation.pdf inclus dans
69
le package de distribution de CB ou envisager de supporter l'équipe CB 
70
en souscrivant un abonnement à la documentation CB :
71
http://www.joomlapolis.com/content/view/2542/37/
72

    
73

    
74
INSTRUCTIONS DETAILLEES
75
---------------------
76

    
77
1)  Installer le composant com_comprofiler.zip (Voir note ci-dessous).
78
    NOTE: S'il vous plaît, soyez patient. Le fichier comprofiler.zip 
79
    est lourd (1.7 MB) et prend un certain temps pour se charger et
80
    s'installer (parfois plus de de 5 minutes sur de gros sites !).
81
    L'installation de CB sera faite automatiquement en 2 pages (2 étapes
82
    d'installation), qui se lanceront automatiquement.
83
    S'il vous plaît, patientez jusqu'à obtenir le message en vert vous
84
    indiquant que l'installation est finie.
85
    En cas de problème, voir la section dépannage plus bas dans ce 
86
    fichier.
87

    
88
    NOTE: Dans Joomla 1.5, à partir de la version CB 1.2 RC, le mode 
89
    Legacy de Joomla n'est plus nécessaire. Ce mode n'interfère pas le 
90
    fonctionnement des versions natives de CB 1.3 et plus, mais ne doit
91
    pas être activé pour leur installation. 
92
    Pour l'utilisation de certains plugins et de la majorité de ceux de
93
    la génération de CB 1.1, le mode Legacy doit être activé.
94

    
95
    NOTE: PHP Safe mode soit être sur Off pour l'installation du 
96
    composant et des plugins dans Joomla! 1.0.x et Mambo.
97

    
98
    NOTE: Mambo 4.6.0-4.6.5 ne gère pas correctement les multiples xml,
99
    aussi :  
100
    a) Vous devez premièrement dézipper com_comprofiler.zip, supprimer
101
    les fichiers se terminant par j.xml et g.xml et rezipper avant
102
    installation sur ces versions Mambo.
103
    b) Pour chaque module utilisé ci-dessous, vous devez dézipper le
104
    package, remplacer le fichier XML qui est à l'intérieur du dossier 
105
    par celui qui est à l'extérieur, puis rezipper le dossier de 
106
    fichiers pour Mambo 4.6.
107

    
108
    IMPORTANT: Si l'installation échoue, regardez la section "En cas
109
    d'échec de l'installation" plus bas.
110

    
111
2)  Installer le module mod_cblogin.zip.
112

    
113
    IMPORTANT: Si vous utilisez le module de Login du noyau de Joomla ou
114
    Mambo, la synchronisation des utilisateurs Joomla/CB sera décalée.
115

    
116
    NOTE: Aller dans Joomla/Mambo Panneau Administration->Composants
117
    ->Community Builder->Outils
118
    et lancer l'outil de synchronisation des utilisateurs pour ajuster
119
    votre base utilisateurs si nécessaire.
120

    
121
3) Installer le module mod_comprofilerModerator.zip.
122
   Ce module est aussi connu sous le nom de CB Workflows et est utilisé
123
   pour gérer en Frontend les actions de modération.
124
   (Module Optionnel utile seulement si vous utilisez les fonctions
125
   relatives aux modérateurs).
126

    
127
4) Installer le module mod_comprofilerOnline.zip
128
   Ce module est aussi connu sous le nom de CB Online et est utilisé
129
   pour afficher une liste des utilisateurs connectés avec un lien 
130
   menant sur les pages des profils de ceux-ci.
131
   (Module Optionnel affichant une liste des utilisateurs connectés).
132

    
133
5) Activer le module de Login de CB (CB Login) et les autres modules de
134
   CB par le biais du panneau d'aministration (Extensions->Gestion des 
135
   modules, puis activer les modules ou cliquer sur leurs noms pour les
136
   éditer et ajuster leurs paramètres).
137

    
138
6) Aller dans Joomla/Mambo Administration :
139
   ->Composants->Community Builder->Configuration 
140
   et choisir le type de nom d'utilisateur (Choix mode Nom/Prénom) 
141
   correspondant à la façon selon laquelle vous voulez traitez les 
142
   utilisateurs existants pendant la synchronisation dans la prochaine 
143
   étape. 
144
   Assurez vous de bien cliquer sur "Sauver" pour sauvegarder votre 
145
   configuration.
146
   
147
6b)Aller dans Joomla/Mambo Administration :
148
   ->Composants->Community Builder->Tools
149
   et utiliser  l'outil "Synchroniser les utilisateurs" CB avec Joomla
150
   ou Mambo.
151

    
152
7) Désactiver le module de Login standart de Joomla/Mambo. Pour le 
153
   faire, aller dans le panneau d'administration (Backend), puis:
154
   - Dans Mambo/joomla 1.0 aller à modules->modules site puis cliquer 
155
     sur la coche verte activée du mod _login afin qu'elle passe au 
156
     rouge.
157
   - Dans Joomla 1.5 aller dans Extensions->gestion des modules puis 
158
     cliquer sur la coche verte activée du mod_login afin qu'elle 
159
     passe au rouge.
160

    
161
8) Ajouter un nouveau lien de menu dans le "Menu Utilisateur" pour
162
   Community Builder:
163
   (Ce sera un lien vers la page du profil de l'utilisateur).
164
   Pour cela, aller dans "Menus" -> "Menu Utilisateur", cliquer sur 
165
   Nouveau, puis:
166
   - Dans Mambo/joomla 1.0 sélectionner "composant", "Community Builder 
167
     (comprofiler)", niveau d'accès Public pour ce lien, donner lui un
168
     nom, puis Sauver ce nouveau menu.
169
   - Dans Joomla 1.5 cliquer sur Lien interne "Community Builder", 
170
     puis "User Profile", laisser un niveau d'accès Public pour ce lien
171
     de menu, donner lui un titre et un alias, puis Sauver ce nouveau 
172
     lien de menu.
173
   NOTE: Ce n'est pas une question de sécurité, CB contrôle l'accès. 
174
         Si vous ne voulez pas que ce lien de menu apparaisse
175
         publiquement, vous pouvez le placer dans le menu utilisateur
176
         comme expliqué ci-dessus ou dans un autre menu dont le module 
177
         aura comme niveau minimum d'accès celui de "Enregistré".
178

    
179
9) Ajouter un lien de menu vers une liste:
180
   (Ce sera un lien vers la recherche dans la liste d'utilisateurs).
181
   Pour cela, aller dans "Menus" -> "Menu Utilisateur"(Pour listes
182
   non-publiques) ou "Menus" -> "Menu Principal"(pour listes publiques),
183
   cliquer sur Nouveau, puis:
184
   - Dans Mambo/Joomla 1.0 sélectionner Lien-URL / Externe-URL et faites
185
   la pointer vers index.php?option=com_comprofiler&task=usersList 
186
     (pas 'http://domaine' nom) et Sauver.
187
   - Dans Joomla 1.5 cliquer sur Lien interne "Community Builder", 
188
     puis "Users lists", laisser les paramètres par défaut, puis Sauver.
189
    NOTE: Si vous souhaitez que la liste soit publiquement accessible, 
190
    donnez lui le niveau d'accès Public (ainsi que celui de l'étape 8).
191
    NOTE: Si ce menu est le premier du Menu Principal, il sera la page
192
     d'accueil de votre site.
193

    
194
10) Aller dans Joomla/Mambo Administration:
195
    ->Composants->Community Builder->Tools
196
    Et lancer l'outil "Charger les données exemples" pour pré-remplir
197
    les champs standarts d'une liste utilisateur (adresse, téléphone,
198
    etc), et aussi créer une liste par défaut des utilisateurs.
199
    NOTE: Pour éditer cette liste par défaut des utilisateurs/ajouter 
200
    d'autres listes utilisateurs, aller dans: 
201
    Joomla/Mambo Administration :
202
    ->Components->Community Builder->Listes
203
      et changer/ajouter liste(s) avec le niveau d'accès souhaité.
204
      Assurez vous qu'elles sont bien publiées.
205

    
206
11) Si vous voulez autoriser les inscriptions seulement par le biais 
207
    de Community Builder (recommandé):
208
    - dans Administration:
209
    ->Composants->Community Builder->Configuration->Inscription:
210
      Dans l'option "Permettre l'enregistrement des utilisateurs",
211
      choisir "oui, indépendamment du paramètre global du site"
212
    - dans Administration:
213
    ->Site->Configuration générale->Site (Joomla 1.0/Mambo) 
214
      ou 
215
      Site->Configuration générale->Système (Joomla1.5):
216
      Dans l'option "Autoriser l'enregistrement des utilisateurs", 
217
      choisir "Non".
218

    
219
12) C'est fini !
220
    Depuis CB 1.2, la ré-optimisation des chemins de connexion autorise
221
    maintenant la mise en mode "On" dans la configuration de CB.
222
    
223
S'il vous plaît, vous pouvez soutenir l'équipe de développement de CB
224
en souscrivant un abonnement à la documentation CB :
225
http://www.joomlapolis.com/content/view/2542/37/
226

    
227
=====================================================================
228
Section DEPANNAGE
229

    
230
EN CAS D ECHEC DE L'INSTALLATION DU COMPOSANT:
231
- Ecran blanc: Vérifier les erreurs logs dans votre serveur web, ou
232
  activer les erreurs PHP.
233
  Ou essayer les deux corrections ci-dessous à l'aveuglette.
234

    
235
- Erreur Délai d'éxécution maximal atteint:
236
   Sur les serveurs très lents, SI les délais d'attente d'installation
237
   sont dépassés (Pas encore vu): vous pouvez résoudre ce problème 
238
   comme suit: Ouvrez le fichier:
239
   - joomla 1.0/mambo: administrator/index2.php
240
   - joomla 1.5: administrator/index.php
241
   et ajouter la ligne
242
   set_time_limit( 240 );
243
   juste après la ligne <? , supprimer les répertoires: 
244
   components/com_comprofiler
245
   et 
246
   administrator/components/com_comprofiler et réinstaller.
247

    
248
- Erreur Mémoire épuisée (parfois Erreur 500):
249
   Joomla 1.5 avec le mode legacy sur ON et la couche FTP sur ON sous
250
   PHP 4.x peut donner une erreur
251
   Mémoire épuisée si sa limite est de 8 Méga-octets. Dans ce cas, 
252
   simplement passer le mode legacy sur OFF uniquement pour 
253
   l'installation de CB 1.3.1 , puis revenir sur ON si nécessaire. 
254
   Ou ajouter la ligne (de la même façon que ci-dessus):
255
   ini_set( 'memory_limit', '16M' ); @ini_set( 'memory_limit', '32M' );
256

    
257
- Si l'installation du composant échoue à l'étape 2, ne paniquez pas ! :
258

    
259
  Tout accès à Community Builder par l'administration est sécurisé.
260

    
261
  Dans toutes les tâches de Backend, il y a un test pour savoir si 
262
  l'étape 1 s'est correctement achevée ou non.
263

    
264
  - Si vous ne voyez pas les messages d'avertissements dans le haut de 
265
  la fenêtre, et installation terminée avec succès.
266

    
267
  - Si vous voyez un avertissement du genre:
268

    
269
    "Warning: file 'components/com_comprofiler/pluginsfiles.tgz' still 
270
    exists.
271
    Cela est probablement dû au fait que la première étape de 
272
    l'installation n'a pas été complète, ou que la deuxième n'a pas eu
273
    lieu. Si vous êtes certain que la première installation s'est
274
    correctement déroulée, vous devez exécuter la deuxième étape avant 
275
    d'utiliser CB. Vous pouvez le faire en cliquant sur le lien:
276
    "(please click here to continue)."
277

    
278
    Ensuite, il ne vous reste plus qu'à cliquer sur le lien pour 
279
    terminer la seconde étape. 
280
    Cette étape décompresse simplement ce fichier 'pluginsfiles.tgz' au
281
    même endroit, puis supprime le fichier. La deuxième étape peut être
282
    effectuée à nouveau en toute sécurité.
283

    
284
  Si ça ne fonctionne toujours pas, ceci est probablement lié à un
285
  problème de permissions dans le dossier 'components/com_comprofiler',
286
  qui n'autorise pas l'écriture au serveur web (ou des autorisations
287
  non-actives pour l'installation de Joomla 1.5 par ftp).
288

    
289
  Vous pouvez résoudre ce problème en modifiant les permissions dans
290
  ce dossier et tenter à nouveau l'étape 2.
291

    
292
  En dernier recours, vous pouvez décompresser pluginsfiles.tgz, et 
293
  renommer le dossier extrait 'pluginsfiles' en 'plugin' au même endroit.
294
  Vous devez vous assurer que le dossier plugin et ses sous-dossiers
295
  (user, templates, language) sont aussi inscriptibles, sinon vous ne
296
  serez pas en mesure d'installer des plugins CB ultérieurement.
297

    
298

    
299
DESINSTALLATION DE CB
300

    
301
pour désinstaller CB, il suffit de désinstaller le composant et ses 
302
modules avec votre CMS.
303
Les données utilisateurs seront conservées dans les tables MySQL qui
304
commencent par le prefix jos_comprofiler.
305
La configuration principale de CB est supprimée lors de la 
306
désinstallation du composant car elle est stockée dans le fichier 
307
administrator/components/com_comprofiler/ue_config.php
308
Les configurations des modules CB sont supprimées lors de la 
309
désinstallation par le CMS. 
310
Les plugins cb, tables et champs de configurations, ainsi que les 
311
données utilisateurs sont conservées pour une réinstallation (Voir le
312
fichier READ-ME-UPGRADE.txt pour plus détails sur la mise à jour ou la
313
réinstallation)
314
Pour supprimer tous les enregistrements de la base de données, 
315
supprimer les tables commençant par jos_comprofiler avec un outil pour
316
MySQL comme par exemple phpMyAdmin.
317

    
318
-----------------------------------------------------------------------
319

    
320
PROBLEMES CONNUS:
321

    
322
- avec Joomla 1.6 beta 14, il y a un problème (bug venant de Joomla 1.6)
323
  dans la sélection des menus internes. Les élements de menu Community
324
  Builder s'affichent dans Joomla 1.6 cependant la sélection de ceux-ci
325
  ne se fait pas correctement.
326
  Pour contourner le problème (tant qu'il n'est pas réglé dans une 
327
  nouvelle version beta ou RC de Joomla 1.6 new beta or RC), il faut
328
  créer un lien de type externe en appliquant des urls:
329
  + lien à utiliser pour User Profile (Mandatory):
330
    index.php?option=com_comprofiler
331
  + lien à utiliser pour Users lists:
332
    index.php?option=com_comprofiler&task=userslist
333
  + lien à utiliser pour User profile edit:
334
    index.php?option=com_comprofiler&task=userdetails
335
  + lien à utiliser pour Username/Password reminder:
336
    index.php?option=com_comprofiler&task=lostpassword
337
  + lien à utiliser pour Registration page:
338
    index.php?option=com_comprofiler&task=registers
339
  + lien à utiliser pour Login page:
340
    index.php?option=com_comprofiler&task=login
341
  + lien à utiliser pour Logout action:
342
    index.php?option=com_comprofiler&task=logout
343

    
344
- Suivez les dernières évolutions sur le forum www.joomlapolis.com.
345

    
346
NOTE: Dans le gestionnaire de configuration de Community Builder, il est
347
inclus un vérificateur de votre version actuelle de CB et de la dernière
348
version disponible. Cette requête ne collecte aucune information
349
privée. Les seules informations récupérées par cette requête http 
350
standart sont le numéro de version et l'adresse du site. Si vous n'avez
351
pas accès à internet, après un délai de 20 à 90 secondes, un message 
352
d'erreur sera affiché à la place de la dernière version disponible.
353
Vous pouvez désactiver la vérification automatique de version en vous
354
rendant dans l'onglet Intégration et en choisissant "Vérification 
355
manuelle" (Non-recommmandé).
356

    
357
POUR LA DOCUMENTATION, LE SUPPORT ET LES DERNIERES NEWS, VISITEZ: 
358
http://www.joomlapolis.com 
359

    
360
POUR RAPPORTER UN BUG OU DEMANDER UNE FONCTIONNALITE, VISITEZ: 
361
http://www.joomlapolis.com/
362
et consultez la catégorie de forum dédiée à la version CB 1.3.1.
363

    
364
LICENCE:
365
CB est enregistré sous licence GNU/GPL version comme un tout, certaines
366
parties qui le compose sont sujets à d'autres licences pour lesquelles
367
l'équipe CB dispose des droits d'utilisation pour CB.
368

    
369
MARQUE:
370
CB est une marque(nom) déposé par ses auteurs sur www.joomlapolis.com
371
Nous vous serions gré d'utiliser le Nom "CB" pour faire référence au 
372
logiciel ou manuels, et de dire explicitement que vous ne participez en
373
aucune manière au projet CB, que vous ne le représentez pas et de ne 
374
pas associer la marque ou logo à vos propres marques. Si vous avez des
375
questions concernant l'utilisation de notre nom, merci de nous contacter
376
en utilisant le formulaire de contact sur www.joomlapolis.com"
377

    
378