Coppermine Photo Gallery v1.5.x: Dokumentasjon og Manual

Innholdsfortegnelse

Oppgradering

Pass på: da det er gjort forandringer både i Coppermines filer og i databasen i versjonen før cpg1.5.x, så må brukere av versjoner eldre enn cpg1.5.0 utføre alle steg som nevnes under: både filene og scriptet update.php script må kjøres.

Hvorfor oppgradere?

Det finnes større og mindre oppdateringer av Coppermine. Større oppdateringer har hittil vært cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x, cpg1.4.x og cpg1.5.x. Neste store oppdatering blir cpg1.6.x (som for tiden er under utvikling - ingen dato er foreløpig bestemt) - du leser nå dokumentasjonen for cpg1.5.x. Mindre oppdateringer (de tredje sifferet i versionsnumreringen) representerer oppdateringer, også kalt "vedlikeholds-oppdateringer". Større oppdateringer inneholder nye funksjoner (sammenlignet med tidligere større oppdateringer), mindre oppdateringer inneholder ikke nye funksjoner, men bare rettinger av feil og mindre forbedringer (som å legge til nye språkfiler).

For å forstå den release-policy som utviklingsteamet av Coppermine, har så må du forstå hvordan feil rettes: vi vedlikeholder en lagringsplass på nettet, der kildekoden for alle større oppdateringer stadig forbedres. Større og mindre feil som rapporteres på Coppermines suportforum rettes i lagringsplassen. Når en ny pakke settes sammen, vil alle rettinger som er gjort i lagringsplassen til å inngå i den nye oppdaterings utgivelsen.

Det er en god grunn for hver ny vedlikeholds-oppdatering: de oppdateres vanligvis når en ny feil eller en ny sikkerhetsmessig sårbarhet oppdages. Som nevnt over er det adskillige "mindre" feilrettinger som inkluderes i hver ny oppdatering også, ikke bare den store som var foranledningen til vedlikeholdsoppdateringen. Derfor er det ikke tilstrekkelig og bare rette de enkelte sårbarhetene som var årsaken til at den nye oppdateringen blir gitt ut. Oppgrader i stedet til den siste stabile utgivelsen så fort den kommer.

Grunnen for pakke-oppdateringer

Her er en liste på mindre oppdateringer av cpg1.5.x og grunnen for at de ble gitt ut. Listen er ment for å forklare hvorfor du bør oppdatere så snart som mulig til siste stabile utgivelse hvis du har en foreldet version.

Detaljer
Pakke Grunn for utgivelse Utgivelses Dato
cpg1.5.12
  • Security release (stable)
  • Anonseringer
  • Fixed film strip issue (forumet)
  • Fixed indent for subcategories (forumet)
  • Fixed function 'utf_replace' (forumet)
  • Updated Portuguese language file (user contribution)
  • Fixed custom thumbnail for files with oppercase extension (forumet)
  • Fixed memberlist issue when database name contains a dash (forumet)
  • Fixed colspan for guest comments when captcha is enabled (forumet)
  • Fixed PHP session name for captcha (forumet)
  • Fixed playback of Windows Media Player videos (forumet)
  • Fixed XSS issues (forumet)
