Coppermine Photo Gallery v1.5.x: Dokumentation och Manual

Innehållsförteckning
Endast delvis översatt

Uppgradering

Notera: eftersom det skett förändringar både i Coppermines filer och i databasen jämfört med versioner före cpg1.5.x, så måste användare av versioner äldre än cpg1.5.0 utföra alla steg som nämns nedan: både filerna måste ersättas och scriptet update.php script måste köras.

Varför uppgradera?

Det finns större och mindre uppdateringar (releaser) av Coppermine. Större releaser har hittills varit cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x, cpg1.4.x och cpg1.5.x. Nästa större release kommer att bli cpg1.6.x (som för närvarande är under utveckling - ingen release-datum är bestämt ännu) - du läser för närvarande dokumentationen för cpg1.5.x. Mindre releaser (den tredje siffran i versionsnumreringen) representerar uppdateringar, även kallat "underhålls-releaser". Större releaser innehåller nya funktioner (jämfört med tidigare större releaser), mindre releaser innehåller inte nya funktioner, utan bara felrättningar och mindre förbättringar (som tillagda språkfiler).

För att förstå den release-policy som utvecklingsteamet av Coppermine har så måste du förstå hur fel rättas: vi underhåller ett repositorium (lagringsplats på nätet) där källkoden för varje större release ständigt förbättras. Större och mindre fel som rapporteras på Coppermines supportforum rättas i repositoriet. När ett nytt paket sätts ihop, kommer alla rättningar som gjorts i repositoriet att ingå i den nya underhålls-releasen.

Det finns en god anledning för varje ny underhållsrelease: de paketeras vanligtvis när ett nytt fel eller en ny sårbarhet upptäcks som är relevant säkerhetsmässigt. Som ovan sagt finns det åtskilliga mindre felrättningar som inkluderas i varje ny release också, inte bara den stora som föranledde underhållsreleasen. Därför är det inte tillräckligt att bara rätta den enskilda sårbarheten som var anledningen till att det nya paketet släpptes. Uppgradera istället till den senaste stabila releasen så snart denna släppts.

Anledningar för paket-releaser

Här är en lista på mindre releaser av cpg1.5.x och anledningen till att de släpptes. Listan är menad att förklara varför du bör uppgradera så snart det är möjligt till senast stabila release om du kör en föråldrad version.

Detaljer
Paket Anledning för release Release Datum
cpg1.5.16
  • Security release (stable)
  • Announcement thread
  • Fixed 'delete all comments' function in album properties
  • Fixed issue with registration process if both email verification and admin activation are enabled
  • Added plugin hook 'register_form_validate'
  • Fixed display of non-image files when 'Go directly from thumbnail to full-sized image' is enabled in config (thread)
  • Also send activation confirmation email if the user has been activated via the user manager (thread)
2011-09-01
cpg1.5.14
  • Maintenance release (stable)
  • Announcement thread
  • Fixed username in activation mail (thread)
  • Fixed version number displayed on the index page in the doc
  • Added Norwegian language file (user contribution)
  • Fixed album thumbnail for keyword albums without physical files when link_pic_count is disabled (thread)
  • Use the intermediate picture 'use dimension' setting when resizing full-sized pictures during the upload process
  • Fixed spelling of 'email' in German language files
  • Fixed validation of ImageMagick path in config
  • Added missing jump label 'top_display_media' to theme 'eyeball' (thread)
  • Fixed PHP notices 'Undefined variable' and 'Use of undefined constant' during install step 2 (thread)
  • Fixed some missing icons in help pages (thread)
  • Fixed detection of intermediate-sized pictures when renaming files (thread)
  • Added Serbian language file (user contribution)
  • Fixed embedding of SWF files (thread)
  • Fixed safe_mode check when sending emails
  • Fixed selection of gallery icon for user categories (thread)
  • Fixed display of random album thumbnail in sub-category if album keyword is set (thread)
  • Updated Turkish language file (user contribution)
  • Fixed user manager issue (thread)
  • Fixed several keywords issues (issues with ampersands and spaces, leftover keyword separators) (thread)
  • Fixed valid token issue during logout (thread)
  • Display exact character encoding in config (thread)
  • Fixed permission issue if admin tries to create a personal album (thread)
  • Fixed batch-add issue if no file is selected (thread)
  • Fixed visibility issue when setting an album password with IE (thread)
  • Fixed admin tools format in eyeball theme (thread)
  • Fixed thumbnail pages dropdown list on album list (thread)
  • Adjusted part of documentation to reflect cpg1.5.x code change (thread)
  • Fixed critical error message for meta album 'lastalb' if thumbnail image doesn't exist (thread)
  • Fixed first level album thumbnails if thumbnail image doesn't exist
  • Moved memberlist button to home menu drop-down for theme 'curve' (thread)
  • Added workaround for delayed cookie issue during login (thread)
