Processwire-ohjeistus Sisällys Yleistä tietoa järjestelmästä... 2 Sivutyypit ja kentät... 2 Sivurakenne... 3 Piilotetut ja julkaisemattomat sivut... 3 Uuden sivun luominen... 3 Sivun piilottaminen ja julkaiseminen... 4 Sivun siirtäminen... 5 Sivun kopioiminen... 5 Sivun muokkaaminen... 6 Sisältö... 6 Tekstieditori... 7 Linkin luominen ja poistaminen... 8 Kuvien ja tiedostojen lataaminen... 9 Alasivut... 10 Asetukset... 11 Poista... 12 Katso... 12
Yleistä tietoa järjestelmästä ProcessWire on rakenteinen julkaisujärjestelmä. Tämä tarkoittaa, että järjestelmän tietokentät mukautetaan kunkin projektin tarpeisiin. Tästä johtuen näissä yleisohjeissa ei voida mennä yksityiskohtiin, kuten kuinka julkaiset uutisen tai näin lisäät uuden tuotteet. Näissä ohjeissa keskitytään järjestelmän perusominaisuuksiin, jotka ovat yhteisiä kaikille ProcessWire-sivustoille. Sivutyypit ja kentät Jokaisella sivulla on oma sivutyyppinsä, joka määrittää, minkälaisista kentistä sivun sisältö koostuu. Erilaisia kenttätyyppejä on lukuisia, esimerkkeinä mainittakoon teksti, iso tekstikenttä, kuva(t), tiedosto(t), viittaus toiseen sivuun, sähköpostiosoite, linkki jne.
Sivurakenne Sivut asettuvat sivupuuhun hierarkkisesti. Sivuston valikot rakennetaan lähes poikkeuksetta automaattisesti noudattaen sivuston sivupuuta. Sivun osoite määrittyy myös sivurakenteen mukaan. Voit selata sivupuuta klikkaamalla sivun nimeä. Samalla sivun nimen viereen avautuu muutama linkki, joiden toiminta kuvataan myöhemmin tässä dokumentissa. Sivun vieressä oleva harmaa numero kertoo sen alla olevien sivujen lukumäärän. Mikäli alasivuja on paljon (yleensä rajana 50), niin tällöin sivupuuhun avautuu sivuutus, jonka avulla pystyt lataamaan lisää alasivuja näkyviin. Piilotetut ja julkaisemattomat sivut Osa sivuista voi olla piilotettuina, jolloin ne näkyvät haaleammalla värillä sivupuussa. Piilotettu sivu on julkinen, mutta sitä ei haluta näkyviin sivuston valikkoon. Jos sivua ei ole julkaistu, niin se näkyy sivupuussa yliviivattuna. Ainoastaan sellaiset henkilöt, joilla on muokkausoikeus julkaisemattomaan sivuun näkyvät sen. Julkaisematon sivu ei siis ole koskaan kirjautumattoman selaajan saatavilla. Uuden sivun luominen Saat luotua uuden sivun, kun napsautat sivun valinnoista Uusitoimintoa. Uusi sivu luodaan aina sen sivun alle, jonka kohdalta painat Uusi-linkkiä. Kun olet painanut Uusi-linkkia, avautuu yksinkertainen näkymä, jossa annetaan seuraavat tiedot: Otsikko: tämä nimi tulee näkyväksi nimeksi. (Huom: Otsikko voi olla tietyissä kohdin nimetty toisin, esim. Henkilön nimi ) Nimi: Osoitepalkin nimi määräytyy automaattisesti tallennuksen yhteydessä. Voit halutessasi myös muokata sivun osoitepalkin nimeä. Sivupohja: usein sivupohja on ennalta määrätty, mutta tietyissä tilanteissa voit itse valita haluamasi sivupohjan. Tallenna: kun tallennat sivun, se luodaan oikealla paikalle, mutta ei vielä julkaista. Pääset heti tallentamisen jälkeen muokkaamaan varsinaista sivun sisältöä.
Sivun sisällön muokkaaminen on kuvattu tarkemmin kohdassa Sivun muokkaaminen. Sivun piilottaminen ja julkaiseminen Oletuksena uutta sivua ei ole vielä julkaistu, ja siitä kertova huomioteksti näkyy muokkausnäkymän yläreunassa. Kun luot sivulle sisältöä ja napsautat Julkaise-painiketta, tulee sivu näkyville. Mikäli et halua vielä julkaista sivua, mutta haluat kuitenkin tallentaa tekemäsi muutokset, voit painaa Tallenna, mutta älä julkaise nappia. Tämä pitää sivun julkaisemattomana, mutta säilyttää tekemäsi muutokset. Voit määritellä, kuinka sivu on näkyvissä Asetukset -osion Tila-valinnoilla. Piilotettu: Piilotettu sivu tarkoittaa sivua, joka halutaan pitää piilossa valikoista, mutta muuten saatavilla ilman kirjautumista. Sivupuussa piilotetun sivun nimen väritys on haaleampi kuin julkaistujen sivujen. Lukittu: Lukittu-vaihtoehto näytetään yleensä vain pääkäyttäjille. Sen avulla jokin sivu voidaan lukita niin, ettei siihen ole mahdollista tehdä muutoksia.
Ei julkaistu: Julkaisematon sivu on kirjautumattomilta käyttäjiltä kokonaan tavoittamattomissa. Sivupuussa julkaisemattoman sivun nimi on yliviivattu. Tällöin sivua ei pääse katsomaan muokkaustilassa muut kuin ne, joilla on sivuun muokkausoikeudet. Sivun siirtäminen Mikäli haluat muuttaa sivun paikkaa, napsauta ko. sivuun liittyvistä toiminnoista Siirrä-toimintoa. Saat siirrettyä sivun haluamaasi paikkaan sivupuussa raahaamalla se uuteen paikkaan hiirellä. Tiettyjä sivuja ei voi siirtää, vaan niiden järjestys on automaattisesti määritelty. Esimerkiksi sivun Uutiset alla olevat yksittäiset uutiset järjestetään usein julkaisupäivämääränsä perusteella automaattisesti. Samoin usein on rajattu, minkälaisia sivuja voi olla eri sivujen alla. Esimerkiksi usein määritellään, että tapahtumat sivun alle ei voi siirtää muita kuin sivuja, joiden sivutyyppi on tapahtuma. Sivun kopioiminen Mikäli teillä on käytössä Kopioi-toiminto, mahdollistaa se sivukopion luomisen. Sivupuusta klikatun sivun nimen perään tulee näkyviin kopioi-linkki. Mikäli kopioi-linkkiä ei näy, niin ominaisuutta ei ole joko asennettu käyttöön tai käyttäjäoikeutesi eivät riitä sen hyödyntämiseen
Sivun muokkaaminen Kun ole luonut uuden sivun, avautuu näytöllesi sivun nimeämisen jälkeen näkymä, jolla hallitset sivun sisältöjä sekä asetuksia. Sama näkymä avautuu myös silloin kun muokkaat jo olemassa olevaa sivua. Muokkaus-näkymän välilehdet ja niiden sisältökentät vaihtelevat asiakkaittain. Sisältö-osiossa voit heti julkaista sivuston. Mikäli et tätä halua tehdä keskeneräiselle sivulle, voit jatkaa sivuston työstöä Tallenna, mutta älä julkaise - toiminnon kautta. Kun teet muutoksia muille välilehdille, muista aina tallentaa muutoksesi. Voit julkaista sivun kun se on valmis. Sisältö Yleensä sivun ensimmäinen välilehti on nimeltään Sisältö. Välilehtien nimet ja määrä voi vaihdella sivutyypin perusteella. Samoin ne kentät, joita välilehtien alta löytyy, vaihtelevat eri sivutyyppien kanssa. Tässä ohjeistuksessa sisältö-välilehden alta löytyy varsin yksinkertainen perussivu, jossa on kolme kenttä: Otsikko, Tiivistelmä ja Sisältö. Yleensä kenttiä on hieman enemmän. Esimerkiksi jos sivutyyppi olisi ruokaresepti, niin kenttinä olisi todennäköisesti: Reseptin nimi, ainesosat, ohjeet, reseptin luokka ja valmistukseen kuluva aika. Näistä esimerkkisivumme kentistä Otsikko ja Tiivistelmä ovat yksinkertaisia tekstikenttiä. Sisältö-kenttä sen sijaan on laajempi kokonaisuus, jossa on tekstieditoreista tuttuja ominaisuuksia. Myös editorissa olevien toiminnallisuuksien määrä vaihtelee eri sivustojen ja kenttien välillä. Koska tekstieditori on varsin yleinen kenttä ja se sisältää useita keskeisiä ominaisuuksia, niin olemme tässä ohjeessa kuvanneet sen toiminnasta tärkeimmät ominaisuudet.
Tekstieditori Tekstieditorin toiminnot auttavat sinua jäsentelemään ja elävöittämään sivun sisältöä. Tässä muutama yleisesti käytössä oleva toiminto: Kappale: Voit jäsentää tekstiä otsikoinneilla ja muilla tekstiin kohdistuvilla muotoiluilla Lihavointi ja kursivointi Järjestämätön lista: asialista luentomerkeillä Järjestetty lista: asialista numeroinnilla Lisää linkki ja poista linkki: sivuston sisäisen tai ulkoisen linkityksen luominen ja poistaminen. ks. linkin luominen Valitse kuva: järjestelmään ladatun kuvan lisääminen osaksi sisältöä ks. kuva- ja tiedostokentät html: HTML-koodin muokkaus Kokoruututila: avaa tekstisisällön koko ruudin kokoiseksi. Huom: Kuvien ja linkityksien lisääminen ei ole mahdollista tässä kokoruututilassa
Linkin luominen ja poistaminen Sisältöön lisättävä linkki voi olla joko linkki sivuston ulkopuolelle tai viitata muuhun sivuston sisäiseen sivuun. Linkin määritteleminen aloitetaan aktivoimalla sana/lause, johon linkki halutaan määritellä. Tällöin linkkipainikkeet aktivoituvat. Sivuston ulkopuolinen linkki voidaan määritellä kopioimalla kohdesivun url-osoite ja liittää se Linkitä osoitteeseen-kenttään. Voit lisäksi määritellä haluatko linkin käyttäminen avaavan kohdesivun uuteen ikkunaan. Linkitä sivuun toiminto mahdollistaa linkityksen sivuston sisällä. Tällöin voit valita sivupuusta sivun, johon linkkitys kohdistuu. Voit myös tässä linkityksessä valita haluatko kohde sivun aukeavan uuteen ikkunaan.
Linkitä tiedostoon -toiminnolla voit linkittää esim. pdf-tiedoston aukeamaan linkin takaa. Tällöin kohdeasiakirjan on oltava valmiiksi ladattuna osaksi sivustoa. Mikäli haluat linkittää tiedostoon, joka on ladattu jollekin toiselle sivulle, niin valitse tuo sivu ensin Linkitä sivuun kohdasta. ks. Kuva- ja tiedostokentät. Kuvien ja tiedostojen lataaminen Jotta voit lisätä sisältöön kuvia tai linkittää sisältöä asiakirjoihin, täytyy sinun ensiksi ladata nämä osaksi järjestelmäänne. Esimerkkisivullamme kuvat ja tiedostot löytyvät oman välilehtensä alta, mutta usein nämäkin kentät saattavat olla Sisältö-välilehden alla. Kuvien ja tiedostojen lataaminen tapahtuu samalla periaatteella kuin liitetiedostojen liittäminen sähköpostiin. Kuva tai tiedosto ladataan osaksi järjestelmää Selaa-toiminnolla. Kunkin kentän tukemat tiedostotyypit on lueteltu alla. Mikäli sinulla on tarvetta päästä lisäämään tiedostoja, joiden tiedostopäätettä ei ole lueteltu, ole yhteydessä tekniseen tukeen. Uusimmilla selaimilla (Internet Explorer 10+, Firefox 3.6+, Google Chrome, Safari 6+) tiedostojen lataaminen onnistuu suoraan pudottamalla tiedostot työpöydältä kentän päälle. Kuvan lataamisen jälkeen ovat kuvat käytettävissä sisällön muokkaamisessa. Huom: Kuvat ovat sivukohtaisia, mutta tiedostoja on mahdollista linkittää ristiin eri sivujen välillä. Suosituksemme on kuitenkin ladata tiedosto sille sivulle, jossa sitä käytetään, vaikka tämä tarkoittaisi saman tiedoston lataamista useaan paikkaan. Useilla sivustoilla kuvat saatetaan sijoitella automaattisesti sivulle. Joillakin sivuilla tätä varten on erillinen valinta ( Näytä kuvat automaattisesti sivuilla tjms).
Alasivut Uusia alasivuja voit luoda muokkaus-tilassa olevalle sivulle Alasivut -osion kautta. Tämä toiminnallisuus on täysin vastaava, kuin sivun luominen sivupuun kautta. Tässä näkymässä voi myös lisätä alasivuilla automaattisen järjestyksen. Esimerkiksi mikäli haluat järjestellä alasivut automaattisesti niiden nimen perusteella aakkosittain, onnistuu se kohdan Alasivujen järjestys kautta.
Asetukset Tässä osiossa voit vaikuttaa muokattavana olevan sivun asetuksiin. Tähdellä (*) merkityt kentät ovat pakollisia. Nimi*: sivun url-osoite, joka määräytyy automaattisesti sivun otsikon mukaan. Sivutyyppi*: Yleensä sivutyyppiä ei tarvitse eikä pysty vaihtamaan, mutta joskus se voi olla mahdollista. Sivutyypin vaihtaminen voi vaikuttaa sivun sisältökenttiin. Yläpuolella oleva sivu*: kertoo, minkä sivun alla sivu sijaitsee. Tätä kautta voi myös siirtää sivun sijaintia. Sama toiminnallisuus onnistuu myös sivupuun kautta. Tila: valinta määrittelee sivun näkyvyyden o Piilotettu: sivupuussa piilotetun sivun nimen väritys on haaleampi kuin julkaistujen sivujen. Tällöin sivu ei näy osana sivustoa eikä myöskään tule mukaan sivuhakuihin. Sivu löytyy kuitenkin sivustolta sen url-osoitteella. o Ei julkaistu: sivupuussa julkaisemattoman sivun nimi on yliviivattu sivurakenne-näkymässä. Tällöin sivua ei pääse katsomaan muokkaustilassa muut kuin ne, keillä on ko. sivuun käyttöoikeus. o Lukittu: Sivun lukitseminen näytetään yleensä vain pääkäyttäjille. Sen avulla on mahdollista lukita sivu niin, ettei siihen voi tehdä muutoksia (ennen kuin lukitus poistetaan). Kenellä on pääsy tähän sivuun: tämä koostaa (vielä valitettavan teknisen) näkymän siitä, mitä eri käyttäjäroolit pystyvät sivulla tekemään. Tiedot: Kuka sivun on luonut ja milloin sekä kuka viimeksi on sivua muokannut ja milloin.
Poista Sivun poistaminen järjestelmästä tapahtuu Poista -osion kautta. Mikäli haluat poistaa sivun lopullisesti, aktivoi Siirrä roskakoriin -valinta ja napsauta Siirrä roskakoriin - painiketta. Katso Katso-toiminto siirtyy sivun julkiseen näkymään. Muista tallentaa muutoksesi ennen siirtymistä sivulle.