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

Innholdsfortegnelse

Brukere

I denne dokumentasjonen er termologien "bruker" benyttet for registrerte brukere som har en registrert konto og er innlogget. Termologien "gjest" brukes for alle, både registrerte brukere og uregistrerte gjester. Registrerings-muligheter vises bare (hvis gjester tillates å registrere seg og hvordan registreringen fungerer) blir konfigurert i den korresponderende seksjon konfigurering. Coppermine har en egen funksjon som tilater deg å kontrollere hva grupper dine brukere er i (gruppe medlemskaps-tilatelser) untagen hvis du har deaktivert den innebygde (behandle brukere) hvis du bruker funksjonenun linking av Coppermine med en annen applikasjon. Hvis du aktiverer linking, vil den linkede aplikasjonen ta over og dine brukere blir kontrollert av denne aplikasjon istedet for Coppermine.

Brukerkontroll-panel

Brukerkontrollpanelet finner du ved å klikke på "brukere" i administrator-menyen. Her kan du opprette og administrere dine brukere.

Hvis du har aktivert (linking) til Coppermine med en annen aplikasjon (fks. din favoritt applikasjon), Vil Coppermine benytte brukerlisten i applikasjonen du linket til med (din BBS), slik at den innebygde Coppermine brukeradministrasjon vil bli deaktivert i forhold til brukeradministrasjonen som følger med den linkede aplikasjonen. Dette er laget slik for å unngå en overflødig og upassende integrasjon.
Som et resultat av dette, vil du ikke ha tilgang til dette kontrollpanelet. Ved å klikke på linken "brukere" blir du i sedet sendt til din linkede aplikasjons brukeradministrasjon.


Sidens kontrollmuligheter

Søk bruker(e)

Du kan søke: * (for en streng) og ? (en enkel karakter) eller %expression%.
Eksempel: søke etter j* vil vise både Jon og Jeanette

Opprette nye brukere

For å opprette nye brukere, bare klikk på knappen "Opprett ny bruker" nederst på brukeradministrasjonssiden, og skriv inn i formulæret som dukker opp.

Dette vil ikke virke hvis du har linket galleriet til en annen aplikasjon, da brukeradministrasjonen blir utført av den aplikasjonen du har linket Coppermine med. I dette tilfellet, vil brukeradministrasjonssiden for din linkede aplikasjon dukke opp - opprett en ny bruker der.

Administrere brukere

For å administrere brukerenes tilatelser, klikk på rediger-knappen ved siden av brukerens navn. Du vil da komme til en side hvor du kan forandre alle brukerens felter. Dette inkluderer også muligheten til å forandre passordet for denne brukeren. Hvis du ikke ønsker å forandre en brukers passord la passordfeltet stå tomt.
Gardinmenyen viser hvilken primærgruppe brukeren er plassert i. Sjekkboksen under viser sekundærgrupper.

Noter deg at dette formulæret (som resten av Coppermines bruker formulærer) blir utilgjengelige hvis du har aktivert linking, fordi brukerbehandlingen i din linkede aplikasjon (fks. din BBS) overstyrer og benyttes for all brukerbehandling.

Albumtilatelser pr. gruppe

Linken "Albumtilatelser pr. gruppe" lar deg vise hvilken album som er tilegnet medlemer av en gruppe. For å gjøre dette absolutt klart: denne funksjonen lar deg ikke tilegne album til grupper, den bare viser disse tilatelsene. For å tilegne album til utvalgte grupper, bruk album tilatelser for induviduelle album.

Gruppemedlemskap

Når du oppretter en ny bruker eller administrerer en eksisterende bruker, vil du se en linje kallt "Brukergrupper" - den viser hvilke gruppe(r) brukeren er plassert i.
Det første feltet (en gardinmeny) viser de primære brukergrupper. Det viser brukerens status. Du kan sette det til "Administrator" (for brukere som du ønsker skal ha administrator-rettigheter) eller "Registerte".
Andre (sekundære) grupper kan tillegges ved å bruke sjekkboksen under gardinmenyen. Her vises alle dine selvlagde grupper (som du kan opprette og administrere ved å bruke gruppe kontrollpanelet) og standardgruppene (de som følger med Coppermine og ikke kan slettes). Legg til andre grupper for dine brukere her. Privilegier for en spesiel brukertype legges til her: de minst restriktive tilatelser kan bli lagt til.

Hvis du ønsker at dine registrerte brukere bare skal ha mulighet til å se en oversikt for galleriet, og bare priviligerte brukere i din selvlagde gruppe "fotografer" har tilatelse til å laste opp filer, legg alle brukere i standardgruppen "registrete" (som standard, der de alle havner først). Bare brukere som du vil gi tilatelser til å laste opp filer, legger du i gruppen "fotografer" som en sekundærgruppe. Gå så til gruppekontrollpanelet og still inn slik at gruppen "registrerte" ikke har tilatelse til å laste opp filer der. Tillat så opplasting for din selvlagde gruppe "fotografer".

