# Coppermine Photo Gallery v1.5.x: Documentation et Manuel

# Utilisateurs

Dans cette documentation, le terme "utilisateur" est utilisé pour tous ceux qui ont accès à votre galerie, aussi bien les utilisateurs enregistrés que les invités / Anonymes non enregistrés. Les fonctionnalités d'enregistrement (si les visiteurs sont autorisés à s'inscrire en premier lieu et leurs autorisations) peuvent être configurées dans la section correspondante du panneau de configuration. Coppermine contient une gestion des utilisateurs propre qui vous permet de contrôler les groupes auquels appartiennent vos utilisateurs (appartenance à un groupe, contrôle des autorisations), sauf si vous désactivez la gestion des utilisateurs en faveur d’une passerelle entre Coppermine avec une autre application. Si vous activez une passerelle, c'est l'application avec laquelle vous avez fait l'intégration qui prendra le relais et le contrôle de vos utilisateurs à la place de Coppermine.

## Le panneau de Gestion des utilisateurs

Le panneau de contrôle utilisateur peut être trouvé en cliquant sur "Utilisateurs" dans les boutons d’administration, Il est le lieu où vous créez et gérez vos utilisateurs.

Si vous avez activé l'intégration (Une passerelle) de Coppermine avec une autre application (par exemple, votre application favorite BBS), Coppermine utilise la table membre de l'application que vous utiliser avec (votre BBS), de sorte que la fonction de gestion d'utilisateur de Coppermine sera désactivée en faveur de la gestion des utilisateurs de l'application qui sert de passerelle. Cela a été fait pour éliminer les redondances et faciliter une intégration sans heurt.
Par conséquent, vous n'aurez pas ce panneau de gestion d’utilisateurs en cliquant sur «utilisateurs» Le lien vous enverra à la place à la gestion des utilisateurs de l’application qui vous sert de passerelle.

### Gestion d’utilisateurs

- Vous pouvez trier l'affichage dans la gestion des utilisateurs soit en cliquant sur les flèches () à côté de chaque entête de colonne ou en choisissant l'ordre de tri dans la liste déroulante en haut à droite.
- Si vous avez plus de 25 utilisateurs, un onglet sur la page sera apparent en bas à droite de l'écran, vous permettant d'aller aux pages suivantes, de la liste de vos membres
- En cliquant sur l’icone () voir le profil en face du nom d'un utilisateur, vous afficherez la page individuelle du profil de la personne (lecture seule)
- L'icône d'édition () vous fera parvenir au profil de l'utilisateur en mode édition - vous pouvez changer le mot de passe, l'adresse de messagerie et d'autres paramètres liés à l'utilisateur.
- Si un utilisateur a ajouté dernièrement des fichiers, l’icône à côté de son nom passera de gris () à vert (). En cliquant dessus, cela affichera les fichiers qui ont été envoyés par cet utilisateur.
- La colonne "Groupe" affiche le groupe principal dont l'utilisateur est membre.
- La colonne "Enregistré le" indique la date à laquelle le compte de l’utilisateur a été créé
- La colonne "Dernière visite" indique la date de la dernière visite de l'utilisateur
- La colonne "Fichiers" indique le nombre de fichiers que l'utilisateur a téléchargé à ce jour (y compris ceux qui sont en attente d'approbation de la part de l’administrateur)
- La colonne "Espace utilisé/Espace alloué" indique la quantité d'espace qui est attribué en vert et en rouge celle que l'utilisateur a déjà utilisé. L'espace alloué que l'utilisateur est autorisé à avoir ("quota") dépend du groupe de l'utilisateur - vous définissez ce paramètre dans le panneau de configuration des groupes.
- Vous pouvez modifier un certain nombre de paramètres pour plusieurs utilisateurs à la fois, en cochant la case en à côté de chaque noms d’utilisateurs (utiliser la case tout en haut ou tout en bas de la page pour sélectionner / désélectionner tous les utilisateurs de la page), puis choisissez une action à effectuer dans la liste déroulante "Sélectionner" en bas à gauche de la page. Les actions que vous pouvez choisir sont "Effacer", "Activer", "Désactiver", "Changer le mot de passe", "Changer de groupe principal" et "Ajouter un groupe secondaire". L'utilisateur actuellement connecté (vous en tant qu'administrateur de Coppermine) n'a pas de case à cocher à côté de son nom pour éviter, la suppression accidentelle ou à la désactivation de votre propre compte administrateur.

