Attachments Documentation

Version 1.2 - February 20, 2008

Norwegian Bokmaal (nb-NO) translation by: Espen Gjelsvik - www.get-web.no / espen@get-web.no

  1. Introduksjon
  2. Opplastings begrensninger
  3. Innstillinger
  4. Vis filnavn
  5. Endre utseendet på vedleggslisten
  6. Ikoner for filtyper
  7. Advarsler
  8. Oppdatering
  9. 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):

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::
[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

[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:
  1. 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).
  2. Avinstaller 'Attachments' komponenten.
  3. Avinstaller 'Attachments' programutvidelsen.
  4. Installer så den nye versjonen ved å pakke ut zip filen. Installer programutvidelsen først, deretter komponenten
  5. Aktiver 'Attachments' programutvidelsen.
  6. Bruk så phpMyAdmin til å legge tilbake dataene inn i den nye tabellen jos_attachments.
  7. 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: [Back to top]

Vennligst rapporter alle feil og øsnker til jmcameron@jmcameron.net.