Coppermine Integration plugin for Wordpress
Current version: 4.6
Written for Wordpress 1.5, 1.6/2.0 and Coppermine 1.3x and 1.4x
Author: Martijn van der Kwast <mvdkwast@gmx.net>, Mathias Decker <mathias@itgweb.de>

This plugin integrates Coppermine into Wordpress.

Please see the plugin page for full information:
http://blog.artworkz.net/?p=283

WARNING: THIS IS AN EXPERIMENTAL UNSTABLE VERSION. IF YOU ARE LOOKING
FOR A STABLE VERSION, GET VERSION 3.3 INSTEAD.

Of course, if you have downloaded this version, you might as well check it
out and give me some feedback !

New Features
------------

- Integration with Coppermine 1.42, 1.43 
- Integration with WordPress 1.6/2.0/2.3/2.7
- Works with TinyMCE
- custom links
- pictures for other media type
- mp3 player
- shadows


Features
--------

- One-click insert system for recent pictures.
- Use menus to choose the alignment and the size of your pictures in your 
  posts.
- Image browser to select pictures from the whole gallery.
- Popup window to upload pictures without leaving the editor.
- Simple Template Tags to display your recent/random/favourite pictures in 
  your theme.
- Optional sharing of users.
- Search pictures from within WordPress.


Requires
--------

- WordPress 1.5.1/1.5.2/1.6/2.0
- Coppermine Gallery 1.33/1.34/1.35/1.42/1.43
- A modern browser that understands CSS2 and javascript.


Upgrade
-------

- Replace the plugin files with the newer ones from this package.

- Don't forget to update the files in the coppermine directory.

- Load the configuration page once. (This will initialize the new options).

- If you modified your previous coppermine.css file, make sure you have
  a backup version somewhere. Compared to 3.3 a lot of things have been
  added, so you cannot simply use your old coppermine.css .


Quick instructions 
------------------

- You should remove or rename any previous version of this plugin before
  you install.

- Extract the Zip file to a temporary folder.

- Copy the wp-content/plugins/coppermine directory to your plugin directory so that 
  you get a .../wordpress/wp-content/plugins/coppermine directory.
 
- Copy files to your coppermine directory:

  + if you have coppermine 1.3x, copy the files from cpg/1.3x/cpg/ to your Coppermine
    directory

  + if you have coppermine 1.4x, copy the files from cpg/1.4x/cpg/ to your Coppermine
    directory.

  And by Coppermine directory, I mean the directory where Coppermine resides, not the
  plugin directory! 
  
- Go to Admin > Plugins, and follow the link 'Go here to configure' in the entry for
  the Coppermine plugin.

- Configure your Coppermine connection settings and other options.

- Press 'Save Settings'

- Go back to Admin > Plugins, and activate the plugin.

- IMPORTANT: If wordpress is not the root server, you must manually add against by the name of your sub-folder in the files: Coppermine details.js (4 times)
(add /name_of_folder/ before wp-content/plugins/coppermine/coppermine-details.php) and 1 time in lightbox.js before wp-content

User Integration
----------------

This is optional. You will not need this in typical single-user setups. You will be
able to view, insert and upload pictures without it. 

If you have Coppermine 1.3x:

- Replace the Coppermine files with the ones in 
  cpg/1.3x/user-integration

- Go to Admin > Plugins, and follow the link 'Go here to configure' in the entry for
  the Coppermine plugin.

- Click on the Upgrade database link


For all versions of Coppermine:

- Activate 'Integrate users'

- Logout from WordPress and login again. You should now also be logged into Coppermine.


You can now import all users at once, or let the users be auto-imported the moment they
login to WordPres.


Gotchas:

- You will only see your own pictures in the inserter bar. If you want to see everybody's
  picture, activate that option on the configuration page.

- Users will be created in Coppermine after the first time they login to WordPress unless you
  click 'import users' in the coppermine-config.php

- For Coppermine 1.4x only: If you don't activate password encryption in Coppermine, the
  imported users will only be able to login to Coppermine through WordPress, not directly.


Search Integration
------------------

If you're using the Kubrick theme (default), you can put wp-content/themes/default/search.php 
in your theme directory.

If you don't you will have to read the online documentation.




More information
----------------

The official plugin page is:
http://www.stilglog.com/wordpress-plugins/coppermine-plugin/

Please see the website for a detailed description of the options/tags,
including screenshots. The documentation describes versions 3.x.

For questions and comments, please use the comments section.


License
-------

Coppermine Integration is 
Copyright (c) 2005 Martijn van der Kwast <mvdkwast@gmx.net>

This plugin is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