2011-08-01
cpg1.5.12
  • Security release (stable)
  • Announcement thread
  • Fixed film strip issue (thread)
  • Fixed indent for subcategories (thread)
  • Fixed function 'utf_replace' (thread)
  • Updated Portuguese language file (user contribution)
  • Fixed custom thumbnail for files with uppercase extension (thread)
  • Fixed memberlist issue when database name contains a dash (thread)
  • Fixed colspan for guest comments when captcha is enabled (thread)
  • Fixed PHP session name for captcha (thread)
  • Fixed playback of Windows Media Player videos (thread)
  • Fixed XSS issues (thread)
2011-01-02
cpg1.5.10
  • Maintenance release (stable)
  • Announcement thread
  • Fixed default page when comments are sorted in descending order (thread)
  • Fixed issue with plugin usergal_alphatabs when bridged (thread)
  • Added charsetmgr.php to the delete files array (thread)
  • Fixed admin email address validation (thread)
  • Corrected French lang file to fix the non showing dropdown in the user manager (thread)
  • Fixed search feature in the keyword manager (thread)
  • Added partial Swedish language file (user contribution)
  • Added Italian language file (user contribution)
  • Added Icelandic language file (user contribution)
  • Added language fallback to function cpg_get_default_lang_var (thread)
  • Updated Finnish language file (user contribution)
  • Updated default value of transparent_overlay in configuration.htm (thread)
  • Added code that makes sure mb_strlen actually exists when called (thread)
  • Fixed album manager issue when users aren't allowed to create private albums (thread)
  • Fixed lower case user name issue with plugin usergal_alphatabs (thread)
  • Fixed issue where users can edit public albums (thread)
  • HTML validation (thread)
  • Added partial Portuguese language file (user contribution)
  • Added partial Catalan language file (user contribution)
  • Fixed template error if guests are allowed to create public albums
  • Allow admin to change email address (thread)
  • Fixed issue when regular users try to upload to self-created public albums with simple upload form (thread)
  • Fixed missing classid attribute causing videos not to play (thread, thread)
  • Updated regex to fix error message for blank 'allowed file types' values (thread)
  • Fixed setting email sender address
  • Show 'upload needs admin approval' message for flash uploader (thread)
  • Fixed exif issue when auto resizing is enabled and watermarking is disabled (thread, thread)
  • Optimized picture resizing and watermarking procedure
  • Fixed display of unprocessed bbcode markup in ecard display
  • Fixed registration process if both email verification and admin activation enabled (thread)
  • Fixed error message if uploaded file exceeds dimension limit (thread)
  • Fixed session table name in SMF bridge files (thread)
  • Fixed deprecated message on pluginmgr.php (thread)
  • Fixed critical error on memberlist when bridged (thread)
  • Fixed use of mysql_insert_id (thread)
  • Fixed template placeholder bug that caused cut off tags
  • Updated Swedish language file (previous version was mainly a Danish language file)
  • Added partial Swedish documentation
  • Fixed last visit display in user manager when bridged with SMF2 (thread, thread)
  • Fixed implementation of plugin hook 'ip_information' (thread)
  • Use IPTC headline instead of IPTC title as picture title according to docs (thread)
  • Added additional submit button on top of 'Edit files' form (thread)
  • Added plugin hooks 'after_edit_file', 'upload_html_pre_move' and 'upload_swf_pre_move' (thread)
  • If error occurs during batch-add, show error message and don't redirect automatically (thread)
  • Fixed default selection of check boxes for batch-add (thread)
  • Fixed issue with 'User Gallery Alphabetic Tabbing' plugin when bridged (thread)
  • Skip unknown file types during batch-add process (thread)
  • Added label for 'remember me' checkbox (thread)
  • Removed value 'SERVER_PROTOCOL' from client ID generator (thread)
  • Fixed picture resizing via admin tools (thread)
  • Removed declaration of function 'cpg_folder_file_delete' from update.php (thread)
  • Fixed spelling of ImageMagick (thread)
  • Fixed error message when entering invalid email address in profile manager (thread)
  • Fixed renaming of already added files during batch-add (thread)
  • Fixed picture manager - show user created albums in public categories (thread)
  • No longer specify a MySQL engine - use the server default.
  • Fixed comment approval when editing comments (thread)
  • Add anonymous group if it doesn't exist (thread)
  • Fixed ownership of albums created with xp publisher
  • Consistent use of plugin hook types 'action' and 'filter' (thread)
  • Adjusted/added maxlength parameter for album title/keyword according to database types (thread)
  • Display more batch add error messages
  • Fixed use of intermediate-sized image (thread)
  • Theme 'curve': remove drop-down menu leftover if empty (thread)
  • Added plugin hook 'replace_forbidden_conditions' (thread)
  • No error message for admin during upload if image dimension exceeds configuration value (thread)
  • Always use PHP time when querying the database (thread)
  • Added missing/new plugin hooks to visiblehookpoints plugin
  • Fixed potential security issue during installation (thread)
  • Fixed issue with language manager (thread)
