Coppermine Photo Gallery v1.5.x: Documentation and Manual
Table of contents
Documentation Language Selection
Coppermine documentatie
Over Coppermine
Over de documentatie
Documentatie Conventies
Functies
Quick-Start gids
Inhoudstafel
Minimum vereisten
Server-sided minimum vereisten
Web server
PHP support
mySQL database
Afbeeldingen bibliotheek
Self-Hosting & Webserver Setup
Persoonlijke vereisten
Vereisten FAQ
Testen / bugrapporten
Geen support voor alpha en beta versies
Gebieden die vooral aandacht vragen
Functielijst
Het rapport formaat
Beschikbaarheid
Talen
Hoe talen werken in Coppermine
Get rid of a particular language
Language fallback
Scope of internationalization
The language manager
Controls
Columns
Default
Language name
English
Native
Custom
Flag
Language file
Available
Complete
Enabled
Vertaalgids
Vertalers gevraagd!
Waarom vertalen?
Voor welke talen zijn vertalingen nodig?
Wie kan vertalen?
Karakter codering
Editors & Tools
Alleen volledige vertalingen
Stap voor stap
Speciale problemen
Taalversies
Werk in uitvoering
Initiële vertaling voor release
Gebruik van oudere taalbestanden
Vertalen van de documentatie
Stappen voor de vertaling van de documenten in uw taal
Verzeker er u van dat de vertaling nog niet bestaat
Maak de structuur
Kopieer de core taalbestanden
Start de vertaling
Gebieden die aandacht vragen
Pas op met de inhoudstafel
Zip uw vertaling
Lees verder
Credits
Coppermine team
Medewerkers
Vertalers
Taalbestanden
Documentatie
Gratis code gebruikt
Erkenningen
Many Thanks
Licentie & Copyright
Copyrights
Licentie
Vorige versies
Bijkomende voorwaarden (license add-ons)
Behoud van toeschrijvingen aan auteurs
Markeren van aangepaste versies
Vrijheid
Bekende problemen
Installatie en setup
Hoe het script installeren
Wat doet de installer
Instellen van rechten
Rechten op verschillende webserver types
Apache op Unix/Linux (CHMOD)
Basics
Groepen in Lunix
Webserver daemon
Binaire berekeningen
Waarvoor is dit alles goed?
FTP applicatie
Website control panel
Shell access
Ownership (CHOWN)
Apache op Windows
IIS op Windows
Support vragen voor problemen met rechten
Rechten op mapniveau
Het installatie scherm
Het klassieke installatiescherm
De installatie wizard
Auto-Installers
Installatie FAQ
Uninstall
Upgraden
Waarom upgrade?
Redenen voor pakketrelease
Changelog
Stappen nodig om Coppermine te upgraden (van gelijk welke versie)
Bijkomende handelingen voor een update van bepaalde versies
Upgrade van versies cpg1.0,1.1,1.2.x of 1.3.x
Upgrade van cpg1.4.x naar versie cpg1.5.x
Upgrade van oudere versies dan cpg1.5.x naar de meest recente versie van cpg1.5.x
Het update script
Wat doet het
Doel
Autorisatie controle
Wanneer moet de updater uitgevoerd worden?
Versiecontrole
Wat doet het
Opties
Versie vergelijking
Upgrade FAQ
Downgrade van cpg1.5.x naar een oudere versie
Starten
Basis concepten
Initiele configuratie
Categorie/album/bestandsstructuur
Verkleinde afbeeldingen
Thumbnails
Tussenformaten
Originelen
Aanbevolen verklein setups
Geen full-size pop-ups
Laat full-size pop-ups met maximum ruimtebesparing toe
"Normale" setup met bescheiden gebruik van bestandsruimte
Uw admin account
Check uploads
Overweeg bridging
Wat mogen uw gebruikers doen?
Verander het ontwerp van uw coppermine
Typische setups
Enige uploader zonder gebruikers tussenkomst (Monolithic gallery)
Enige uploader met gebruikerstussenkomst
Meerdere uploaders zonder nieuwe registraties (gesloten groep)
Frequently Asked Questions
Setup / Configuratie
Add-ons / Modificaties / Hacks
Coppermine Support board
Thema's
Thema's die meekomen met Coppermine
Upgrade van uw aangepast thema
Converteren van cpg1.4.x thema's naar cpg1.5.x
Edit style.css
Edit template.html
Edit theme.php
Validatie Methodologie
Thema-inhoud
Editeren van template.html
Template tokens
Belangrijk
Lijst van tokens in template.html
Editeren van style.css
Instrumenten
Gebruik van Web Developer toolbar
Editor
Lijst van classes in style.css
Aanvullende stylesheet
Editing theme.php
Item types
Het voorbeeldthema - een template om van te kopiëren
Methode
Scope
Lijst van items in theme.php
Thema voorbeelden
Aanvullende inhoud
Aanvullende inhoud op de thumbnail pagina
Extra rij tussen thumbnailrijen
Extra tabelcel op iedere thumbnailpagina
Aanvullende inhoud op de intermediate-image pagian's
Dadelijk volgend op de intermediate image
Dadelijk volgend op de filmstrip
Aanvullende inhoud op de full-size pop-up
Samenvatting
Hoe het themasysteem werkt
Gebruiker-ontworpen thema's
Bekijk gebruiker-ontworpen thema's
Download gebruiker-ontworpen thema's
Installeer gebruiker-ontworpen thema's
Copyrights van gebruiker-ontworpen thema's
Vraag naar support voor gebruiker-ontworpen thema's
Ontwerp uw eigen thema
Creating your custom theme
Rename your theme first
Tips & tricks
Gebruik van WYSIWYG-editors
Aanpassen van kleuren
Ontwerpen van een Coppermine thema dat past bij de layout van uw website
Introduction
Pre-requisites
Tools
Skills
Example
Pick a similar theme first
Start editing your theme
Replace the content from the sample with placeholder tokens
Adapting the style
Initial test
Editeren van template.html
Template tokens
Belangrijk
Lijst van tokens in template.html
Editing theme.php
Item types
Het voorbeeld thema - een template om van te kopiëren
Methode
Scope
Lijst van items in theme.php
Editeren van style.css
Tools
Lijst van classes in style.css
Aanvullende stylesheet
Theme examples
Summary
Additional content
Additional content on the thumbnail page
Extra row between thumbnail rows
Extra table cell on each thumbnail page
Additional content on the intermediate-image pages (displayimage.php)
Directly next to the intermediate image
Directly next to the film strip
Additional content on the full-size pop-up
Copyright-disclaimer in voettekst
Fair use
Unfair use
Dynamic (PHP-driven) inhoud
Gebruik van anycontent.php
Aanpassen van kop- en voettekst
Thema-gebaseerde dynamische inhoud (theme.php)
Aanpassen van core-bestanden
Graphic resources in thema's
Menu Icoontjes
Beeld Navigatiebalk
Beoordelen van afbeeldingen
Film Strip graphics
Vordering van beeld (lader)
Beheer
Admin menu-items
In-/ uitschakelen van beheerdersfunctie
Upload goedkeuring
Configuratie
Categorieën
Albums
Sorteer mijn foto's
Groepen
Gebruikers
Ban Gebruikers
Mijn profiel
Bespreek Commentaren
Toon E-kaarten
Bestanden toevoegen in Batch
Admin Instrumenten (Herschalen Foto's)
Trefwoord manager
Plugin Manager
Bridge Manager
Bekijk logbestanden
Algemene statistiek
Controleer versies
Update database
Export
PHP-info
Toon nieuws
Documentatie
Admin modus voor gewone gebruikers
Admin menu-items voor gewone gebruikers
Banning
Wat is nieuw?
Scope
Hoe werkt verbanning
Waarom is verbannen via IP-adres niet aanbevolen
Pagina controles
Geen verbanning indien gebridged
Te doen
Configuratie
Algemene instellingen
Taal & Karakterset instellingen
Thema instellingen
Albumlijst overzicht
Thumbnail overzicht
Foto overzicht
Commentaar instellingen
Contactformulier instellingen
Thumbnail instellingen
Bestands instellingen
Foto watermerken
Registratie
Gebruikers instellingen
Aangepaste velden voor gebruikersprofiel
Aangepaste velden voor beeldomschrijvingen
Cookie instellingen
E-mail instellingen
Logging & statistieken
Onderhouds instellingen
Herstel standaardinstellingen
Groepen
Het groepscontrolepaneel
Groepsnamen
Groepstypes
Quota
Groepsrechten (Beoordeling/E-kaarten/Commentaren)
Publieke albums upload
Persoonlijke galerij
Upload methode
Toegewezen albums
Aanmaken van aangepaste groepen
Wissen van aangepaste groepen
Triggering synchronisatie (bridged only)
Gebruikers
Het gebruikers controlepaneel
Pagina controles
Zoeken naar gebruiker(s)
Aanmaken nieuwe gebruiker(s)
Aanpassen gebruiker
Groepslidmaatschap
Verloren paswoorden
Coppermine gebruikersaccount paswoord
Coppermine in standalone modus
Coppermine bridged
mySQL account paswoord
Categorieën
Het categorie controlepaneel
Pagina controles
Topbox "Sorteer categorieën alfabetisch"
Middelbox "Beheer Categorieën"
Bodembox "Update/Creëer categorie"
Speciale categorie "Gebruikersgalerijen"
Albums
De Album Manager
Albums aanmaken
Albums hernoemen
Albums volgorde veranderen
Albums wissen
Aanpassen van albums/bestanden
Albumeigenschappen
Herstel albumeigenschappen
Admin vs. gebruiker
Album FAQ
Bestanden
Editeren van bestanden
Editeren van videos
Aanpassen Thumbnails
Volgorde van thumbnails
Types van thumbnails
Uploading aangepaste thumbs
Hoe het werkt
Schema Naamgeving
Waarom kan Coppermine geen thumbnails aanmaken voor mijn video's?
Stap-voor-stap instructies
Aanpassen van thumbnails FAQ
Trefwoorden
Trefwoorden toewijzen
Trefwoord scheidingsteken
Editeren/toevoegen trefwoorden
Trefwoord manager
Album trefwoorden
bbCode
Doel
Beschikbare bbcode tags
Gevaren
Meer controle
Exif data
Wat is EXIF
Verschillende smaken
Hoe het werkt
Geen exif support op de server
Beperkingen
EXIF manager
Plugins
Wat is een plugin?
De Plugin API
Waar vinden we Plugins?
Plugins in pakket van Coppermine
Link Target (link_target)
Wie is online? (onlinestats)
OpenSearch (opensearch)
Sample Plugin (sample)
Gebruikers alfabetische Galerijtabs (usergal_alphatabs)
Visible HookPoints (visiblehookpoints)
SEF_URLS plugin
De Plugin Manager
Plugin Uploaden
Plugin Installeren
Plugin Configuratie
Plugin de-installeren
Plugins schrijven
Performance
Configuratie instellingen
Algemeen
Spiking
Server instellingen
PHP instellingen
MySQL instellingen
Third party tools
YSlow
Beheerdersinstrumenten
Beschikbare opties
Update thumbs en/of verkleinde foto's
Bestandsnaam→ Bestandstitel
Wis bestandstitels
Wis foto's met originele grootte
Wis middelgrote foto's
Wis bestanden die ouder zijn dan een ingesteld aantal dagen
Wis commentaren van ontbrekende bestanden
Wis originele imageback-up (watermerk modus)
Herlaad bestandsafmetingen en afbeeldingsgrootte
Reset de 'Bekeken' tellers
Converteer trefwoord scheidingsteken
Usage
Errors
Error types
Soft Errors
Hard Errors
Unhandled Errors
Fatal error
Enabling debug_mode in Config
Manually enabling debug_mode
Turning debug_mode off
Common error messages
Database-related error messages
Common PHP errors
Upload-related error messages
Backup & Moving
Backing up your gallery
File Backup
Complete File Backup
Partial File Backup
Incremental File Backup
Database Backup
What needs to be backed up?
Database Backup Tools
phpMyAdmin
mySqlDumper
mysqldump
mysqlhotcopy
After the database backup
Moving your gallery
Moving on your webserver
Moving from one webserver to the other
Disadvantages of renaming
Changing Coppermine's URL in config
Watermarking
Alternatives
Turning the context menu off
Only display your precious content to legitimate viewers
Display on overlay
Client-sided watermarking
Uploading
Uploading pics by FTP / Batch-Add Pictures
What batch-add does
How batch-add works
Common mistakes
Batch-add does not work as expected
Files appear to be broken
Do not rename
Do not delete
Sorting
Capitalization matters
Computers see numbers differently
Uploading by HTTP
Upload interfaces
Flash-driven multiple-files upload interface
Usage
HTML-driven single-file upload interface
Usage
Windows XP Web Publishing Wizard
Requirements
Setup
Uploading pictures
File structure
Removal/Uninstall
Upload troubleshooting
Permissions
Enable troubleshooting settings
Asking for support on upload issues
Step-by-step guide when asking for support
Example support request
Error messages
Impossible to move x to y
failed to open dir: No such file or directory
Undefined variable: HTTP_POST_VARS
Sorry there is no album where you are allowed to upload files
Allowed memory size of X bytes exhausted
Exec() has been disabled
Not a GD extension
Error executing ImageMagick - Return value 127
PHP running on your server does not support the GD image library
No file was uploaded ! If you have really selected a file to upload, check that the server allows file uploads
Destination directory x is not writable by the script
Server-sided restrictions
The PHP configuration file php.ini
Things to check
Upload mechanisms/methods
Memory usage during resizing
Comments
Allowing comments
Comments options
Spam issues
Captcha
Approval
Akismet
Summary
Reviewing Comments
Individual Comments
Bridging
What bridging does
Available bridge files
Pre-requistes
Authentication by cookie
Standalone version first
Coppermine users, groups and pics uploaded by users are lost when integrating
Backup
Integration steps
Using the bridge manager
Choose application to bridge coppermine with
Path(s) used by your bridge app
Bridge app URL
Absolute bridge app path
Relative path to your bridge app's config file
Cookie prefix
Bridge-app-specific settings
Use bridge app custom groups?
Enable/disable bridging
Recover from failed bridging
Synchronising the bridge app groups with Coppermine's groups
Bridging support
Some config options get disabled
Bridging files
Creating a custom bridge file
Bridging philosophy
Individual bridge issues
phpBB3
PunBB1.1.5
PunBB1.2
XMB
Subdomain issues
File system
Cookies
www-subdomain
Developer documentation
Adding/renaming/removing files
Target audience
Scope
Naming conventions
Adding files
Language files
Renaming files
Deleting files
Coding guidelines
Target audience
Scope
Indentation
Encoding
General guidelines
PHP code
Formatting
Control Structures
Function Calls
Function Definitions
PHP Code Tags
Nesting of HTML in PHP
Line breaks
Naming Conventions
Database queries
Documentation
HTML output
Image-tags in HTML output
Links in HTML output
Form elements in HTML output
Deprecated tags
Prefered tags
Credits for coding guidelines
Usability
Forms
Config options
Target audience
History
New features
Step by Step
Basic.sql
Update.sql
Admin.inc.php
Language file
Documentation
To Do
Database schema
Configuration file
Database reference within coppermine code
cpg15x_albums
cpg15x_banned
cpg15x_bridge
cpg15x_categories
cpg15x_categorymap
cpg15x_comments
cpg15x_config
cpg15x_dict
cpg15x_ecards
cpg15x_exif
cpg15x_favpics
cpg15x_filetypes
cpg15x_hit_stats
cpg15x_languages
cpg15x_pictures
cpg15x_plugins
cpg15x_sessions
cpg15x_temp_messages
cpg15x_usergroups
cpg15x_users
cpg15x_votes
cpg15x_vote_stats
Editing the documentation
Target audience
Edit existing documents
Add new documents
Moving content from one document to the other
Hidden features
Database structure
Header & footer blocks
Documentation internationalization
Expandable/collapsible "detail"-blocks
Help
Start and end anchors needed
Adding anchors to headings
Code
CSS class "code"
HTML-tag "pre"
CSS class "cpg_code"
CSS class "smallcode"
HTML-tag "textarea"
Combining HTML tags and CSS classes
No syntax highlighting
Javascript in Coppermine
Target audience
Javascript files location and organization
TODO
How to include javascript files
How to include JavaScript files in plugins
How to pass PHP variables to included javascript
Autostart JavaScript
Packaging a new release
Target audience
Subversion repository
Steps
Check out
Replace version number in all files
Linux
Windows
Remove Byte Order Marks
Prepare an announcement thread
Edit the upgrade section of the docs
Edit the changelog
Edit the version number
Commit your changes
Update the versioncheck data
Completeness
Update revision numbers and hashes
Update cpg15x.files.xml on the Coppermine home page
Export from subversion
RapidSVN
Tortoise SVN
Create the archive
Upload the archive
Publish announcement thread
Create news items
News item on sf.net
News item on forum
News item on home page
News embedded into existing galleries
Update the demo
Plugin Writing for Coppermine
Quick Start Guide
Intended Audience
People who should read this documentation
People who do not need to read this documentation
Why write plugins?
Preparations
Choose a name
Consider translations
Consider a config screen
Database changes
Support issues
Plugin versions
Core files
Naming conventions
Folders
Files
Archives
Coding
Use of Superglobals
Database access
Direct queries
Accessing database tables
Creating database tables
Deleting database tables
Storing your plugin's config values
Plugin Types
Using includes
Plugin Writing: Tutorial, API
Intended Audience
Required Skills & Knowledge
Recommended Software & Support Forums
"Hello, world" Plugin Tutorial
My First Plugin
Installation, Configuration, and Clean-Up
Installation with Simple Configuration
Installation with Configuration Parameters
Configuration during Operation
Uninstallation & Clean-Up
Linking to Custom Plugin Scripts
Adding a Button to Coppermine
Adding a Button to the admin menu
Adding a Button to the overall menu
Adding JavaScript to plugins
Multi-language Support
Distributing Your Plugin
Plugin Hooks
Plugin Class Properties & Methods
Global Variables & Constants
Reference list of plugin hooks
Target audience
Choosing Plugin Hooks
Finding Plugin Hooks
Plugin Hooks by File Name
Script: index.php
Filter: 'anycontent'
Filter: 'user_caption_params'
Filter: 'plugin_block'
Script: displayimage.php
Filter: 'file_info'
Filter: 'post_breadcrumb'
Script: thumbnails.php
Filter: 'post_breadcrumb'
Script: functions.inc.php
Filters: 'gallery_header' and 'gallery_footer'
Filter: 'thumb_data'
Filter: 'template_html'
Filter: 'page_meta'
Filters: 'thumb_caption' and all derivatives
Script: themes.inc.php
Filter: 'file_data'
Script: usermgr.php
Filter: 'usermgr_header'
Filter: 'usermgr_footer'
Script: pluginmgr.php
Filter: 'plugin_configure'
Filter: 'plugin_cleanup'
Script: plugin_api.inc.php
Filter: 'page_html'
Filter: 'page_end'
Filter: 'plugin_install'
Filter: 'plugin_uninstall'
Filter: 'plugin_wakeup'
Filter: 'plugin_sleep'
Script: init.inc.php
Filter: 'page_start'
Script: picmgmt.inc.php
Filter: 'add_file_data'
Plugin Hooks Alphabetically
Plugin Hooks by Hook Type
Plugin Hook Examples
Adding an upload method
Add tags for thumbnails display
Sanitization of Superglobals using Inspekt
Target audience
What's new?
Reason
What Inspekt does
Inspekt accessor methods
How to use Inspekt with Coppermine Photo Gallery
Using Inspekt
Inspekt in Coppermine
Consider the methods to use
Examples
Regular Expressions
Links
Subversion
Target audience
Caveats
What is subversion?
Where is the subversion repository hosted?
Recommended software
Alternative access using Web SVN
Repository structure
Coppermine core files
Plugins
Checking out
Checking out the entire repository
Checking out a particular Package
Checking out a particular file
Refering to files downloaded from the subversion repository
Is there no single package that I could download instead?
Download Tarball archives
Developers-only
Check out before checking in
Committing your code
Changelog
Obtaining write access
Step by step
Download the client application
Initial checkout
Revisions
Subversion file headers
Tools recommended by the devs
Database manipulation
FTP clients
Web development
Text editors
Picture Editors
Updating
Doelpubliek
Verborgen functie
Variables & Constants
System Global Variables
Coppermine Constants
Versioncheck
Hidden features
XML structure
To do list