# Coppermine Photo Gallery v1.5.x: Documentation and Manual

# Using Windows XP Web Publishing Wizard with Coppermine

If you are using Windows XP, you can use its built-in web publishing wizard to upload your photos to your gallery.

Once you have properly installed the script on your server, call the xp_publish.php file from your web browser (http://your_site.com/coppermine_dir/xp_publish.php).

The script displays some information on how to do the installation on the client side and how to use the Wizard. Basically you will need to download a small file created by the script that needs to be loaded into your Windows registry.

If you want to allow your users to use the Windows XP Web Publishing Wizard, it's advisable to promote it by showing a link to the file somewhere on your page.

## Requirements

- XP Publisher is a Microsoft product. It will only run on Windows XP/Vista. It will only work if the client is using the Microsoft browser "Internet Explorer". Coppermine just provides a file to use the XP Publisher user interface. There is nothing that can be done to circumvent this. If you are not happy with the way the XP Publisher works or if you would like additional or different features, you will have to address Microsoft, not the Coppermine developers.
- As suggested above, the registry file needs to create a key in the user's registry. There needs to be a name for that key. That's why you need to have specified a name for your gallery and a gallery description in Coppermine's config.

## Setup

Before you can use the XP Web Publishing Wizard, it needs to know the address of the your gallery.

- Open your browser and type the following into the address box replacing "your_site.com" and "coppermine_dir" with your own Gallery address information : `http://your_site.com/coppermine_dir/xp_publish.php`
- On "File Download - Security Warning" click "Save" to save the cpg_###.reg file on your Desktop. (The ### represents a 10-digit numerical timestamp.)
- Open Windows Explorer
- Select Desktop from the left panel
- Double click on the file name that you just saved
- On Registry Editor's "Are you sure..." dialog click "Yes"

Above procedure needs to be done only once by users wishing to use the XP Publishing Wizard.

## Uploading pictures

The process of uploading pictures is a matter of following a simple dialog. It takes much longer to describe the process than do it.

- Start Windows Explorer and locate the directory with your photographs and select one or more pictures for upload.
- If the Windows Explorer left panel is not titled "Picture Tasks", click on the "X" in the top right corner of the panel to close it and to reveal the Picture Tasks panel.
- Select "Publish xxxx to the Web" from "File and Folder Tasks" on the left panel. "xxxx" could say "this file, these files or this folder" depending on what is highlighted on the right panel.
- On Web Publishing Wizard's Welcome screen click "Next".
- You can change your selection if necessary on the Thumbnail window showing up. Click "Next" when you are ready.
- From the service provider window highlight your Photo Gallery name and click "Next".
- Enter your Coppermine username and password to login to your gallery and click "Next".
- From the "Welcome username" window you have an option of uploading your picture(s) into one of the existing albums or starting a new album. Click "Next" when you are ready.
- Click "Next" in the upload starting confirmation window.
- Select the picture sizes for the uploaded pictures. If you are unsure about acceptable picture sizes, verify with your Gallery administrator. Click "Next" when you are ready.
- You are presented with the last window of the dialog and given a choice of opening the Gallery when the upload is complete.
- Click "Finish" to end the XP Web Publishing Wizard and to enter the Gallery to check the new album contents.
- In order to avoid the gallery being flooded by pictures uploaded through the wizard, only the gallery admins and users that can have their own albums can use this feature
- Once the upload has started, the wizard can't display any error message returned by the script so you can't know if the upload failed or succeeded until you check your gallery
- If the upload fails, the admin should enable "Debug mode" in Coppermine's config and try with one single picture and check error messages in the log file that is located in Coppermine's root directory on the server

## File structure

Many gallery admins prefer to have a physical folder and file structure within their albums folder that represents the logical category/album structure of the gallery. Using the XP Publisher, this folder/file structure can not be kept: files uploaded using the XP publishing wizard go into a folder within the albums-folder that matches a particular naming scheme: the wizard creates folders named "wpw-YYYYMMDD" (e.g. "wpw-20081026") and uploads the files into that folder. There is no way you can circumvent or alter this behaviour, but after all you don't have to: coppermine's database keeps track of files, the human doesn't have to.

## Removal/Uninstall

If you want to remove the XP Web Publishing entry created from your gallery (e.g. because you have moved to a new domain), you have to edit the registry manually. Be carefull when doing so - messing with the registry without knowing what you do may damage your operating system.

- Click "Start" - "Run..."
- Type "`regedit`" (without the quotes) and hit enter
- Navigate to `HKEY_CURRENT_USER \ Software \ Microsoft \ Windows \ CurrentVersion \ Explorer \ PublishingWizard \ PublishingWizard \ Providers \`
- Highlight the entry on the left side of the screen that corresponds to your coppermine install
- Hit the "delete"-key on your keyboard
- Click "Yes" on the confirmation dialog
- Close the registry editor