Ohjeita EFFIn verkkosivujen toimittajille

Ohjeita EFFIn Drupal-CMS:n käyttöön
===================================

Yleistä
——-
Drupal on ahkera välimuistittelija. Sivuston lukijoille tästä on vain hyötyä, mutta kirjoittajia se voi vähän haitata. Kannattaa opetella painamaan selaimen reload-nappia aina kun tuntuu, ettei ruudulla ehkä näy ihan ajan tasalla olevaa materiaalia.

Tukipyyntöjä ja bugiraportteja sopii mieluiten lähettää `EFFICMS-projektisivun `_ kautta. Apua voi kysyä myös `sähköpostitse webmasterilta `_.

Julkaisu
——–
Sivu/kirjoitus (Drupal-jargonissa: “solmu”) tulee kaikkien luettavaksi kun sille rastitetaan “julkaistu”. Nykyisille verkkosivuille se tulee (max. 30 sekunnin viiveellä) kun rastitetaan “promotoidaan etusivulla”.

Solmujen tyypit
—————

Solmun tyypin valinnalla sivua luotaessa on merkitystä. Tyypit tärkeysjärjestyksessä:

sivu
Yleiskäyttöisin (ja mutkikkain) sisältötyyppi.

Ominaisuudet: tiivistelmäkenttä, oletusarvoisesti julkaistaan
mutta ei etusivulle, versionhallinta, liitetiedostot.

**HUOM:** muista tyypeistä poiketen, leipätekstin alkuun
*ei* sivua katsoattessa lisätä automaattisesti otsikkokenttään
kirjoitettu otsikkoa vaan sen oletetaan sisältyvän leipätekstiin
(kuten esim. lehdistötiedotteissa).
Vaikka otsikko *esikatselussa* valitettavasti näkyy kahteen
kertaan, julkaisun jälkeen se kuitenkin toimii oikein.

blogiartikkeli
Nimensä mukainen, lyhyt kirjoitus.

Ominaisuudet: tiivistelmäkenttä, oletusarvoisesti julkaistaan
JA näytetään etusivulla, liitetiedostot, ei versiointia.

**HUOM:** Kirjoittaja ja päivämäärä näytetään automaattisesti
otsikon jälkeen. Tämän kategorian solmut aliasoidaan automaattisesti
kaavalla ‘blog/YYYY-MM-DD-.html’.

kuva
Kuva voidaan julkaista joko sellaisenaan omalla sivullaan (harvinaista)
tai liittää muihin artikkeleihin. Ominaisuudet: ei mitään.

uutisjuttu
Sopii nimensä mukaisesti nimen omaan uutisten julkaisuun. Samat
ominaisuudet kuin blogiartikkelilla, mutta kirjoittajan nimeä ei näytetä
ja osoite aliasoidaan kaavalla ‘uutiset/YYMMDD-.html’.

webform
Sähköpostilomake. Kohtuullisen mutkikas systeemi, mutta näyttää
toimivan (esimerkkisivu: `sähköpostia webmasterille `_).

project
Bugi-/issue-/tukipyyntö-järjestelmä. Tätä voi käyttää erilaisten
projektien koordinointiin ja esim. TODO-listan tapaan. Kirjoita
webmasterille ennen kuin luot uuden projektin.

issue
“Project”-tyyppiin liittyvä bugiraportti tms. Näitä ei kannata
luoda “luo sisältöä”-sivun kautta vaan menemällä oikean projektin
sivulle ja valitsemalta sieltä “submit issue” tms.

Luokittelu
———-
Muistakaa luokitella kirjoitukset huolellisesti! Koko systeemi perustuu oletukselle, että sisältö on luokiteltu hyvin. Luokkia, eli Drupal-jargonissa “sanastoja”, on tällä hetkellä 4:

| Julkaisutyyppi
| Toiminta-alue
| Multimedia
| Erityistila

Näistä ensimmäiset 2 ovat erityisen tärkeitä, sillä sisällön aliakset (URLit, alla asiasta tarkemmin) luodaan niiden perusteella automaattisesti. “Multimedia” on tarkoitettu sellaisten sivujen merkkaamiseen, joilta löytyy valokuvia, videoita tms. “Erityistila”:ssa on tällä hetkellä vain 1 termi, “Luonnos”. Jos se on päällä, autentikoidut käyttäjät pääsevät kommentoimaan sivua.

