🌍
English
Differences
|
user_documentation:tools:picasa2piwgo [2013/02/15 19:29] 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. | ||
| - | * Transfer photos, face tags, tags, and photo captions 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 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 Settings ==== | + | ==== Application Usage ==== |
| - | {{:application_screenshot.jpg?direct|}} | + | 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: |
| - | **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 | + | {{::picasa2piwigo_main_form.jpg?|}} |
| - | **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. | + | 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. |
| - | **Output Path** – Location where text and html output files are placed. | + | ==== Application Options ==== |
| - | **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. | + | Upon first usage of the extension, you must enter information about your connection to Piwigo: |
| - | **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 | + | {{::optionform.jpg?|}} |
| - | **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. | + | **Piwigo Server URL** - The URL to your Piwigo server. |
| - | **Server Name** – The IP address of the mySQL server. | + | **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. |
| - | **Database** – The name of database used by Piwigo. Usually it’s piwigo. | + | **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 |
| - | **Database User Name** – A mySQL account that has read/write access to the Piwigo database. I use root. | + | ==== Limitations ==== |
| - | **Database Password** – You know. | + | **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. |
| - | **Database Table Prefix** – The prefix of the Piwigo database tables. Usually it’s piwigo. | + | **Types of Files ** - Picasa2Piwigo supports photo files only. The tool is unable to upload video files to 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. | + | **Maximum Number of People Tags ** - Picasa2Piwigo accommodates up to 2,000 people tags. |
| - | ==== Tips ==== | + | ==== Known Issues (to be resolved in future releases) ==== |
| - | + | ||
| - | * 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 ==== | + | |
| - | * 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. | + | |
| - | + | ||
| - | * 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. | + | |
| - | * 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 ==== | ||