2010-11-30
cpg1.5.8
  • Maintenance release (stable)
  • Announcement thread
  • Fixed setting default language with language manager (thread)
  • Changed form token generation - removed trouble maker parameters (thread)
  • Fixed language manager issue for language files with underscore (thread)
  • Set moderator group to '0' for all albums to avoid problems for people who used that feature before it was dropped (thread)
  • Fixed ecard if no intermediate picture is present (thread)
  • Added Estonian language file (user contribution)
  • Update 'last visit' time if it's a 'remember me' session (thread)
  • Added Slovak language file (user contribution)
  • While deleting non-images, delete the corresponding custom thumbnail if exists
  • While renaming non-images, rename the corresponding custom thumbnail if exists
  • While renaming files, check if there will be no conflicts before doing anything
  • Added plugin hook 'token_criteria'
  • Fixed missing CSS class cpg_summary and icon replacement leading to broken output of help boxes on config screen (thread & thread)
  • Fixed possibility for users to edit their files in public galleries if disabled in config (thread)
  • Disable the possibility for guests to enter file details by default (thread)
  • Fixed error message when regular users try to delete their albums in public categories
  • Re-organizing zip archives inside docs folder
  • Adding documentation about plugin config options
  • Fixed issue when reset file ratings (thread)
  • Fixed empty values for 'reason' in 'report to administrator' email (thread)
  • Fixed category view when albums with keywords are present (thread)
  • Changed type of plugin hooks 'theme_thumbnails_wrapper_start/end' from 'filter' to 'action' and adjusted English documentation accordingly (thread)
  • Added search terms to the title of the thumbnails page (thread)
  • Added Japanese language file (user contribution)
  • Adding boxes to config documentation for defaults, max, min, recomended and record name
  • Display Coppermine news always in an iframe (thread)
  • Fixed error message for non existing categories (thread)
  • Replaced wrong link in update.php (thread)
  • Added language table population section to update script to stop cpg1.4.x upgrades seing only Luxemburgish and Mexican as available langauges
  • Updated Turkish language file (user contribution)
  • Show password prompt if user tries to access file in password protected album directly
  • Added Brazilian language file (user contribution)
  • Fixed uploading to password protected albums in public categories (thread)
  • Changed default values for user galleries category (thread)
  • Fixed album visibility issue with user galleries (thread)
  • Changed fix for category alpha sorting
  • Fixed a critical error with the most viewed meta album
  • Updated French language file (improvement and corrections)
  • Allow higher port numbers for the site url config setting
  • Fixed display of swf files in Firefox (thread)
  • Fixed resizing of watermark backup images (thread)
  • Fixed category permissions for secondary user groups (thread)
  • Fixed issue when editing user albums (thread)
  • Fixed issues with usergal_alphatabs plugin (thread & thread)
  • Fixed line breaks in contact form emails
  • Removed outdated FAQ items
  • Updated Hungarian language file (user contribution)
  • Fixed pre-population of user name on comments form (thread)
  • Fixed timeout issue when fetching remote files (thread)
  • Fixed thumb sharpening (thread)
  • Place new comments form accordingly to sort order of comments (thread)
  • Added Danish language file (user contribution)
  • Added default value for 'user_profile6' during user creation (thread)
  • Fixed HTML validation issue for german lang files - replaced & by &
  • Updated plugin manager documentation (thread)
  • Added Hungarian language file (user contribution)
  • Fixed pagination for user manager (thread)
  • Updated Finnish language file (user contribution)