Noter: knappen "albumtilatelser pr. gruppe" under sjekkboksen er ikke ment for å tilegne albumtilatelser, men bare for å sjekke tilatelsene som er satt. Du kan bare tillegge partikulære albumtilatelser på albumtilatelser skjermbildet.

Glemte passord

Det er mange passord å huske på og mange saker relatert til passord. Ikke alle er relatert til Coppermine så de vil ikke tas opp i full bredde her. Hvis du har behov for å finne ut av passorddetaljer som ikke er relatert til selve Coppermine, er det en god ide å benytte søkemotorer/eller ditt webhotels hjelpefunksjoner.

Coppermine brukerpassord

Det er ingen forskjell mellom en administrator eller en ikke-administrator brukerkonto: de begge fungerer på samme måte: du må logge inn med et brukernavn (eller en email addresse hvis du tillater koresponderende valg i Coppermines konfigurasjon) og et passord. Hvis idenifikasjonen er riktig, dvs. Om Coppermine "kjenner" deg, vil Coppermine oppdage om din brukerkonto tilhører admin gruppen eller ikke. Basert på gruppemedlemsskapet vil du ha forskjellige privilegier.
Det er imidlertid en vesentlig forskjell mellom Coppermine i selvstendig modus (som standard) og Coppermine linket med en annen aplikasjon:

Coppermine i standardmodus

Databasetabellen som Coppermine brukere lagres i inneholder ikke brukerenes passord i vanlig tekst men bare en MD5-kryptert passord hash. Forestill deg hash som en summeringssjekk: i virkligheten er det et resultat av en kalkuleringing: når passordet skrives inn på Coppermines innloggingsskjerm, sender browseren passordet som gjesten har lagt inn til serveren. Serveren kalkulerer hash koden som gjesten har lagt inn og sammenligner med det som er lagret i databasen. Hvis denne hash verdien matcher, blir passordet lest som korrekt og brukeren er identifisert, en cookie er lagret på gjestens computer som hovedsaklig sier "brukeren med navnet XYZ er idenifisert". Igjen, inngen passord er lagret noe sted.
Når dette er sagt er det opplagt at du ikke kan åpne passordet noe sted, simpelthen fordi det ikke er lagret noe sted.
Men vi er alle mennesker og det kan skje at du (som en som driver et Coppermine galleri) eller at dine brukere glemmer sine passord av en eller annen grunn. Derfor er det en mekanisme som gjør at du kan logge inn igjen. Desverre kan du ikke bare sende en passordhukommelse med en email, ganske enkelt fordi serveren ikke har passordet. Derfor er det en link i Coppermines innloggingsbilde som kalles "Jeg har glemt mitt passord". Hvis en gjest klikker på den vil gjesten bli sendt til et formulær hvor det er mulig å entre sin email addresse. Men vent litt! Har du ikke akkurat sagt at serveren ikke vet passordet og derfor ikke kan sende dette via email? Ja det er riktig. Det er egentlig en tre trins prosses: gjesten kan skrive inn sin emailadresse. Hvis en bruker med denne email addressen eksisterer i Coppermines brukertabell, blir en email sendt til denne adressen som inneholder en link som motakeren må klikke på for å verifisere at brukeren har glemt sitt passord og ønsker å få ett nytt. Dette er gjort slik for å forhindre at noen blir utelukket pga. noen med uærlige hensikter prøver å forespørre etter et nytt passord på andres vegne. Linken i emailen inneholder en "token" som ingen kan gjette seg til eller oppkonstruere: Dette er unikt. Bare hvis denne linken bebyttes vil passord-hjelpen starte. Serveren produserer et tilfeldig passord for kontoen som koresponderer med email adressen og sender det nye passordet i en ny email. Med det nye passordet som blir sendt i mail nr. to, kan brukeren logge seg inn igjen.
Dette er en meget elegant måte å løse problemet på hvis dette er satt opp på en skikkelig måte, men det er selvfølgelig noe som kan gå feil:
  • Brukeren må huske emailadressen som opprinnelig ble brukt for å opprette kontoen
  • Brukeren må ha tilgang til email adressen, dvs. at brukeren må huske sitt ikke-Coppermine passord for email kontoen
  • Email addressen som koresponderer med brukerkontoen må være opprettet først, som kanskje ikke kan være tilfellet for administratoren hvis han mislykkes i opprettelsen for sin egen konto
  • Serveren må være kobfigurert slik at den virklig sender emailer
  • Email sendt av serveren kan bli blokkert av en tredjeparts spam filter