2011-01-02
cpg1.5.10
  • Maikkenance release (stable)
  • Anonseringer
  • Fixed default page when comments are sorted in descending order (forumet)
  • Fixed issue with plugin usergal_alphatabs when bridged (forumet)
  • Added charsetmgr.php to the delete files array (forumet)
  • Fixed admin email address validation (forumet)
  • Corrected French lang file to fix the non showing dropdown in the user manager (forumet)
  • Fixed search feature in the keyword manager (forumet)
  • 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 (forumet)
  • Updated Finnish language file (user contribution)
  • Updated default value of transparent_overlay in configuration.htm (forumet)
  • Added code that makes sure mb_strlen actually exists when called (forumet)
  • Fixed album manager issue when users aren't allowed to create private album (forumet)
  • Fixed lower case user name issue with plugin usergal_alphatabs (forumet)
  • Fixed issue where users can edit public album (forumet)
  • HTML validation (forumet)
  • Added partial Portuguese language file (user contribution)
  • Added partial Catalan language file (user contribution)
  • Fixed template error if guests are allowed to create public album
  • Allow admin to changi email address (forumet)
  • Fixed issue when regular users try to upload to self-created public album with simple upload form (forumet)
  • Fixed missing classid attribute causing videos not to play (forumet, forumet)
  • Updated regex to fix error message for blank 'allowed file types' values (forumet)
  • Fixed setting email sender address
  • Show 'upload needs admin approval' message for flash uploader (forumet)
  • Fixed exif issue when auto resizing is enabled and watermarking is disabled (forumet, forumet)
  • 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 (forumet)
  • Fixed error message if uploaded file exceeds dimension limit (forumet)
  • Fixed session table name in SMF bridge files (forumet)
  • Fixed deprecated message on pluginmgr.php (forumet)
  • Fixed critical error on memberlist when bridged (forumet)
  • Fixed use of mysql_insert_id (forumet)
  • 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 (forumet, forumet)
  • Fixed implementation of plugin hook 'ip_information' (forumet)
  • Use IPTC headline instead of IPTC title as picture title according to docs (forumet)
  • Added additional submit button on top of 'Edit files' form (forumet)
  • Added plugin hooks 'after_edit_file', 'upload_html_pre_move' and 'upload_swf_pre_move' (forumet)
  • If error occurs during batch-add, show error message and don't redirect automatically (forumet)
  • Fixed default selection of check boxes for batch-add (forumet)
  • Fixed issue with 'User Gallery Alphabetic Tabbing' plugin when bridged (forumet)
  • Skip unknown file types during batch-add process (forumet)
  • Added label for 'remember me' checkbox (forumet)
  • Removed value 'SERVER_PROTOCOL' from client ID genedator (forumet)
  • Fixed picture resizing via admin tools (forumet)
  • Removed declaration of function 'cpg_folder_file_delete' from update.php (forumet)
  • Fixed spelling of ImageMagick (forumet)
  • Fixed error message when entering invalid email address in profile manager (forumet)
  • Fixed renaming of already added files during batch-add (forumet)
  • Fixed picture manager - show user created album in public categories (forumet)
  • No longer specify a MySQL engine - use the server default.
  • Fixed comment approval when editing comments (forumet)
  • Add anonymous group if it doesn't exist (forumet)
  • Fixed ownedship of album created with xp publisher
  • Consistent use of plugin hook types 'action' and 'filter' (forumet)
  • Adjusted/added maxlength parameter for album title/keyword according to database types (forumet)
  • Display more batch add error messages
  • Fixed use of ikkermediate-sized image (forumet)
  • Theme 'curve': remove drop-down menu leftover if empty (forumet)
  • Added plugin hook 'replace_forbidden_conditions' (forumet)
  • No error message for admin during upload if image dimension exceeds configuration value (forumet)
  • Always use PHP time when querying the database (forumet)
  • Added missing/new plugin hooks to visiblehookpoints plugin
  • Fixed potential security issue during installesjon (forumet)
  • Fixed issue with language manager (forumet)