2010-08-06
cpg1.5.7 Detta paket släpptes aldrig, det har faktiskt aldrig funnits. -
cpg1.5.6
  • Maintenance release (stable)
  • Announcement thread
  • Fixed broken link (thread)
  • Extended lang_byte_units array for some language files (thread)
  • Fixed ip address duplicates in stat_details.php (thread)
  • Updated Czech language file (user contribution)
  • Fixed typo that caused the display of the 'not supported version' message box (thread)
  • Fixed issue when uploading plugins to Windows-driven galleries
  • Removed cpg1.3.x theme upgrade guide, as a direct upgrade from cpg1.3.x to cpg1.5.x no longer is supported
  • Create different log entries for user registrations and admin user creations in access log file (thread)
  • Fixed config value for path to ImageMagick when selecting GD during intallation (thread)
  • Fixed query for album moderation group (thread)
  • Fixed display of upload approval button (thread)
2010-06-04
cpg1.5.5 Detta paket släpptes aldrig, det har faktiskt aldrig funnits. -
cpg1.5.4 2010-06-02
cpg1.5.3 2010-03-05
cpg1.5.2
  • Beta release. First public release for testing and evaluation. Do not use for production! No support available yet.
  • Announcement thread
2009-11-16
cpg1.5.1
  • Alpha release for testers and translators. This version is not a public release - it has only been released to a closed group of users for testing and translation purposes.
2009-07-24
cpg1.5.0
  • This version was never released as a package - the version number 1.5.0 was just reserved for the initial development stage of the cpg1.5.x series before the feature freeze stage started. There is no package available, nor has there ever been one - only Subversion checkouts have been possible.
Never

Som du ser rättar och förbättrar Coppermines utvecklingsteam ständigt programvaran. Varje mer komplicerad programvara innehåller fel, så det finns ingen garanti att den version a cpg1.5.x serien som är den nuvarande också kommer att bli den sista, slutgiltiga och felfria versionen. Det är mycket viktigt att du gör uppdateringar så snart som nya paket släpps.

Ändrings-logg

Detaljer om de förändringar som ingår i release kan hittas i ändringsloggen som kommer med i varje paket. Ändringsloggfilen kan hittas i rot-katalogen i Copperminepaketet. Ändringsloggen innehåller mer information om ytterligare språk och datum och tid när rättningen gjordes.

Ändringsloggen är en ren textfil som kan läsas med ett enkelt redigeringsprogram - på Windows-baserade maskiner duger notepad.exe bra.

Nödvändiga steg att utföra vid uppgradering av Coppermine (från någon version)

Instruktionerna här gäller för alla uppdateringar/uppgraderingar av Coppermine, så läs dem noga.

För att göra detta fullständigt klart:

det finns ingenting sådant som ett separat uppgraderingspaket - Coppermine kommer alltid som ett komplett paket som kan användas för såväl nyinstallation som uppgradering.

Ytterligare steg för att uppdatera från vissa versioner

Beroende på den version som du uppdaterar ifrån, så finns det en del ytterligare saker som du måste göra:

Uppgradera från version cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x till cpg1.5.x

