ihaa.com > ihaaedit > Kaikki yhdellä sivulla

ihaaedit: työkaluja tehokkaan www-julkaisuprosessin rakentamiseen

ihaaedit on Unix/Linux, Apache, PostgresQL ja PHP -ympäristössä toimiva www-sivujen luonti ja päivitystyökalu, jolla erilaisten muuttuvien www-saittien julkaisuprosessi on helppo rakentaa juohevaksi ja toimivaksi. ihaaedit sopii varsinkin sellaisiin ympäristöihin, joissa on jo kokeneita www-palvelujen tekijöitä joilla on osaamista wysiwyg-työkaluohjelmista sekä HTML:stä. ihaaedit:illä on jo rakennettu useita dynaamisia www-saitteja pilotteina. Jos haluat lukea ihaaedit:in koko dokumentaation yhdessä pötkössä tai tulostaa sen kokonaan kätevästi, voit käyttää yhdelle sivulle koottua versiota (joka tietenkin automaattisesti luodaan ihaaeditillä ajan tasaisesti). Kommentit voi lähettää osoitteella haa@ihaa.com.

Tällä sivulla on kaikki ihaaedit:in dokumentaatio yhdellä sivulla, joka on helppo tulostaa tai lukea kerralla.

1. Johdanto

ihaaeditin käyttö on helppoa

Esimerkki siitä, miten helposti ihaaeditillä sivujen muokkaus onnistuu.

Kun tietojen päivittäjä tulee sivuilla ja antaa ylläpitosalasanan, ilmestyy niille sivuille joilla on muokattavia elementtejä edit-nappula, jota klikkaamalla pääsee muokkaamaan tietoja.

Ylläpitäjä voi vapaasti surffailla saitilla eri sivuilla ja kullakin sivulla on helppo pääsy muokkaamaan sivun tietoja edit-nappulaa klikkaamalla.

Koska sivujen rakentaja voi miettiä mitkä kohdat sivuista ovat muokattavissa ja miten, ei tietojen ylläpitäjän tarvitse murehtia itse sivujen toimivuudesta, vain sisällöstä.

Kun Edit-nappulaa klikkaa, ilmestyy sama sivu näkyviin mutta sellaisena, missä muokattavat kohdat ovat tavallisten www-lomakkeiden tapaan helposti muutettavissa.

Kun muokkaus on tehty, Save-nappula tallettaa tiedot, tai Cancel (peru) -toiminnolla pääsee pois ilman että tiedot muuttuvat.

Jos muutetun sivun tietoja on käytetty muualla saitissa, tiedot päivittyvät heti joka paikkaan missä niitä on käytetty. Esimerkiksi jos uutisen otsikkoa muutetaan, muuttuu uutisotsikko heti myös sivulla jossa on lista uutisista.

ihaaeditillä on myös mahdollista tehdä virtuaalisivuja, joissa kaikilla sivuilla on sama ulkoasu mutta sisältö vaihtuu sivujen välillä. Tällöin uusien sivujen lisääminen sekä vanhojen poistaminen jne. onnistuu myös helposti suoraan www-liittymän kautta.

Toimiva julkaisuprosessi www-sivuille

Miten ratkaistaan yksi www-sivujen suurimmista ongelmista: tietojen päivittäminen helposti.

Perinteinen tapa tehdä www-sivuja vaatii, että www-sivut toteuttanut ammattilainen myös suorittaa kaikki ylläpito- ja muutostoimenpiteet. Tällainen julkaisuprosessi, missä tieto kulkee muutaman toimijan kautta ei käytännössä toimi kovin hyvin.

Paras ratkaisu olisikin sellainen, missä www-sivujen toteuttaja rakentaa perusrakenteet ja sivujen ulkoasun, mutta itse tietojen syöttäminen, päivittäminen ja pitäminen ajan tasalla tapahtuu suoraan niiden toimesta, joilla tieto on.