2010-11-30
cpg1.5.8
  • Maikkenance release (stable)
  • Anonseringer
  • Fixed setting default language with language manager (forumet)
  • Changid form token genedation - removed trouble maker parameters (forumet)
  • Fixed language manager issue for language files with underscore (forumet)
  • Set moderator group to '0' for all album to avoid problems for people who used that feature before it was dropped (forumet)
  • Fixed ecard if no ikkermediate picture is present (forumet)
  • Added Estonian language file (user contribution)
  • Update 'last visit' time if it's a 'remember me' session (forumet)
  • 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 (forumet & forumet)
  • Fixed possibility for users to edit their files in public galleries if disabled in config (forumet)
  • Disable the possibility for guests to enter file details by default (forumet)
  • Fixed error message when regular users try to delete their album in public categories
  • Re-organizing zip archives inside docs folder
  • Adding documentation about plugin config options
  • Fixed issue when reset file ratings (forumet)
  • Fixed empty values for 'reason' in 'report to administrator' email (forumet)
  • Fixed category view when album with keywords are present (forumet)
  • Changid type of plugin hooks 'theme_thumbnails_wrapper_start/end' from 'filter' to 'action' and adjusted English documentation accordingly (forumet)
  • Added search terms to the title of the thumbnails page (forumet)
  • 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 (forumet)
  • Fixed error message for non existing categories (forumet)
  • Replaced wrong link in update.php (forumet)
  • 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 album in public categories (forumet)
  • Changid default values for user galleries category (forumet)
  • Fixed album visibility issue with user galleries (forumet)
  • Changid 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 (forumet)
  • Fixed resizing of watermark backup images (forumet)
  • Fixed category permissions for secondary user groups (forumet)
  • Fixed issue when editing user album (forumet)
  • Fixed issues with usergal_alphatabs plugin (forumet & forumet)
  • 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 (forumet)
  • Fixed timeout issue when fetching remote files (forumet)
  • Fixed thumb sharpening (forumet)
  • Place new comments form accordingly to sort order of comments (forumet)
  • Added Danish language file (user contribution)
  • Added default value for 'user_profile6' during user creation (forumet)
  • Fixed HTML validation issue for german lang files - replaced & by &
  • Updated plugin manager documentation (forumet)
  • Added Hungarian language file (user contribution)
  • Fixed pagination for user manager (forumet)
  • Updated Finnish language file (user contribution)
2010-08-06
cpg1.5.7 Denne pakker er aldrig utgitt, den har faktisk aldrig eksistert. -
cpg1.5.6
  • Maikkenance release (stable)
  • Anonseringer
  • Fixed broken link (forumet)
  • Extended lang_byte_units array for some language files (forumet)
  • Fixed ip address duplicates in stat_details.php (forumet)
  • Updated Czech language file (user contribution)
  • Fixed typo that caused the display of the 'not suported version' message box (forumet)
  • 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 suported
  • Create different log entries for user registrations and admin user creations in access log file (forumet)
  • Fixed config value for path to ImageMagick when selecting GD during intalletion (forumet)
  • Fixed query for album moderation group (forumet)
  • Fixed display of upload approval button (forumet)
2010-06-04
cpg1.5.5 Dette pakke släpptes aldrig, det har faktisk 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 suport available yet.
  • Anonseringer
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 oversettelse purposes.
2009-07-24
cpg1.5.0
  • This version was never released as a pakkege - 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 pakkege available, nor has there ever been one - only Subversion checkouts have been possible.
Never

Som du ser retter og forbedrer Coppermines utviklingsteam stadig programvaren. Alle kompliserte programvarer inneholder feil, så det er ingen garanti at den versjon av cpg1.5.x serien som er den nåværende vil bli den siste og feilfrie versjonen. Det er svært viktig at du oppdaterer så snart nye pakker slippes.

Endrins-logg

Detaljer om de forandringer som inngår i en oppdatering kan du finne i endringsloggen som følger med hver pakke. Endringsfilen er i rot-katalogen i Copperminepakken. Endringsloggen inneholder mer informasjon om flere språk, dato og når forandringen ble gjort.

Endringsloggen er en ren tekstfil som kan leses med et enkelt redigeringsprogram - på Windows-baserte maskiner fungerer notepad.exe bra.

Nødvendige steg for å utføre oppgradering av Coppermine

Instruksjonene her gjeller for alle oppdateringer/oppgraderinger av Coppermine, så les dem nøye.

For å gjøre dette fullstendig klart:

Det finnes ikke en separat oppgraderingspakke - Coppermine kommer alltid som en komplett pakke som kan brukes for såvel nyinstallasjon som oppgradering.

Flere steg for å oppdatere fra visse versjoner

Avhengig av den versjon som du oppdaterer fra, så finnes det en del flere ting som du må gjøre:

Opgradere fra versjon cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x til cpg1.5.x

Suport for en direkte oppgradering fra cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x til cpg1.5.x er tatt bort - hvis du femdeles kjører en slik steinaldersversjon, må du opgradere i to steg (fra din versjon til cpg1.4.x og siden til cpg1.5.x)

Opgradere fra versjon cpg1.4.x til cpg1.5.x

Opgradere fra eldre versjoner av cpg1.5.x til den siste versjonen av cpg1.5.x

