Yleinen

Kun aukaiset Asetukset, näet tämän välilehden ensin.

Tällä välilehdellä nähdään DOCmanin versio (toki version voi tarkistaa myös, kun menet Lisäosat > Asenna/poista > Komponentit.)

Lisäksi tässä kohtaa määritetään tiedostojen tallennuspolku. Kun asennat DOCmanin, dmdocuments-kansio asennetaan automaattisesti Joomla!si juureen, samoin polku tallentuu DOCman asetuksiin. Kaikki, siis ihan kaikki tiedostot, jotka lataat palvelimelle ja näkymään sivustolla DOCman-lisäosan avulla, tallentuvat tähän kansioon. Käytännössä sinun tarvitsee muuttaa tiedostojen tallennuspolku ainoastaan silloin, kun siirrät dmdocuments-kansion johonkin muuhun paikkaan.

Huomaa siis, että Joomla!si juuri (root) ei saa olla kirjoitussuojattu, jotta ko. kansio voidaan sinne asentaa. Tämä ominaisuus on aiheuttanut jonkin verran ongelmia käyttäjillä, joilla juuri (root) on ollut kirjoitussuojattu (aiheet DOCman foorumilla). Ymmärtääkseni tämä on saanut sen verran paljon rakentavaa palautetta, että dmdocuments-kansio tullaan siirtämään parempaan paikkaan DOCmanin asennusta ajatellen. Itse asiassa tämän piti tapahtua jo DOCman 1.4.0 stable -versiossa, mutta jostain syystä näin ei käynyt.

Jos haluat olla ehdottoman varma, että kukaan ei pääse selaimen osoiteriviä hyväksi käyttäen dmdocuments-kansion tiedostoihin käsiksi niin voit sijoittaa sen kuvan polkuun näin:
/Applications/MAMP/htdocs/dmdocuments eli sijoitat sen vastaavaan paikkaan omalle palvelimellesi. Onko tuo nyt suomeksi yksi kansio ylöspäin juuresta. (Tässä siis kaikki mallikuvat tulevat MAMP-kehitysympäristöstä.)

Lisäksi varmista, että dmdocuments-kansio sisältää index.html -tiedoston. Tällä tiedostolla on se vaikutus, että jos käyttäjä kirjoittaa selainriville esim. http://www.beltassu.net/dmdocuments/ niin hän ei näe kansion sisältöä. Voit lukea englanniksi aiheesta vaikka tästä linkistä (forum.joomla.org).

Julkisivu

Julkisivu-välilehdellä määritetään, mitä tapahtuu julkisen liittymän puolella.

Mennään kohdat läpi yksi kerrallaan. Huomautan kuitenkin tässä vaiheessa, että kaikkia toimintoja en ole koskaan käyttänyt DOCman asetuksista ja että osa toiminnoista ei edes toimi, mielestäni. Ehkä tässä kohtaa voisi todeta, natiivia versiota odotellessa.

Lähes jokaisen kohdan perässä on info-pallo, josta saa lisätietoa, kun vie hiiren pallon päälle. Eli nyt ainakin osaksi toistetaan tuota infoa, mutta haitanneeko tuo. Tarkoitus on kuitenkin tuoda esiin DOCman infoa myöskin niille, jotka eivät ole vielä asentaneet DOCmania omaan Joomla!an.

Julkisivu-välilehden kohdat:

Osio pois käytöstä?
Jos haluat väliaikaisesti ottaa "Tiedostoalueen" pois käytöstä julkisen liittymän puolella, laita täppä kohtaan kyllä. Jos käyttäjä yrittää päästä tiedostoihin klikkaamalla DOCman valikkolinkkiä, hän saa ilmoituksen "Tämä osio on väliaikaisesti pois käytöstä. Yritä myöhemmin uudelleen". Tämä on määritelty kielitiedostossa eli sitä voi myös vapaasti muuttaa.

Näytettävät tiedostopäätteet:
En tiedä mikä vaikutus tällä on. Jos ei anna mitään arvoja, niin kaikki tiedostot näkyvät (ainakin mamp-kehitysympäristössä). Erota tyypit | -merkillä