Käytännössä tämä onnistuu niin, että tiedot voi päivittää suoraan www-palveluun omalta www-selaimelta mistä tahansa käsin aina kun päivitystarve syntyy.

ihaaedit:issä on lisäksi se hyvä puoli, että sen käyttö on todella selkeää ja intuitiivista: Kun salasana on annettu, tietoja voi muokata suoraan siellä missä ne ovat, halutulla sivulla juuri siinä kohdassa missä tieto näkyy.

2. Perusteet

Muokattavista elementeistä

käytettävissä on monenlaisia mahdollisuuksia

Ensin esimerkki siitä, miten sivulle saa upotettua muokattavia elementtejä:

<?require('ihaaedit.php')?>
<html>
<head>
<title><?editshow('otsikko')?></title>
</head>
<body bgcolor="#FFFFFF"> <?editstartpage()?>
<H1><?edittext('otsikko')?></H1>
<P>Kotisivuni teksti on <?edittext('teksti',60,5)?>
<P>Sivulla on käyty <%=counter(300)%> kertaa.
<P>Bannerimainos: <%bannerstart()%>
<%banneritem('http://libplussa.fi/kuvat/plussa75.gif',
'http://www.libplussa.fi',
10)%>
<%banneritem('http://www.iki.fi/iki/iki-logo-16.gif',
'http://www.iki.fi',
20)%>
<%bannerend(468,60)%>
<P><?edittext('pitkateksti',60,10)?>
<?editendpage()?>
</body>
</html>

Sivuilla voi olla muokattavia elementtejä mm. seuraavan kaltaisia:

Muokattava yhden rivin kokoinen teksti
Muokattava monen rivin kokoinen teksti
Kuva, jonka voi ladata http-upload -nappulalla ja joka skaalataan www-suunnittelijan määrittelemään kokoon palvelimella automaattisesti (ei tarvitse miettiä tarkkaan kuinka isona skannaa jne)
Lista bannereita joista valitaan jokin satunnaisesti

Elementtien lisäksi sivuille voi rakentaa erilaisia listoja sivujen sisällöistä, mm.

Lista, missä on halutussa muodossa tietoja halutuilta sivuilta (esim. uutislista ingresseineen, lista sivujen nimistä, tms).
Kategorioittain jaoteltu lista sivuista, eli sivut lajitellaan jonkin kentän mukaan ensin kategorioihin ja niiden sisällä sitten eri tavalla.
Haku, joka näyttää hakutuloksena sivut joista löytyy annettu teksti

Yksittäisten sivujen lisäksi on myös helppo rakentaa "kortistohakemistoja", joissa on yksi sivupohja mutta hakemistossa voi olla "monta" käyttäjälle näkyvää sivua joilla kaikilla on sama ulkoasu mutta eri sisältö muokattavissa kentissä.

On myös mahdollista yhdistää sivujen editointi ja tavallinen http-autentikaatio jolloin sivut pääsee katsomaan salasanalla ja voi saman tien muokata niitä sivuja joita käyttäjällä on lupa muokata.

Maksimipituus tekstille missään muokattavassa kentässä on 8000 merkkiä. Kaikissa tulee editoitaessa tekstilaatikon eteen kentän nimi
otsikoksi, niin tietää mikä kenttä on mikäkin.

Käyttämällä näitä toimintoja luovasti, voi saada aikaa kaikenlaista hauskaa ja toimivaa...

Peruskäyttö yksittäisillä www-sivuilla

muokattavia elementtejä www-sivuille

Tämä toimii mille vain sivulle, kunhan ko. saitissa on PHP päällä
.html -tiedostoille.

Tiedoston ihan ekan rivin ihan alussa, siis ennen mitään muuta, pitää
olla:

<%require('ihaaedit.php')%>

Tämä tarvitaan jos käytät mitään tässä dokumentissa mainittuja
toimintoja.