Det er ikke mer å gjøre for å opgradere fra en eldre versjon av cpg1.5.x til den siste versjonen av samme familie. Å utføre de grundleggende instruksjonene som beskrives over i Steg nødvendige for å opgradere Coppermine er tilstrekkelig.

Oppdateringsprogrammet

Oppdateringsprogrammet er et script som vil oppdatere din database og slette gamle filer fra foreldede versjoner som ikke lengere brukes i den nye versjonen. Du kommer til den gjennom å klikke på tilsvarende link i administratormenyen eller gjennom og angi adressen (URL) i adressefeltet på din webbleser.

Du kan kjøre oppdateringsprogrammet gjennom å angi http://din_side.no/din_coppermine_mappe/update.php i din webblesers adressfelt.

Hvad det gjør

Oppdateringsprogrammet utfører tre ting:

Hensikt

Oppdateringsprogrammet vil utføre oppdateringen av databasen for deg etter at du manuellt har erstattet den sql fil som den bruker. oppdateringsprogrammet kommer ikke til å oppdage at det finnes en nyere versjon av Coppermine tilgjenglig og heller ikke vil det laste ned noenting fra Coppermines hjemmeside. Automatiseringsnivået i Coppermine er ikke avansert nok (foreløpig).

For å se om det finnes nye versjoner eller vedlikeholdsreleaser, se nyheter fra coppermine-gallery.net.

Tilatelseskontroll

I Coppermine versjonen før cpg1.5.x, brukte oppdateringsprogrammet være offentlig tilgjengelig, d.v.s. alle kunne kjøre det. Mens dette var bra for suportformål (suportere kunne kjøre oppdateringsprogrammet for brukere som trengte hjelp om det var åpenbart at de ikke gjorde det), så var det en liten riskiko at denne tilgjengelighet for alle i noen tilfelle kunne innebære en sikkerhetsrisiko. Derfor besluttet utviklingsteamet å beskytte oppdateringsprogrammet fra å kunne kjøres av hvem som hadde tilgang til det - fra og med cpg1.5x må du angi administrator-opplysninge. Det kan du gjøre på fire ulike sett:

Når må man oppdatere?

Du må oppdaterere hver gang du oppdaterer/oppgraderer/sletter, eller hver gang som filen sql/update.sql erstattes med en ny versjon.

Det skader ikke å kjøre oppdateringsprogrammet flere ganger, så hvis du er usikker kan du kjøre det igjen.

Versjonskontroll-verktøyet

