====== Piwigo Import Tree ======

Ce script peut être exécuté pour importer une arborescence de fichiers sur Piwigo.
A partir d'un répertoire défini, celui-ci et tous les sous-répertoires de l'arborescence sont déclinés en albums sous Piwigo, avec les images JPEG et leur description.

[[http://piwigo.org/ext/extension_view.php?eid=606|Page officielle de Piwigo Import Tree]] (Révisions & Téléchargement)


===== Pré-requis =====

Ce script nécessite Perl. Si celui-ci n'est pas installé, il peut être téléchargé depuis [[http://www.perl.org]] – ActiveState Perl et Strawberry Perl ont tous les deux été testés sous Windows7.


===== Utilisation =====

Ce script est exécuté avec les variables suivantes :

<code bash>perl piwigo_import_tree.pl
    --base_url=http://addresse/du/site/piwigo
    --user=robert
    --password=secret
    --directory="mon répertoire photos"</code>

Avec :

  * --user=robert est un administrateur de la galerie.
  * --directory="mon répertoire photos" est le chemin (relatif ou absolu) vers le répertoire racine de l'arborescence. (Si le nom du répertoire contient des espaces, encadrez le avec des doubles quotes)
  * --parent_album_id=NN est l'identifiant interne de l'album parent de Piwigo. Ce paramètre est optionnel.
  
Ces variables peuvent être saisie dans n'importe quel ordre. Les valeurs par défaut peuvent être modifiées dans le script avec Notepad et ensuite être omises à l'appel du script.

Si votre galerie Piwigo est chez piwigo.com, utilisez les paramètres comme suit :
<code bash>perl piwigo_import_tree.pl
    --base_url=http://VOUS.piwigo.com
    --user=VOUS
    --password=??
    --directory="mon répertoire photos"</code>


===== Utilisateurs Windows =====

Pour exécuter un script Perl, cliquer sur "Démarrer" puis "Exécuter" pour ouvrir un terminal.
Utiliser la commande "cd" pour vous placer dans le répertoire approprié. Il peut être utile de se placer à la racine de l'arborescence.
Utiliser alors la ligne de commande de l'exemple ci-dessus (le mieux est de la préparer avant de la copier/coller).

Le terminal déroulera alors la liste des albums et images envoyés à Piwigo.
Chaque image JPEG est transférée à la taille d'origine.


===== Titre des photos =====

En plus de cela, s'il existe un fichier Descript.ion dans le répertoire (comme ceux produits par Fotopic), il est lu et la légende de chaque image servira de titre pour les images de Piwigo. Ce fichier est constitué de lignes contenant le nom du fichier image et la légende séparés par une tabulation. Le nom par défaut de ce fichier peut être changé pour un autre nom de fichier texte.


===== Exécutions multiples pour synchroniser =====

La plus utile des fonctions de cet outil est que vous pouvez ajouter albums, images et descriptions dans l'arborescence et ré-exécuter le script pour ne transférer que les nouvelles images.


====== Pour aller plus loin... ======

<WRAP round mini-index>
__**Page(s) associé(s) :**__\\
{{backlinks>.}}
\\
<WRAP hi bigger centeralign center 500px>[[:sommaire|Retourner au sommaire du wiki]]</WRAP>\\
\\
</WRAP>


<wrap hide> MERCI DE NE PAS TOUCHER AUX LIGNES QUI SUIVENT.</wrap>
~~META:
mother = tools
&order = 50
~~