Dokumentteja per sivu
Kuinka monta dokumenttia näytetään yhdellä sivulla. Jos dokumentteja enemmän kuin määritelty arvo, tapahtuu sivutus.

Oletusjärjestys
Tässä määritetään minkä mukaan järjestetään ja onko nouseva vai laskeva järjestys.

Lähetä sähköpostia ryhmän jäsenille?
Koko DOCman 1.4.0 version historian aikana tämä kohta on ollut minulle täysi myseeri. DOCman 1.3.0 versiossa tämä toimi. Sääli. Tämä oli hyvä ominaisuus, toivottavasti tulee takaisin vielä.

Kuvakkeen koko
Määritä minkä kokoisia kuvakkeita käytetään kategorioiden ja dokumenttien nimen edessä.

Poista tyhjät alueet
En tiedä mikä vaikutus tällä on.

Monta päivää uusi
Montako päivää teksti "Uusi" näytetään dokumentin nimen vieressä.

Latausten määrä ollakseen suosittu
Montako latausta dokumentille pitää tulla, kunnes dokumentin nimen vieressä näytetään teksti "Suosittu".

Näytä lisenssit?
En ole koskaan tätä kohtaa käyttänyt, mutta nyt tein pientä testiä. Tämän kohdan tarkoitus on, että käyttäjän tulee hyväksyä ko. lisenssi ladattavalle dokumentille ennen kuin hän voi ladata dokumentin (jos sivuston ylläpitäjä näin haluaa). Eli jos haluat, että käyttäjän tulee hyväksyä lisenssi, laita täppä kohtaan kyllä. Siitäkin huolimatta, että tämä kohta määritetään dokumenttikohtaisesti vielä erikseen.

Extra! Testaa lisenssi. Mene Tiedostot > Urheilu ja kokeile ladata dokumentti "Viides".

Salli sisältö mambotit?
Tästä en osaa sanoa mitään, katso info-pallo admin puolella.

Oikeudet

Oikeudet-välilehti on se kaikista tärkein osa DOCman asetuksia, kun ajatellaan dokumenttien jakamista turvallisesti oikeisiin kohderyhmiin. Ongelmia/vaikeuksia ei ole, jos kaikki dokumentit ovat kaikkien käyttäjien saatavilla, mutta heti kun aletaan muodostamaan ryhmiä tai rajoitetaan ei-rekisteröityneiden latausoikeuksia niin silloin pitää tämän välilehden säädöt olla kohdallaan. Toki asiaan vaikuttaa myös dokumenttikohtaiset oikeus-asetukset.

Toistaiseksi DOCman ei taivu aivan monimutkaisiin toimintoihin, mutta perusasiat ovat kuitenkin kunnossa. Tulevaisuudessa ymmärtääkseni DOCman 2.0 ja Joomla! 1.6 (ja uusi ACL) mahdollistavat monimutkaisempienkin oikeuksien muodostamisen/jakamisen.

Ennen kuin menemme tarkemmin tämän välilehden eri kohtiin, totean, että en ole itse näiden kohtien kaikkia vaihtoehtoja käynyt läpi, joten en henkilökohtaisesti ole todennut, että jokin toimii tai ei toimi. Tuon tämän esille sen takia, että DOCman foorumilla on muutamia ketjuja, joissa käyttäjät ovat todenneet, että käytettäessä Joomla!n käyttäjäryhmiä (esim. author, editor) niin tällöin DOCman ei toimi (esim. ko. dokumenttia ei pysty lataamaan tms.).

Eli tarkoitus on nyt tuoda esille ne tavat, joilla DOCman toimii ja jotka itse olen havainnut hyväksi. Oikeastaan nämä tavat voidaan jakaa kolmeen ryhmään.

1. Kaikki saavat ladata dokumentteja.
2. Kaikki saavat katsoa, minkä nimisiä dokumentteja on jaossa, mutta vain rekisteröityneet voivat ladata.
3. Räätälöity DOCman ryhmä saa katsoa ja ladata dokumentteja.

Kolmas vaihtoehto on siinä mielessä hankala, että siihen ei voi ympätä 1. ja 2. kohdan ominaisuuksia. Tämä tarkoittaa siis sitä, että jos valitset jonkin DOCman ryhmän dokumentin omistajaksi, kukaan muu ei näe ko. dokumenttia, ei edes sitä, että se on olemassa.

