Attachments Dokumentaatio
Versio 1.2 - February 20, 2008
- Esittely
- Rajoitukset tallennuksessa
- Asetukset
- Näytä tiedostojen nimet
- Liitelistojen muotoilu
- Tiedosto tyyppien kuvakkeet
- Varoitukset
- Päivittäminen
- Kiitokset
Esittely
The 'Attachments' - laajennus Joomla!:lle mahdollistaa tiedostojen liittämisen artikkeleihin.
'Attachments' sisältää liitännäisen liitteiden näyttämiseksi ja komponentin liitteiden lataamista ja hallintaa varten.
Asetuksista voi määrittää ketkä näkevät ja kuka voi lisätä liitteitä sekä monia muita käytettävyyttä parantavia valintoja.
Huom!: Kaikki valinnat tehdään komponenttien hallinnan kautta. Tämä laajennus toimii vain Joomla! 1.5:ssa tai sitä uudemmassa versiossa.
Tämä laajennus sisältää käännöksen sekä tukee englannin lisäksi seuraavia kieliä:
-
Kiina: Perinteinen ja yksinkertaistettu kiina. Kääntäjä: baijianpeng (http://www.joomlagate.com). (Kiitos baijianpeng)
-
Hollanti: Kääntäjä: Parvus. (Kiitos Parvus!)
-
Suomi: Kääntäjä: Tapani Lehtonen (www.tapanilehtonen.info). (Kiitos Tapani!)
-
Norja: Kääntäjä: Espen Gjelsvik. (Kiitos Espen!)
-
Portugali/Brasilia: Kääntäjät: Arnaldo Giacomitti (www.giacomitti.eng.br) ja Cauan Cabral (www.cauancabral.net).
-
Espanja: Kääntäjä: Carlos Alfaro. (Kiitos Carlos!)
Kiitos käännösten tekijöille! Jos haluat auttaa kääntämisessä muille kielille, ota yhteyttä tekijään (tiedot lopussa).
[Takaisin yläosaan]
Ihan mitä tahansa ei palvelimelle voi ladata. The 'Attachments' ei salli Joomla! Media Managerissa määrittelemättömien tiedostojen lataamista palvelimelle.
Muuttaaksesi asetuksia mene Sivuston asetukset-sivulla ja valitse Järjestelmä-välilehti.
Mediatiedostojen asetukset-alueella voit hallita mitä tiedostotyyppejä ja MIME-tyylisiä tiedostoja voi palvelimelle ladata.
The 'Attachments' huomioi edellä asetettuja arvoja, mutta sallitut kuvatiedostotyypit-kenttää ei huomioida.
[Takaisin yläosaan]
Kaikkia 'Attachments':n asetuksia säädetään komponentin oman hallinnan kautta. Tämä sijaitsee "Komponentit"-valikon alla sijaitsevassa "Liitetiedostot" nimisessä kohdassa. Valitse oikeassa reunassa oleva asetukset-nappi ja pääset muokkaamaan seuraavia komponentin asetuksia:
-
Kenellä on oikeus nähdä liitteet: Tämä asetus määrittää kenellä on oikeus nähdä artikkelien liitetiedostot. Tällä hetkellä käytössä on kaksi vaihtoehtoa:
-
'Kaikki' - Tämä tarkoittaa sitä että liitetiedostot näkyvät kaikille riippumatta siitä onko kirjautunut vai vieras.
-
'Kirjautuneet'. - Tämä tarkoittaa että käyttäjän tulee olla kirjautunut järjestelmään nähdäkseen liitetiedostot.
-
Kenellä on oikeus lisätä liitteitä: Tämä asetus määrittää kenellä on oikeus lisätä liitetiedostoja artikkeleihin. Tällä hetkellä käytössä on kaksi vaihtoehtoa:
-
'Vain artikkelin kirjoittaja' - Liitteiden lisäämistä varten esitettävät linkit näkyvät vain artikkelin kirjoittajalle.
-
'Kuka vain kirjautunut' - Liitteiden lisäämistä varten esitettävät linkit näkyvät kaikille jotka ovat kirjautuneet järjestelmään.
-
Liitteiden julkaisun oletusarvo:
Tämä valinta määrittää julkaistaanko uudet liitetiedostot automaattisesti lisäämisen jälkeen. Jos valintana on 'Kyllä', artikkelit ovat heti lisäämisen jälkeen näkyvissä käyttäjille. Jos valintana on 'Ei', tulee ylläpitäjän hyväksyä liitteen julkaisu hallintasivustolta ennen kuin tiedosto tulee näkyviin.
-
Automaattisen julkaisun varoitus:
Jos liitteiden automaattinen julkaisu on oletusarvoisesti pois päältä (ylempi valinta), voit informoida liitteen lisääjää ettei liite näy ennen kuin ylläpito sen julkaisee. Jos kenttä jätetään tyhjäksi, näytetään järjestelmän oletusviesti jossa kehotetaan ottamaan yhteyttä ylläpitoon liitteen julkaisemiseksi.
-
Näytä otsikot: Jos asetus on 'Kyllä', lisätään liitteen kuvauksien yläpuolelle otsikkorivi, joka kuvaa mitä sarakkeet tarkoittavat.
-
Näytä liitteen kuvaus: Tämä asetus määrittää näytetäänkö liitteen kuvausta liitelistassa.
-
Näytä liitteen koko: Tämä asetus määrittää näytetäänkö tiedoston kokoa liitelistassa.
-
Näytä muutosten päivämäärä: Tämä asetus määrittää näytetäänkö viimeisimpien muutosten teon päivämäärä liitelistauksessa.
-
Muutoksen päivän muoto: Tämä asetus määrittää näytettävän muutospäivämäärän muodon. Muoto määräytyy PHP:n date funktion mukaan. Tämä asetus on oletusarvoisesti muotoa "M-j-Y g:ia", joka näyttää suunnilleen: "Sep-29-2007 5:05pm" Jos haluat näyttää pelkän päivän, poista "g:ia" muodon lopusta. Suomessa tyypillisen formaatin saat laittamalla asetukseksi "j.n.y G.i", joka näyttää "24.12.07 16.01".
Lisätietoja: http://php.net/manual/en/function.date.php
-
Tiedoston nimen suurin pituus:
Määrittää kuinka pitkä tiedoston nimi voi olla liitelistassa. Pidemmät nimet
typistetään ja typistetystä nimestä tulee näytettävä nimi (todellisuudessa tiedoston nimeä ei muuteta). 0-arvo merkitsee ettei tiedoston nimeä ole tässä rajoitettu. (tietokannassa tiedoston nimelle on varattu 80 merkkiä). Huom: Jos tiedoston nimeä lyhennetään tämän säännön vuoksi, lyhennetty tiedoston nimi tulee "näytettävä tiedoston nimi"-kenttään.
-
Liitelistan CSS-tyyli: Tällä asetuksella voidaan ohittaa oletusarvoinen tyyli. Oletusarvoinen tyylin nimi on 'attachmentList'. Katso Lisätietoja:[Liitetiedostojen muotoilu].
-
Liitetiedoston avaustyyli:
Tämä asetus määrittää kuinka liitetiedostot avataan. 'Samassa ikkunassa' tarkoittaa että liite avataan samaan selainikkunaan kuin itse linkki on. 'Uuteen ikkunaan' tarkoittaa että liitettä varten selain avaa uuden ikkunan tai välilehden.
-
Lisää etuliite tiedoston nimeen: Asetus määrittää laitetaanko tiedoston nimen alkuun numeerinen etuliite kun se tallennetaan palvelimelle. Vaihtoehtoja tälle asetukselle on kolme:
-
'Artikkelin ID' - Tämä valinta lisää tiedoston nimen alkuun artikkelin tunnistenumeron. Tämän valinnan etuina ovat eri puolilla esiintyvien saman nimisten artikkelien erottuminen sekä liitteitä listattaessa saman artikkelin liitteiden esiintyminen peräkkäin. Huomioi että tämä mahdollistaa saman nimisten artikkeleiden käytön eri artikkeleissa (samassa artikkelissa ei kuitenkaan voi olla saman tiedostonimen omaavia liitteitä).
-
'Liitteen ID' - Tämä valinta lisää tiedoston nimen alkuun liitetiedoston tunnistenumeron. Tämä estää ristiriidat saman nimisten tiedostojen välillä koska kaikilla liitetiedostoilla on yksilöllinen tunnistenumero. Listattaessa liitteet asettuvat tunnistenumeron mukaiseen järjestykseen.
-
'Ei mitään' - Jos tämä valitaan, tiedoston nimen eteen ei lisätä tunnistetta vaan tallennetaan sellaisenaan. Tämä aiheuttaa ristiriidan jos kaksi saman nimistä tiedostoa esiintyy. Kaikilla liitetiedostoilla tulee olla ainutlaatuinen nimi.
-
Latauksien alihakemisto: 'Attachments' laajennus tallettaa llitteet tähän alihakemistoon, joka sijaitsee Joomla!:n päähakemistossa. VAROITUS: Jos tätä muutetaan, tulee uusi hakemisto luoda manuaalisesti ennen kuin seuraava liite lisätään. Tämä ei vaikuta jo tehtyihin siirtoihin. Vanhat liitteet säilyvät vanhassa hakemistossa ja tietokannan viittaukset säilyvät muuttumattomina.
-
Muokatut otsikot liitelistoille:
Oletusarvoisesti 'Attachments'-laajennus otsikoi liitelistauksen tekstillä "Liitteet:". Jos tarve vaatii, voidaan tämä otsikko vaihtaa joksikin sopivammaksi, kuten: "Lataukset:". Tämän voi tehdä esimerkiksi artikkeliin 211 lisäämällä asetuksiin (ilman lainausmerkkejä): '211 Lataukset'. Yksi sääntö riviä kohden.
-
Piilota liitteet seuraavista:
Pilkuin eroteltu lista avainsanoista ja pääryhmistä/ryhmistä joiden liitelistat tulisi piilottaa. Käytössä on kaksi erityista avainsanaa: 'frontpage' estää liitteiden näkymisen etusivulla ja 'all_but_article_views' näyttää liitteet vain artikkelinäkymässä. (Älä käytä lainausmerkkejä näiden avainsanojen yhteydessä.) Pääryhmien ja ryhmien tunnisteet tulee kirjoittaa numeerisessa muodossa ja kenolla (/= erotettuina: Pääryhmä#/ryhmä#, pääryhmä#/ryhmä#. Käytä pelkkää pääryhmän tunnistetta kattaaksesi kaikki pääryhmän liitteet. Esimerkiksi: 23/10, 23/11, 24
-
Turvattu liitteiden lataus:
Oletusarvoisesti liitetiedostot tallennetaan julkisesti käytettävään alihakemistoon. Jos valittuna on Turvattu vaihtoehto, alihakemisto ei ole julkinen ja tiedostojen latauspolku on eri kuin mitä käyttäjät näkevät. Tämä estää tiedostojen joutumisen niiden käsiin, joilla ei ole oikeutta siihen. Jos Turvattu vaihtoehto ei ole valittuna, tiedostoihin pääsee käsiksi kaikki jotka tietävät oikean URL-osoitteen, koska alihakemisto on suojaamaton.
HUOM!: Turvatussa tilassa liitteiden listaus ei ole käytössä ellei käyttäjä ole kirjautuneena järjestelmään.
-
Turvattujen tiedostojen lataamistapa:
Tämä määrittää tuleeko tiedostojen olla ladattavissa tiedostoina vai selainikkunassa (jos selain osaa käsitellä tiedostotyyppiä). Vaihtoehtoja on kaksi:
- 'Selaimessa': Tässä tilassa liitteet jotka voidaan, näytetään selaimessa. Jos selain ei osaa näyttää, tiedosto ladataan erillisenä tiedostona!
- 'Tiedostona': Liitteet ladataan aina erillisenä tiedostoina.
[Takaisin yläosaan]
Näytettävä tiedoston nimi
Yleensä kun liitteet on ladattu palvelimelle, näkyy liitelistassa liitetiedoston koko nimi. Joissain tapauksissa liitetiedostojen nimi saattaa olla liian pitkä näytettäväksi. Latauslomakkeessa on erillinen 'Näytettävä tiedoston nimi'-kenttä, johon liitettä palvelimelle siirtävä voi kirjoittaa oikean tiedoston nimen sijaan näytettävän nimen tai otsikon.
Esimerkiksi, tiedoston nimeen liittyviä lyhenteitä voidaan käyttää tässä. Ylläpitäjät voivat muokata arvoa jälkikäteen ylläpitonäkymässä.
Huom!: Asetuksissa voidaan määrittää kuinka pitkä näytettävän tiedoston nimi voi olla. Tätä arvoa pidemmät nimet lyhennetään automaattisesti ja lyhennetty nimi tulee näytettäväksi nimeksi.
[Takaisin yläosaan]
Liitelistojen tyyli
Liitelistaukset käyttöliittymässä tehdään käyttämällä erityisiä 'div':jä jotka sisältävät taulukon liitteitä varten. Taulukkoon on kytketty useita eri CSS luokkia jotka mahdollistavat ulkoasun helpon muokkauksen sivuston ylläpitäjän toimesta. Katso Attachments liitännäisen tyylitiedostosta (löytyy: plugins/content/attachments.css) mallia. Jos haluat muuttaa tyyliä, harkitse alkuperäisten tyylien kopioimista tiedoston loppuun eri nimellä muuttamalla 'attachmentList' joksikin muuksi. Liitännäisten hallinnassa vaihda Attachment liitännäisen Liitetaulukon muoto parametriin uusi nimi. Sitten muokkaa luokan määritteitä sopivaksi kopioimastasi osasta. Tämä mahdollistaa sen että voit nopeasti palauttaa alkuperäisen ulkoasun vaihtamalla aiemmin muuttamasi parametrin takaisin alkuperäiseen arvoonsa, 'attachmentList'.
Etuna on myös se että voit kopioida muokatut tyylit eri tiedostoon ja palauttaa ne kun päivität Attachment laajennuksen uuteen versioon. Tämän voi toteuttaa myös käyttämällä CSS:n komentoa @import.
[Takaisin yläosaan]
Tiedostotyyppien kuvakkeet
'Attachments' laajennus lisää liitelistoissa kunkin tiedoston eteen kuvakkeen. Jos haluat lisätä uuden kuvaketyypin toimi seuraavasti:
(1) Lisää sopiva kuvake hakemistoon 'media/attachments/icons' ellei se ole jo siellä.
(2) Muokkaa tiedostoa 'components/com_attachments/file_types.php' ja lisää soveltuva rivi jonoon
$attachments_icon_from_file_extension joka osoittaa tiedoston päätteen kuvakkeen nimeen (kaikki media/attachments/icons hakemistossa). Jos tämä ei toimi suoraan, tulee matriisiin $attachments_icon_from_mime_type. lisätä sopiva rivi.
(3) Ota kopiot kuvaketiedostosta ja päivitetystä file_types.php:sta ennenkuin päivität 'Attachment' laajennusta!
[Takaisin yläosaan]
Varoitukset
-
Mikäli sinulla on arkaluonteisia tai yksityisiä tiedostoja, käytä Turvattu lataus valintaa!
Mikäli et tee näin, tallentuu tiedostot julkisesti avoimeen hakemistoon josta kuka tahansa, joka tietää oikean URL-osoitteen, voi sen ladata. Turvattu vaihtoehto suojaa tiedostoa niiltä joilla ei siihen ole oikeutta (määritelty yllä). Katso lisätietoja 'Turvattu tiedoston siirto'-valinnasta yläpuolelta.
-
Joka kerta kun tiedostoa siirretään palvelimelle, lataushakemiston olemassaolo tarkistetaan ja luodaan tarvittaessa. Jos 'Attachments' laajennus ei voi luoda lataushakemistoa automaattisesti se tulee luoda manuaalisesti (ja tämä voi aiheuttaa ongelmia tiedostojen siirrossa palvelimelle). Varmista että annat lataushakemistolle soveltuvat oikeudet tiedostojen tallettamiseen. Unix/Linux ympäristössä 744 pitäisi toimia.
-
Jos tämä laajennus ei salli sinun tallettaa tietyn tyylisiä tiedostoja palvelimelle (esimerkiksi zip-tiedostoja), huomioi että Media Manageriin asetetut rajoitukset tiedostoille ovat voimassa. Tämä siksi että näin voidaan estää vahingollisten tiedostotyyppien, kuten html ja php, lisäämisen suoraan artikkeliin. Ylläpitäjillä on oikeus muuttaa asetuksia hyväksyttävistä tiedostotyypeistä hallintapaneelin kautta. Sivusto -> sivuston asetukset -> järjestelmä -> Mediatiedostojen asetukset.
-
Toinen lisäosa, 'add_attachment_btn_plugin' (nimetty 'Button - AddAttachment':ksi lisäosien hallinnassa) mahdollistaa liitteiden lisäämisen artikkeli teko- ja editointivaiheessa. Tämä lisäosa luo muokkausikkunan alapuolelle painikkeen jolla komponenttia voidaan käyttää. Jos olet asentanut lisäosan ja komponentin oikein, mutta painiketta ei näy, tarkista että se on kytketty käyttöön lisäosien hallinnasta. Huom! Painike tulee näkyviin vasta kun artikkeli on ensimmäisen kerran tallennettu, koska lisääminen poistaa tallentamattomat muutokset.
-
Tämä versio näyttää toimivan oikein hakukoneystävällisten url-osoitteiden (SEF) kanssa Joomla! 1.5:n RC3 ja RC4 versioiden kanssa. Päivitykset aiempien versioiden kanssa eivät välttämättä toimi oikein.
[Takaisin yläosaan]
Päivittäminen
Mikäli haluat päivittää 'Attachment'-lisäosan siten että liitteet säilyvät, toimi seuraavasti:
-
Käytä phpMyAdmin:ia (tai jotain muuta SQL työkalua) tallentaaksesi jos_attachments taulukon sisällön (käytä 'vienti'-toimintoa (export)).
-
Poista vanha 'Attachments' komponentin asennus.
-
Poista vanha 'Attachments' lisäosan asennus.
-
Asenna uusi versio purkamalla paketti ja asentamalla ensin lisäosat ja sitten komponentti.
-
Ota 'Attachments' lisäosat uudelleen käyttöön.
-
Palauta aiemmin phpMyAdmin:lla (tai muulla SQL-työkalulla) tallentamasi tiedot uudelleen luotuun jos_attachments taulukkoon.
-
Jos päivität vanhemmasta versiosta kuin 1.0 uudempaan ja sinulla on vanhoja liitteitä, tulee sopivat arvot lisätä uuteen 'icon_filename' -kenttään kirjautumalla järjestelmään ylläpitoon ylläpitäjän tunnuksin ja menemällä selaimella seuraavaan osoitteeseen:
/administrator/index.php?option=com_attachments&task=add_icon_filenames
Huomioi että poistaessasi 'Attachments' laajennuksen poistat viitteet tietokannasta, mutta itse tiedostot säilyvät tallennushakemistossa. Tämän vuoksi päivitettäessä tulee sovellukseen liittyvä tietokannan taulukko kopioida ja palauttaa jotta viitteet vanhoihin liitetiedostoihin säilyy. Mikäli viittauksia vanhoihin liitteisiin ei haluta säilyttää, ei viitetietoja tarvitse tallettaa.
Mikäli päätät olla säilyttämättä viitteitä, poista kaikki vanhat liitetiedostot lataushakemistosta myöhempien nimiristiriitojen välttämiseksi.
[Takaisin yläosaan]
Kiitokset:
Kiitos seuraaville osanottajille ja tietolähteille:
-
Kirja Learning Joomla! 1.5 Extension Development: Creating Modules, Components, and Plugins with PHP; Kirjoittajana: Joseph L. LeBlanc - Paljon apua 'Attachments' laajennuksen luomisessa.
- Tiedostotyyppien kuvakkeet ovat peräisi seuraavista lähteistä::
Huomioitavaa on että useimpia 'Attachments':n kuvakkeista on muokattu yllä olevista lähteistä peräisin olevista kuvakkeista. Alkuperäisiä kuvakkeita hakiessasi, vieraile yllä mainituissa osoitteissa.
[Takaisin yläosaan]
Ole hyvä ja lähetä palautteet ja havaitsemasi virheet (englanniksi): jmcameron@jmcameron.net.