| 1 | <!-- Keeps file coded in UTF-8 without BOM : é --> |
|---|
| 2 | |
|---|
| 3 | <h1>Event Cats</h1> |
|---|
| 4 | |
|---|
| 5 | <h3>Log in an account thanks to a single URL; duplicate an account</h3> |
|---|
| 6 | |
|---|
| 7 | <h5><span style = "font-style:italic;">Display directly: <a href = "#principes">Principles</a>, <a href = "#onglets">Tabs</a>, <a href = "#remerciements">Acknowledgements</a></span></h5> |
|---|
| 8 | |
|---|
| 9 | <h2><a name = "principes">Principles</a></h2> |
|---|
| 10 | |
|---|
| 11 | <p> |
|---|
| 12 | Event Cats allows to log in a user in Piwigo, without providing username and password <span style = "text-decoration:underline;">("autolog")</span>. It also allows that an account created by a visitor gets immediately the same access than another account <span style = "text-decoration:underline;">("duplication")</span>.<br /> |
|---|
| 13 | <br /> |
|---|
| 14 | The purpose is to allow you, after an event where you "have been the photographer", to share your pictures a very simple way with people not having (yet) an account on your gallery, but still publishing your images in a <span style = "text-decoration:underline;">private</span> category. But maybe is there other ways to use it :-) ... |
|---|
| 15 | </p> |
|---|
| 16 | <hr width = "5%" align = "center"> |
|---|
| 17 | <p> |
|---|
| 18 | The automatic identification is carried out thanks to the "autolog" code, placed in the link that you give to the people whom you want to give access to. The visitors using this link find themselves directly logged in on your gallery under the account associated to the "autolog" code. The page displayed just after the identification can be: |
|---|
| 19 | <ul> |
|---|
| 20 | <li>home page;</li> |
|---|
| 21 | <li>a category page;</li> |
|---|
| 22 | <li>a picture;</li> |
|---|
| 23 | <li>a page from plugin "<a href = "http://fr.piwigo.org/ext/extension_view.php?eid=153" title = "Open a window on plugin Additional Pages" onclick = "window.open(this.href); return false;">Additional Pages</a>", provided of course that this plugin is installed and activated, and that at least one of its page is available.</li> |
|---|
| 24 | </ul> |
|---|
| 25 | Once identified, your visitors can create an account — a personal one — having the same properties than the account under which they were previously identified. One can this way create his own account and have immediately access to private content on your gallery, without to wait for a validation from you. You can grant or deny account duplication, the same way you grant or deny access to a private category, selecting groups, account status, or accounts individually. |
|---|
| 26 | </p> |
|---|
| 27 | <p> |
|---|
| 28 | The link (URL) allowing automatic identification on your gallery, is built as following: |
|---|
| 29 | <ul><li style = "list-style-type:none;">http://<span style = "font-style:italic;">‹your gallery location›</span><span style = "font-weight:bold;">&autolog=<span style = "font-style:italic;">‹code›</span></span></li></ul> |
|---|
| 30 | When the user shall be redirected on another page than the home page, the following parameters are added: <span style = "font-weight:bold;">&cat=<span style = "font-style:italic;">‹category identifier›</span></span> for a category, <span style = "font-weight:bold;">&img=<span style = "font-style:italic;">‹image identifier›</span></span> for an image (in addition of category parameter), and <span style = "font-weight:bold;">&ap=<span style = "font-style:italic;">‹Add. P. identifier›</span></span> for a page from plugin Additional Pages. If an autolog URL is submitted with an <span style = "font-weight:bold;">&img</span> parameter without category, the displayed page is the home page. If an autolog URL is submitted with both an <span style = "font-weight:bold;">&ap</span> and a <span style = "font-weight:bold;">&cat</span> parameter (with or without the <span style = "font-weight:bold;">&img</span> parameter), the displayed page is the Additional Page.<br /> |
|---|
| 31 | </p> |
|---|
| 32 | <p></p> |
|---|
| 33 | |
|---|
| 34 | <h2><a name = "onglets">Onglets</a></h2> |
|---|
| 35 | |
|---|
| 36 | <p> |
|---|
| 37 | Event Cats vous propose jusqu'à cinq onglets pour contrôler son fonctionnement : |
|---|
| 38 | <ul> |
|---|
| 39 | <li><a href = "#autolog_new">Création autolog</a> ;</li> |
|---|
| 40 | <li><a href = "#autolog_entries">Entrées autolog</a> <span style = "font-style:italic;">(lorsqu'il existe au moins une entrée "autolog")</span> ;</li> |
|---|
| 41 | <li><a href = "#autolog_modif">Modification autolog</a> <span style = "font-style:italic;">(lorsqu'il existe au moins une entrée "autolog")</span> ;</li> |
|---|
| 42 | <li><a href = "#duplication">Duplication</a> <span style = "font-style:italic;">(lorsque "Autorisation de la duplication" a pour valeur "Sélection par groupes")</span> ;</li> |
|---|
| 43 | <li><a href = "#config">Configuration générale</a>.</li> |
|---|
| 44 | </ul> |
|---|
| 45 | </p> |
|---|
| 46 | |
|---|
| 47 | <p> |
|---|
| 48 | <h4><a name = "autolog_new">Création autolog</a></h4> |
|---|
| 49 | <p> |
|---|
| 50 | Cet onglet permet de créer les entrées dans la base de données. Une entrée associe un code à un utilisateur et à une page affichée. Il est possible qu'un même code soit utilisé plusieurs fois, dans le cas où il serait pratique de donner accès à des pages différentes, à un même compte. Mais un même code ne peut bien sûr être associé qu'à un seul compte.<br /> |
|---|
| 51 | <br /> |
|---|
| 52 | Lors de la création d'une entrée, il est possible de créer aussi le compte utilisé dans cette entrée. Les comptes créés par Event Cats sont des comptes génériques, c'est-à-dire prévus pour être utilisés par plusieurs visiteurs différents. Le nom du compte peut être généré par Event Cats, si une page à afficher a été sélectionnée, car c'est l'intitulé de la page affichée qui est utilisée pour créer le nom du compte. Event Cats peut aussi créer un groupe, qui sera associé à la catégorie sélectionnée le cas échéant, et comme le code aussi peut être généré par Event Cats, il est possible de créer une entrée dans Event Cats simplement en sélectionnant une page à afficher puis en appuyant sur "Tout automatique".<br /> |
|---|
| 53 | <br /> |
|---|
| 54 | Comme la page à afficher est mentionnée dans l'URL (avec les paramètres <span style = "font-weight:bold;">&cat=<span style = "font-style:italic;">‹identifiant catégorie›</span></span>, <span style = "font-weight:bold;">&img=<span style = "font-style:italic;">‹identifiant image›</span></span>, <span style = "font-weight:bold;">&ap=<span style = "font-style:italic;">‹identifiant add. p.›</span></span>, voir ci-dessus), l'utilisateur a la possibilité de changer la page affichée en modifiant l'URL. Si le compte associé au code n'est pas autorisé à afficher cette page, Piwigo ne l'affichera pas — pas de danger. Mais pour éviter l'affichage du message "Vous n'êtes pas autorisé sur la page demandée", vous pouvez demander à ce que la page affichée soit "forcée", c'est-à-dire que Event Cats redirige l'utilisateur vers la page prévue par vous lors de la création de l'entrée, quels que soient les éventuels paramètres <span style = "font-weight:bold;">&cat</span>, <span style = "font-weight:bold;">&img</span>, et/ou <span style = "font-weight:bold;">&ap</span> présent(s) dans l'URL utilisé par les visiteurs.<br /> |
|---|
| 55 | <br /> |
|---|
| 56 | Le champ "Commentaire" est totalement facultatif, il a pour seul but de vous permettre d'enregistrer un petit texte à votre guise, affiché dans la liste des codes (onglet <a href = "#autolog_entries">Entrées autolog</a>) sous forme d'info-bulle ou en-dessous des codes. |
|---|
| 57 | </p> |
|---|
| 58 | |
|---|
| 59 | <h4><a name = "autolog_entries">Entrées autolog</a></h4> |
|---|
| 60 | <p> |
|---|
| 61 | Cet onglet, disponible une fois qu'au moins une entrée "autolog" existe pour votre galerie, permet de visualiser les entrées déjà présentes dans votre base de données. Lorsque vous sélectionnez une entrée, l'URL qui lui correspond s'affiche dans le champ "URL" pour vous permettre de copier le lien d'identification automatique vers votre "catégorie événement" :-) , et de le coller par exemple dans un courriel à destination des intéressé(e)s. Sur la plupart des navigateurs, cliquer sur "URL" permet de sélectionner directement tout le champ, vous n'avez plus qu'à copier.<br /> |
|---|
| 62 | <br /> |
|---|
| 63 | Vous disposez des outils suivants dans cette page : |
|---|
| 64 | <ul> |
|---|
| 65 | <li style = "list-style-image:url(plugins/event_cats/icon/disable.png);"> |
|---|
| 66 | <span style = "font-weight:bold;">Rendre l'entrée périmée</span> : cet outil permet de faire en sorte que le code de l'entrée sélectionnée soit reconnu par Event Cats, mais que le visiteur ne soit <span style = "font-weight:bold;">pas</span> identifié.<br />Lorsque vous cliquez sur cet outil, si le plugin Additional Pages est utilisable, c'est l'onglet <a href = "#autolog_modif">Modification autolog</a> qui est affiché ; sinon, l'entrée est directement modifiée avec comme page affichée "Accès refusé" (après confirmation de votre part). Cela vous permet de ne laisser un code actif qu'un certain temps, après quoi les "retardataires" sont redirigés vers la page que vous aurez choisie. En effet, l'identification automatique peut permettre à des personnes non autorisées de visualiser un contenu privé, aussi peut-il être pratique de ne prendre ce risque que pendant un temps limité. Un excellent outil pour prévenir que vous prévoyez de rendre périmée une identification automatique, est le plugin <a href = "http://fr.piwigo.org/ext/extension_view.php?eid=190" title = "Ouvrir une nouvelle fenêtre sur le plugin PWG Suffs" onClick = "window.open(this.href);return false;">PWG Suffs</a>. |
|---|
| 67 | </li> |
|---|
| 68 | <li style = "list-style-image:url(plugins/event_cats/icon/forced.png);"> |
|---|
| 69 | <span style = "font-weight:bold;">Ne plus rendre l'entrée forcée</span> : cet outil revient à décocher la case "Forcé" dans l'onglet <a href = "#autolog_modif">Modification autolog</a>. Vous aurez ainsi la possibilité de créer d'autres entrées avec le même code ; et les utilisateurs de cet URL pourront tenter de le modifier (voir <a href = "#autolog_new">Création autolog</a> ci-dessus). |
|---|
| 70 | </li> |
|---|
| 71 | <li style = "list-style-image:url(plugins/event_cats/icon/nforced.png);"> |
|---|
| 72 | <span style = "font-weight:bold;">Forcer l'entrée</span> : cet outil permet de forcer la page affichée pour une entrée (voir <a href = "#autolog_new">Création autolog</a> ci-dessus). |
|---|
| 73 | </li> |
|---|
| 74 | <li style = "list-style-image:url(plugins/event_cats/icon/duplicate.png);"> |
|---|
| 75 | <span style = "font-weight:bold;">Recopier l'entrée</span> : cet outil permet d'afficher l'onglet <a href = "#autolog_new">Création autolog</a> en y ayant sélectionné directement l'entrée à recopier, afin de créer une nouvelle entrée utilisant le même code (et donc le même compte identifié), mais en changeant la page affichée. |
|---|
| 76 | </li> |
|---|
| 77 | <li style = "list-style-image:url(plugins/event_cats/icon/url2.png);"> |
|---|
| 78 | <span style = "font-weight:bold;">Tester l'URL</span> : cet outil permet de vérifier que l'URL fonctionne bien comme prévu. Attention : en cliquant sur ce lien, vous terminez évidemment votre session d'administration sur votre site. |
|---|
| 79 | </li> |
|---|
| 80 | <li style = "list-style-image:url(plugins/event_cats/icon/delete.png);"> |
|---|
| 81 | <span style = "font-weight:bold;">Supprimer l'entrée</span> : cet outil permet de supprimer l'entrée.<br />A savoir que si un visiteur utilise un URL comportant un code "autolog" qui n'existe pas dans la base de données (donc par exemple un code que vous auriez fourni à un moment, puis supprimé), vous pouvez choisir dans l'onglet <a href = "#config">Configuration générale</a> vers quelle page il sera redirigé. |
|---|
| 82 | </li> |
|---|
| 83 | <li style = "list-style-image:url(plugins/event_cats/icon/modify.png);"> |
|---|
| 84 | <span style = "font-weight:bold;">Modifier l'entrée</span> : cet outil permet d'afficher l'onglet <a href = "#autolog_modif">Modification autolog</a> avec l'entrée directement sélectionnée. |
|---|
| 85 | </li> |
|---|
| 86 | </ul> |
|---|
| 87 | </p> |
|---|
| 88 | <h4><a name = "autolog_modif">Modification autolog</a></h4> |
|---|
| 89 | <p> |
|---|
| 90 | Cet onglet, disponible lui aussi une fois qu'au moins une entrée "autolog" existe pour votre galerie, permet de modifier une entrée (si si...). Contrairement au moment de la création d'une entrée, vous pouvez rendre là l'entrée "périmée", en choisissant "Aucun" comme "Utilisateur identifié" ou "Accès refusé" comme "Page affichée". Si "Aucun" est sélectionné pour "Utilisateur identifié", et que le plugin Additional Pages est utilisable, il est possible de choisir une page Additional Pages comme page affichée. Vous avez ainsi la possibilité de désactiver un code, mais en affichant une explication personnalisée (voir l'explication sur <img src = "plugins/event_cats/icon/disable.png"> <span style = "font-weight:bold;">Rendre l'entrée périmée</span> dans le paragraphe sur l'onglet <a href = "#autolog_entries">Entrées autolog</a>). |
|---|
| 91 | </p> |
|---|
| 92 | <h4><a name = "duplication">Duplication</a></h4> |
|---|
| 93 | <p> |
|---|
| 94 | Cet onglet n'est disponible que lorsque le paramètre "Autorisation de la duplication" a pour valeur "Sélection par groupes". En effet, il est inutile lorsque la duplication est autorisée pour tous les comptes, ou pour aucun.<br /> |
|---|
| 95 | Il vous permet de contrôler la duplication : quels comptes pourront être dupliqués, et la façon dont le lien s'affichera. La sélection des comptes s'effectue de la même façon que la page "Gérer les permissions pour une catégorie" (la page a tout simplement été recopiée :-/ ...).<br /> |
|---|
| 96 | La façon dont le lien s'affiche permet principalement de ménager les visiteurs identifiés sous un compte générique (le type de compte utilisé par Event Cats pour une création de compte) : si un visiteur a utilisé un lien activant un code "autolog", il est identifié sans avoir fourni de nom d'utilisateur et de mot de passe. Il n'est donc a priori pas conscient qu'il peut "recopier" ce compte, et il est donc inutile de lui proposer la "duplication", terme pouvant alors s'avérer incompréhensible. On lui donne tout simplement la possiblité de "S'enregistrer", et, sans que cela soit évoqué, s'il s'enregistre (alors qu'il est en fait déjà identifié), il obtient immédiatement les mêmes droits que le compte sous lequel il était précédemment identifié, et peut ainsi continuer à naviguer sur votre galerie dans les même catégories que le compte associé au code "autolog" que vous avez fourni, mais sous son compte personnel, avec les avantages que cela apporte : personnalisation, nommage des commentaires... L'enregistrement se passe sinon de la même façon que par la procédure "normale", et vous êtes averti que votre galerie compte un nouvel utilisateur. Il n'y a, à l'heure où j'écris, pas d'incompatibilité connue avec le plugin <a href = "http://fr.piwigo.org/ext/extension_view.php?eid=216" title = "Ouvrir une nouvelle fenêtre sur le plugin NBC UserAdvManager" onClick = "window.open(this.href);return false;">NBC UserAdvManager</a> (gestion avancée des utilisateurs). |
|---|
| 97 | </p> |
|---|
| 98 | <h4><a name = "config">Configuration générale</a></h4> |
|---|
| 99 | <p> |
|---|
| 100 | Ce dernier onglet permet d'ajuster les paramètres suivants : |
|---|
| 101 | <ul> |
|---|
| 102 | <li><span style = "font-weight:bold;">Duplication</span> : mêmes paramètres généraux que dans l'onglet <a href = "#duplication">Duplication</a> ;</li> |
|---|
| 103 | <li><span style = "font-weight:bold;">Code inconnu</span> : page que doit afficher votre galerie dans le cas où le visiteur utilise un URL comportant un code "autolog" ne faisant pas partie de la liste actuelle de vos codes (donc, par exemple, dans le cas de l'utilisation d'un code que vous avez supprimé) ;</li> |
|---|
| 104 | <li><span style = "font-weight:bold;">Autres</span> : |
|---|
| 105 | <ul> |
|---|
| 106 | <li>vous pouvez enregistrer un commentaire pour chacun de vos codes : celui-ci peut être affiché dans l'onglet <a href = "#autolog_entries">Entrées autolog</a> soit en info-bulle, soit en-dessous des codes ;</li> |
|---|
| 107 | <li>si le bandeau d'aide est activé, il sera montré à chaque fois que vous accèderez à un onglet, sinon il restera caché.</li> |
|---|
| 108 | </ul> |
|---|
| 109 | </li> |
|---|
| 110 | </ul> |
|---|
| 111 | </p> |
|---|
| 112 | </p> |
|---|
| 113 | <p></p> |
|---|
| 114 | |
|---|
| 115 | <h2><a name = "remerciements">Remerciements</a></h2> |
|---|
| 116 | |
|---|
| 117 | <p> |
|---|
| 118 | <ul> |
|---|
| 119 | <li><a href = "http://www.gauchon.fr" title = "Ouvrir une nouvelle fenêtre sur le site de P@t" onClick = "window.open(this.href);return false;">P@t</a> a fourni le code des fonctionnalités ; sans lui, Event Cats n'existerait pas ;-) ! ;</li> |
|---|
| 120 | <li><a href = "http://fr.piwigo.org/forum/profile.php?id=3572" title = "Ouvrir une nouvelle fenêtre sur le profil de ddtddt" onClick = "window.open(this.href);return false;">ddtddt</a> et <a href = "http://www.vdigital.org" title = "Ouvrir une nouvelle fenêtre sur le site de VDigital" onClick = "window.open(this.href);return false;">VDigital</a> ont permis d'accélérer de beaucoup le développement de ce plugin... (si si, si si, ç'aurait été vraiment <span style = "font-style:italic;">encore</span> plus long sinon...) ;</li> |
|---|
| 121 | <li><a href = "http://www.julien-moreau.fr" title = "Ouvrir une nouvelle fenêtre sur le site de Gotcha" onClick = "window.open(this.href);return false;">Gotcha</a> a tout fait pour me ralentir... en me faisant corriger ce qui était le moins heureux ;-) ;</li> |
|---|
| 122 | <li><a href = "http://piwigo.wordpress.com" title = "Ouvrir une nouvelle fenêtre sur le site de plg" onClick = "window.open(this.href);return false;">plg</a> a aussi contribué quelquepart, mais je sais plus bien pourquoi, déjà ??... ;</li> |
|---|
| 123 | <li>et puis le forum en général (flipflip, flop25...), rien de tel pour avancer !</li> |
|---|
| 124 | <li>Et, <span style = "font-style:italic;">last but not least</span>, <span style = "font-weight:bold;">vous</span> : en ayant téléchargé ce plugin ; si possible en l'utilisant ; et éventuellement en postant remarques, critiques, commentaires et demandes de modification : <a href = "http://fr.piwigo.org/forum/viewtopic.php?id=15641" title = "Ouvrir une nouvelle fenêtre sur la discussion Event Cats" onClick = "window.open(this.href);return false;">discussion Event Cats sur le forum Piwigo.fr</a>.</li> |
|---|
| 125 | </ul> |
|---|
| 126 | </p> |
|---|
| 127 | |
|---|