Ok. Jotta päästään mukavasti alkuun niin katsotaan ensin kohdat "Vierailijoiden oikeudet" ja "Dokumentti oikeudet - Näytä".

Vierailijoiden oikeudet
Tällä määritetään mitä vieraat (ei-rekisteröityneet käyttäjät) voivat tehdä. Vaihtoehtoja on kolme.

1. vierailijat eivät näe mitään
2. näkevät dokumentit, mutta eivät voi ladata niitä tai
3. voivat myös ladata dokumentteja.

Huomaa, että tämä asetus voidaan ohittaa dokumenttikohtaisesti.

Näytä
Tämä määrittää oletuskäyttäjän tai oletuskäyttäjäryhmän, joka voi ladata ja tarkastella dokumentteja. Tämäkin asetus voidaan ohittaa dokumenttikohtaisesti.

Jos siis haluat, että:
Kaikki saavat ladata dokumentteja > aseta "Selaa, lataa ja katso" ja "Kaikki".
Kaikki saavat katsoa dokumenttilistaa, mutta vain rekisteröityneet voivat ladata > aseta "Vain selaus" ja "Kaikki".

Perimmäinen kysymys on, että kuka/mikä ryhmä on oletusryhmä. Tämän kun selvität itsellesi niin asetuksien muokkaaminen on helppo toimenpide.

Ok, sitten ne muut kohdat tältä välilehdeltä.

Lataukset
Määrittää käyttäjän/ryhmän, joka voi ladata dokumentteja palvelimelle. Ei-rekisteröityneet käyttäjät eivät voi koskaan ladata tiedostoja palvelimelle. Huomaa, että vaikka sinulla olisi useampi ryhmä ja määrität erikseen uuden ryhmän, joka saa ladata tiedostoja palvelimelle, niin tämä ryhmä näkee kaikki DOCman kategoriat, joihin voi ladata tiedostoja. Eli käyttäjän pitää itse valita oikea kategoria. Tällä hetkellä ei ole mahdollista ladata tiedostoa vain oman ryhmän kategoriaan.

Hyväksyminen, Julkaise
Määrittää käyttäjän/ryhmän, joka voi hyväksyä ja/tai julkaista dokumentteja.

Katseluoikeutta voi muuttaa

Tämä määrittää voiko tiedoston luoja/editoija muuttaa tiedoston katsomiseen tarvittavia käyttöoikeuksia.
Huomaa: Ylläpitäjät voivat aina muuttaa katseluasetuksia.

Ylläpidä
Tämä määrittää oletuskäyttäjän tai oletuskäyttäjäryhmän, joka ylläpitää dokumenttia. Asetus voidaan ohittaa dokumenttikohtaisesti.

Ylläpitäjää voi muuttaa
Tämä määrittää voiko tiedoston luoja/editoija muuttaa dokumentin ylläpitäjää.
Huomaa: Ylläpitäjät voivat aina valita ylläpitäjän.

Yksittäiset käyttäjät
Kun tämä asetus on "Ei", voit silti antaa oikeuksia ryhmille, mutta et enää yksittäiselle käyttäjälle. Voimassa olevat dokumentti oikeudet säilyvät, mutta muokatessa sellaista dokumenttia, jolla on yksittäisen käyttäjän oikeudet sinun pitää valita dokumentille käyttäjäryhmä yksittäisen käyttäjän sijaan.

Toistaiseksi DOCmanissa on havaittu ongelmia, jos käyttäjiä on paljon (eli yli 1000). Tällöin on hyvä asettaa tämä kohta arvoon "Ei".

Tiedoston luojat
Koko sivustoa koskeva asetus joka määrittää mitä dokumentin luoja voi tehdä. Tämä on lisäys tavallisen käyttäjän tai dokumentin ylläpitäjän käyttöoikeuksiin.

HAJATELMA
Sinun tulee huolehtia siitä, että tämän välilehden säädöt ovat "tiukimmat" mahdolliset, jos annat käyttäjille erilaisia oikeuksia ladata dokumentteja (ryhmät, rekisteröityneet käyttäjät) niin että tietyt dokumentit näkyvät vain tietylle käyttäjäryhmälle.

