This is an old revision of the document!
La FAQ est en cours d'élaboration et pour première conséquence, elle est loin d'être structurée. Elle est même insuffisante à ce jour. Merci d'avance aux visiteurs de leur compréhension.
Je n'ai pas encore installé PWG et je me pose bien des questions, peut-être vais-je trouver des réponses ici.
Je suis décidé, mais voilà, c'est bien la première fois que je vais faire ça. Ce ne sont pas les questions qui manquent, mais les réponses.
Admin + Configuration + Général .
Admin + Configuration + Affichage par défaut
Développer toutes les catégories Oui / Non
Dans le fichier include/mysql.inc.php
.
Mais si vous vous posez cette question, c'est que vous n'avez pas encore démarré le processus d'installation et votre fichier include/mysql.inc.php est encore vide.
En serveur mutualisé (fournisseur d'accès par exemple): un processeur sera monopolisé dans la limite de 30 secondes en général. Votre site apparaitra en rouge dans le suivi de votre site (monitoring), inutile d'en dire plus.
En serveur dédié (ou sur votre propre serveur): cela reste un problème et devra être apprécié en fonction du nombre de processeurs du serveur et des accès externes.
Cependant, si vous avez besoin d'un créateur automatique de miniatures, vous pouvez essayer de télécharger http://ahao.free.fr/Photo/SiteDistant.zip . Modifiez les paramètres du fichier config_create_miniature.php, puis uploadez-le à la racine du site concerné avec les autres fichiers. Lancez ce fichier depuis votre navigateur, et voilà les miniatures sont crées :p Reste plus qu'à synchroniser PWG.
En fonction de la vitesse de votre ordinateur, ce réglage permettra en moyenne de créer 300 à 600 miniatures avant la fin du l'exécution du script. Si cela se produit, cliquer simplement sur le lien “Miniatures”, sélectionner “Tout” pour le “Nombre de miniatures à créer,” puis cliquer sur Envoyer.
Pour obtenir des explications détaillées, connectez-vous à PWG et rendez-vous à la rubrique :
Admin → General → Instructions
Les catégories réelles (identiques à des albums photos) doivent être créés directement dans le fichier système du serveur, dans le sous-dossier galleries
. Il y a deux façons de procéder :
galleries
. Le nom que vous donnerez à ce sous-dossier sera celui affiché dans PWG. Si le système d'exploitation est de type Unix / Linux, ce sous-dossier DOIT être accessible en écriture par les utilisateurs. Evidentes à créer, mais l'association d'éléments avec les catégories est parfois plus complexe.
Rapidement les images prennent de la place, et l'hébergement est engorgé, alors la solution proposée par PhpWebGallery : La mise en oeuvre de sites distants.
Concernant les mods, je préconise la lecture du ”Comment installer un MOD? ” lorsqu'on a récupéré l'archive désirée. Cela évitera sans doute quelques mauvaises surprises.
Certaines actions doivent être évitées, lesquelles?
En savoir+
Règle d'or: Je ne synchronise pas si je n'ai pas réellement de nouvelles images.
1 - “Je n'ai pas trouvé de fichier config_local.inc.php alors j'ai modifié config_default.inc.php…” Bien sûr que vous n'avez pas trouvé ce fichier local, puisque que c'est à vous de le créer. Il n'est pas distribué: c'est votre fichier.
'default' est livré avec de nouveaux paramètres à chaque version. Si vous faites des modifs dans ce fichier, lors de la prochaine mise à jour vos modifications seront perdues et peut être que votre galerie ne fonctionnera plus. Donc, on ne modifie pas le fichier config_default.inc.php. On crée son config_local.inc.php.
2 - “J'ai recopié le fichier config_default.inc.php dans config_local.inc.php comme ça, je peux les changer tout à ma guise.”
Dans la version n+2 vous aurez peut être 200 paramètres en plus, pouvez-vous dire lesquels vous aurez déjà, ceux qui seront modifiés, ceux qui ne le seront pas.
Dans config_local.inc.php on ne mentionne que les $conf qu'on souhaite vraiment modifier.
3 - “Quand j'accède à ma galerie j'ai un message :”
Warning: Cannot modify header information - headers already sent by (output started at /.../include/config_**local**.inc.php:???) ...
PhpWebGallery tente de créer l'entête de bloc IP (ce n'est qu'un warning) mais cet entête (en principe unique) a déjà été créé.
“Par qui?” output started at… config_local.inc.php
“Oui, mais vous avez dit ci-dessus de le créer… Alors, je ne comprends plus rien.”
Nous avons dit de le créer mais pas de faire des erreurs quand même. Il se trouve qu'un module php comme config_local.inc.php doit suivre des règles strictes d'écriture entre autres, il doit commencer par:
<?php
et il doit se terminer par:
?>
De plus, aucun espace ou ligne vide ne doit être après cette dernière ligne !!! C'est en général ces dernières erreurs qui génèrent l'entête IP. D'ailleurs, dans ”(output started at /…/include/config_local.inc.php:???)” les ??? correspondent au numéro de ligne où se trouve l'erreur. Soit très souvent 10 ou plus.
4 - “J'ai fait un config_local.inc.php mais le paramètre n'est pas pris en compte. (Pire, parfois, mes anciens paramètres ne sont plus reconnus).” Il y a une erreur de syntaxe dans le config_local.inc.php:
dans votre navigateur lancer http://monsite/magalerie/include/config_local.inc.php
, cela peut vous aider à comprendre (l'erreur est sur la ligne ou sur la ligne précédente).
[En cours par Eric]
1 - Lancer la page ws.htm dans votre navigateur préféré.
2 - Une page vous demande de préciser la position du script WS (ws.php). Normalement, il doit se trouver sous 'http:\\www.monsite.com\magalerie\ws.php'.
3 - Cliquez alors sur “GO!”
4 - Il s'agit maintenant de choisir la bonne méthode en fonction du résultat désiré. Voici une traduction des termes :
5 - Votre choix fait, il suffit de cliquer sur la méthode pour obtenir le panneau de requêtes associé. Il serait trop long et fastidieux de détailler chaque méthode. Aussi, pour notre exemple, nous choisirons ici la méthode “pwg.categories.getImages” qui nous permettra de d'afficher aléatoirement des images ou leur version miniature selon différents critères.
6 - En utilisant la méthode “pwg.categories.getImages”, nous avons tout d'abord 2 paramètres à renseigner : Le format de la requête (Request format) et le format de la réponse (Response format):
: Je n'ai pas encore trouvé de cadre d'emploi pour POST…
: S'il y en a qui se sentent pour traiter le sujet des XML et autres…
7 - Dans la partie de droite, nous avons un tableau récapitulant tous les paramètres utilisables pour la méthode sélectionnée. Chaque méthode a un tableau de paramètre différent. Il serait trop long de tout détailler ici. Dans le cadre de notre exemple (méthode “pwg.categories.getImages”), voici les explications des différents filtres :
8 - Avec tous ces élements, il nous est maintenant possible de “jouer” avec l'outil pour tenter d'obtenir le résultat souhaité. La vérification du résultat produit se fait en cliquant sur les liens “Invoke” ou “Invoke (New window)”. Le premier lien affiche le résultat dans le cadre en dessous du tableau de paramètres quant au second, affiche dans une nouvelle fenêtre du navigateur. En poursuivant notre exemple, nous utiliseront les paramètres suivants :
Traduction : “Récupérer, sur une page, 5 images au hasard dans toutes les catégories et sous catégories dont la note moyenne est d'au moins 1.2.”
Autre exemple :
Traduction : “Récupérer, sur une page, 5 images au hasard, vues au moins 500 fois, dans toutes les catégories et sous catégories.”
9 - Un clic sur “Invoke” et on obtient un tableau sérialisé des données trouvées par la requête. Comme on a spécifié “Random” dans le paramètre “order”, on ne devrait pas retrouver deux fois le même résultat. Sauf, bien entendu, s'il n'y a pas assez d'images répondant aux critères. Le tableau est représenté sous la forme :
a:2:{s:4:“stat”;s:2:“ok”;s:6:“result”;a:1:{s:6:“images”; (…) “page_url”;s:72:“http://www.monsite.com/magalerie/picture.php?/[id]/category/[id]”;}}}}}}}
10 - Pas très évident de vérifier le bon fonctionnement de la requête sous cette forme, je vous l'accorde. Mais vous pouvez faire des essais en réduisant, par exemple, le nombre d'images à retourner.
A suivre…