Passez votre souris ici pour dГ©rouler
IntГ©gration du script avec une autre application (passerelle)
Ce que fait l'intГ©gration
Coppermine peut ГЄtre intГ©grГ© Г d'autres applications au niveau de la gestion des utilisateurs, partageant le mГЄme identifiant pour l'ensemble de votre site; c'est ce que l'on appelle l'intГ©gration ou passerelle. Cela facilitera l'utilisation pour les visiteurs, puisqu'ils ne devront s'identifier qu'une seule fois; leur identifiant fonctionnera avec Coppermine aussi bien qu'avec toutes les pages avec lesquelles Coppermine sera intГ©grГ©.
Par dГ©faut, l'intГ©gration est dГ©sactivГ©e, et ceux qui ne souhaitent pas l'utiliser peuvent oublier cette fonction sans problГЁmes. Il y a toutefois des problГЁmes lors de l'intГ©gration Г un stade plus avancГ© (une fois qu'il y a dГ©jГ du contenu dans Coppermine), donc, si vous souhaitez utiliser l'intГ©gration, vous devriez l'activer avant de commencer Г ajouter du contenu.
Originellement, l'intГ©gration de Coppermine a Г©tГ© crГ©e pour une intГ©gration avec des BBS (Forums). Par la suite, des passerelles pour d'autres applications (qui n'entrent pas dans la catГ©gorie des "BBS") ont Г©tГ© ajoutГ©es - le plus souvent pour des systГЁmes de gestion de contenu (CMS). NГ©anmoins, les rГ©fГ©rences aux applications BBS restent dans certains documents et chaines de caractГЁres du fichier langue. Il n'y a pas de raison de s'inquiГ©ter de cela.
Les passerelles n'intГЁgrent pas votre galerie et l'application avec laquelle vous voulez appliquer cette passerelle de maniГЁre visuelle. Si vous voulez une intГ©gration visuelle, crГ©ez un thГЁme personnalisГ© pour votre galerie, qui correspond Г l'aspect de l'ensemble de votre site et ajoutez un lien pointant du menu de Coppermine Г l'application avec laquelle vous l'avez intГ©grГ© et vice et versa.
Lorsque l'intégration est activée, Coppermine enlève la gestion des utilisateurs interne et utilise celle de l'application avec laquelle vous avez crée une passerelle (par exemple votre forum). En conséquence, vos utilisateurs devront s'enregistrer et s'identifier dans votre application avec laquelle Coppermine est intégré (BBS). Une fois fait, ils seront redirigés vers Coppermine (s’ils viennent de la page d'identification de Coppermine et que l'application avec laquelle la passerelle est faite autorise les redirections).
Fichiers d'intГ©gration disponibles
Coppermine peut s'intГ©grer avec les applications suivantes (exemple: Coppermine
et votre forum vont partager la mГЄme base de donnГ©es utilisateurs).
- Invision Power Board
- Mambo
- MyBB
- Phorum
- phpBB 2
- phpBB 3
- PunBB 1.15
- PunBB 1.2 (fonctionne aussi avec FluxBB 1.2)
- SMF 1.x
- SMF 2.x
- vBulletin
- XMB
- Xoops2
PrГ©-requis
Autentification par cookie
L'intГ©gration de l'identification utilise le cookie de votre application de forum, toutefois, cela ne fonctionnera pas si les cookies de votre forum ne sont pas visibles par Coppermine. Donc, si vous n'ГЄtes pas un expert, faites les choses simplement et installer Coppermine et votre application Г bridger sur le mГЄme domaine.
| Cela va fonctionner: |
Cela peut fonctionner: |
Cela ne va pas fonctionner: |
Application intГ©grГ©e: http://votredomaine.com/forum/
Coppermine: http://votredomaine.com/galerie/ |
Application intГ©grГ©e: http://forum.votredomaine.com/
Coppermine: http://galerie.votredomaine.com/ |
Application intГ©grГ©e: http://votrepremierdomaine.com/forum/
Coppermine: http://votreseconddomaine.com/galerie/ |
Le chemin du cookie dans la configuration du forum devrait ГЄtre '/' lГ ou l'option est disponible.
Les noms des cookies de votre application intГ©grГ©e et de Coppermine ne doivent pas ГЄtre les mГЄmes - ils doivent ГЄtre diffГ©rents !
Certaines applications intГ©grГ©es ont une option pour activer les cookies indГ©pendants des sous-domaines. Vous devez activer cette option si vous possГ©dez l'ensemble du domaine.
Certaines applications intГ©grГ©es utilisent un chemin de cookie par dГ©faut qui ne rend le cookie disponible que pour l'application elle mГЄme, et pas pour les applications se trouvant dans un autre rГ©pertoire du serveur. Si c'est le cas pour vous, vous devrez revoir la configuration de votre application intГ©grГ©e d'abord pour vous assurer que le cookie de votre application intГ©grГ©e est bien visible par Coppermine.
Dans SMF 1.1.x, l'option est appelГ©e "stockage local des cookies". Si elle est activГ©e, les cookies issus de SMF ne seront accessibles que pour le forum et pas par les autres applications. C'est pourquoi, lors de l'Г©tablissement d'une passerelle entre Coppermine et SMF, vous devrez aller dans le panneau de configuration de SMF et de dГ©sactiver l'option stockage local des cookies. Dans SMF cette option peut ГЄtre trouvГ©e sous "Administrateur" → "paramГЁtres du serveur" → "Options de configuration" → "Activer le stockage local des cookies".
Pour d'autres applications intГ©grables, l'option peut ГЄtre nommГ©e diffГ©remment et peut se trouver sous une autre structure de navigation, mais le rГ©sultat reste le mГЄme: le cookie gГ©nГ©rГ© par l'application intГ©grГ©e doit ГЄtre stockГ© de maniГЁre Г ce qu'il soit accessible par les autres applications dans le mГЄme domaine.
Dans la plupart des applications BBS rГ©centes, vous pouvez dГ©terminer si vous voulez gГ©rer l'authentification des utilisateurs par cookie ou par session. Si vous voulez Г©tablir une passerelle, vous devez vous assurer que l'application avec laquelle vous voulez Г©tablir une passerelle, utilise les cookies comme mГ©thode d'authentification - Coppermine ne fonctionne pas avec les authentifications gГ©rГ©es par les sessions !
Version autonome d'abord
Pour Г©viter les confusions, assurez vous de paramГ©trer les deux applications (Coppermine et l'application intГ©grГ©e) de maniГЁre autonome d'abord. Assurez-vous que les deux fonctionnent correctement, sans l'intГ©gration. Testez toutes les fonctions de Coppermine (comme le tГ©lГ©chargement, l'enregistrement etc...) une fois que Coppermine est installГ©, avant de commencer la mise en place de la passerelle.
Les utilisateurs, groupes et images tГ©lГ©chargГ©es par les utilisateurs de Coppermine sont perdus lors de l'intГ©gration
Attention: Si vous avez dГ©jГ des utilisateurs et des groupes personnalisГ©s dans votre base de donnГ©es de Coppermine lorsque vous activez l'intГ©gration, soyez attentifs au fait qu'ils seront perdus ! Si vous utilisateurs de Coppermine ont crГ©es des albums privГ©s et y ont tГ©lГ©chargГ©s des fichiers, ils seront eux aussi perdus !
Explication dГ©taillГ©e:
Comme la plupart des applications utilisant une communauté Coppermine stocke tout ce que font les utilisateurs (y compris l'administrateur) comme le téléchargement de fichiers, les commentaires, les votes, dans la base de données. La référence à chaque action faite par un utilisateur est défini par un IDentifiant utilisateur unique. La corrélation entre les actions de l'utilisateur et le profil de l’utilisateur correspondant est faite par le biais d'un IDentifiant unique dans chaque enregistrement de la base de données qui défini les actions des utilisateurs.
Lorsque la passerelle est Г©tablie, la gestion des utilisateurs de Coppermine est remplacГ©e par celle de l'application avec laquelle la passerelle est Г©tablie. En consГ©quence l'IDentifiant de l'utilisateur de l'application intГ©grГ©e (qui est diffГ©rent de celui de Coppermine) est pris en compte.
L'utilisateur de Coppermine "Pierre" a pour IDentifiant utilisateur Coppermine "3". Il l'a utilisГ© pour tГ©lГ©charger plusieurs fichiers qui ont Г©tГ© placГ©s dans le rГ©pertoire /albums/userpics/10003/. L'URL de cette galerie personnelle est http://votresite.com/votre_repertoire_coppermine/index.php?cat=10003.
Dans l'application BBS l'utilisateur "Paul" a eu l'identifiant "3".
AprГЁs l'activation de la passerelle, l'URL http://votresite.com/votre_repertoire_coppermine/index.php?cat=10003 pointera vers la galerie personnelle de l'utilisateur "Paul". Toutes les images que Pierre avait tГ©lГ©chargГ©es apparaissent comme ayant Г©tГ© tГ©lГ©chargГ©es par Paul.
Conclusion:
La corrГ©lation entre les actions faites par les utilisateurs de Coppermine non intГ©grГ© et les "nouveaux" comptes de l'application avec laquelle vous avez crГ©e la passerelle sont perdus. En consГ©quence vous n'avez actuellement pas perdus les fichiers qui ont Г©tГ© tГ©lГ©chargГ©s auparavant, mais ils apparaissent comme ayant Г©tГ© tГ©lГ©chargГ©s par un autre utilisateur.
Sauvegarde
Il est particuliГЁrement recommandГ© de sauvegarder aussi bien votre base de donnГ©es Coppermine que vos fichiers avant d'activer la passerelle, de sorte Г pouvoir revenir en arriГЁre si l'intГ©gration devait mal se passer.
En fait, vous ГЄtes encouragГ©s Г sauvegarder votre base de donnГ©es rГ©guliГЁrement, et plus particuliГЁrement avant de faire des changements dans le code.
Cependant, ne vous alarmez pas des disfonctionnement de votre forum qui pourraient ГЄtre causГ©s par la passerelle: Coppermine n'affecte pas votre forum (ni aucune autre application). Lors de la mise en place de la passerelle, Coppermine ne lance aucune requГЄte en Г©criture/modification dans la base de donnГ©es de l'application intГ©grГ©e, tout comme Coppermine ne modifie aucun fichier de l'application intГ©grГ©e ! La pire chose qui puisse arriver si quelque chose se passait mal, serait que votre galerie Coppermine soit inaccessible. Il est tout Г fait impossible que la passerelle de Coppermine affecte l'application intГ©grГ©e.
Etapes de l'intГ©gration
Depuis cpg1.4.x vous pouvez utiliser le gestionnaire d'intГ©gration qui propose une interface sous forme d'assistant pour activer/dГ©sactiver la passerelle.
Utilisation du gestionnaire d'intГ©gration
Le gestionnaire d’intégration est une nouvelle fonction de cpg1.4, il n'était pas disponible dans les versions précédentes. Au lieu de modifier manuellement le code de Coppermine, vous pouvez activer/désactiver la passerelle depuis votre navigateur, en utilisant une interface sous forme d'assistant. Pour démarrer le gestionnaire d’intégration, identifiez vous comme administrateur choisissez "Gestionnaire d'intégration" dans le menu administrateur.
Note: A chaque étape dans l'assistant, des informations sont écrites dans la base de données de Coppermine ! A l'inverse d'autres assistants (généralement sur votre ordinateur) le gestionnaire d’intégration n'a pas de bouton "annuler" ! Une fois que vous avez activé la passerelle et que tout fonctionne correctement, vous ne devriez pas changer de valeurs, juste par curiosité, puisqu'elles sont écrites dans la base de données, cela ferait que la passerelle utilisée ne fonctionnerait plus une fois que vous aurez "joué" avec.
Note complГ©mentaire
Si vous avez crée un fichier de passerelle personnalisé, copiez simplement ce fichier de passerelle dans le répertoire bridge de Coppermine et il s'affichera dans l'interface du gestionnaire d’intégration (le fichier de passerelle doit se trouver dans le sous répertoire de Coppermine "bridge").
Si un bouton retour (
) est affichГ© aprГЁs un champ d'entrГ©, la valeur du champ n'a pas la valeur par dГ©faut. Cela peut ГЄtre tout Г fait normal de ne pas avoir la valeur par dГ©faut, nГ©anmoins vous devez garder en mГ©moire que si vous avez "jouГ©" avec le gestionnaire d'intГ©gration avant, les paramГЁtres prГ©cГ©dents qui se trouvent dans un champ peuvent ne pas ГЄtre correct. - ne passez pas allГЁgrement une Г©tape sans faire trГЁs attention Г cela. Utilisez le bouton retour pour revenir Г la valeur par dГ©faut (pas nГ©cessairement "votre" valeur par dГ©faut).
Choisissez l'application avec laquelle vous voulez Г©tablir une passerelle
Dans la premiГЁre Г©tape de l'assistant "choisissez l'application avec laquelle vous voulez Г©tablir une passerelle avec Coppermine", vous devez choisir l'application que vous voulez avec Coppermine. Notez que vous devez avoir cette application installГ©e sur votre serveur, elle doit ГЄtre correctement configurГ©e et doit ГЄtre opГ©rationnelle. N'utilisez pas le gestionnaire d'intГ©gration si vous avez juste planifiГ© l'intГ©gration de Coppermine avec une autre application plus tard.
Choisissez un des fichier passerelle disponible
Cliquez sur "suivant"
Etapes suivantes
Les Г©tapes suivantes dГ©pendent de l'application avec laquelle vous voulez faire l'intГ©gration de Coppermine: certaines applications ont besoin que l'on entre une URL ou un chemin. Certaines ont besoin que des donnГ©es de cookies soient entrГ©es, d'autres pas. L'assistant ne vous demandera que les paramГЁtres nГ©cessaires Г votre application - si l'un ou l'autre des points dГ©crits plus bas ne s'appliquent pas Г votre application, pas de panique - ne remplissez que les informations obligatoires et cliquez sur "suivant". Toutefois, vous devez comprendre que Coppermine ne peut vГ©rifier que certaines de vos entrГ©es - certaines peuvent ГЄtre invalidГ©es.
Chemin(s) vers l'application avec laquelle vous voulez Г©tablir une passerelle
Il y a de multiples manières utilisées par le mécanisme d'intégration de Coppermine pour se connecter à une application intégrée. Généralement, les paramètres entrés dans le gestionnaire d’intégration à cette étape "demandent" à Coppermine ou se trouve votre application intégrée et ou se trouve le fichier de configuration contenant les donnée utilises par Coppermine pour "s'accrocher" à l'application à intégrée. Comme il y a différentes approches des applications intégrées sur la manière dont cela peut être fait, la méthode utilisée par l'assistant peut être différente, en fonction de l'application que vous avez choisie à la première étape de l'assistant. Lancez simplement l'assistant et regardez quels sont les paramètres nécessaires et renseignez les soigneusement.
URL de l'application intГ©grГ©e
L'URL complГЁte du rГ©pertoire de votre application Г intГ©grer (y compris le http:// , exemple. http://www.votredomaine.com/forum/).
Notez que vous ne devez pas prГ©ciser de fichier Г la fin de l'URL - si votre application se trouve Г l'adresse http://www.votredomaine.com/forum/index.php, ne spГ©cifiez que l'URL du rГ©pertoire qui contient le fichier index de votre application.
Assure vous de mettre l eslash de fin - l'URL doit ГЄtre http://www.votre domaine.com/forum/ et pas juste http://www.votredomaine.com/forum
Chemin absolu de l'application bridgГ©e
C'est le chemin absolu de votre application intГ©grГ©e vue depuis la racine de votre site
- Si votre application intГ©grГ© est Г l'adresse http://www.exemple.com/forum/, entrez /forum/ dans ce champ
- Si votre application intГ©grГ© est Г l'adresset http://www.exemple.com/foo/bar/, enrez /foo/bar/ dans ce champ
Vous devez comprendre que ce paramГЁtre n'est pas le chemin absolu d'un systГЁme de fichier sur votre serveur web, mais juste le chemin absolu vu depuis la racine de votre site.
Dans le systГЁme de fichier de votre serveur, le chemin absolu vers la racine de votre site devrait ГЄtre quelque chose comme /var/www/votre_nom_de_compte/public_html/. En consГ©quence, l'application avec laquelle vous voulez Г©tablir une passerelle doit se trouver dans un chemin absolu du systГЁme de fichier de votre serveur comme ceci: /var/www/votre_nom_de_compte/public_html/forum/. Votre galerie Coppermine devrait se trouver dans le chemin absolu comme ceci: /var/www/votre_nom_de_compte/public_html/galerie/. Toutefois, c'est le rГ©pertoire racine qui importe Г ce stade - Coppermine ne va pas plonger dans le systГЁme de fichier et ne prend pas en compte le chemin absolu que vous devez utiliser avec d'autres applications ou pour inclure des fichiers - il utilise juste le chemin vu depuis la racine (ce qui peut ГЄtre directement accessible depuis le navigateur). Donc, pour cet exemple, le chemin absolu vu depuis la racine de votre site devrait ГЄtre /forum/ - ni plus ni moins.
Chemin relatif vers le fichier de configuration de l'application intГ©grГ©e
C'est le chemin relatif vers l'application avec laquelle vous voulez Г©tablir une passerelle, vu depuis le rГ©pertoire de Coppermine (exemple "../forum/" si votre application intГ©grГ©e se trouve Г l'adresse http://www.votredomaine.com/forum/ et Coppermine Г http://www.votredomaine.com/gallery/)
Un chemin relatif ne doit pas commencer avec un slash - c'est la diffГ©rence visuelle d'un chemin absolu. Vous devez penser en niveau de rГ©pertoire/sous-rГ©pertoire pour comprendre le concept de chemin relatif. Imaginez que tous les rГ©pertoires de votre serveur sont les branches d'un arbre qui sont tournГ©es vers le bas: les racines Г©tant en haut et les branches allant vers le sol. Le chemin relatif dГ©crit la route que vous devez faire depuis un rГ©pertoire particulier (le rГ©pertoire dans lequel se trouve Coppermine) vers un autre rГ©pertoire (le rГ©pertoire ou se trouve l'application intГ©grГ©e). La maniГЁre d'Г©crire un chemin relatif contient une maniГЁre spГ©ciale de dire "un niveau plus haut": ce sont deux points suivis par un slash (../). Ceci dit, regardez les quelques exemples ci-dessous:
| Votre installation Coppermine |
L'installation de l'appliaction intГ©grГ©e |
Chemin relatif |
| http://exemple.com/galerie/ |
http://exemple.com/forum/ |
../forum/ |
| http://exemple.com/galerie/ |
http://exemple.com/communaute/forum/ |
../communaute/forum/ |
| http://exemple.com/images/coppermine/ |
http://exemple.com/bbs/ |
../../bbs/ |
|
|
|
| http://exemple.com/galerie/ |
http://example.com/ |
../ |
| http://exemple.com/ |
http://exemple.com/forum/ |
forum/ |
| http://exemple.com/communaute/images/ |
http://exemple.com/communaute/ |
../ |
| http://exemple.com/un/repertoire/tres/complique/ |
http://exemple.com/ |
../../../../ |
| http://exemple.com/galerie/ |
http://exemple.com/communaute/forum/ |
../communaute/forum/ |
PrГ©fixe de cookie
Ce doit ГЄtre le nom du cookie de l'application avec laquelle vous souhaitez Г©tablir la passerelle. N'entrez pas le prГ©fixe de cookie de votre galerie Coppermine ici ! Vous ne pouvez pas le dГ©finir vous-mГЄme - vous devez regarder la documentation ou les rГ©glages de l'application avec laquelle vous voulez Г©tablir la passerelle.
L'application populaire "phpBB2" utilise le prГ©fixe de cookie par dГ©faut phpbb2mysql - il peut ГЄtre modifiГ© par l'administrateur du forum, donc, si vous n'ГЄtes pas sur de votre prГ©fixe de cookie, allez dans le panneau de configuration du forum et cherchez le prГ©fixe du cookie qui s'y trouve.
Le prГ©fixe de cookie ne doit pas ГЄtre confondu avec le chemin du cookie - ce sont deux choses trГЁs diffГ©rentes. Le prГ©fixe de cookie (dans certaines applications est appelГ© "nom du cookie") fait partie intГ©grante de l'application - quelque chose que les dГ©veloppeurs de l'application ont dГ©finie.
ParamГЁtres spГ©cifiques des applications intГ©grГ©es
Utiliser les groupes personnalisГ©s de l'application bridgГ©e ?
Est ce que Coppermine doit importer les groupes spГ©ciaux qui existent dans votre application intГ©grГ©e ? Si vous sГ©lectionnez Non, Coppermine utilisera uniquement les groupes standards (Administrateur, EnregistrГ© et Anonyme) ce qui rendra l'administration plus facile. Si vous activez cette option en sГ©lectionnant Oui, vous aurez une gestion des droits plus fine dans Coppermine et pourrez dГ©finir les droits dans Coppermine en vous appuyant sur les groupes personnalisГ©s de votre application intГ©grГ©e. Vous pouvez changer ce paramГЁtre plus tard.
Activer/dГ©sactiver la passerelle
C'est la dernière étape du gestionnaire d’intégration - il résume les paramètres que vous avez défini dans les étapes précédentes - vous pouvez activer/désactiver l'intégration ici. Par défaut, l'intégration est paramétrée sur "désactivé" une fois que le gestionnaire d'intégration a été lancé pour la première fois. Vous ne devez activer l'intégration que si vous êtes sur que l'application avec laquelle vous voulez établir la passerelle est paramétrée correctement. Cliquez sur le bouton "Terminer" dans tous les cas pour finalement écrire dans la base de données, même si vous choisissez de garder les paramètres actuels (laisser l'intégration "désactivée").
- Activer l'intГ©gration/passerelle avec XXX
Restauration aprГЁs une erreur d'intГ©gration
Si vous avez donnГ© de mauvais rГ©glages lors de l'utilisation de l'assistant d'intГ©gration, votre intГ©grateur peut Г©chouer, avec pour rГ©sultat (dans la plupart des cas) dans une situation ou l'intГ©gration est activГ©e, mais ou vous ne pouvez pas vous identifier pour la dГ©sactiver Г nouveau (exemple si vous entrez un mauvais paramГЁtre de cookie qui empГЄche le fonctionnement de l'authentification). Pour parer Г cette situation, un paramГЁtre de restauration a Г©tГ© inclue dans le gestionnaire d'intГ©gration: si vous n'ГЄtes pas identifiГ© comme administrateur dans Coppermine (en fait si vous n'ГЄtes pas identifiГ© du tout) et que vous accГ©dez Г l'URL du gestionnaire d'intГ©gration depuis votre navigateur (http://votredomaine.com/votrerepertoirecoppermine/bridgemgr.php) en entrant cette adresse manuellement dans la barre d'adresse de votre navigateur, il vous est demandГ© d'entrer vos paramГЁtres de compte d'administrateur (identifiant et mot de passe) - utilisez les paramГЁtres que vous avez dГ©finis lors de l'installation de Coppermine (identifiants administrateurs pour une version autonome). Cela ne va pas vous identifier, mais va dГ©sactiver l'intГ©gration, vous permettant de corriger les mauvais rГ©glages. Pour Г©viter que d'autres essayent de trouver vos identifiants administrateurs ici, il y a un temps d'attente entre chaque essai qui augmente Г chaque fois, faites donc attention lorsque vous entrez vos identifiants administrateurs.
Synchroniser les groupes de l'application intГ©grГ©e avec les groupes de Coppermine
Identifiez-vous en utilisant le compte administrateur de votre forum. Allez sur votre galerie, activez le mode administrateur et cliquez sur le bouton "Groupes". Cela va synchroniser les groupes de Coppermine avec ceux de votre forum. Les permissions que vous verrez pour chaque groupe seront totalement fausses. Prenez donc le temps de les paramГ©trer correctement.
Chaque fois que vous ajoutez ou effacez un groupe dans votre forum vous devrez faire l'opГ©ration ci-dessus pour garder la synchronisation des groupes.
Lorsque vous essayerez de vous identifier/dГ©connecter ou gГ©rer les utilisateurs depuis Coppermine, vous serez redirigГ© vers la page correspondante de votre application forum. Une fois que l'identification /la dГ©connection sera faite, vous ne serez pas automatiquement redirigГ© vers votre galerie parce que votre forum n'a pas de fonctions pour cela. Il est de votre initiative d'ajouter un lien sur la page de votre forum pour retourner vers la galerie.
Il est obligatoire que vous (en tant qu'administrateur) alliez directement Г la page de gestion des groupes aprГЁs l'intГ©gration ou Г chaque fois que vous aurez changГ© quelque chose dans la configuration de l'application intГ©grГ©e, parce que vous devrez refaire une resynchronisation.
Aide Г l'intГ©gration
Avec les explications donnГ©es plus haut, vous devriez ГЄtre en mesure de crГ©er une passerelle entre votre forum et Coppermine. NГ©anmoins, si quelque chose ne fonctionne pas correctement, vous pouvez bien entendu aller sur le Forum d'aide de Coppermine. Lorsque vous demandez de l'aide, merci de garder en mГ©moire que les supporteurs auront besoin de certaines informations pour pouvoir vous venir en aide:
Certaine options de la configuration sont dГ©sactivГ©es
Comme expliquГ© dans cette page, Coppermine va remplacer la gestion des utilisateurs avec celle de l'application intГ©grГ©e. En consГ©quence, les options de configuration de Coppermine ne s'appliquent plus non plus (par exemple les champs du profil utilisateur). C'est pourquoi les options de configuration qui s'appliquent uniquement aux installations autonomes, non intГ©grГ©es, de Coppermine seront dГ©sactivГ©es sur la page de configuration si l'intГ©gration est activГ©e.
Fichiers d'intГ©gration (Passerelle)
Dans le répertoire racine de Coppermine vous trouverez un sous-dossier nommé "bridge" - c'est l'emplacement ou se trouvent les fichiers d'intégration. Lorsque Coppermine est lancé (lorsque les visiteurs naviguent sur des pages pilotées par Coppermine), Coppermine inclue les fichiers passerelle relatifs à l'application avec laquelle vous avez créé une passerelle. En utilisant ce fichier, Coppermine fait ce qui est nécessaire pour l'authentification des visiteurs. Même si Coppermine n'est pas du tout intégré, il y a quand même un fichier qui est inclu depuis le répertoire bridge ("coppermine.inc.php") qui défini quelles sont les tables à utiliser.
GГ©nГ©ralement, vous ne devez pas modifier les fichiers qui se trouvent dans le rГ©pertoire bridge - en fait, la chose la plus importante que vous devez vous rappeler est que Coppermine a besoin du rГ©pertoire bridge et de son contenu, mГЄme si vous n'avez pas activГ© la fonction d'intГ©gration. Laissez donc les fichiers tels quels. Les super-utilisateurs qui savent ce qu'ils font peuvent bien Г©videmment modifier les fichiers passerelle pour les adapter Г leurs besoins.
Il y a eu des utilisateurs qui ont essayГ© de "lancer" les fichiers passerelle eux-mГЄme depuis leur navigateur - cela ne fonctionne pas et ne fait rien, mais il en rГ©sulte un message d'erreur. Les fichiers passerelle ne sont pas destinГ©s Г fonctionner de maniГЁre autonome. - ils sont inclus par Coppermine pendant son fonctionnement. Si vous ne savez pas ce que cela signifie, laissez simplement ces fichiers ou ils sont. Cela ne pose pas de problГЁmes d'avoir des fichiers passerelle sur votre serveur mГЄme si vous n'utilisez pas de passerelle correspondant Г un fichier particulier.
CrГ©er un fichier passerelle personnalisГ©
En thГ©orie, Coppermine peut ГЄtre s'intГ©grГ© avec n'importe quelle application tierce qui a une gestion/authentification d'utilisateurs. Il y a des centaines d'applications qui sont des candidats potentiels. Simplement Г cause du trГЁs grand nombre de passerelle possible, mais aussi Г cause d'autres restrictions (applications non libres, manque de temps, manque de besoin), l'Г©quipe de dГ©veloppement de Coppermine ne peut pas fournir un nombre Г©norme de fichiers. C'est pourquoi seul un petit nombre de fichiers passerelle sont disponibles. Si vous cherchez un fichier passerelle pour une autre application qui n'est pas disponible directement dans Coppermine, cherchez sur le forum d'aide de Coppermine s'il n'y a pas dГ©jГ un fichier passerelle issu d'une contribution d'utilisateur, ou (encore mieux), vous ГЄtes encouragГ©s Г crГ©er vous mГЄme votre propre fichier passerelle et Г le partager sur le forum. Nous (l'Г©quipe de dГ©veloppement de Coppermine) devons compter sur les contributions des utilisateurs pour la plupart des fichiers passerelles potentiels.
Malheureusement, il n'y a actuellement pas de section particuliГЁre de documentation expliquant comment crГ©er un fichier passerelle personnalisГ©, la meilleure mГ©thode est donc de regarder un fichier existant et de le modifier pour l'adapter Г vos besoins.
Philosophie de l'intГ©gration
L'Г©quipe de dГ©veloppement de Coppermine pense que le mГ©canise d'intГ©gration ne doit pas interfГ©rer avec l'application Г intГ©grer avec Coppermine. C'est pourquoi un bon fichier passerelle qui peut ГЄtre considГ©rГ© comme pouvant ГЄtre intГ©grГ© au code principal de Coppermine ne doit pas obliger Г faire des modifications du code l'application Г intГ©grer, ni de faire des changements dans la structure de la base de donnГ©es de l'application intГ©grГ©e depuis des requГЄtes envoyГ©es par Coppermine.
La raison de notre rГ©ticence Г autoriser l'intГ©gration d'interfГ©rer avec l'application bridgГ©e est que nous ne souhaitons pas corrompre celle ci si quelque chose ne passait mal.
NГ©anmoins, il y a des fichiers passerelle issus de contributions qui ne peuvent pas fonctionner de la maniГЁre non-intrusive que nous proposons (comme la passerelle de Mehdi pour Joomla). Nous ne disons pas que ces fichier passerelle sont mauvais - en fait nous apprГ©cions que ces fichiers soient mis Г disposition. Vous devez comprendre que nous ne pouvons pas apporter de l'aide sur les applications tierces. Nous vous recommandons de faire une sauvegarde avant de mettre en place une passerelle en utilisant ces applications tierces.
ProblГЁmes particuliers d'intГ©gration
Il y a quelques remarques additionnelles qui s'appliquent Г certains fichiers passerelle particuliers:
-
phpBB3
Redirection aprГЁs dГ©connexion: pour pouvoir crГ©er une redirection aprГЁs dГ©connexion en utilisant le fichier passerelle phpBB3, vous devez modifier le fichier phpBB ucp.php:
Trouvezmeta_refresh(3, append_sid("{$phpbb_root_path}index.$phpEx"));
$message = $message . '<br /><br />' . sprintf($user->lang['RETURN_INDEX'], '<a href="' . append_sid("{$phpbb_root_path}index.$phpEx") . '">', '</a> ');et remplacez parmeta_refresh(3, request_var('redirect', append_sid("{$phpbb_root_path}index.$phpEx")));
$message = $message . '<br /><br />' . sprintf($user->lang['RETURN_INDEX'], '<a href="' . request_var('redirect', append_sid("{$phpbb_root_path}index.$phpEx")) . '">', '</a> ');
Reconnaissance de l'administrateur pour les forums mis Г jour: si votre forum a Г©tГ© mis Г jour depuis phpBB2 vers phpBB3 vous devrez faire une Г©tape supplГ©mentaire.
Ouvrez phpbb3.inc.php, trouvez
$this->admingroups = array(5);
Changez le 5 pour le groupe administrateur dans phpBB3. Vous pouvez le trouver en faisant ce qui suit
Allez sur votre forum, identifiez vous comme administrateur; cliquez sur l'onglet "Utilisateurs et Groupes" et allez Г "Gestion des groupes". Vous verrez maintenant tous les groupes de votre forum et Г cГґtГ© d'eux trois liens (ParamГЁtres/Membres/Effacer); cliquez sur "ParamГЁtres" Г cГґtГ© du groupe auquel vous souhaitez donner les droits administrateur. Regardez maintenant la ligne d'adresse qui doit ГЄtre similaire Г Г§a:
http://votredomaine.com/phpbb3/adm/index.php?i=groups&sid=[lettresetchiffresallГ©atoires]&icat=12&mode=manage&action=edit&g=64
Dans notre exemple, l'ID du groupe est 64;
-
PunBB1.1.5
Pour la redirection aprГЁs identification/deconnexion:
Ouvrez le fichier punbb login.php, trouvez: $page_title = pun_htmlspecialchars($pun_config['o_board_title']).' / '.$lang_common['Login'];
et ajoutez avant $redirect_url = (isset($_GET['redir'])) ? $_GET['redir'] : $redirect_url;
puis trouvez: redirect('index.php', $lang_login['Logout redirect']);et changez pour: redirect(isset($_GET['redir']) ? $_GET['redir'] : 'index.php', $lang_login['Logout redirect']);
-
PunBB1.2
Pour la redirection aprГЁs identification/dГ©connexion:
Ouvrez le ficher PunBB login.php et trouvez: $page_title = pun_htmlspecialchars($pun_config['o_board_title']).' / '.$lang_common['Login'];
ajoutez juste avant$redirect_url = (isset($_GET['redir'])) ? $_GET['redir'] : $redirect_url;
Puis trouvezredirect('index.php', $lang_login['Logout redirect']);et changez parredirect(isset($_GET['redir']) ? $_GET['redir'] : 'index.php', $lang_login['Logout redirect']);
-
XMB
Correction du Cookie (si votre forum n'est pas installГ© Г la racine du site): ouvrez le fichier XMB functions.php, trouvez la dГ©finition de fonction pour put_cookie (vers la ligne 1414) et ajoutez$path = '/';
juste en haut de la focntion
ProblГЁmes de sous-domaines
Il y a beaucoup d'utilisateurs qui demandent frГ©quemment sur le forum d'aide si l'intГ©gration de Coppermine est possible entre sous-domaines: la rГ©ponse est "oui" en thГ©orie en tout cas. Comme expliquГ© ci-dessus, vous ne pouvez pas crГ©e de passerelles entre des domaines diffГ©rents (utiliser le mot domaine au sens large, ce devrait ГЄtre ici "un second niveau de domaine"), mais vous pouvez crГ©e des passerelles entre diffГ©rents sous-domaines si certains prГ©-requis sont prГ©sents, qui peuvent difficilement ГЄtre influencГ©s par les dГ©veloppeurs de Coppermine: les cookies du domaine ou se trouve l'application avec laquelle vous voulez crГ©er la passerelle doit ГЄtre lisible par Coppermine et les deux domaines doivent ГЄtre physiquement sur le mГЄme serveur. C'est le cas pour la plupart des utilisateurs qui sont sur des serveurs mutualisГ©s.
SystГЁme de fichiers
La plupart des hГ©bergeurs, paramГЁtrent leurs serveurs de sorte que le sous-domaine soit juste un sous-rГ©pertoire du domaine parent dans le systГЁme de fichiers. Nous (l'Г©quipe de dГ©veloppement de Coppermine) ne pouvons garantir que c'est le cas pour les paramГЁtres de votre serveur, donc, en cas de doute, demandez de l'aide Г votre hГ©bergeur. Ce n'est donc ici que l'explication sur comment les sous-domaines fonctionnent sur la plupart des serveurs - ne nous en voulez pas si ce n'est pas le cas pour vous.
Votre application intГ©grГ©e a l'URL http://forum.exemple.com/, avec comme chemin absolu dans le systГЁme de fichiers: /var/www/votre_nom_de_compte/public_html/forum/, avec /var/www/votre_nom_de_compte/public_html/ reprГ©sentant la racine du site (ex. http://exemple.com/). Votre galerie est accessible depuis l'URL http://gallery.exemple.com/, qui correspond au chemin absolu du systГЁme de fichier /var/www/votre_nom_de_compte/public_html/galerie/. Vu depuis la racine du site, les sous-domaines "forum" et "galerie" sont juste la reprГ©sentation des sous-rГ©pertoires de la racine du site qui sont nommГ©s de la mГЄme maniГЁre ("forum" et "galerie"). C'est pourquoi le gestionnaire d'intГ©gration vous demande d'entrer le chemin relatif depuis la galerie vers l'application Г intГ©grГ©e, cela serait ../forum/ (qui se lit "un niveau de rГ©pertoire plus haut", puis aller dans le sous-rГ©pertoire "forum").
Cookies
Comme indiquГ© Г plusieurs reprises, l'authentification de Coppermine est basГ©e sur les cookies. Si l'intГ©gration est activГ©e, Coppermine doit ГЄtre capable de lire le cookie de l'application intГ©grГ©e. Ce n'est possible que si vous n'avez pas de restrictions empГЄchant Coppermine de le faire. La plupart des applications tierces (et beaucoup des applications avec lesquelles Coppermine peut crГ©er une passerelle) autorisent la dГ©finition d'un chemin de cookie. Malheureusement, toutes n'identifient pas clairement ce chemin dans leur panneau de configuration: certaines l'appellent cookie local sans vous permettre de dГ©finir un chemin particulier. Cette option existe pour des raisons historiques: autrefois, beaucoup d'utilisateurs ne pouvaient pas acquГ©rir leur propre domaine, dons ils Г©taient hГ©bergГ©s dans un sous rГ©pertoire du domaine parent. Tout leur contenu devait se trouver dans un seul rГ©pertoire et donc devait avoir une option dans leur application pour s'assurer que leur cookie n'Г©tait pas accessible par les autres utilisateurs du domaine parent. Aujourd'hui, les universitГ©s offrent souvent Г leurs Г©tudiants un espace ressemblant Г Г§a: http://exemple.com/~nomutilisateur/. Les utilisateurs de ce genre d'hГ©bergement doivent avoir une option pour avoir un chemin de cookie qui permette de s'assurer que quelqu'un d'autre qui est hГ©bergГ© Г l'adresse http://exemple.com/~un_autre_utilisateur/ n'a pas accГЁs Г son cookie.
Si votre galerie se trouve Г http://exemple.com/galerie/ et que votre application intГ©grГ©e se trouve Г http://exemple.com/forum/, ce n'est pas une bonne idГ©e de dГ©finir le chemin du cookie de votre application intГ©grГ©e comme Г©tant /forum - cela signifie que seules les pages se trouvant dans le sous-rГ©pertoire /forum du rГ©pertoire racine du site. Comme votre galerie ne se trouve pas dans ce sous-rГ©pertoire, elle ne pourra pas lire le cookie de votre application intГ©grГ©e - rГ©sultat, la passerelle ne fonctionnera pas.
Pour finir: pour 99% des utilisateurs, rГ©gler le chemin de cookie Г "" (rien) sera le meilleur choix.
sous-domaines en www
La plupart des sites internet sont accessibles avec ou sans le sous-domaine www: gГ©nГ©ralement, http://exemple.com/ fonctionne de la mГЄme maniГЁre que http://www.exemple.com/. C'est trГЁs bien et facilite la vie des utilisateurs, mais avec un inconvГ©nient: un sous-domaine est un domaine diffГ©rent du point de vue des cookies. C'est pourquoi vous devrez ГЄtre cohГ©rent dans l'utilisation des sous-domaines www: intГ©grer http://exemple.com/galerie/ et http://www.exemple.com/bridge-app/ va certainement causer des problГЁmes de cookies.
Pour Г©viter cela, vГ©rifiez les rГ©glages de Coppermine aussi bien que de l'application intГ©grГ©e: assurez-vous dans les deux panneaux de configuration que vous utilisez le mГЄme type d'URL avec le sous domaine WWW ou sans.
Recomandation:
Le sous-domaine www a été introduit dans les premiers jours de l'Internet. Techniquement, il n'est plus nécessaire, mais beaucoup d'utilisateur on prit l'habitude d'utiliser le sous-domaine www lorsqu'ils tapent une URL. Nous recommandons d'utiliser une URL sans le www pour la rendre plus facile à mémoriser. Pour être sûr de ne pas gêner ceux qui entreraient une URL avec le www, nous recommandons de définir une règle de réécriture dans un fichier .htaccess personnalisé qui ressemblerait à ceci:
Remplacez votredomaine et com dans les Г©lГ©ments de codes ci dessus. Si votre site se trouve Г l'adresse exemple.fr, changez le code ci-dessus avec quelque chose comme
Merci de noter que la définition de vos règles de réécriture n’est pas dans les attributions du forum d'aide de Coppermine - vous devez utiliser votre moteur de recherche favori pour trouver des détails à ce sujet.