Etter utgivelsen av cpg1.3.2 har Coppermine et versjonskontroll-verktøy som gjør det enklere å løse spørsmål om oppgraderinger og oppdateringer. for å kjøre versjonskontrollen, legg bare til versioncheck.php til adressen i din webleser etter at du har logget inn som administrator (eksempel: http://din_side.no/din_coppermine_mappe/versioncheck.php). I og med 1.5.x, kan du kjøre versjonskontrollfunksjonen fra administratormenyen.

versjonskontrollverktøyet utfører ikke noen faktiske oppdateringer: det laster ikke ned nyere versjoner av Coppermine for deg og ikke installerer det noen programrettinger - det er bare der for å gjøre deg oppmerksom på om det finnes nyere versjoner og om du allerede har opgraderet korrekt.

Hva gjør Versjonskontroll-verktøyet

Programmet "versjonskontroll" er der for to formål:

Programmet går gjennom filene på din webserver og forsøker å bestemme om disse er identiske med de som finnes i lageret på http://coppermine-gallery.net. Filer som ikke matcher vises og disse er de filer du også burde oppdatere.

Som med tidligere versjoner har versjonskontrollsiden blit forandret for cpg1.5.x både visuellt og funksjonsmessig.

Første versjonskontroll

Ved første versjonskontroll vil du se at alternativ skjermen først vises. Fra starten burde standardalternativet være OK, så bare prøv å bruke det. Programmet vil da bestemme hvilken Coppermine versjon du for tiden bruker, og vil søke om den XML fil på Coppermines lager som tilsvarer din versjon. Det vil sammenligne alle filer som finnes på din server med de siste som det anbefales å bruke (forsøker å få disse data fra lageret). Du bør du se en liste med mapper og filer som burde finnes på din server og en forklaring om de filversjonene som du har er de siste. for detaljer om hvordan du skal tolke innformasjonen, les videre.

Alternative innstillinger

Det er flere alternativer på versjonskontrollsiden, som burde være ganske selvforklarande:

Alternativskjermen lar deg konfigurere versjonskontrollen, eller det som vises. Alternativenne lagres ingensteder, så du må justere dem hver gang du kjører versjonskontrollen. Standardalternativet burde være OK for de fleste brukere - forandre dem bare om du har et spesiellt behov for å gjøre det.

Versjonssammenligning

Det er mye informason som vises på liten plass. Her er det eksempeler på mulige utdata og hva det betyr:

Ting som kan gå feil når man kjører versjonskontrollen

Nå versjonskontrollen kjøres blir kompliserte oppgaver iverksatt, det kan oppstå feil avhengig av hvordan din webserver er oppsatt:

Verktøyet versjonskontroll tilbys for å tilfredstille slutbrukeren. Da det er mange faktorer som kan påvirke den, kan hende at det ikke fungerer på din webserver. Hvis versjonskontrollen ikke gjør noenting gjeller dette antagligvis for deg - Du behøver ikke bekymre deg over det: Vær nøye med å holde din Coppermine installasjon up to date, fortrinnsvis ved å aktivere konfigurasjonsalternativet "Vis nyheter fra coppermine-gallery.net". bare hvis enkelte problem rapporteres av versjonskontrollverktøyet (eg. bare om noen rader inneholder en anmerkning i kommentarkollonen), bør du undersøke mere.

Feil forventninger

For en del kan dette virke trivielt, mens det for andre er viktig informasjon: naturligvis er det slik at filer som du ikke har erstattet under oppgraderingsprosessen (fks.. anycontent.php) vil vises som foreldet i utdataene fra versjonskontrollen. Det er selvsagt hva som kan forventes. Det skader ikke om du gjorde oppgraderingen nøyaktig som beskrevet, fordi de filer du skulle beholde under prosessen ikke inneholder noen koder som behøver oppdateres. Som for eksempel, anycontent.php inneholder ingen koder (i hvert fall ikke den som kommer med Coppermine). Den kan inneholde tilpassede koder hvis du bestemmer deg for å bruke det. For mer innformasjon om bruken av anycontent.php, se avsnittet "bruke anycontent.php".

Versionskontrollverktøyet gjør ingen nedlastinger av nyere filversjoner fra internett - det bare kontrollerer filene du har på din server sammenlignet med en liste på siste gjeldende filer fra utgiveren av programmet. Versionskontrollverktøyet kontrollerer ikke eller renser din side for hackere.

Oppgradering FAQ

Neddatere fra cpg1.5.x til en eldre versjon

CPG1.5.x inneholder mange nye funksjoner (sammenlignet med eldre versjoner), så vi oppmuntrer våre brukere å opgradere. Det er noen som vil test ut cpg1.5.x og senere bestemme seg for at de vil gå tilbake til en eldre versjon. Du må tenke på at en full oppgradering forandrer det overgripende utseendet på Coppermines database som også inkluderer en konvertering av kodingen til unicode. Denne prosess kan ikke angres: når du en gang har gjort konverteringen, er den eneste veien tilbake og gjøre en komplett mySQL database backup (du må selvfølgelig gjøre denne backup før du oppdaterer uansett). Og gjøre mySQL dumpinger (backuper) anbefales, så du bør gjøre det .

For Å gjøre dette absolutt klart: du kan bare nedgradere om du brukte cpg1.4.x først og opgraderte til denne versjon av cpg1.5.x. Hvis du har en ny innstallasjon av cpg1.5.x, kan du ikke nedgradere overhodet!

For å utføre nedgraderingen, erstatt alle cpg1.5.x filer på din server med filer fra en eldre versjon (som om du gjorde en oppgradering, se over). Les siden som omhandler sikkerhetskopier, som du må ha gjort av databasen før oppgraderingen. Hvis du ikke har noen database dump kan du ikke nedgradere!