Use & installation is self-explanatory (I think).

-----------------------------------------------------------------------------

One note about using custom search boxes - add the following hidden field to 
any custom search forms so that the plugin will properly process the results:

	<input type="hidden" name="plugin_search_album" value="true" />

And make sure if you are using a quick search box that you specify which
fields to search or use "type = full" (as shown below) or "type = albumonly".

Custom search forms must use "GET" if they are to use "type" instead of the
specific search fields, in order for this plugin to add album search results.

-----------------------------------------------------------------------------

Here's an example "quick search" box you can add anywhere in your theme.php:

        echo <<<EOT
          <form method="get" action="thumbnails.php" name="searchcpg">
            <input type="hidden" name="album" value="search" />
            <input type="hidden" name="type" value="full" />
            <input type="hidden" name="plugin_search_album" value="true" />
            <input type="input" name="search" maxlength="255" value="" class="textinput" />
            <input type="submit" value="Quick Search" />
            &gt; <a href="search.php">Advanced Search</a>
          </form>
          <script language="javascript" type="text/javascript">
          <!--
          document.searchcpg.search.focus();
          -->
          </script>
EOT;

-----------------------------------------------------------------------------

For the "search only albums (no pictures)" option, the original search form
will still return results for pictures if people type in its URL manually,
or if you somehow manage to put a link somewhere where my plugin doesn't see
it and replace it with the plugin's search form (which is unlikely).

If you have questions about the code you must put in theme.php for this 
"search only albums" feature, please read about theme creation/modification
on the Coppermine forum.  Right now, I cannot find any other way to 
automatically insert this code so you have to do it manually.  As the 
configuration note says, you don't have to remove this code if you uninstall
the plugin since it functions normally if the plugin is off or gone.  Do it
once & forget about it (unless you want to customize this display for other
reasons in the future in which case, you have it right there already to do
so).

-----------------------------------------------------------------------------

If you want to customize the labels used in the stats display, read the 
comments in lang/english.php file in this plugin folder.  Essentially, you
uncomment $lang_plugin_searchalbum_stats and set the two labels there as 
desired.  The plugin will then automatically use these settings instead of 
the core Coppermine multi-language settings for these labels.

-----------------------------------------------------------------------------

Corresponding thread: http://coppermine-gallery.net/forum/index.php?topic=26483.0