Hvis dette er tilfellet for deg fks. hvis du har glemt Coppermines admin konto og du ikke kan bruke "glemt passord" funksjonen av en eller annen grunn, kan du gjøre som følgende:
  • Hvis du har tilgang til phpMyAdmin, sett et nytt passord for din Coppermine brukerkonto. Her er instruksjonene som ble postet av en bruker på Coppermine hjelpeforum:
    Når du har lukket opp phpMyAdmin vil du se databasene til venstre. Åpne databasen som hører til Coppermine. Til venstre vil du se tabellene.
    Klikk på tabellen kallt XXX_users, hvor XXX er tabelprefixet som du valgte ved innstalleringen av Coppermine første gang (fra boksen, er prefixet cpg15x_, så standard navn for tabellen skal være cpg15x_users). Du må klikke på ikonet til venstre av teksten, hvis ikke vil du ikke få opp den rette visningen.
    Hvis du har mistet ditt admin passord se på kolonnen kalt user_id. Se på den 1. Dette er admin kontoen som du opprettet ved installasjonen. Til venstre av denne kolonnen er det et retteikon (som betyr rediger). Klikk på det.
    Nå skal du ha felter som du kan skrive i.
    Til høyre for linjen kallt user_pass ligger det krypterte passordet. Slett det som står der og fyll inn med .
    Dette vil forandre passordet til admin. Du må ikke la passordfeltet stå tomt. Nederst på siden like under lyspæren står det Save. Hvis det er slik klikk på go knappen. Gå ut av phpMyAdmin ved å klikke "exit" ikonet på sidens øvre venstre hjørne.
    Skriv inn URL adressen til din Coppermine side. Logg inn med ditt brukernavn og passordet admin. Straks du har logget inn bør du selvfølgelig forandre ditt passord til noe annet i stedet for admin. Klikk på "Min profil" skroll ned til bunnen av siden og klikk på "Forandre passordet". Skriv inn det gamle passordet (admin) og ditt nye passord (som du må bekrefte en gang til) og bekreft formulæret. Hvis alt går riktig vill du se en melding som bekrefter dette.
    Du kan bruke den samme fremgangsmåten for brukere: logg inn som administrator, gå til bruker kontrollpanelet, rediger brukerens profil ved å klikke rediger ikonet ved siden av brukernavnet og deretter skrive inn et nytt passord i de riktige feltene.
    Et annet alternative er å bruke phpMyAdmin uten å forandre noe men ved å bruke rainbow table siden og søke etter passordet som matcher den hash som du kan få tilbake ved å bruke phpMyAdmin.
  • Hvis du ikke har tilgang til phpMyAdmin, kan du gjøre følgende for å opprette en ny administrator-konto:
    • Bruk din favoritt teksteditor (notepad.exe er fin) for å skrive tekstfiler med dette innholdet:
    • Kall filen adminpass.php og last den opp til din webserver i Coppermines rot mappe
    • Kjør filen med din internettleser ved å skrive inn URL adressen for filen som du lastet opp (omtrent slik http://yourdomain.tld/your_coppermine_folder/adminpass.php) i addressefeltet i din internettleser
    • Viktig: slett filen adminpass.php fra din server - det er risikabelt for din side hvisdu ikke gjør dette!
    • Logg inn med den nye brukeren som skriptet har opprettet for deg.
    • Bytt passord umidelbart straks du har logget deg på.

Coppermine linket til annen aplikasjon

Når Coppermine er linket med annen aplikasjon, vil bruker-redigeringen for den linked eaplikasjon "ta over", så hvis en gjest klikker på logg inn linken i Coppermine blir brukeren omdirigert til din linkede aplikasjons innlogings-side. Etter å ha logget inn der kan brukeren bli sendt tilbake til ditt Coppermine-drevne galleri (hvis din linkede aplikasjon støtter omdirigering etter innlogging). Coppermine er bare "klar over" at brukeren er identifisert i din linkede aplikasjon; Coppermine er ikke bevisst brukerens passord. Derfor kan du ikke bruke Coppermine mekanismer for å få tilbake mistede brukerkontoers passord når du benytter linking til annen aplikasjon. Hvis din linkede aplikasjon har mekanismer for å få tilbake mistede passord må du bruke disse mekanismer.

mySQL konto passord

Hvis du (eller ditt wbhotell) har forandret din mySQL konto-detaljer (fks. hvis du har opprettet et nytt passord for din mySQL konto) kan du ta hensyn til dette i Coppermine ved å redigere filen include/config.inc.php.
Vær klar over at du bare kan gjenspeile dine mySQL database konto forandringer i denne filen. Coppermine kan ikke forandre passordet til din mySQL konto. Hvis du ønskerå gjøre det (fks. forandre din mySQL admin kontos passord), bruk den mekanismen dom ditt webhotell tillater eller spør ditt webhotell om å forandre det for deg.