Attachments Dokumentaatio

Versio 1.2 - February 20, 2008

  1. Esittely
  2. Rajoitukset tallennuksessa
  3. Asetukset
  4. Näytä tiedostojen nimet
  5. Liitelistojen muotoilu
  6. Tiedosto tyyppien kuvakkeet
  7. Varoitukset
  8. Päivittäminen
  9. 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ä:

Kiitos käännösten tekijöille! Jos haluat auttaa kääntämisessä muille kielille, ota yhteyttä tekijään (tiedot lopussa).

[Takaisin yläosaan]

Rajoitukset latauksissa

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]

Asetukset

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:

[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

[Takaisin yläosaan]

Päivittäminen

Mikäli haluat päivittää 'Attachment'-lisäosan siten että liitteet säilyvät, toimi seuraavasti:
  1. Käytä phpMyAdmin:ia (tai jotain muuta SQL työkalua) tallentaaksesi jos_attachments taulukon sisällön (käytä 'vienti'-toimintoa (export)).
  2. Poista vanha 'Attachments' komponentin asennus.
  3. Poista vanha 'Attachments' lisäosan asennus.
  4. Asenna uusi versio purkamalla paketti ja asentamalla ensin lisäosat ja sitten komponentti.
  5. Ota 'Attachments' lisäosat uudelleen käyttöön.
  6. Palauta aiemmin phpMyAdmin:lla (tai muulla SQL-työkalulla) tallentamasi tiedot uudelleen luotuun jos_attachments taulukkoon.
  7. 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:

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.

Valid HTML 4.01 Transitional