Attachments Documentation
Version 1.2 - February 20, 2008
Norwegian Bokmaal (nb-NO) translation by: Espen Gjelsvik - www.get-web.no / espen@get-web.no
- Introduksjon
- Opplastings begrensninger
- Innstillinger
- Vis filnavn
- Endre utseendet på vedleggslisten
- Ikoner for filtyper
- Advarsler
- Oppdatering
- Bekjennelser
Introduksjon
Programutvidelsen 'Attachments' til Joomla! gjør det mulig å legge ved filer til artikkler.
Inkludert er en plugin for å vise vedlegg, i tilegg til en komponent for opplasting og administrasjon av vedlegg.
Det er mulighet for å kontrollere hvem som skal ha tilgang til å se vedlegg, og hvem som skal ha tilgang til å laste dem opp,
i tilegg er det flere andre muligheter for å øke fleksibilitet og bruksområde.
Merk: alle instillinger styres fra komponent manageren. Denne programutvidelsen fungerer kun med Joomla! 1.5 eller nyere.
Dette tilegget har muligheter for språkpakker, og støtter følgende språk (i tilegg til Engelsk):
- Kinesisk: Tradisjonell og forenklet kinesisk, oversatt av
baijianpeng (http://www.joomlagate.com).
(Hjelp filen er ikke oversatt enda.)
- Nederlandsk: Oversatt av Parvus. (Takk Parvus!)
- Portugisisk/Brasiliansk: Oversatt av Arnaldo Giacomitti
(www.giacomitti.eng.br) og Cauan Cabral (www.cauancabral.net).
- German: Oversatt av Michael Scherer. (Takk Michael!)
- Finnish: Oversatt av Tapani Lehtonen. (Takk Tapani!)
- Spanish: Oversatt av Carlos Alfaro. (Takk Carlos!)
- Norsk (bokmål): Oversatt av Espen Gjelsvik (www.get-web.no)
Mange takk til oversetterne! Har du lyst til å hjelpe til ned å oversette til et språk som enda ikke er støttet? Ta kontakt med forfatteren (se nederst).
[Til toppen]
Opplastings begrensninger
Ikke alle filtyper kan lastet opp. 'Attachments' vil kun tillate filtyper som er definert i Joomla!`s Media manager.
For å se (og endre) tilatte filtyper naviger til Global konfigurasjon og klikk på fanen System.
Under mediainstillinger kan du kontrollere hvilke filendelser og mime typer som er tillatt for opplasting.
'Attachments' tar hensyn til disse begrensningene, med unntak 'Tillatte filendelser for bilder (filtyper)' da disse blir ignorert.
[Til toppen]
Innstillinger
Alle innstillinger for 'Attachments' kan endres i kontrollpanelet til komponenter.
For å endre på disse, gå til administrasjonssiden, velg "Artikkel Vedlegg" under "Komponenter" menyen.
Klikk på "Parametre" i enden av verktøylinjen og du vil nå se alle parametre du kan endre.
Disse parametrene er som følger::
- Hvem kan se vedlegg: Denne instillingen styrer hvem som kan se listen over vedlegg i en artikkel.
Det er to valg for denne instillingen:
- 'alle'. - Dette valget lar vedleggene være synlige for alle besøkende, uansett om de er innlogget eller ikke.
- 'innlogget bruker'. - Dette valget lar vedleggene kun være synlig for brukere som er innlogget.
- Hvem som kan legge til vedlegg: Dette valget kontrollerer hvem som skal ha tilgang til å kunne legge ved et vedlegg til en artikkel.
Her har man to valg:
- 'Artikkelens forfatter' - Link for å legge til vedlegg vil kun være synlig for forfatteren av artikkelen.
- 'Innlogget bruker' - Link for å legge til vedlegg vil være synlige for alle innloggede brukere.
- Vedlegg publiseres automatisk: Denne 'auto
publiser' muligheten lar deg kontrollere om vedleggene skal publiseres automatisk med en gang de er lastet opp.
Hvis du velger 'Ja' vil vedleggene være synlige for brukere umiddelbart etter opplasting. Velger du
'Nei' vil de ikke bli publisert. De må manuelt publiseres av en Administrator.
- Advarsel for automatisk publisering: Hvis du velger å deaktivere automatisk publisering, har du her muligheten til å
legge til en melding som forklarer fremgangsmåten for manuell publisering.
Hvis du lar dette feltet stå tomt vil de få en generell feilmelding som foreslår at de skal kontakte en administrator for å få hjelp til publisering.
- Vis titler: Hvis denne settes til 'Ja' vil en rad med titler legges til i toppen av vedleggslisten,
som beskriver hva hver kolonne inneholder.
- Vis vedleggs beskrivele: Dette valget kontrollerer om vedleggets beskrivelse skal vises.
- Vis filstørrelse: Dette valget kontrollerer om filstørrelsen vises i listen over vedlegg.
- Vis dato for endring: Hvis denne settes til
'Ja', så vil dato for siste endring av filen vises i listen over vedlegg.
- Dato format for endringsdato: Du kan
selv velge format for visning av endringsdatoen. Dette gjøres ved bruk av 'date' funksjonen i PHP.
Som standard er følgende format valgt "M-j-Y g:ia"
Dette vil gi følgende resultat "Sep-29-2007 5:05pm". Vil du vise kun dato, ikke klokkeslett så kan du fjerne 'g:ia' delen.
- Maks lengde for filnavn:
Her kontrolleres makslengden for filnavn som skal vises i vedleggslisten.
Filnavn lenger enn maksgrensen vil bli beskåret. (av kosmetiske årsaker vil det faktiske filnavnet ikke endres.)
Verdi 0 betyr at filnavnet kan være uendelig (filnavn feltet i vedleggsdatabase er begrenset til 80 tegn.)
Merk: Hvis filnavn er beskåret, vil det fulle filnavnet fortsatt vises i feltet "visnings navn"
- CSS stil for vedleggs listen:For å overstyre
CSS stilen til vedleggslisten så kan du definere en egen stil her.
Standar stilnavnet er 'attachmensList'. Se [Endre utseendet på vedleggslisten] for mer informasjon.
- Metode for vedleggs link:
Her kan du velge hvordan linken til et vedleggs skal åpnes.
'I samme vindu' vil åpne linken i samme vindu. 'I nytt vindu' vil åpne et nytt vindu, i noen nettlesere vil det åpnes i en ny fane.
- Styring av filnavn: Denne innstillingen
lar deg kontrollere et prefiks som settes inn i forkant av filnavnet.
Du har tre valg.
- 'Artikkel ID' - Her settes ID til artikkelen i forkant av filnavnet. Dette vil kunne forhindre konflikter der flere vedlegg har samme navn.
- 'Vedleggets ID' - Som over, bare at her velges ID`n fra vedlegget.
- 'Ingenting' - Hvis du velger dette alternativet vil filnavnet ikke endres. Du må selv passe på at det ikke oppstår konflikter med filnavn.
- Undermappe for opplasting: 'Attachments'
programutvidelsen vil legge filer i denne undermappen i topnivået for din Joomla! installaskon.
Advarsel: Hvis du endrer denne instillingen må du selv opprette den nye mappen manuelt før du laster opp nye vedlegg.
Merk at om denne mappen endres så har dette ikke tilbakevirkende kraft, vedlegg lastet opp før endringen vil fortsatt ligge i den gamle mappen.
- Egdendefinert tittel for vedleggsliste:Som
Standard så setter 'Attachments' teksten "Vedlegg:" som overskrift på vedleggslisten.
I noen tilfeller ønsker du kanskje å benytte en annen overskrift. Du har her muligheten til å spesifisere
overskriften pr artikkel. For eksempel hvis du ønsker at vedleggslisten i artikkel 211 skal ha overskriften "Downloads:"
så kan du gjøre følgende:
'211 Downloads' (uten annførselstegn). En overskrift pr linje.
- Skjul vedlegg for:
Kommasepparert liste over nøkkelord eller Seksjoner/Kategorier der vedleggslisten ikke skal vises. To spesial nøkkelsord kan brukes: 'frontpage' for å fjerne vedleggslisten på forsiden. og 'all_but_article_views' for kun å vise vedlegg i artikkelvisning. (Fjern anførselstegnene når du legger inn nøkkelord.) Seksjon/Kategori ID`ene må oppgis som en nummerisk verdi separert med en skråstrek(/): Seksjon#/Kategori#, Seksjon#/Kategori#, Bruk bare 'Seksjon#' for å definere alle kategorier for en gitt seksjon. F.eks: 23/10, 23/11, 24. Som vil fjerne vedleggslisten for kategiri med ID 10 og 11 i Seksjon med ID 23, samt at alle kategorier i seksjon med ID 24 vil være uten vedleggsliste.
- Sikre nedlastninger: 'Attachments'
lagrer som standard alle vedlegg i en fritt tilgjengelig undermappe. Hvis du velger sikre
nedlastinger så vil mappen vedleggs lagres i gjøres utilgjengelig .
Nedlastningslinkene i frontend vil la deg laste ned vedleggene, men de vil ikke være direkte linker.
Dette vil forhindre tilgang til filene hvis ikke brukeren har de korrekte tilgangene.
Hvis sikre nedlastninger ikke velges, vil nedlastningslinkene fortsatt ikke være direkte linker, men filene vil være tilgjengelig for alle som kan
den fulle URL adressen til undermappen, da den fortsatt vil være fritt tilgjengelig.
Velger du sikre nedlastninger vil tilgangen til filer bli forhindret selv om noen skulle vite den fulle URL adressen, dette fordi undermappen nå vil beskyttes.
Merk: i sikre modus vil ikke vedleggslisten vises til brukere som ikke er logget inn.
- Nedlastningsmodus for sikre nedlastninger:
Dette valget kontrollerer om vedleggene skal lastes ned som separate filer, eller om de skal vises i nettleser
(om nettleseren støtter gitt filtype). Det er to alternativer her:
- 'integrert':Vedlegg vil åpnes i nettleseren hvis det er støtte for det, (slik som bilder og tekst).
- 'vedlegg':Vedlegg vil lastes ned som en separat fil.
Uansett, filer som ikke støttes av nettleseren vil i begge tilfeller bli lastet ned som en separat fil.
[Til toppen]
Visning av filnavn
Normalt når filer lastes opp og vises i en vedleggsliste så vil hele filnavnet vises som en nedlastnings link.
I noen tilfeller vil filnavnet være for langt for at dette skal fungere smertefritt. I opplasningsskjemaet
har man et felt kalt "visnings navn", her kan man velge et alternativt filnavn som skal vises i stedet for det hele filnavnet.
Merk: Det er en parameter som heter 'Maks lengde for filnavn' her settes begrensningen på filnavnet, er filnavnet lenger enn denne begrensningen så vil resten av
filnavnet vises i feltet for visnings navn.
[Til toppen]
Endre utseendet på vedleggslisten
Vedleggslisten som vises i artiklene bruker en spesiell 'div'
som inneholder en tanell for vedleggene.
Tabellen har flere forskjellige CSS klasser tilknyttet, dette forenkler jobben til webansvarlig og forbedrer fleksibiliteten.
Se i CSS filen for programutvidelsen for eksempler (plugins/content/attachments.css).
Ønsker du å endre stilen, så kan du kopiere den orginale stilen inn i slutten av den samme filen og gi nytt navn til 'attachmensList' til noe du selv velger.
I kontrolpanelet til Attachments programutvidelsen så endrer du parameteren for CSS stil for vedleggs listen: til å inneholde den nye stilen du har deifnert i bunn av CSS filen.
På denne måten kan du enkelt skifte mellom utseendet, vil du ha tilbake det orginale utseendet så sett parametren til 'attachmentList'.
[Til toppen]
Ikoner for filtyper
'Attachments' programutvidelsen legger til ikoner forran hver fil i vedleggslisten.
Ønsker du å legge til en filtype gjør følgende:
(1) Legg til ønsket ikon i mappen 'media/attachments/icons', hvis det ikke allerede finnes et passende ikon der.
(2) Åpne og rediger følgende fil: 'components/com_attachments/file_types.php' legg til en passende linje til det
statiske array`et $attachments_icon_from_file_extension som kobler et ikon til en filtype.
Skulle ikke dette fungere må du kanskje legge til en ny linje i arrayet $attachments_icon_from_mime_type.
(3) Husk å ta kopi av ikon filen og av file_types.php filen før du foretar en oppdatering av programutvidelsen, slik at de ikke blir overskrevet.
[Til toppen]
Advarsler
- Hvis du har sensitive eller private vedlegg bruk sikkerhetsfunksjonen til å forhindre tilgang til vedleggene.
Bruker du ikke denne funksjonen, så vil vedleggene bli lagret i en fritt tilgjengelig mappe som alle kan åpne forutsatt at de kjenner til URL`n.
Sikre funksjonen forhindrer tilgang til alle som ikke har rettigheter.
- Hver gang en fil blir lastet opp så sjekkes det om opplastingsmappen finnes, gjør den ikke det vil den opprettes automatisk.
Hvis 'Attachments' ikke lykkes med å opprette mappen, må du opprette den selv. Husk å sette riktige rettigheter på mappen som tillater opplastning til den.
I unix/linus verdenen kan du sette chmod 744.
- Skulle du få problemer med å laste opp visse filtyper så husk at denne programutvidelsen
henter listen over tillatte filtyper fra Media behandleren. Kun en administrator kan administrere hvilke filtyper som er tillatt.
- Det er en plugin som heter 'add_attachment_btn_plugin' (I plugin manageren heter den 'Button - AddAttachment')
Denne legger til en knapp i bunn av redigerings bildet for artikkler.
Har du installert denne plugin, men får ikke opp knappen, så sjekk at plugin er aktivert.
Merk: Denne knappen er ikke aktiv i bildet der du legger til ny artikkel, den er kun tilgjengelig når du redigerer en eksisterende artikkel.
- Denne versjonen ser ut til å fungere med SEF sammen med Joomla! 1.5
RC3 og RC4 utgivelser. Oppdateringen av 'Attachments' til RC3 ser ut til å ødelegge for SEF med RC2.
[Back to top]
Oppdatering
Har du vedlegg lastet opp med en tidligere versjon som du ønsker å overføre til en ny versjon så følg disse stegene:
- Bruk phpMyAdmin (eller lignende verktøy for SQL dumping) for å lagre innholdet av tabellen jos_attachments (ved bruk av export funksjonen, bruk "complete insert" ikke "extended).
- Avinstaller 'Attachments' komponenten.
- Avinstaller 'Attachments' programutvidelsen.
- Installer så den nye versjonen ved å pakke ut zip filen. Installer programutvidelsen først, deretter komponenten
- Aktiver 'Attachments' programutvidelsen.
- Bruk så phpMyAdmin til å legge tilbake dataene inn i den nye tabellen jos_attachments.
- Oppgraderer du fra en versjon før 1.0 til en versjon etter 1.0 må du gå inn i administrasjonssiden å legge til de korrekte verdiene for feltet
'icon_filename' dette gjøres ved å logge inn i administrasjonssiden og så gå til følgende url
/administrator/index.php?option=com_attachments&task=add_icon_filenames
Merk at avinstallering av 'Attachments' programutvidelsen ikke fjerner tidligere opplastede filer,
men den fjerner vedleggs tabellen i databasen. Så etter å ha reinstallert en ny versjon av 'Attachments', er det kun nødvendig å legge tilbake
vedleggstabellen for å gjenopprette alle tidligere vedlegg.
Ønsker du ikke å gjenopprette tidligere vedlegg så ikke glem å slette filene manuelt fra opplastingsmappen.
Dette vil forhindre at det oppstår konflikter der to filer har samme navn.
[Til toppen]
Bekjennelser
Mange takk til de følgende bidragsytere og resurser:
- Boken Learning Joomla! 1.5 Extension Development: Creating Modules,
Components, and Plugins with PHP by Joseph L. LeBlanc denne var veldig nyttig under arbeidet med 'Attachments'.
- Ikoner for filtyper kommer fra flere kilder, deriblandt:
Merk at de fleste ikonene er modifisert og redigert for å passe inn. Ønsker du laste ned orginalene så hent de fra sidene ovenfor.
[Back to top]
Vennligst rapporter alle feil og øsnker til jmcameron@jmcameron.net.