### Chercher un utilisateur(s)

Vous pouvez utiliser les astérisques: `*` (pour toute les chaînes de caractères) et le point d’interrogation `?` (Un seul caractère) ou même une expression via l’utilisation du symbole % `(%expression%)`.
Exemple: la recherche de `j*` aura comme retour `Jack` et `Jill`

### Créer de nouveaux utilisateurs

Pour créer un nouvel utilisateur, cliquez simplement sur le bouton "Créer un nouvel utilisateur" au bas du gestionnaire d’utilisateur et remplissez le formulaire qui apparaîtra.

Cela n'est évidemment pas si fonctionnel si vous avez activé l’intégration d’une passerelle, car la gestion des utilisateurs est assurée par l'application qui vous sert de passerelle Coppermine. Dans ce cas, l'écran de gestion des utilisateurs de l’application de votre passerelle devrait montrer - créer un nouvel utilisateur.

### Modification d'un utilisateur

Pour modifier les propriétés d'un utilisateur, cliquez sur le bouton () à côté du nom d'utilisateur. Vous trouverez ensuite une page où vous pouvez modifier toutes les informations contenue dans le profil de l'utilisateur. Cela inclut la possibilité de changer le mot de passe de cet utilisateur. Si vous ne voulez pas changer le mot de passe de l'utilisateur, laissez le champ mot de passe vide.
La liste déroulante indique le groupe principal dans lequel l'utilisateur se trouve, les cases en dessous indiquent les groupes secondaires existants.

S'il vous plaît, notez que cet écran (ainsi que le reste de la gestion des utilisateurs de Coppermine) ne sera pas disponible si vous avez activé une passerelle, car alors la gestion des utilisateurs de l'application que vous avez comme passerelle (par exemple, votre BBS) intervient et traite tout ce qui concerne la gestion des utilisateurs.

#### Droits sur les albums pour le groupe

Le lien "Droits sur les albums pour le groupe" vous permettra d'afficher les albums qui sont affectés exclusivement aux membres d'un groupe en particulier. Pour être tout à fait clair: cette fonctionnalité ne vous permet effectivement pas d'attribuer des albums à des groupes, il ne fait qu'afficher ces assignations. Pour attribuer des albums à des groupes en particuliers, utilisez la boîte de dialogue propriétés de l'album des albums individuels.

### Groupe d’appartenance