Jos sivulla on editoitavia kenttiä, niin sitten pitää olla
editstartpage ja editendpage, joiden välissä on sitten kaikki
editoitavat kentät. Mieluiten heti BODY-tagin jälkeen (tai ennen
editoitavia kenttiä sopivassa kohdassa, tähän kohtaan tulee Edit /
Save,Cancel,Reset -nappulat):

<%editstartpage()%>

Sivun lopussa viimeisen editoitavan jälkeen ja ennen </BODY>:ä pitää
sitten olla:

<%editendpage()%>

Editoitaessa editstart/endpage:sta tulee formin alku ja loppu, jonka
kautta editointi toimii. Jos sivullasi on muita lomakkeita, tee näin
jolloin editoitaessa lomakkeesi ei näy mutta näkyy tavallisille
käyttäjille:

<%if($editdoedit){%>
(Tässä on lomake, kun et ole editoimassa)
<%}else{%>

...tässä on lomakkeesi koodi, sisältäen <FORM> ja </FORM> -tagit...

<%}%>

Tai parempi on sijoittaa koko lomake HTML:ssä ennen editstartpage:a
tai editendpage:n jälkeen.

Sivujen sisällön muokkaus

ihaaeditillä sivujen muokkaus onnistuu keneltä tahansa

Surffaa sivulle jota haluat editoita. Kirjoita selaimen URL-kentän
loppuun sivun osoitteen perään
?login=1
eli esim. niin että siellä lukee http://jotain/jotain.html?login=1

Sitten selain kysyy tunnusta ja salasanaa, anna ne. Sitten ko. saitin
editoitaville sivuille pitäisi tulla alkuun "Edit" nappula. Voi olla,
että sinulle on annettu oikeudet muokata vain jotain osaa saitista,
silloin Edit-nappula näkyy vain sivuilla joihin sinulla on oikeudet.

Jos haluat muokata jotain, klikkaa ko. Edit-nappulaa, niin saat sivun
muokattavaksi.

Muokkaa sisältöä miten haluat, ja paina sitten Save: muutokset
tallettuvat, Cancel: muutokset ei talletu, Reset: palauta kentät
sellaisiksi kuin ne olivat edit-napin painalluksen jälkeen.

Kun haluat lopettaa muokkauksen ja poistaa selaimestasi
muokkausoikeudet eli "logata ulos", mene sivulle jolla näet
Edit-nappulan ja klikkaa "Logout" -tekstiä. Sivun pitäisi latautua
uudelleen ilman Edit-nappulaa ja varmistuksella joka kertoo, että olet
logannut ulos.

Varsinkin jos käytit jotain yleisöpäätettä, muista AINA logata ulos ja
kokeile vielä että jos menet sitten takaisin sivuille ne eivät ole
enää editoitavissa.

Käyttäjän tunnistus ja sivujen muokkaaminen vaatii, että selaimesi
tukee cookieita eli keksejä, joita käytetään muokkausoikeuden
säilyttämiseen sinä aikana kun yhteys on auki.

Muokkausoikeus poistuu myös automaattisesti kahden tunnin kuluttua
sisäänloggaamisesta, jotta se ei unohtuisi auki pitkäksi aikaa. [TODO:
viimeisestä editistä?]

Sivupohja ja "kortisto"

Käytössä on myös monipuolinen "kortisto"

Jos haluat tehdä hakemiston, missä on sivupohja ja sitten
virtuaalisesti monta sivua (eli hakemisto/jotain.html -> pohja
tiedoilla sivulta "jotain") niin toimi seuraavasti:

Tee hakemisto. Luo sinne tiedosto nimellä .htaccess joka sisältää
(huomaa yksi kohta mihin pitää editoida hakemiston url-osoite)
dokumentin lopussa olevan esimerkin tekstin.

