Plugin: suppressor

Author:  KF  (406man)
Description: Suppresses file information displayed with an image. Also suppresses sub-menu items.
License: Standard Coppermine
Installation: Standard method.
Version: V1.2 

Coppermine has a large range of features and functions, which allows it to be useful in many applications, but a 
downside is that there can be too much displayed on the screen

This plugin is called “suppressor” and the configuration menu allows the administrator to decide which items to 
display (or not). Four types of item can be suppressed:

1) items of file information that are displayed on the screen created by displayimage.php  The screen is the 
“medium” sized image,  which shouldn’t be confused with the option to display a full size image (which is enabled as 
a configuration option and isn’t affected by this plugin). 

Any of these items of file information can be suppressed using the plugin configuration menu:
•	Filename
•	Filesize
•	Date added
•	Dimensions
•	Displayed
•	DateTime Original
•	URL
•	Keywords
•	Favorites (*)

2) The second row of menu items is known in Coppermine as the sub-menu. These menu items can be suppressed:
•	Last Uploads
•	Last comments
•	Most viewed
•	Top rated
•	My Favorites (*)
•	Search

(*)If you suppress Favorites, the main menu item “Favorites” (actually appears on what is called the sub-menu) will 
be removed as well as the “Add to favourites” link on the image display page. 

The following items of file information always appear unless they are blank:
•	Title
•	Caption
•	Album name

There is a button above the image on the image display screen “Show File Information” or “Hide File Information” 
which toggles between displaying all the file information or none of it. What suppressor does is to prevent the 
selected information being shown when the “Show File Information” button is set to show all file information. 

3) In the thumbnail display, when the mouse pointer hovers over a thumbnail, in standard Coppermine four items are 
displayed:
•	Filename
•	Filesize
•	Date added
•	Dimensions
New for Version 1.1: these are suppressed depending on what has been set in the configuration using the plugin manager.

4) In the Image Display screen, hovering the mouse pointer over the image displays its title and any keywords.
A configuration item in the plugin allows this display of keywords to be suppressed

I’ve tested the plugin with Coppermine version 1.6.22 and 1.6.25. It won’t install on 1.5.x. I’ve also tested it 
with French as the main language and it works fine.

An additional group of functions has been implemented for version 1.2 of this plugin. 
i) Whether the uploader name is displayed on the thumbnails page depends on what's been configured in the Thumbnail 
View section of the gallery configuration. The setting applies to all albums. There may be times when the administrator 
would like to override this setting. For example to suppress display of the uploader name in a particular album. 
This has been implemented using the album keyword field. If the keyword contains NOUPLOADER the uploader name is not 
displayed on the Thumbnail View and Image View screens, regardless of the configuration setting. Similarly if the keyword 
contains UPLOADER the uploader name is always displayed on these screens. Note that in the standard gallery the Image 
View screen always displays the uploader name as the configuration setting has no effect.
ii) The EXIF information and custom fields on the image display screen can be suppressed for a particular album by adding 
the keyword NOEXIF to the album keyword field.

LIMITATION: With the standard Coppermine eyeball and hardwired themes the plugin cannot change the sub_menu because 
the themes have their own definition of the sub_menu template which lacks the plugin hook. The image display works 
in the normal way so the plugin can suppress file info.

Comments, bug reports and feedback welcome.