Lorsque vous créez un nouvel utilisateur ou modifiez un utilisateur existant, vous verrez une ligne nommée "Groupe de l'utilisateur" - elle détermine de quel(s) groupe(s) l'utilisateur est membre.
Le premier champ (un champ déroulant) détermine le groupe d'utilisateurs principal. Il détermine le statut d'un utilisateur. Vous devez le régler à "Administrateur" (pour les utilisateurs à qui vous souhaitez attribuer des pouvoirs d’administrateur) ou "Enregistré / Anonymes" pour les autres.
L’appartenance à un groupe complémentaire (secondaire) peut être assignée en cochant les cases sous le champ déroulant. Ici, tous les vos groupes personnalisés (que vous pouvez créer et de gérer l'aide du panneau de configuration des groupes) devraient être visibles ainsi que les groupes de base ((principaux) ceux qui sont crées par Coppermine au départ et qui ne peuvent être supprimés). L'assignation d’un membre à un groupe supplémentaire se fait ici. Les privilèges que possède un utilisateur particulier s’additionnent, il hérite de l'appartenance aux groupes: les autorisations les moins restrictives sont prises en compte.

Si vous voulez que vos utilisateurs "enregistrés" soient capables de visualiser votre galerie, mais que seulst vos utilisateurs privilégiés de votre groupe d'utilisateurs personnalisé "photographes" soient autorisés de télécharger des fichiers, vous devez intégrer tous les membres de vos utilisateurs dans le groupe "enregistré" (par défaut, ils le sont déjà). Uniquement pour les utilisateurs à qui vous voulez donner le privilège de télécharger, cochez la case à cocher "photographes" dans le groupe secondaire. Ensuite, allez à votre panneau de configuration des groupes et mettez autorisé sur "oui" dans "Téléchargement dans les Albums Publics" pour le groupe "photographes" et non pour le groupe "enregistrés".

Note: Le bouton "Droits sur les Albums pour le Groupe" sous les cases à cocher n'est pas destiné à attribuer des autorisations d'albums, mais seulement pour vérifier les permissions. Vous ne pouvez donner des autorisations sur l'album que par les propriétés de l’album.

## Mot de passe perdu

Il y a de nombreux mots de passe que vous devez mémoriser, et il ya de nombreuses questions qui sont liées aux mots de passe. Toutes ne s'appliquent pas à Coppermine, nous n'en parlerons donc que brièvement ici. Si vous avez besoin de plus de détails sur les questions de mots de passe qui ne sont pas liés à Coppermine, c'est une bonne idée d'utiliser un moteur de recherche et / ou l’aide à votre hébergeur.

### Mot de passe de compte d'utilisateur de Coppermine

Il n'y a pas de différence entre un administrateur et un compte d'utilisateur non-administrateur: ils fonctionnent tous les deux de la même façon: vous devez vous connecter en fournissant un nom d'utilisateur (ou une adresse e-mail si vous avez activé l'option correspondante dans la configuration de Coppermine) et un mot de passe. Si cette authentification a été réussie, c'est à dire si Coppermine vous "connait", cela lui permettra de déterminer si votre compte d'utilisateur appartient au groupe administrateur ou non. Sur la base de cette appartenance à un groupe, vous aurez différents privilèges.
Il ya cependant une différence fondamentale entre Coppermine fonctionnant en mode autonome (classique) et Coppermine fonctionnant via une passerelle avec une autre application:

#### Coppermine en mode autonome