Support för en direkt uppgradering från cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x till cpg1.5.x har tagits bort - om du fortfarande kör en sådan stenåldersversion, måste du uppgradera i två steg (från din version till cpg1.4.x och sedan till cpg1.5.x)

Uppgradera från version cpg1.4.x till cpg1.5.x

Uppgradera från äldre versioner av cpg1.5.x till den senaste versionen av cpg1.5.x

Det finns ingenting ytterligare att göra för att uppgradera från en äldre version av cpg1.5.x till den senaste versionen av samma familj. Att utföra de grundläggande instruktionerna som beskrivits ovan i Steg nödvändiga för att uppgradera Coppermine (från någon version) räcker.

Uppdateringsprogrammet

Uppdateringsprogrammet är ett script som kommer att uppdatera din databas och radera överblivna filer från föråldrade versioner som inte längre används i den nya versionen. Du kan komma åt den genom att klicka på motsvarande länk i administratörsmenyn eller genom att ange sökvägen (URL) i adressfältet på din webbläsare.

Du kan köra uppdateringsprogrammet genom att ange http://din_sida.se/din_coppermine_mapp/update.php i din webbläsares adressfält.

Vad det gör

Uppdateringsprogrammet utför tre saker:

Syfte

Uppdateringsprogrammet kommer att utför uppdateringen av databasen åt dig efter det att du manuellt ersatt den sql fil som det använder. Uppdateringsprogrammet kommer inte att upptäcka åt dig om det finns en nyare version av Coppermine tillgänglig och inte heller kommer det att ladda ner någonting från Coppermines hemsida. Automatiseringsnivån i Coppermine är inte avancerad (ännu).

För att se om det finns nya versioner eller underhållsreleaser, se nyheter från coppermine-gallery.net.

Behörighetskontroll

I Coppermine versioner före cpg1.5.x, brukade uppdateringsprogrammet vara offentligt åtkomligt, d.v.s. alla kunde köra det. Medan detta var bra för supportändamål (supportrar kunde köra uppdateringsprogrammet för användare som behövde hjälp om det var uppenbart att de inte gjort detta), så fanns det en liten risk att denna åtkomlighet för alla i något steg kunde innebära en säkerhetsrisk. Därför beslutade utvecklingsteamet att skydda uppdateringsprogrammet från att kunna köras av vem som än hade åtkomst till det - från och med cpg1.5x måste du ange administratörsuppgifter. Det kan du göra på fyra olika sätt:

När måste uppdateringsprogrammet köras?

Du måste köra uppdateringsprogrammet varje gång du uppdaterar/uppgraderar, eg. varje gång som filen sql/update.sql ersätts med en ny version.

Det skadar inte att köra uppdateringsprogrammet flera gånger, så om du är tveksam kan du köra det igen.

Versionskontrollverktyget

