🌍
English
Differences
|
user_documentation:tools:picasa2piwgo [2013/02/15 19:46] kenl |
user_documentation:tools:picasa2piwgo [2014/10/31 15:50] (current) kenl |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| Features: | Features: | ||
| * Easily transfer multiple photos from Picasa to Piwigo. | * Easily transfer multiple photos from Picasa to Piwigo. | ||
| - | * Transfers photos, face tags, tags, and photo captions from Picasa to existing or new albums in Piwigo. | + | * Transfer photos, face tags, tags, photo captions, and album descriptions from Picasa to existing or new albums in Piwigo. |
| - | The application can be downloaded from: tbd | + | The application can be downloaded from: http://piwigo.org/ext/extension_view.php?eid=680 |
| ==== Installation ==== | ==== Installation ==== | ||
| - Download the extension and unzip. | - Download the extension and unzip. | ||
| + | - After unzipping, there will be a list of directories. Each directory corresponds to a different language. Select your preferred installer language and enter the corresponding directory. | ||
| - Run setup.exe | - Run setup.exe | ||
| - | - Open install_button.htm in a web browser and click on the "Install the Picasa2Piwigo button into Picasa" link. | + | - Open the file, install_button.htm, in a web browser and click on the "Install the Picasa2Piwigo button into Picasa" link. Confirm installation into Picsasa. |
| ==== Application Usage ==== | ==== Application Usage ==== | ||
| Line 19: | Line 20: | ||
| After installation, a "2Piwigo" button will be placed on the bottom section of Picasa. To use, select one or more photos in Picasa and then click on the "2Piwigo" button. A dialog box will then be shown allowing you to upload the photo(s) to a new or existing Piwigo album. The dialog box looks like this: | After installation, a "2Piwigo" button will be placed on the bottom section of Picasa. To use, select one or more photos in Picasa and then click on the "2Piwigo" button. A dialog box will then be shown allowing you to upload the photo(s) to a new or existing Piwigo album. The dialog box looks like this: | ||
| - | {{:picasa2piwigo_main_form.jpg?|}} | + | {{::picasa2piwigo_main_form.jpg?|}} |
| + | |||
| + | The "Parent Album" and "Album" pull down lists will be automatically populated using information from your Piwigo server. Select "New Album" or "Add To Album", enter the appropriate information, and click the "Execute" button. | ||
| ==== Application Options ==== | ==== Application Options ==== | ||
| Line 25: | Line 28: | ||
| Upon first usage of the extension, you must enter information about your connection to Piwigo: | Upon first usage of the extension, you must enter information about your connection to Piwigo: | ||
| - | {{:optionform.jpg?|}} | + | {{::optionform.jpg?|}} |
| - | **Picasa Contacts File** – The contacts.xml file used by Picasa. In my case, the file was located at: c:\Users\admin\AppData\Local\Google\Picasa2\Contacts | + | **Piwigo Server URL** - The URL to your Piwigo server. |
| - | **Root Photo Path** – The directory where you want the application to start reading photos from. The application will traverse sub-directories and it ignores any .picasaoriginals directories. | + | **Piwigo User Name/Password** - A Piwigo user name/password that has rights to add photos to the server. Use a user name/password that has a piwigo status of "user" or better. |
| - | **Output Path** – Location where text and html output files are placed. | + | **Piwigo Contacts File** – The contacts.xml file used by Picasa. This is used to parse face tags from Picasa. In my case, the file was located at: c:\Users\admin\AppData\Local\Google\Picasa2\Contacts |
| - | **Generate HTML Files** – When checked, simple HTML files will be created for each contact, with hyperlinks to each photo that the particular contact appears in. It may be useful if you want a simple web page with links to people’s photos. | + | ==== Limitations ==== |
| - | **Base URL** – Used to create the start of the hyperlink to each photo. Leave a slash at the end like http://myurl.com/photos/, not http://myurl.com/photos | + | **Maximum Number of Files to Upload ** – Picasa limits the number of files supplied to add-ins to 120 files. So, the maximum number of files that can be uploaded at a time is 120. |
| - | + | ||
| - | **Set Tags in Piwigo** – When checked, the application will place Picasa face tags into the Piwigo database and tag corresponding photos. When the option is not checked, only text and html (if selected) files are generated. | + | |
| - | + | ||
| - | **Server Name** – The IP address of the mySQL server. | + | |
| - | + | ||
| - | **Database** – The name of database used by Piwigo. Usually it’s piwigo. | + | |
| - | + | ||
| - | **Database User Name** – A mySQL account that has read/write access to the Piwigo database. I use root. | + | |
| - | + | ||
| - | **Database Password** – You know. | + | |
| - | + | ||
| - | **Database Table Prefix** – The prefix of the Piwigo database tables. Usually it’s piwigo. | + | |
| - | + | ||
| - | **Clear Existing Face Tags in Piwigo** – When checked, deletes tags from the piwigo tag database before adding new tags. When checked, only face tags that appear in contacts.xml will be deleted from Piwigo. Other tags will not be affected. | + | |
| - | + | ||
| - | ==== Tips ==== | + | |
| - | + | ||
| - | * If you want to preview changes that will be made to the Piwigo databse, run the tool with “Set Tags in Piwigo” un-checked and examine the results in the output folder. | + | |
| - | ==== Technical Stuff ==== | + | **Types of Files ** - Picasa2Piwigo supports photo files only. The tool is unable to upload video files to Piwigo. |
| - | * Application will handle a maximum of 512 unique faces in Picasa. | + | |
| - | * If you’ve already tagged photos in piwigo using the application it will not re-tag them. So, it’s ok to run the application multiple times using the same photo directories. | + | **Maximum Number of People Tags ** - Picasa2Piwigo accommodates up to 2,000 people tags. |
| - | * This application was verified with Piwigo database version 2.4. The application validates the database version number and offers the user the chance to abort if there is a version mis-match. I can make no guarantees that the application will work with other database versions. Also, I’m sure the developers of Piwigo would prefer thatt users don’t directly change the database. However, in this case, I find it sensible. | + | ==== Known Issues (to be resolved in future releases) ==== |
| - | * It is possible to have duplicate filenames in Picasa with the duplicate filenames being in different directories. The application checks all duplicate filenames (up to 10,000) against the album names. So, even if there are duplicate filenames, it will be ok. | + | none at this time |
| ==== Issues or Suggestions ==== | ==== Issues or Suggestions ==== | ||