Les tables de la base de données des utilisateurs de Coppermine ne contiennent pas le mot de passe utilisateur réel en texte brut, mais seulement un hachage MD5 encrypté. Voyez ce hachage comme une somme de contrôle: en fait c'est le résultat d'un calcul: lorsque le mot de passe est inscrit sur l'écran de connexion de Coppermine, le navigateur envoie le mot de passe que le visiteur a entré, vers le serveur. Le serveur calcule ensuite la valeur de hachage qui résulte du mot de passe entré par le visiteur et compare enfin, la valeur de hachage stockées dans la table de base de données a celle qui vient d'être calculée. Si ces valeurs de hachage sont égales, le mot de passe est considéré comme correct et l'utilisateur est authentifié, c'est à dire qu'un cookie est stocké sur l'ordinateur du visiteur qui dit en gros "L'utilisateur avec le nom d'utilisateur XYZ à réussi l’authentification". Encore une fois, aucun mot de passe n’est stocké nulle part.
Cela étant dit, il devrait être évident que vous ne pouvez pas voir le mot de passe n'importe où, simplement parce qu'il n'est pas réellement stocké quelque part.
Mais alors, nous sommes tous humains, donc il se peut que vous (en tant que propriétaire d'une galerie Coppermine) ou vos utilisateurs oublient leur mot de passe pour une raison quelconque. C'est pourquoi il existe un mécanisme pour s'assurer que vous puissiez vous connecter à nouveau. Malheureusement, vous ne pouvez pas envoyer un rappel de mot de passe à l'intérieur d’un e-mail à l'utilisateur, tout simplement parce que le serveur n'a pas connaissance du mot de passe. C'est pourquoi il existe un lien sur l'écran de connexion de Coppermine qui est nommé "J'ai oublié mon mot de passe". Si un visiteur clique dessus, il / elle sera envoyée à un écran de rappel de mot de passe où il / elle peut entrer son adresse e-mail. Mais attendez une minute! N'avez-vous pas simplement dit que le serveur ne connaît pas le mot de passe et donc il ne peut pas l'envoyer par e-mail ? Et oui, c'est vrai. En fait, c'est un processus en trois étapes: le visiteur peut entrer son adresse e-mail. Si un utilisateur avec cette adresse email existe dans la table users de Coppermine, un email est envoyé à cette adresse qui contient essentiellement un lien que le destinataire de l'email doit cliquer pour vérifier qu'il a effectivement oublié son mot de passe et veut en demander un nouveau. Ceci est conçu comme une mise en garde contre le vandalisme, pour s'assurer que personne ne vous bloque en ayant demandé un nouveau mot de passe pour lui. Le lien à l'intérieur du courriel contient un symbole qui ne peut pas être devinés ou composé: il est unique. Ce n'est que si ce lien est effectivement cliqué que le rappel de mot de passe est déclenché. Le serveur attribue alors un nouveau mot de passe aléatoire pour le compte qui correspond à l'adresse e-mail et envoie ce nouveau mot de passe dans un autre e-mail. Avec ce nouveau mot de passe qui est dans le second e-mail, l'utilisateur peut se connecter de nouveau.
Il s'agit d'un processus très élégant et à toute épreuve une fois qu'il est correctement configuré, mais il y a bien sûr certaines choses qui peuvent mal se passer:

- L'utilisateur doit connaître l'adresse e-mail, qui lui a permi de créer son compte utilisateur
- L'utilisateur doit avoir accès à l'adresse e-mail, et il a besoin de se rappeler le mot de passe (pas de Coppermine) pour le compte e-mail
- L'adresse e-mail qui correspond au compte d'utilisateur doit être remplie en premier lieu, ce qui pourraient ne pas être le cas pour l'administrateur s'il a omis d’en fournir une pour son propre compte
- Le serveur doit être configuré correctement pour pouvoir envoyer des courriels
- Le courriel envoyé par le serveur peut être bloqué par erreur par des mécanismes de filtrage de type anti-spam

Si tel est le cas en ce qui vous concerne, c'est-à-dire, si vous avez oublié votre mot de passe de compte administrateur de Coppermine, voici les choses à faire:

- Si vous avez accès à phpMyAdmin, il suffit de définir un nouveau mot de passe pour votre compte d'utilisateur de Coppermine. Voici les instructions qui ont été initialement publié en tant que contribution d’utilisateurs sur le forum d'aide de Coppermine:
  Une fois que vous êtes dans le phpMyAdmin, vous verrez les bases de données sur la gauche. Cliquez sur la base de données de Coppermine. Sur la gauche vous pourrez voir les tables.
  Cliquez sur la table nommée `XXX_users`, où XXX est le préfixe de table que vous avez choisi lors de l'installation de Coppermine initiale (d’origine, le préfixe est `cpg15x_`, de sorte que le nom de la table par défaut doit être `cpg15x_users`). Puis cliquez sur l'icône à gauche du texte sinon vous ne verrez pas le contenu de la table à droite de l'écran.
  Si vous avez perdu votre mot de passe d’administrateur regardez la colonne intitulée user_id. Recherchez le 1. C'est compte administrateur que vous avez créé lors de l'installation initiale. A la gauche de cette colonne il y a une icône représentant crayon (c'est à dire modifier). Cliquez sur ce lien.
  Vous devriez avoir maintenant des champs, dans lesquels vous pouvez écrire.
  A la droite de la ligne `user_password` se trouve le mot de passe crypté. Effacer le et remplacer par .
  Que fera le mot de passe `admin`. Ne laissez en aucun cas le champ mot de passe vide. Allez au bas de la page et cliquez sur `Exécuter` en `sauvegardant`. Vous pouvez maintenant sortir de phpMyAdmin en allant à l'icône de la sortie dans le coin supérieur gauche.
  Tapez l'URL de votre page de Coppermine. Connectez-vous avec votre nom d'utilisateur et le mot de passe `admin`. Une fois que vous êtes connecté avec succès, vous devez bien entendu modifier le mot de passe pour mettre autre chose que `admin`. Cliquez sur "Mon profil", allez vers le bas de la page et cliquez sur "Changer mon mot de passe". Entrez dans "Mot de Passe actuel" `admin` puis votre nouveau mot de passe (vous devez l’entrer deux fois) et validez le formulaire. Si tout va bien, vous verrez un message qui le dit: "Votre Mot de Passe a été modifié".
  Vous pouvez faire le même processus pour les utilisateurs: Pour accéder au profil d'un utilisateur, vous ouvrez une session en tant qu'administrateur. Allez dans le panneau de gestion des utilisateurs, modifier le compte d'un utilisateur en cliquant sur l'icône d'édition () à côté du nom de l'utilisateur, puis entrer un nouveau mot de passe dans le champ correspondant.
  Une autre alternative utilisant phpMyAdmin sans rien changer est d'utiliser un site avec une table arc-en-ciel et de chercher le mot de passe qui correspond au hachage que vous vous trouvez dans phpMyAdmin.
- Si vous n'avez pas accès à phpMyAdmin, vous pouvez procéder comme suit pour créer un nouveau compte administrateur:
  - Utilisez votre éditeur de texte favori (notepad++ est très bien) afin de créer un fichier texte avec ce contenu: <?php define('IN_COPPERMINE', true); require('include/init.inc.php'); define('ADMIN_PHP', true); $sql="UPDATE `{$CONFIG['TABLE_USERS']}` SET user_name='tempadmin', user_active='YES', user_password='098f6bcd4621d373cade4e832627b4f6' WHERE user_id='1'"; cpg_db_query($sql); pageheader('Create admin user'); starttable('-1', 'Please delete this file after account creation!', 2); echo <<< EOT <tr> <td class="tableh2"> Username: </td> <td class="tableb"> tempadmin </td> </tr> <tr> <td class="tableh2"> Password: </td> <td class="tableb"> test </td> </tr> EOT; endtable(); pagefooter(); ?>
  - Nommez le fichier `adminpass.php` et téléchargez le sur votre serveur web à la racine du dossier de Coppermine
  - Exécutez le fichier dans votre navigateur en entrant l'URL du fichier que vous venez de télécharger (quelque chose comme `http://votredomaine.fr/le_dossier_de_coppermine/adminpass.php`) dans la barre d'adresse de votre navigateur
  - Important: supprimer le fichier adminpass.php de votre serveur une fois l’opération fini - c'est un grand danger pour votre site si vous ne le faite pas !
  - Connectez-vous avec le nouvel utilisateur que le script a créé pour vous.

#### Coppermine et les passerelles

Lorsque Coppermine fonctionne avec une passerelle (bridge), la gestion des utilisateurs de l'application de la passerelle "prend le relais", donc si un visiteur clique sur le lien Connexion dans Coppermine, il est redirigé vers l’écran de connexion de transition de l’application de la passerelle. Après une connexion réussie, il / elle risque d'être renvoyé dans votre galerie Coppermine (si votre application prend en charge la redirection de transition après la connexion). Coppermine est seulement «conscient» que l'utilisateur a été authentifié dans votre application de transition; Coppermine n'est pas au courant du mot de passe de l'utilisateur. Par la suite, vous ne pouvez pas utiliser les mécanismes de Coppermine pour récupérer les mots de passe perdus pour les comptes d'utilisateurs lorsque vous êtes avec une passerelle. Si votre application fournit des mécanismes permettant de retouver votre mot de passe, utiliser ses mécanismes.

### Mot de passe mySQL

Si vous (ou votre hébergeur) changez des détails de votre compte mySQL (par exemple, si vous avez attribué un nouveau mot de passe à votre compte mySQL), vous devez tenir compte de vos modifications dans Coppermine en éditant le fichier `include/config.inc.php`.
S'il vous plaît garder à l'esprit que vous ne pouvez que refléter les changements de votre base de données mySQL dans ce fichier. Coppermine ne peut pas vraiment changer le mot de passe de votre compte MySQL lui-même. Si vous voulez faire ce changement (c'est à dire votre mot de passe MySQL compte administrateur), utiliser n'importe quel mécanisme que votre hébergeur fournit pour accomplir ou demandez à votre hébergeur de le changer pour vous.