Coppermine Photo Gallery v1.5.x: Documentation and Manual
Inhaltsverzeichnis
Dokumentation Sprachauswahl
Coppermine Dokumentation
Über Coppermine
Über die Dokumentation
Konventionen
Features
Schnellstart-Assistent
Inhaltsverzeichnis
Mindestvoraussetzung
Server-seitige Mindestvoraussetzungen
Ein Webserver
Ein Webserver mit PHP-Unterstützung
Eine MySQL-Datenbank
Eine Grafik-Bibliothek:
Selbst-Hosting und Webserver-Setup
Persönliche Voraussetzungen
Requirements FAQ
Test / Fehler bei den Entwicklern melden
No support for alpha and beta versions
Areas to be particularly mindful of
Feature list
The report format
Availability
Sprachen
Wie Coppermine mit Sprachen arbeitet
Übersetzungs-Assistent
Translators wanted!
Why translate?
Translations for which languages are needed?
Who can translate?
Character encoding
Editors & Tools
Full translations only
Step by step
Special issues
Language versions
Work in progress
Initial translation for release
Using older language files
Translating the documentation
Steps for translating the docs into your language
Make sure that the translation doesn't already exist
Create the structure
Copy the core language files
Start translating
Areas to pay attention to
Take care of the table of contents
Zip your translation
Further reading
Danksagungen
Coppermine Entwickler Team
Unterstützer
Übersetzer
Sprachdateien
Dokumentation
Verwendeter Open Source Code
Danksagungen
Many Thanks
Lizenz und Copyright
Copyrights
Lizenz
Vorhergehende Versionen
Zusätzliche Bedingungen
Erhaltung der Autorenschaftshinweise
Kennzeichnung von modifizierte Versionen des Materials
Freedom
Bekannte Probleme
Installation und Einstellungen
Wie man das Skript installiert
Was passiert während der Installation
Berechtigungs-Einstellungen
Apache auf Unix/Linux (CHMOD)
Basics
Groups in Lunix
Webserver daemon
Binary arithmetics
What good is all of this?
FTP application
Website control panel
Shell access
Ownership (CHOWN)
Apache auf Windows
IIS on Windows
Unterstützung/Support in Berechtigungsfragen
Der Installations-Assistent
Automatische Installation
Installations FAQ
De-Installation
Aktualisierung
Warum aktualisieren?
Gründe für die Veröffentlichungen
Changelog
Aktualisierungs-Schritte (alle Versionen)
Zusätzliche Schritte für bestimmte Versionen
Aktualisierung von cpg1.0,1.1,1.2.x oder 1.3.x
Aktualisierung von cpg1.4.x auf Version cpg1.5.x
Das Aktualisierungs-Skript
Was das Skript macht
Zweck
Überprüfung der Berechtigung
Wann muss das Aktualiserungs-Skript laufen?
Die Versions-Prüfung
Was das Skript tut
Optionen
Versionsvergleich
Aktualisierungs-FAQ
Von cpg1.5.x auf eine ältere Version downgraden
Am Anfang
Grundlegende Konzepte
Erstmalige Einrichtung
Kategorie/Alben/Datei-Struktur
Größenänderung von Bildern
Thumbnails
Intermediates
Originals
Recommended resizing setups
No full-size pop-ups
Allow full-size pop-ups with maximum space saving
"Regular" setup with moderate file space consumption
Dein Admin-Konto
ochladen
Bridging in Betracht ziehen
Was dürfen die Besucher der Seite tun?
Das Aussehen Deiner Galerie anpassen
Gebräuchliche Einstellungen
Single uploader without user interaction (Monolithic gallery)
Single uploader with user interaction
Häufig gestellte Fragen (FAQ)
Setup / Configuration
Add-ons / Modifications / Hacks
Coppermine Support board
Designs (Themes)
Mitgelieferte Designs
Aktualisierung Deines selbstgemachten Designs
Konvertierung von cpg1.4.x-Themes auf cpg1.5.x
Bearbeite style.css
Bearbeite template.html
Bearbeite theme.php
Validierung
Inhalt eines Themes
Editing template.html
Template tokens
Important
List of tokens in template.html
Editing style.css
Tools
Web Developer Toolbar usage
Editor
List of classes in style.css
Additional stylesheet
Editing theme.php
Item types
The sample theme - a template to copy from
Method
Scope
List of items in theme.php
Theme Examples
Wie ein Theme funktioniert
Zusätzliche Themes
Preview user-contributed themes
Download user-contributed themes
Installing user-contributed themes
Copyrights of user-contributed themes
Asking for support on user-contributed themes
Contributing your own theme
Erstellung eines eigenen Themes
Benennen Dein Theme zuerst um
Tips & Tricks
Verwendung von grafischen Editoren
Farben bearbeiten
Erstellen eines Themes für Coppermine im Stil der restlichen Seite
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
Bearbeitung von template.html
Template-Platzhalter
Wichtig
Übersicht der Platzhalter in template.html
Editing theme.php
Item types
The sample theme - a template to copy from
Method
Scope
List of items in theme.php
Bearbeitung von style.css
Tools
List of classes in style.css
Additional 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 der Fußzeile
Fair use
Unfair use
Dynamischer (PHP-basierter) Inhalt
Verwendung von anycontent.php
Benutzerdefinierte Kopf- und Fußzeile
Theme-basierter dynamischer Inhalt (theme.php)
Veränderung von Grund-Dateien
Grafische Resourcen in Designs
Menü-Icons
Bildnavigation
Bewertungs-Icons
Film Strip graphics
Progress image (loader)
Administration
Admin-Menü-Einträge
Enable / disable admin controls
Upload approval
Config
Categories
Albums
Sort my pictures
Groups
Users
Ban Users
My profile
Review Comments
Display Ecards
Batch add files
Admin Tools (Resize Pictures)
Keyword manager
Plugin Manager
Bridge Manager
View log files
Overall stats
Check versions
Update database
Export
phpinfo
Show news
Documentation
Admin mode for regular users
Admin menu items for regular users
Verbannen
What's new?
Scope
How banning works
Why banning by IP address is not recommended
Page controls
No banning when bridged
To do
Einstellungen
Allgemeine Einstellungen
Sprach- und Zeichensatz-Einstellungen
Themen-Einstellungen
Ansicht Albenliste
Ansicht Thumbnail
Ansicht Bild
Einstellungen Kommentare
Kontakformular-Einstellungen
Thumbnail Einstellungen
Bild/Datei-Einstellungen
Wasserzeichen auf Bildern
Registrierung
Benutzer-Einstellungen
Benutzerdefinierte Felder für Benutzerprofile
Benutzerdefinierte Felder für zusätzliche Dateiinformationen
Cookie-Einstellungen
Email-Einstellungen
Logging und Statistiken
Wartungs-Einstellungen
Werkseinstellungen zurücksetzen
Gruppen
Gruppen-Einstellungen
Gruppen-Namen
Gruppen-Arten
Speicherlimits
Gruppenberechtigungen (Bewertung/Ecards/Kommentare)
Uploads in öffentliche Alben
Persönliche Galerien
Upload-Methoden
Zugewiesene Alben
Benutzerdefinierte Gruppen erstellen
Benutzerdefinierte Gruppen löschen
Synchronisierung auslösen (nur bei Bridging)
Mitgliedschaft in mehr als einer Gruppe
Benutzer
Benutzer-Manager
Bedien-Elemente
Benutzer suchen
Benutzer erstellen
Benutzer bearbeiten
Gruppen-Mitgliedschaft
Vergessene Passwörter
Passwort für ein Coppermine Benutzerkonto
Coppermine im Standalone-Modus
Coppermine gebridged
Passwort für das mySQL-Konto
Kategorien
The categories control panel
Page controls
Top box "Sort categories alphabetically"
Middle box "Manage Categories"
Bottom box "Update/Create category"
Special category "User galleries"
Alben
Der Alben-Manager
Alben erzeugen
Alben umbenennen
Alben-Reihenfolge ändern
Alben löschen
Alben/Dateien bearbeiten
Alben-Eigenschaften
Alben-Eigenschaften zurücksetzen
Gegenüberstellung Admin/Benutzer
Alben-FAQ
Dateien
Dateien bearbeiten
Videos bearbeiten
Benutzerdefinierte Thumbnails
Order of thumbnails
Types of thumbnails
Uploading custom thumbs
How it works
Naming scheme
Why can't coppermine create thumbnails for my videos?
Step-by-step instructions
Custom thumbnails FAQ
Schlüsselwörter
Schlüsselwörter zuweisen
Keyword separator or keyword delimiter
Schlüsselwörter bearbeiten/ändern
Schlüsselwort-Manager
Alben-Schlüsselwörter
bbCode
Purpose
Available bbcode tags
Dangers
More control
Exif-Daten
What is EXIF
Different flavors
How it works
No exif support on the server
Limitations
EXIF manager
Zusatzmodule (Plugins)
Was ist ein Plugin?
Die Plugin-API
Wo erhalte ich Plugins?
Im Paket enthaltene Plugins
Link Target (link_target)
Who is online? (onlinestats)
OpenSearch (opensearch)
Sample Plugin (sample)
User Gallery Alphabetic Tabbing (usergal_alphatabs)
Visible HookPoints (visiblehookpoints)
SEF_URLS plugin
Der Plugin-Manager
Plugins hochladen
Plugins installieren
Plugins konfigurieren
Plugins deinstallieren
Plugins erstellen
Leistung
Configuration settings
General
Spiking
Server settings
PHP settings
MySQL settings
Third party tools
YSlow
Admin-Werkzeuge
Available Tools
Update thumbs and/or resized photos
Filename → File title
Delete file titles
Delete original size photos
Delete intermediate pictures
Delete files that are older than a set number of days
Delete comments on missing files
Delete original image backup (watermark mod)
Reload file dimensions and size information
Reset view counters
Convert keyword separator
Usage
Fehlermeldungen
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
Wasserzeichen
Alternatives
Turning the context menu off
Only display your precious content to legitimate viewers
Display on overlay
Client-sided watermarking
Hochladen (Upload)
Hochladen per FTP/Stapel-Hinzufügen
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
Hochladen per http
Upload interfaces
Flash-driven multiple-files upload interface
Usage
HTML-driven single-file upload interface
Usage
Windows XP Web Publishing-Assistent
Requirements
Setup
Uploading pictures
File structure
Removal/Uninstall
Fehlerbehandlung beim Hochladen
Berechtigungen
Einstellungen für die Fehlersuche
Upload-Support
Step-by-step guide when asking for support
Example support request
Fehlermeldungen beim Hochladen
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-seitige Einschränkungen
The PHP configuration file php.ini
Things to check
Upload mechanisms/methods
Memory usage during resizing
Kommentare
Kommentare zulassen
Kommentar-Optionen
Spam-Probleme
Captcha
Approval
Akismet
Summary
Kommentare begutachten
Einzelne Kommentare
Integration mit anderen Applikationen (Bridging)
Was bedeutet Bridging
Verfügbare Bridging-Dateien
Vorbedingungen
Authentifizierung durch Cookies
Zuerst die unabhängige Version
Coppermine-Benutzer, -Gruppen und duch die Benutzer hochgeladene Bilder gehen verloren bei der Integration
Backup
Integrations-Schritte
Verwendung des Bridge-Managers
Wähle Applikation, mit der gebridged werden soll
Von der Bridge-Applikation verwendete Pfade
Bridge app URL
Absolute bridge app path
Relative path to your bridge app's config file
Cookie prefix
Bridge-Applikations-spezifische Einstellungen
Use bridge app custom groups?
Bridging ein-/ausschalten
Rettung nach fehlgeschlagenem Bridging-Versuch
Gruppen-Synchronisierung zwischen der Bridge-Applikation und Coppermine
Bridging-Support
Einige Einstellungen werden deaktiviert
Bridge-Dateien
Eigene Bridge erstellen
Bridging-Philosophie
Bridge-spezifische Probleme
phpBB3
PunBB1.1.5
PunBB1.2
XMB
Subdomains
File system
Cookies
www-subdomain
Entwickler-Doku
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
Target audience
Hidden feature
Variables & Constants
System Global Variables
Coppermine Constants
Versioncheck
Hidden features
XML structure
To do list