Käytännössä tämän pystyy selvittämään vastaamalla kysymykseen: "Onko sinulla käyttäjäryhmä, joka saa nähdä ja ladata kaikki dokumentit?". Jos vastaus on Kyllä, voit asettaa tämän ryhmän oletukseksi kohdassa "Näytä". Kun dokumentti laitetaan sivuille eikä oikeuksia muuteta niin vain tämä ryhmä näkee dokumentin.

Jos vastaus on Ei, niin sinun kannattaa tehdä tyhjä ryhmä, joka on oletusryhmä. Jos dokumentin oikeuksia ei muuteta, kukaan ei näe dokumenttia. Eli tiedostoa palvelimelle ladattaessa pitää oikeus muuttaa vastaamaan sitä ryhmää/käyttäjää, jolle dokumentti on tarkoitettu.

Käytännössä näin menetellessä mitään vahinkoa ei tapahdu, jos tiedoston lataaja ei muista vaihtaa dokumentin oikeuksia.

VINKKI: Ennen kuin lähdet toteuttamaan tiedoston latausta sivuillasi ja ennen kuin asetat erilaisia oikeuksia sivuillesi, TESTAA joko kehitysympäristössä tai testidokumenteilla ja -käyttäjillä (eri oikeustasot), miten homma toimii käytännössä. Kokemuksesta tiedän, että DOCman oikeusasetuksia pitää hetki pohtia ennen kuin se kolahtaa. Parempi tutkia kuin hutkia, vai miten se sanonta nyt menikään.

Lataa

DOCman, lataus asetukset.

Tiedostojen latausmenetelmät?
Valitse latausmenetelmä(t), jotka käyttäjä voi valita. Ylläpitäjät voivat käyttää kaikkia latausmenetelmiä.

Ladattavan tiedoston suurin sallittu koko
Suurin sallittu tiedoston koko julkisen liittymän puolelta ladattaessa. Huomaa, että et voi yliajaa PHP:n asetusta upload_max_filesize.

Korvaa samanniminen tiedosto?
Jos kyllä, vanha tiedosto korvataan uudemmalla, jos molemmilla on sama nimi. Käytä tätä toimintoa harkiten.

Sallitut tiedostopäätteet
Sallitut tiedostopäätteet julkisen liittymän puolelta.

Käyttäjä voi ladata kaikkia tiedostotyyppejä?
Käytännössä tämän kohdan tarkoitus on aika selkeä, mutta info-pallossa oleva vihjeistys taas epäselvä. Kuitenkin olisin sitä mieltä, että jos ei ole mitään tarvetta käyttäjien ladata kaikkia tiedostotyyppejä niin aseta tämä kohta arvoon Ei.

Muunna kirjaimet pienaakkosiksi?
Voit määrittää muutetaanko isot kirjaimet pieniksi.

Välit tiedostojen nimissä:
Voit määrittää miten tiedostonimen tyhjät välit käsitellään. Mahdollisuuksia ovat: salli välit, hylkää välit, muuta alaviivoiksi (_), muuta väliviivoiksi (-) tai poista välit.

Hylkää tiedostonimet:
Voit määrittää, mitkä tiedostonimet hylätään eli niitä ei ladata palvelimelle.

Turvallisuus

DOCman, turvallisuus asetukset.

Kuumalinkityksen esto?
Jos et halua muiden www-sivustojen linkittävän dokumentteihisi, aseta Kyllä.

Hyväksytyt palvelimet
Lista palvelimista, jotka voivat tehdä linkkejä sivustosi dokumentteihin, jos kuumalinkitys on estetty.

Lokien käyttö?
Aseta Kyllä, jos haluat kerätä lokiin tietoja käyttäjistä (IP-osoite, päiväys, aika ja selatun dokumentin tiedostonimi). Tätä toimintoa käytettäessä tietokantaan kerääntyy paljon tietoa.

Piilota ulkopuoliset linkit?
Tämä asetus piilottaa linkit ulkopuolisiin tiedostoihin katseltaessa dokumentin tietoja. Muokkaus oikeudet omaavat käyttäjät näkevät silti linkin. Tämä ei kuitenkaan anna täydellistä suojaa ulkopuolisille linkeille.