Indeksi- tai kokoomasivuja (esim. “tekijanoikeus/“, “yksityisyys/“ ja FAQ:t) tehtäessä *EI* poikkeuksellisesti valita mitään julkaisutyyppiä eikä toiminta-aluetta, sillä muuten ne näkyvät sisältölistauksissa, mikä olisi indeksisivuille vähän hassua.

Aliaksista
———-
Drupalin sisäinen solmujen tunnistus tapahtuu numeroiden perusteella. Esim. Villen kirjoituksen ‘Tekijänoikeus kääntynyt kulttuuria vastaan’ sisäinen URL
on http://www.effi.org/node/9 mutta koska sille on määritelty *alias*, käyttäjät näkevätkin http://www.effi.org/kirjoitukset/tekijanoikeus-kaantynyt-050213.html.

Olen luonut melko hyvän säännöstön, jonka avulla systeemi osaa automaattisesti luoda kelvollisia URLeja. Edellinen esimerkkikin on automaattisesti generoitu sivun luokituksesta, otsikosta ja julkaisupäivästä.

Aliaksen voi toki määritellä käsinkin. Tämä onnistuu joko sisällön syöttösivulla täyttämällä kenttä “Polku-alias” tai käymällä säätämässä alias-luetteloa käsin jälkikäteen. Näin täytyykin tehdä kun halutaan luoda indeksisivuja tai korvata vanhalla saitilla olevia staattisia sivuja Drupal-sivuilla.

**HUOM:** Etusivu (http://effi.org/) on Drupalin ulkopuolinen skirpti. Se ei siksi näe suoraan Drupalin julkaisutyyppejä ja luokitteluja, vaan luottaa, että sivut ovat oikeassa hakemistossa (url-aliaksella):

– Blogiartikkeliksi tulkitaan “blog/“ -hakemistossa olevat sivut
– Lehdistötiedotteoiksi tulkitaan “tiedotteet/“ -hakemistossa olevat sivut

Jos siis lehdistötiedotteeksi tarkoitettu sivu ei ilmaannukaan lehdistötiedotteiden alle tai blogiartikkelin blogiin, on URL-alias väärin — vaihda se käsin oikeaan hakemistoon.

*Vielä isompi* **HUOM**: Aliasten automaattiset luontisäännöt (jota kannattaa käyttää) ajetaan kun sivua ensimmäisen kerran tallennetaan tai esikatsellaan. Siksi toiminta-alue ja julkaisutyyppi pitää merkitä heti aluksi, eikä vasta tekstin kirjoittamisen jälkeen. Väärin menneen aliaksen **voi resetoida** tyhjentämällä “polku-alias“-kentän, jolloin järjestelmä tekee uuden ehdotuksen. Jos sivulle muutoksesta huolimatta jää vanha osoite, poista “kaikki aliakset“-valikosta kaikki sivun vanhat aliakset, ja anna järjestelmän luodan uusi alias ym. tavalla.

Vanhojen sivujen siirto Drupaliin
———————————
1) `Luo uusi sivu `_
2) Copy-pasteta vanhan sivun HTML-sisältö ‘Leipäteksti’-kenttään
3) Lirjoita vanhan sivun tiedostopolku kenttään ‘Polku-alias’
ilman kauttaviivaa alussa (ts. “abba/silli.html“ eikä “/abba/silli.html“
4) Valitse ‘Julkaisutyyppi’ ja ‘Toiminta-alue’, jos kyseessä on uutinen
eikä pysyvä kokoomasivu (kuten indeksi, faq tms.)
5) Valitse tekstityypiksi “Full HTML”
6) Tallenna
7) Poista vanha .html tiedosto levyltä esim. nimeämällä se “.html-old“:ksi.
8) Tarkista, että sivu näkyy edelleen http://www.effi.org/ :n kautta

Jos sivulla on PHP-koodia, `pyydä webmasteria `_ hoitamaan asia.

Käyttäjistä
———–
Käyttöoikeustasoja (rooleja) on tällä hetkellä 4:

– “Authenticated user” = saa lukea ja kommentoida drafteja mutta ei luoda eikä muokata mitään
– Vieraskynä = saa kirjoittaa blogia mutta ei päivittää mitään muuta
– Toimittaja = saa päivittää kaikkea sisältöä
– Ylläpitäjä = kaikki oikeudet, myös käyttäjien hallinta