Efter release cpg1.3.2 har Coppermine ett versionskontrollverktyg som hjälper dig att lättare lösa frågor om uppgraderingar och uppdateringar. För att köra versionskontrollen, lägg bara till versioncheck.php till adressen i din webbläsare efter att du loggat in som administratör (exempel: http://din_sida.se/din_coppermine_mapp/versioncheck.php). I om med 1.5.x, kan du köra versionskontrollfunktionen från administratörsmenyn.

Versionskontrollverktyget utför inte någon faktisk uppdatering: det laddar inte ner nyare versioner av Coppermine åt dig och inte heller installerar det några programrättningar - det är bara till för att göra dig uppmärksam på om det finns nyare versioner och på om du redan uppgraderat korrekt.

Vad det gör

Programmet "versionskontroll" är tänkt för två ändamål:

Programmet går igenom filerna på din webbserver och försöker att bestämma om dessa är identiska med de som finns i repositoriet på http://coppermine-gallery.net. Filer som inte matchar visas och dessa är de filer du också borde uppdatera.

Jämfört med tidigare versioner har versionskontrollsidan gjorts om för cpg1.5.x både visuellt och funktionsmässigt.

Första körningen

Vid första körningen kommer du att se alternativ skärmen först. Från början borde standardalternativen vara OK, så skicka bara formuläret. Programmet kommer då att bestämma vilken Coppermine version du för närvarande använder, och kommer att söka om den XML fil på Coppermines repositorium som motsvarar din version. Om det lyckas kommer den att jämför alla filer som finns på din server med de senaste som det rekommenderas att använda (försöker att få dessa data från repositoriet). Följaktligen bör du se en lista med mappar och filer som borde finnas på din server och en förklaring om de filversioner som du har är de senaste. För detaljer om hur du ska tolka informationen, läs vidare.

Alternativ

Det finns ett litet antal alternativ på versionskontrollsidan, som borde vara ganska självförklarande:

Alternativskärmen låter dig konfigurera versionskontrollen, eller snarare det som visas. Alternativen sparas ingenstans, så du måste justera dem varje gång du kör versionskontrollen. Standardalternativen borde vara OK för de flesta användare - ändra dem bara om du har en bra anledning att göra det.

Versionsjämförelse

Det finns mycket information som visas på liten yta. Här är en del exempel på möjlig utdata och vad det betyder:

Saker som kan bli fel när man kör versionskontroll

Eftersom de åtgärder som görs när versionskontrollen körs är komplicerade, finns det ett antal saker som kan gå fel beroende på hur din webbserver är uppsatt:

Verktyget versionskontroll tillhandahålls för att tillmötesgå slutanvändaren. Eftersom det finns ett antal faktorer som kan påverka den, kan det hända att det inte fungerar på din webbserver. Om versionskontrollen inte gör någonting alls gäller det förmodligen dig - det är inget du behöver oroa dig över: var bara noga med att hålla din Coppermine installation aktuell, företrädelsevis med att aktivera konfigurationsalternativet "Visa nyheter från coppermine-gallery.net". Bara om enskilda problem rapporteras av versionskontrollverktyget (eg. bara om några rader innehåller en anmärkning i kommentarskolumnen), behöver du orolig och ta dig en närmare titt.

Fel förväntningar

För en del kan det här verka trivialt, medan det för andra är viktig information: naturligtvis är det så att filer som du inte har ersatt under uppgraderingsprocessen (t.ex. anycontent.php) kommer att se föråldrade ut i utdatat från versionskontrollen. Det är förstås vad som kan förväntas. Det skadar inte om du gjorde uppgraderingen exakt som beskrivits, eftersom de filer du skulle behålla under processen inte innehåller någon kod som behöver uppdateras. Som exempel, anycontent.php innehåller ingen kod alls (åtminstone inte den som kommer med i Coppermine). Den kan innehålla anpassad kod om du bestämmer dig för att använda den. För mer information om användningen av anycontent.php, se avsnittet "Använda anycontent.php".

Versionskontrollverktyget gör ingen nedladdning av nyare filversioner från internet - det bara kontrollerar filerna du har på din server jämfört med en lista på senaste filer. Versionskontrollverktyget kontrollerar inte eller rensar din sida från hackers.

Uppgradering FAQ

Nedgradera från cpg1.5.x till en äldre version

CPG1.5.x innehåller många nya funktioner (jämfört med äldre versioner), så vi uppmuntrar våra användare att uppgradera. Det kan finnas de som vill testa cpg1.5.x och senare bestämmer sig för att de vill gå tillbaka till en äldre version. Du måste tänkta på att en full uppgradering ändrar det övergripande utseendet på Coppermines databas som även inkluderar en konvertering av kodningen till unicode. Denna process kan inte ångras: när du en gång gjort konverteringen, är den enda vägen tillbaka att återställa en komplett mySQL databas dump (du måste förstås skapa denna backup före du uppgraderar överhuvudtaget). Att skapa mySQL dumps (backuper) rekommenderas ändå, så du bör göra det nu.

För att göra detta absolut klart: du kan bara nedgradera om du brukade ha cpg1.4.x förut och uppgraderade till denna version av cpg1.5.x. Om du har en ny installation av cpg1.5.x, kan du inte nedgradera alls!

För att faktiskt utföra nedgraderingen, ersätt alla cpg1.5.x filer på din server med filer från en äldre version (som om du gjorde en uppgradering, se ovan). Läs sedan tillbaka den säkerhetskopia som du måste ha gjort av databasen före uppgraderingen. Om du inte har någon databas dump kan du inte backa!