NEW: Luo ko. hakemistoon tiedosto nimellä _pohja.html josta tulee
sivupohja jonka mukaan sivut sitten näytetään. Tämä tiedosto on muuten
samanlainen kuin yhden sivun tapauksessa, mutta alun require-riville
lisätään editmultitemplate() -kutsu, eli:
<?require('ihaaedit.php');editmultitemplate()?>

(Myös vanha systeemi eli editstartpage:en annetaan "multi" lisätieto,
toimii yhteensopivuuden vuoksi <%editstartpage("multi")%>. Uusi
systeemi antaa käyttää muuttujia jo sivun headereissa).

ja mieluiten heti sivun <BODY>-tägin jälkeen. Eli ainoa sivu, jolla
pitää olla multi-määritys, on hakemistossa oleva sivupohja johon sivut
ohjautuvat sopivan .htaccess-määrityksen mukaan.

Jos hakemistossa on jokin tiedosto olemassa, niin se näytetään
sellaisenaan eikä haeta sivupohjan kautta. Ainakin index.html -sivu
kannattaa ehdottomasti tehdä. Muitakin voi tehdä jos haluaa. Muut
hakemisto/jotain.html haut ohjautuu sivupohjaan.

Käytössä on muuten samat muokattavat kentät kuin tavallisillakin
sivuilla ja niiden pitäisi toimia ihan kuin sivut olisivat erillisiä.

Dokumentin lopusta löytyy esimerkeistä myös _pohja.html:n malliesimerkki.

Huomaa, että jos sinulla on multihakemisto /jotain/, niin voit myös
nimetä tiedostot /jotain/virtuaalihakemisto/nimi.html tms, sekin
toimii, eli multihakemiston jälkeinen osa tulee sivun "nimeksi"
kokonaan. Jos haluat, että näillä "alihakemistoilla" on index.html
-sivut, sinun pitää luoda ko. alihakemistot ja tehdä sinne index.html
-tiedostot. Näissä multi-systeemi alihakemistoissa ei pidä olla
_pohja.html:ää tms muuta kuin index.html, ne käyttävät
päämultihakemiston pohjaa ja .htaccessia.

MULTI-YLLÄPITOSIVU: Hakemistossa missä käytät multi-edittiä, voit
helposti päästä editoimaan hakemiston sisältöä käyttämällä maagista
sivunimeä _ihaaedit.html (esim. si.te.dom.ain/news/_ihaaedit.html joka on
systeemin sisäinen automaattinen toiminto. Sivulla on lista sivuista
joista pääsee niitä editoimaan, poistamaan ja voi luoda uusia sivuja.

Note: Eli tämä korvaa vanhan _admin.html -tiedoston.

3. Muokattavat elementit

Bannerit

Vaihtuvat mainosbannerit

Systeemi osaa näyttää joukosta bannereita satunnaisesti
jonkun, ja klikkaamalla banneria joutuu jonnekin. Systeemi toimii
seuraavasti:

Aluksi pitää olla <%bannerstart()%> joka nollaa bannerisysteemin
(samalla sivulla voi olla useita erillisiä bannereita, kunhan jokaista
kohden on oma start-item...-end sarjansa).

Sitten kerrotaan kukin eri mahdollinen banneri yksitellen erillisillä
banneritem-kutsuilla.
<%banneritem('kuvanurl', 'kohdeurl')%>
<%banneritem('kuvanurl', 'kohdeurl', painokerroin)%>
Painokerroin kertoo suhteellisen painotuksen bannerille. Esim.
jos meillä on bannerit painokertoimilla 1,1,1,2 niin
niiden esiintymistodennäköisyys on 20%, 20%, 20% ja 40%.
Oletuspainokerroin on 1.
<%banneritem('kuvanurl', 'kohdeurl', paino, 'yyyymmdd-hhmm')%>
Bannerilla voi olla aika (esim. 20000401-1500" olisi
1.4.2000 klo 15:00) jonka jälkeen sitä ei enää näytetä
eli tällä voi automaattisesti poistaa jonkun bannerin
näkyvistä kun se vanhentuu ja sen voi sitten poistaa
html-koodista ajan kanssa kunhan ehtii. Huomaa, että
päivämäärä ja aika on ''-merkkien sisällä.

Bannerina voi myös olla kuvan sijasta mikä tahansa html-koodin pätkä. Käytä tällöin kutsua banner item html eli:
<%banneritemhtml('htmlkoodia')%>
<%banneritemhtml('htmlkoodia', paino)%>
<%banneritemhtml('htmlkoodia', paino, 'yyyymmdd-hhmm')%>
[html banneri lisätty 1.10.2000]

Lopuksi kerrotaan että näytä banneri tässä sekä bannerin koko (leveys,
korkeus)
<%bannerend(468,60)%>
Huomaa siis, että kaikkien samassa paikassa olevien
bannerikuva-vaihtoehtojen tulee olla saman kokoisia.

Esimerkiksi:
<%bannerstart()%>
<%banneritem('/kuvia/aihe-elaimet.gif','/plussanen/elaimet.html',10)%>
<%banneritem('http://www.cnn.com/logo.gif','http://www.cnn.com',20,
'20000312-1950')%>
<%bannerend(468,60)%>

Banneri ohjautuu uudelle sivulle redirectin kautta, eli www-serverin
lokiin tulee rivi muotoa
... sivu/jolla/banneri/oli.html?bannerjump=koh.de.url&bannerimg=ku.van.url
joita voi sitten jotenkin tilastoida jos haluaa. Eli kullakin rivillä
on millä sivulla on klikattu mitä banneria ja minne jouduttiin.

Bannereiden näyttökertoja systeemi ei laske, rajoita ajan mukaan tai
painokertoimella jos haluat jotenkin rajoittaa bannerin näkymistä.

counter

Laskuri

Sivulle saa laskurin, joka kertoo montako kertaa sivu on
ladattu. Tämä toimii lisäämällä sivulle seuraava kutsu:
<%counter()%>
Näyttää laskurin, aloittaa laskemisen 1:stä
<%counter(10000)%>
Näyttää laskurin. Jos laskurin numero on pienempi
kuin annettu numero (joka on tietty laskettu jostain
aiemmasta lokista tai arviosta jotta laskuri jatkaa
siitä missä oltiin) niin laskuri kasvatetaan siihen
arvoon.
<%counter(10000, 3.141)%>
Voit myös antaa kertoimen, jolla laskuria näytettäessä
numerot kerrotaan (jos haluat arvioida proxyjen yms
vaikutusta asiaan). Tässä tapauksessa eka lataus
antaisi 31410 ja toinen 31413 jne.

Note: Laskurin arvo (siis ei kerrottu kertoimella -arvo) on
sivumuuttujassa jonka nimi on _counter.

editimage

Helposti palvelimelle ladattavat kuvat

Kuvat tallettuvat hakemistoon
/site/lasipalatsi.net/www/editimage ja niihin viitataan vastaavalla
linkillä. Kuvan nimi on "hassu" md5-hash tekstistä
"site/dir/dir/page,name", mutta nimi näkyy kun editoit kuvaa jos se on
määritelty, jos sitä johonkin tarvitsisi. Tuolla md5-sotkulla
varmistetaan, ettei kuvat mene päällekkäin ilman että tiedoston nimi
pitenee liikaa.

<%editimage('nimi')%>
Näyttää ko. kuvan sivulla, ja editoitaessa näyttä file upload
-nappulan.
Esim. <%editimage('kuva')%>

<%editimage('nimi','extraa')%>
... voit antaa jotain extrahöhää, joka tulee IMG-tagin sisään.
Esim. <%editimage('kuva','ALIGN=RIGHT BORDER=0')%>

<%editimage('nimi','extraa',leveys)%>
... tai määrätä, että kuvasta tehdään tietyn levyinen kun se
ladataan palvelimelle. Huomaa, että tämä tuhoaa GIF:fistä
läpinäkyvyyden ja interlace-asetuksen tai voi huonontaa kuvan
laatua skaalauksessa. Kuvan korkeus skaalautuu suhteessa niin
että kuvan muoto ei muutu mutta leveydeksi tulee haluttu.
Esim. <%editimage('naamakuva','',100)%>

<%editimage('nimi','extraa',0,korkeus)%>
... tai määrätä korkeuden, leveys määräytyy tällöin kuvan
skaalaussuhteessa automaattisesti.
Esim. ...<TD><%editimage('sivupylvas','',0,500)%></TD>...

<%editimage('nimi','extraa',leveys,korkeus)%>
... tai määrätä molemmat. Jos kuvan suhteet ovat eri, kuva
venyy tai vääristyy sitten.
Esim. <%editimage('ikoni','ALT="*"',64,64)%>

editlinehidden

EDITLINEHIDDEN: Sama kuin editline, mutta teksti näkyy vain
editoidessa, muulloin sitä ei näytetä lainkaan. Tämä on kätevä
esim. expire-ajan määrittämiseen seuraavalla tavalla:
<%editlinehidden('expire',13)%>

editline(nimi, leveys)

Lyhyt muokattava teksti

EDITLINE: Lyhyt editoitava teksti

<%editline('nimi')%>
Editoitava teksti, editoitaessa yhden rivin laatikko
Esim. <H1><%editline('otsikko')%></H1>

<%editline('nimi',leveys)%>
Sama kuin yllä, mutta voit määrätä halutessasi kuinka monta
merkkiä
Esim. <H1><%editline('pitkaotsikko',50)%></H1>

Jos haluat tallettaa päivämääriä, käytä tällä hetkellä 10 merkkiä
leveää editline -kenttää ja laita sinne päivämäärä 2000-02-20
muodossa, sitten ne tulee lajiteltua oikein tarvittaessa.
Esim. <%editline('paivamaara',10)%>

Katso myös: editsetmenu

editrestfrompage

Tiedon haku näkyviin eri sivuilta

Voit vaihtaa miltä sivulta seuraavat editoitavat
kentät tulee. Näitä voi nyt olla vain useita sivulla ja se vaikuttaa
kaikkiin editoitaviin kenttiin jotka ovat sen jälkeen saman sivun
loppuosassa (ennen ehkä seuraavaa editrestfrompage:a).

Ideana on se, että jos sinulla on vaikka leffainfosivut leffa1.html
leffa2.html leffa3.html joissa on kaikissa samat kentät (otsikko,
esittely, teksti) niin saat kotisivulle helposti yhden/muutamia noista
tällä virityksellä laittamalla sinne otsikko, esittely, teksti
-editoitavat kentät tämän jälkeen, jolloin voit editoitaessa valita
minkä sivun otsikko, esittely, teksti jne -kentät sitten.

Editoitaessa tästä tulee valikko, josta voi valita sivun mistä
kenttien arvot haetaan, tai että ei vaihdeta sitä sivua mistä tiedot
haetaan.

Tämä toimii myös monisivuhakemisto-sivujen kanssa.

Tiedot pitää editoida niiden alkuperäisellä sivulla. Jos haluat jotain
editoitavaa tekstiä samalle sivulle editrestfrompage:n kanssa, niin
laita se ennen ensimmäistä editrestfrompage:a (esim. jos haluat jonkun
tekstikentän johon voi laittaa, että "ei ole mitään tällä hetkellä,
sorry").

<%editrestfrompage('nimi')%>
Maaginen kludgeviritys jolla voi hakea esim. uutisia jostain
läjästä kotisivulle tms.

Esim. jos sulla on moniedithakemisto, jossa on sivut tyyliin:

<%require('ihaaedit.php');editmultitemplate()%>
<%editstartpage()%>
<P>Otsikko: <%editline("otsikko")%>
<%editendpage()%>

Niin voit tehdä vaikkapa index.html -sivun, jossa on valittuna noista
kolme otsikkoa (kenttiä ko. sivulla voisi olla montakin tietty, kunhan
on samat niillä sivuilla joista valitaan tai tulee tyhjää sitten).

<%require('ihaaedit.php')%>
<%editstartpage()%> 
<P>Hieno index.sivu
<P>Seuraavassa valitut kolme juttua:
<P><%editline("mikseimitaan")%>

<%editendpage()%>

Huomaa, että samalla sivulla olevilla editrestfrompage:illa pitää olla
eri nimi, jotta systeemi erottaa ne toisistaan. Jos on vain yksi
editthispage, niin nimeä ei tarvita välttämättä (yhteensopivuus ekan
version kanssa, laita nykyään aina nimi myös).

Jos jostakin editrestfrompage:sta on valittu "(No Change)" -kohta,
niin se tarkoittaa ettei systeemi hyppää sitten sillä kohdalla toisen
sivun tietoihin.

Jos editrestfrompage:sta on valittu "Nothing (empty data)",
silloin sen jälkeen tulevat kentät (mahdolliseen seuraavaan
editrestfrompageen asti) jäävät tyhjiksi, eli millään kentällä ei ole
mitään sisältöä.

<%endeditrestfrompage()%> määritteellä voit lopettaa tämän toiminnon toiminta-alueen ja palata varsinaisen sivun sisältöön.

editsetmenu

Valikko vaihtoehdoista

EDITSETMENU: Valikko, josta voi valita arvon editline-kentälle
olemassaolevista (esim. kategoria jotta tulee samaan kaikki).

<%editline('nimi'); editsetmenu('nimi')%>

Tästä tulee editoidessa tekstikenttä jota voi editoida sekä valikko,
jossa on valmiina kaikki samannimisen tekstikentän eri arvot samassa
hakemistossa olevista tiedostoista. Jos menusta valitsee jotain,
teksti kopioituu editoitavaan kenttään.

Jos haluat hakea kentän 'nimi' arvoja jostain muualta tai koko
saitista, voit antaa lisäargumentin: <% editsetmenu('nimi','/dir') %>,
missä toinen argumentti määrää minkänimisten hakemistojen alta tietoja
etsitään (sivunninem prefix, eli jos sanot /news, se etsisi
ko. nimisen kentän arvoja esim. hakemistoista /news /news/foo
/news/bar jne).

Hakemistonimi "thissubdironly" on alihakemistonimisiä tiedostoja
sisältävän multi-hakemiston tapauksessa vain juuri tämä
"ali"-hakemisto, ei koko multi-hakemisto kaikkineen.

edittag

Yleinen tagi tai linkki

<%edittag('nimi','tag','param')%>
Normaalitilassa tästä tulee HTML:ään teksti muotoa
<tag param="tekstisisältö" extraa>
ja editoitaessa tekstilaatikko, johon voi kirjoittaa jotain.
Jos kentän arvo on tyhjä, silloin ko. tagia ei tule
lainkaan näkyviin (eli se ei tule tyhjällä kentän arvolla
param="" vaan jää kokonaan pois).
Esim. Ime file <%edittag('fileurl','a','href')%>täältä</a>
-> <a href="foo.zip">täältä</a>

<%edittag('nimi','tag','param',leveys)%>
Extraa tulee tagin sisään, voit lisätä jotain muuta vakiohöhää
jos haluat. Samoin kuin image:ssa.
Esim. <%edittag('foo','META','VALUE', 'NAME=keywords')%>
-> <META VALUE="tekstijonkakirjoitat" NAME=keywords>

<%edittag('nimi','tag','param','extraa',leveys)%>
Voit myös määrätä kuinka leveä tekstikenttä on editoitaessa.
Esim. <%edittag('foo','META','VALUE', 'NAME=keywords', 100)%>

edittext

Pidempi muokattava teksti

<%edittext('nimi')%>
Editoitava teksti, editoitaessa textarea.
Esim. <P><I><%edittext('ingressi')%></I>

<%edittext('nimi',leveys,riveja)%>
... voit kertoa montako merkkiä leveä ja korkea textarea:n pitäisi
olla.
Esim. <P><I><%edittext('pitkateksti',60,20)%></I>

EDITSHOW: Näytä teksti jostain, ei editoitavissa.

<%editshow('nimi')%>
Näyttää ko. nimisen kentän sisällön, ei editoitavissa.
Käytä tätä jos haluat jonkun tekstin moneen kertaan.
Esim. Sivun otsikko oli <%editshow('otsikko')%>.

<%editshow('nimi','page')%>
Näyttää ko. nimisen kentän sisällön mainitulta sivulta
saitissa. Käytä johonkin footteriin joka on tietyllä
sivulla ja muualla sitten <%editshow('footer','/index.html')%>
tms.
Esim. Uusin uutisotsikko on <%editshow('newsots','/news/index.html')%>

<%editshow('nimi','page','site')%>
Näyttää ko. kentän ko. sivulta ko. saitista. Älä käytä kuin
erikoistapauksissa (esim. hakea joku uutinen toisesta
saitista toisen saitin sivulla).
Esim. Rexissä menee nyt <%editshow('leffanyt','/index.html','biorex')%>
;

edittextfile(filename, col, row, displaypretty, savepretty)

Muokattava elementti, joka tallettaa tiedon tekstitiedostoon.

Tämä elementti toimii kuten edittext, mutta tallettaa annetun tekstin tavalliseen tekstitiedostoon. Tämä on lähinnä tarkoitettu tapauksiin, missä tietoon halutaan päästä käsiksi myös jossain muualta käsin mistä ei haluta käyttää tietokantaa vaan lukea suoraan tiedostoa.

Tieto talletetaan kahteen tiedostoon eri muodoissa:

filename: sisältää tekstin sellaisenaan ilman muutoksia. Kun kenttää näytetään editoitavalla sivulla tai editoidaan, tieto luetaan tästä tiedostosta takaisin. Tekstiä voi siis muuttaa myös muokkaamalla tätä tiedostoa.
filename.pretty

ihaa.com

Kotisivu
Yritys
Uutiset
Ratkaisut

English
Japanese

Aiheet

Ahaa! Ajatuksia
Työkalut

Ota yhteyttä

ihaaedit: työkaluja tehokkaan www-julkaisuprosessin rakentamiseen

1. Johdanto

ihaaeditin käyttö on helppoa

Toimiva julkaisuprosessi www-sivuille

2. Perusteet

Muokattavista elementeistä

Peruskäyttö yksittäisillä www-sivuilla

Sivujen sisällön muokkaus

Sivupohja ja "kortisto"

3. Muokattavat elementit

Bannerit

counter

editimage

editlinehidden

editline(nimi, leveys)

editrestfrompage

editsetmenu

edittag

edittext

edittextfile(filename, col, row, displaypretty, savepretty)

editvote

Muokattavien elementtien sisältö ja toiminnot

4. Haut ja listaukset

editcategorylist

editpagelinklist

editpagelist

editpagesearch

editshow

Kenttien sisällön muoto listoissa

5. Integrointi wysiwyg-työkaluihin

DreamWeaver 2.0, 3.0

6. Edistyneitä toimintoja

?edithtml=1

editshowupdate

Expire

hideinlists

if-then-else

trustbasicauth()

7. Kehitteillä olevia toimintoja

editdiscussion

8. Esimerkkitiedostoja

multitemplate: index.html kotisivu

multitemplate: news/.htaccess

multitemplate: news/index.html

multitemplate: news/_pohja.html

Tavallinen www-sivu jolla muokattavia elementtejä