Implementasjonsmanual for eredaktør 1.x Introduksjon Dette dokumentet er en innføring i hvordan man setter opp designfiler og maler i eredaktør 1.x. Som forkunnskap er det nyttig å ha litt erfaring med bruk av HTML og CSS, samt noe forståelse av hvordan en database fungerer. Jo mer man kan dette, jo enklere vil det være å lage mer avanserte løsninger med eredaktør. eredaktør i seg selv setter ingen begrensninger i hva slags verktøy en kan bruke til å lage og sette opp webdesign. Det er også opp til hver enkelt om en ønsker å bruke tabell- eller div-basert oppsett av HTML/XHTML. Forbehold eredaktør 1 er under stadig utvikling, så det kan ha kommet nye funksjoner og muligheter siden dette dokumentet ble skrevet. Eksisterende funksjonalitet tas ikke bort. Dette er for å sikre bakoverkompatiblitet med nettsider som allerede er i drift. Gjeldende eredaktør versjon: 1.6.4 1 av 34
Innholdsfortegnelse Implementasjonsmanual for eredaktør 1.x...1 Introduksjon...1 Forbehold...1 Innholdsfortegnelse...2 Oppsett i eredaktør...3 Sidetyper...3 Opprette ny sidetype...3 Attributter...4 Felttyper...4 Kategorier...5 Menyer...6 Egne faner...6 Dele innhold mellom nettsider (multi-site)...6 Duplisere et nettsted eller endre domenenavn...6 WAP/mobil versjon...8 Flerspråklige nettsider...8 Søkemotoroptimalisering...8 Innstillinger...9 Nettstedet...9 Globale variabler... 10 Artikkellister... 10 Diverse valg... 10 SimpleViewer... 10 Variabler tilknyttet publisering... 10 Design (index.html og css)... 12 Egendefinerte spørringer... 13 Eksempel på index.html... 15 Innhold og maler... 16 artikler.asp... 16 tekst.asp... 17 Maler... 18 Tekstmal... 18 Artikkelside... 20 Artikkelliste... 21 Menyliste... 22 Generell... 22 Skjema... 23 Maler i nettbutikken... 24 butikk.asp... 24 produktoversikt... 24 produktliste... 25 produkt.asp... 27 produkt... 27 VBScript/Snippets... 29 Importere... 29 Begrensninger... 29 Innebygde funksjoner... 29 Noen vanlige SQL-spørringer... 31 Faste navn på småtekster... 32 Hjelp og debugging... 33 Maler... 33 Script... 34 2 av 34
Oppsett i eredaktør Dette kapittelet omhandler hvordan man setter opp tekstoppsett og annet inne i eredaktør. Det er i hovedsak sidetyper og menyer en bør vite forskjell på. Sidetyper Hvis vi skal sammenlikne en sidetype med noe annet, så vil den i databaseverdenen være tilsvarende en tabell, i papirverdenen kan den sammenliknes med et skjema. En sidetype består av et gitt antall felter som brukeren kan fylle inn informasjon i. De vanligste feltene er tittel og innhold(tekst og bilder), mens nyheter (som i nettavisene) i tillegg gjerne har en ingress og et ingressbilde som skal vises på forsiden. I eredaktør er det to ferdige sidetypeoppsett. En for menytekster som kun har tittel og tekst, og en for nyheter/artikler som har topptekst, titttel, ingress, ingressbilde og tekst. Det er vanligvis opprettet en sidetype av hver som heter nyhet og tekst. Disse ligger synlige til venstre under Publisering -fanen. Det står ny tekst og ny nyhet. Opprette ny sidetype For å endre, slette eller legge til flere sidetyper, går en inn i Innstillinger > Tekst > Sidetyper. Her listes eksisterende sidetyper opp. Her står navnet på sidetypen, hvilken gruppe som har tilgang til å redigere den, hva slags type(feltoppsett) den er av og hvilken mal som brukes for å vise den. For å opprette en ny sidetype trykker en på Ny-ikonet i toppen. Da kommer en til en side hvor en gjør en del valg i forhold til sidetypen: Navn Navnet på sidetypen. Dette angis i entall, slik at det blir logisk for brukeren. Dette kan ikke endres i etterkant. Type Som nevnt tidligere er det noen faste oppsett av felter. De tre som har med tekstpublisering å gjøre er: - Menyelement o Denne har kun tittel og tekst/innhold som standardfelt - Kategorisert o Denne har tittel, topptekst, ingress, ingressbilde og tekst/innhold. - Egendefinert o Denne har bare tittel som standardfelt Det siste valget som heter Datatabell, brukes i noen av modulene i eredaktør der en skal kunne angi egne felter. I tillegg til de nevnte feltene er det også en del standardfelt rundt publiseringen som publiseringog fjerningsdato, forfatter, stikkord og sidenavn. Mal Her kan en velge mellom de tekstmalene som er opprettet. Dersom ingen mal velges, brukes et standardoppsett. Tekstmaler omhandles i et eget kapittel. Forhåndsdefinert tekst Denne gjelder kun for menyelement og kategorisert. Her listes småtekstene opp. Dersom en velger en av disse, vil innholdet fra denne stå som standard i tekst-feltet. 3 av 34
Vis snarvei Her bestemmer du om sidetypen skal vises som snarvei (Ny ) under Publisering-fanen. Det har ingen annen betydning. Kjør ved lagring Denne brukes dersom det skal kjøres et script eller aktiveres en lenke i bakgrunnen når en lagrer et element av sidetypen. Det kan for eksempel være et script som generer en PDF, sender en mail eller oppretter en kundeprofil. Når en har trykket lagre, kommer en videre til en side hvor en kan opprette esktra felter/attributter. Attributter Attributter er ekstra felter en kan legge til i sidetypen. Disse vises under standardfeltene når en oppretter et nytt element av sidetypen. Det finnes mange forskjellige attributtyper å velge mellom. Hvis en trykker på ny-ikonet får en opp fire valg: Navn Navnet på attributtet. Dette kan ikke endres, og det er en fordel om en unngår spesialtegn her. Særlig ved bruk av HTML editoren, da den ikke fungerer i alle nettlesere ved bruk av for eksempel æ, ø eller å. Type og verdier Disse to henger sammen. Noen felttyper kan bare ha én verdi, noen tillater flere verdier mens andre forventer at en har skrevet en SQL-spørring eller en lenke. Dersom det er mulig med flere verdier, skilles disse med semikolon. Se neste avsnitt for å lære mer om de forskjellige felttypene. Plass Hvilken plass dette attributtet skal ha i listen. Gir mulighet til å styre rekkefølgen som attributtene vises i. Felttyper Tekstboks Tekstboks med én linje. Kan ha én verdi Avkryssning (merk én) Avkryssningsboks (runde felter) med kun mulighet for å merke én verdi om gangen. Kan ha flere verdier. Dersom det ikke er plass til alle verdiene i feltet kan en bruke SQL-utvalg merk én. Avkryssning (merk flere) Avkryssningsboks (firkantede felter) med mulighet for å merke flere verdier om gangen. Kan ha flere verdier. Dersom det ikke er plass til alle verdiene i feltet kan en bruke SQL-utvalg merk flere. Rullegardinsliste Nedtrekksliste med kun mulighet for merke én verdi om gangen. Kan ha flere verdier. Dersom det ikke er plass til alle verdiene i feltet kan en bruke SQL-utvalg merk én. 4 av 34
Tekstfelt Tekstboks med flere linjer. Kan ha én verdi. HTML Editor med mulighet for å formatere teksten og sette inn bilder og lenker m.m. Kan ha én verdi. Bilde Gir mulighet til å laste opp bilder eller velge bilde fra mediebiblioteket. Ingen forhåndsverdi. Lenke Gir mulighet til å skrive inn lenke, eller velge en tekst, eller medieelement å lenke til. Lenke med navn Gir mulighet til å angi en lenke med navn, eller velge en tekst, eller medieelement å lenke til. Verdien som returneres og lagres inneholder hele html-koden for lenken. Dato Gir mulighet til å plukke en dato fra en kalender. Tidspunkt Gir mulighet til å angi et tidspunkt SQL-utvalg merk én Viser en nedtrekks-/rullegardinsliste med resultatet fra spørringen som er angitt som verdi. Feltnavnene må være name og value. Et eksempel på en liste som henter ut en liste over nyheter: SELECT tittel as [name], id as [value] FROM side WHERE type = 'nyhet' ORDER BY tittel Dersom en ønsker å selv angi en liste med navn og verdier, ligger det noe som heter Lister under Avansert > Database. Her kan en opprette egne lister som en kan hente verdier fra. Et eksempel på en liste som henter ut en egendefinert liste (Min liste): SELECT ListeFeltNavn AS [name], ListeFeltVerdi AS [value] FROM lister WHERE ListeNavn = 'Min liste' ORDER BY ListeFeltPlass SQL-utvalg velg flere Tilsvarende som over, men her kan en velge flere verdier. Ekstern verdi Énlinjet tekstboks som viser verdien som en angitt lenke returnerer. Kategorier Kategorier gir mulighet til å dele sidetypene opp i mindre grupper. Dette brukes i hovedsak til sidetyper som er av typen Kategorisert. Disse listes gjerne ut på forsiden og i et arkiv. Ved å bruke kategorier kan en bruke samme sidetype i flere uavhengige lister på nettsiden. Når en oppretter en artikkelliste i menyen, opprettes det automatisk en kategori med det navnet som angis. Det er også mulig å opprette kategorier under Innstillinger > Tekst > Kategorier eller under en valgt sidetype rett i tekstarkivet. 5 av 34
Menyer Her er noen av mulighetene du som skal implementere nettsted har i forhold til menyene. Dersom du ikke vet hvordan menyene fungerer bør du først sjekke brukermanualen. Menyene er egentlig en samling lenker til ulike elementer i og utenfor eredaktør. De har et navn, en lenke (for eksempel /sider/tekst.asp), en lenkeendelse (for eksempel?side=1), en plassering/rekkefølge, målramme og beskrivelse. Alle disse feltene kan brukes når en henter ut menyen manuelt. Som standard ligger det en mappe som heter Hovedmeny under Publisering > Innhold. Dersom en ønsker å ha flere menyer her, som for eksempel skal vises over hovedmenyen, trykker en på Innhold og velger et navn. Dette kan også gjøres dersom en ved en feiltagelse sletter Hovedmeny. Vær oppmerksom på at menyen er navn-lenket. Det vil si at dersom en sletter Hovedmeny og oppretter en mappe med navnet Hovedmeny, vil innholdet fortsatt ligge der. Dette fungerer veldig greit helt til en har to mapper som heter det samme. Da vil innholdet i disse to mappene være identisk. Siden menyen bare er lenker, vil det si at hvis en sletter et menyelement som peker til en tekst, vil ikke teksten slettes. Det gir også mulighet for å ha ubegrenset antall lenker til den samme teksten. Egne faner Det er mulig å definere sine egne arkfaner i toppen av eredaktør. Dette gjøres ved å opprette en top mappe som heter _Arkfaner. I denne mappen plasserer du så en tom mappe for hver arkfane du ønsker å legge inn. Dette kan for eksempel brukes dersom du ønsker å lage din egen modul i eredaktør med sidetyper av typen datatabell. Siden /sider/dataelement.asp?element=[sidetype] kan brukes for å opprette og endre sidetypen. Dele innhold mellom nettsider (multi-site) Det er mulig å ha flere nettsteder med én felles administrasjon. Hvert nettsted/domene kan ha forskjellig design, meny, startside og navn. Det eneste man trenger å gjøre, er å velge at det skal brukes samme database på flere eredaktør installasjoner. Det en må være klar over, er at filer lastes opp i den mappen til domenet en er innlogget på. Dvs at mediafiler og dokumenter i intranettet ikke vil være felles, siden disse leses rett fra disk. Duplisere et nettsted eller endre domenenavn Det hender en ønsker å kopiere et nettsted med alt innholdet, til et nytt domene. Evt at en har registrert feil domenenavn når nettstedet ble satt opp. Her er en kort guide til hvordan dette gjøres. Sett opp den nye eredaktør installasjonen med tilsvarende innstillinger som nettstedet du allerede har. - Kopier databasen fra det gamle nettstedet og overskriv den nyopprettede databasen. - Sjekk at det er samme databaseversjon på det nye nettstedet som det du kopierte fra. (Innstillinger > Database > Oppgradere). Dersom det ikke er det, bytt versjon på det nye. - Kopier over filene fra det eksisterende nettstedet til den nyopprettede mappen. - Endre navn på [gammeltdomene].css filen, så den blir [nyttdomene].css Nå må vi endre alle fil-lenkene i databasen til å peke til de nye filene. Logg inn i eredaktør og gå til 6 av 34
Innstillinger > Avansert > Database > Finn og erstatt I Finn skriver du inn /[gammeltdomene]/ og i Bytt til skriver du /[nyttdomene]/. Det ligger en liste over tabeller og felt som må rettes. Den viktigste er tabellen opplastet med feltet filnavn. 7 av 34
WAP/mobil versjon Det ligger inne en enkel redirect dersom et domene begynner med wap (for eksempel wap.domene.no). Brukeren sendes da til /domene/wap/. Denne mappen finnes i utgangspunktet ikke, men det er mulig å få eksempelkode på dette ved å kontakte EDB Totalpartner. Dersom en ønsker en mobil-versjon av webdesignet, kan en i tillegg til index.html legge inn mobile.html i designmappen. Denne kan ha akkurat de samme taggene som index. Flerspråklige nettsider Det er mange kunder som ønsker at besøkende skal kunne velge hvilket språk innholdet skal vises på. Det er flere måter å løse dette på. Det en må tenke på før en velger løsning, er om alt innholdet skal oversettes, eller om de ulike språkversjonene kan komme til å ha litt ulikt innhold. I de aller fleste tilfellene vil det være noen forskjeller mellom de ulike språkversjonene, og da løses siden enklest ved å ha ulike menystrukturer for hvert språk. Da kan en slette Hovedmeny og legge inn nye mapper med språkene som navn. Når en velger språk, bytter en da bare ut menyen. Det ligger inne en lenke som gjør dette for deg. Den kan for eksempel se slik ut: /sider/menyvalg.asp?meny=english&url=/sider/artikler.asp?type=nyhet--kat=news -- brukes i stedet for &. Noen funksjoner og moduler støtter flere språk, dette er blant annet nyhetsbrevpåmeldingen, nettbutikken og skjemaene. Dersom en ønsker å oversette alle dokumenter til ett eller flere språk, kan en legge inn flere språkversjoner av samme dokument. Dette gjøres ved å legge inn flere kommaseparerte språk under globale variabler. Da vil en få mulighet til å opprette flere versjoner under publisering inne i redigering av en tekst. Søkemotoroptimalisering Det er mange måter å gjøre nettsiden mer synlig i søkemotorene. Bruke ønskede ord i titler, som alternative tekster på bilder, i beskrivelsesfelt m.m. Det aller meste at dette gjøres uavhengig av publiseringsverktøyet. eredaktør har innebygget støtte for description-tag og bruker title-taggen så ofte som mulig. Det er likevel noen små ting en kan gjøre selv. Dersom en lar beskrivelsesfeltet stå tomt vil det ikke vises, og en kan da bruke et attributt for å ha forskjellig beskrivelse(description) på hver enkelt tekst. Det ligger inne et script en kan installere for å skrive ut et attributt i index.html. Det er også mulig å bruke enklere lenker. Hvis en angir et sidenavn til en tekst, kan lenken til denne teksten se slik ut: /tekst/lenker.aspx i stedet for /sider/tekst.asp?side=232. Ved å installere et sitemap-script kan en også ha en side som har lenker til hele innholdet. Denne siden kan også lenkes til på alle undersider fra for eksempel bunnteksten. 8 av 34
Innstillinger Nettstedet Innstillingene for nettstedet ligger under fanen Innstillinger, og deretter Avansert > Nettstedet. Valgene her er globale for nettsiden, og vil også være gjeldene dersom en flytter nettstedet mellom forskjellige servere som har samme hoveddatabase. Dette gjelder også globale variabler som nevnes under. Tittel i nettleseren Dette er tittelen som vil havne i <title> under meta-taggene. Utseende Hvilket skin/design som nettsiden skal bruke. Listen viser de mappene som ligger under skins. Første side Den siden man kommer til ved å bare skrive domenenavnet. Det er et valg her for å søke gjennom sider som ligger inne. Meny Denne settes vanligvis bare til hovedmeny siden det er menyen som eredaktør foreslår som standard. Men dette kan endres. Det som settes her vil også ligge i Session( meny ) når en kommer inn på siden. Utskriftsversjon mulig Avgjør om det vises utskriftsvennlig versjon hvis en bruker den innebygde tekstmalen. Beskrivelse av nettstedet Teksten som står her kommer i description under meta-taggene. Standard til adresse (e-post) Brukes dersom ikke annet er angitt Standard fra adresse (e-post) Brukes dersom ikke annet er angitt, og vises som standard avsender i nyhetsbrevene og nettbutikken. Standard emne i e-poster fra nettstedet Noen steder i eredaktør brukes denne dersom ikke noe annet er angitt. 9 av 34
Globale variabler Under fanen Innstillinger og deretter Avansert > Globale variabler ligger det en del valg for nettsiden. Det dukker stadig opp nye her, så denne listen kan være noe ufullstendig. Artikkellister Standard antall artikler Som standard vises det inntil 14 artikler i en artikkelliste. Dette kan overstyres i selve lenken som nevnt tidligere, eller en kan sette sin egen begrensning. Det gjøres her. Søkemotorvennlige lenker I eredaktør er det mulig å bruke søkemotoroptimaliserte lenker i artikkellistene. Da vil lenkene til tekstene komme på denne formen: /tekst/ [ID] / [Tittel].aspx Mellomrom vil byttes ut med bindestrek, så en lenke kan for eksempel se slik ut: /tekst/43/omoss.aspx. Diverse valg Deaktiver RSS RSS er skrudd på som standard på nettsiden. Dersom en ikke ønsker dette, kan en velge det her. RSS lar besøkende få en liste over de siste sakene som er lagt inn på nettsiden. Denne kan åpnes i ulike programmer. Skjul favorittikon eredaktør viser favorittikonet som standard, dersom man ønsker å skjule dette, krysser man av her. Egendefinert favorittikon Her kan du skrive inn hele stien til et alternativt favorittikon. Husk at det ikke må være krysset av i valget over. Mellomlagre snippetsdata Mellomlagrer resultatet hvert enkelt vbscript i minnet, og skriver ut resultatet i stedet for å kjøre scriptene hver gang. Denne gjelder alle vbscript, og må dermed brukes med omhu. Mellomlagre egendefinerte maler Mellomlagrer resultatet fra malene (<mal sql= ></mal>) i en egen cache-tabell i databasen. SimpleViewer SimpleViewer er en flash-løsning til bildegalleriet. Innstillingene for flashen ligger her. Et tips dersom du ønsker å la bildene fylle i bredden, er å ha færre rader (1-2 stk) og heller flere kolonner. Variabler tilknyttet publisering Språk (kommaseparert) Denne brukes ikke av noen kunder per i dag, men lar systemet opprette flere språkversjoner av samme dokument. Faner ved redigering (kommaseparert) Gir mulighet til å viser flere faner under redigering av dokumenter. Den det brukes til per i dag er tillegg. Flere maltyper 10 av 34
Dersom en ønsker å dele malene opp i egendefinerte typer, kan en legge til flere her. Det er for å unngå at det blir liggende mange under for eksempel generelt. 11 av 34
Design (index.html og css) Når det henvises til domene i dette kapittelet, er det snakk om domenet (f. eks. www.eredaktor.no), men uten www. og endelsen.no. Så det vil si at i tilfellet www.eredaktor.no skal domene være kun eredaktor. Det er flere praktiske grunner til dette. index.html skal plasseres i en egen mappe under Skins. Filen index.html er selve hovedmalen for nettstedet. Den definerer rammene for nettsiden. Siden er en helt standard HTML-side med noen spesielle eredaktør-tagger. CSS filen som benyttes kan enten hete css.css og/eller domene.css og ligger i samme mappe som index.html. Grunnen til dette er at linken opprettes automatisk av eredaktør. Alle bildene ligger i en undermappe som heter images. Grunnen til dette er at eredaktør automatisk forandrer lenkene til bildene slik at de kan brukes av alle sider uavhengig hvor de ligger. Det er en del tagger du kan benytte i index.html for at den skal integreres i eredaktør. Under finner du en innføring i disse: <!--e header --> Denne plasseres i headeren (mellom <head> og </head>). Denne legger inn lenker til css, samt tittel og noen søkeord. Husk å fjerne tittelen som ligger i index.html fra før. <!--e innhold --> Dette er selve hovedtaggen som bestemmer hvor koden fra de ulike sidene skal kjøres. Der denne taggen er plassert vil dokumentene vises, forumet plasseres, nyhetslistene vises. Dersom denne taggen ikke finnes vil den automatisk plasseres helt i slutten av index.html <!--e navlist --> Denne lister ut standardmenyen (for eksempel hovedmeny) i en liste (UL og LI). Brukes gjerne til dropdown-menyer. <!--e listemeny --> Denne lister ut standardmenyen (for eksempel hovedmeny) i en liste (UL og LI). Den bruker class= menu for å hente design. Brukes gjerne med AdxMenu. <!--e katmeny --> (brukes sjelden) Dersom en ønsker å liste opp alle sidetyper og kategorier alfabetisk som en meny. Benytter seg av samme maler som en vanlig meny. <!--e meny --> (brukes sjelden) Denne taggen plasserer menyen. Menyen styres av malene i systemet og er egentlig et javascript. Javascriptet kan også plasseres manuelt, og da kan en også overstyre hvilken meny som skal vises; <script src=/sider/menyjs.asp?meny=...></script> 12 av 34
<!--e include:[småtekst] --> Med denne taggen kan alle småtekster inkluderes direkte. Navnet på småteksten skrives der det nå står [småtekst]. Denne virker med alle småtekster, kun med unntak dersom en småtekst skulle bli gitt navnet denneside. Se punktet under for å forstå dette. <!--e script:[filnavn] --> Med denne taggen kan enkle vbscript importeres direkte i designet. Det ligger en del ferdige script som kan importeres og brukes. Eks: <!--e script:dato.vbs --> <% [vbscript] %> Med denne taggen kan du kjøre enkle vbscript direkte i designet. Kan for eksempel brukes til å skrive ut dagens dato, gjøre en test etc. Eks: <%=Date() %> <!--e denneside --> Denne taggen blir byttet ut med hele lenken til siden, for eksempel kan taggen byttes ut med http://ekanal.no/sider/tekst.asp?id=1213 <!--e rq:[variabel] --> Her kan du hente ut informasjon fra eventuelle endelser på lenken (QueryString) som den over. Forskjellen er at du nå skriver <!--e rq:id --> og får ut verdien 1213. Denne kan brukes sammen med <mal/>-taggene som jeg nevner lenger nede. Men det er ikke anbefalt å putte variabler rett inn i SQL uten å sjekke dem først. <!--e standardside --> Denne taggen blir erstattet av den definerte førstesiden. Dette gjøres dersom en ikke ønsker å lage en lenke til / som også er mulig. Egendefinerte spørringer <mal sql= [databasespørring] >[html-mal]</mal> Dette er den mest avanserte taggen en kan benytte i index.html (og i malene). Den gir deg direkte tilgang til nettstedets database. (Dette er ikke et stort sikkerhetshull, da alle kundene har hver sin database.) Et eksempel på utnyttelse av denne taggen: <mal sql= SELECT TOP 1 tittel, ingress, tekst FROM side > <p class= tittel ><!--e tittel --></p> <p class= ingress ><!--e ingress --></p> <p class= tekst ><!--e tekst --></p> </mal> Her vil den første teksten fra databasen hentes ut og vises med tittel, ingress og brødtekst. Dersom en ønsker å lage en kronologisk liste over alle nyheter kan en også gjøre det enkelt: <mal sql= SELECT tittel, ingress, id FROM side WHERE type = nyhet ORDER BY publisert DESC > <div class= artikkelliste > <p class= tittel ><!--e tittel --></p> <p class= ingress ><!--e ingress --></p> 13 av 34
<p><a href= tekst.asp?side={id} >Les videre</a></p> </div> </mal> I det siste eksempelet her, vil ingressen vises ut uten de linjeskiftene en har lagt inn. Det er fordi HTML krever at linjeskift angis som for eksempel <br />. For at eredaktør skal bytte ut linjeskift med <br /> skriver du bare _ foran feltnavnet. Så ingress vil da bli skrevet: <!--e _ingress --> <mal:[malnavn] sql= [databasespørring] /> Denne taggen tilbyr deg gjenbruk av maler. Her skriver du ikke malen i html-filen. Dermed er det også enklere å endre den direkte fra eredaktør. Dersom vi ønsker å gjøre det samme som i eksempelet over ville vi ha opprettet en mal i eredaktør; Innstillinger > Tekst > Maler. La oss si at vi kaller denne malen for artikler og at den er av typen generell siden vi ønsker å bruke den rundt omkring. Malen ser slik ut: <div class= artikkelliste > <p class= tittel ><!--e tittel --></p> <p class= ingress ><!--e ingress --></p> <p><a href= tekst.asp?side={id} >Les videre</a></p> </div> Deretter går vi inn i index.html for å plassere malen vår. Nå skriver vi følgende tag: <mal:artikler sql= SELECT tittel, ingress, id FROM side WHERE type = nyhet ORDER BY publisert DESC /> Malen vil fungere helt likt som tidligere, bare at nå har du mulighet til å bruke den flere steder om du ønsker. Dersom du vil ha en liste over de siste artiklene opprettet av en bruker som er definert i lenken kan du nå skrive: <mal:artikler sql= SELECT TOP 5 tittel, ingress, id FROM side WHERE type = artikkel AND bruker = <rq:bruker/> ORDER BY publisert DESC /> Dersom det ikke er definert noen bruker i lenken, vil det ikke vises noen ting. Mot slutten av dokumentet er et kapittel med noen vanlige SQL spørringer som kan brukes. 14 av 34
Eksempel på index.html Dette eksempelet er hentet fra litt ulike sider vi har levert. Jeg har fjernet en del overflødig HTML for å vise det viktigste. - Menyen hentes ut i ul og li - Venstre spalte er en liste over titler definert med en mal - I hovedspalten hentes innholdet ut. - Høyrespalten hentes fra et eget script som inneholder kode for å sjekke hvilken side som vises, og tilpasser spalten til denne. - Bunnteksten ligger som en småtekst. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/tr/html4/loose.dtd"> <html> <head> <!--e header --> </head> <body> <!-- her kommer menyen --> <!--e navlist --> <!-- meny slutt --> </body> </html> <!-- venstre spalte (left column) --> <div id= lc > <mal sql= SELECT TOP 5 tittel, id FROM side ORDER BY id desc > <div class= title-list > <a href= /sider/tekst.asp?side={id} ><!--e tittel --></a> </div> </mal> </div> <!-- venstre spalte slutt--> <!-- midtre spalte (main column) --> <div id= mc > <!--e innhold --> </div> <!-- midtre spalte slutt --> <!-- høyre spalte (right column) --> <div id= rc > <!--e script:rc.vbs --> </div> <!-- høyre spalte slutt --> <!-- bunntekst --> <div class= footer > <!--e include:bunntekst --> </div> <!-- bunntekst slutt --> 15 av 34
Innhold og maler Nettsidene en lager i eredaktør baserer seg på maler. Det finnes noen hovedtyper av maler en kan bruke. Jeg skal gå gjennom alle sammen her med eksempler, men først skal jeg prøve å bryte hele malsystemet ned til noe litt mer oversiktlig. Et standard nettsted består av en, eller flere, nyhetslister, samt sider med tekst på. La oss tenke oss en nettside med en forside med nyheter og noen tekster i menyen. Da må vi opprette følgende: - index.html (fil) som bestemmer rammen på alle sidene. Kan overstyres. - css.css (fil) for å bestemme utseendet på nettstedet - artikkelside (mal) som sier hvordan forsiden skal se ut - artikkelliste (mal) som sier hvordan hvert enkelt element på forsiden skal se ut - tekstmal (mal) som bestemmer hvordan menyelementene og nyhetene skal vises Deretter må en sjekke at sidetypene bruker den eller de tekstmalene du har opprettet, og trykke lagre. artikler.asp Dersom en ønsker å benytte seg av ulike maler på artikkelsidene kan en gjøre det. Siden /sider/artikler.asp brukes til å liste ut tittel og ingress (etc.). Det er mulig å overstyre denne med hvilke sidetyper og kategorier tekstene skal hentes fra, samt antall og maler. Dette gjøres ved å lage spesielle lenker. De forskjellige variablene en kan bruke er: Type Kat Ant Tittel Mal Listemal Sokeord Sort Bestemmer sidetypen Bestemmer kategorien Bestemmer antall artikler Bestemmer eventuell tittel på siden Bestemmer hvilken mal som skal brukes på artikkelsiden Bestemmer hvilken mal som skal brukes på artikkellisten Viser kun artikler som inneholder følgende ord eller frase Lar deg sortere etter felt i databasen (eks. tittel eller treff) Eksempler: 1. /sider/artikler.asp?type=nyhet 2. /sider/artikler.asp?type=nyhet&kat=innenriks&ant=10 3. /sider/artikler.asp?type=melding&ant=100&mal=meldingsside&listemal=meldingsliste&sort=id 4. /artikler/nyhet/innenriks.aspx 16 av 34
tekst.asp Siden /sider/tekst.asp brukes til å vise alle tekstene som ligger i eredaktør. Det er ikke så mye en kan gjøre direkte med filen. Malene styres fra hva som er satt opp i sidetypen til hver enkelt tekst. De få valgene en har bestemmer først og fremst hvilken tekst en skal vise, samt om det er utskriftsversjon eller ikke. SIDE ID utskrift Henter teksten med følgende ID (dvs. et tall). Eks: /sider/tekst.asp?side=142 Henter teksten med følgende sidenavn. Eks: /sider/tekst.asp?id=forside Fjerner css og index.html. Eks: /sider/tekst.asp?side=142&utskrift=true En annen måte å utnytte sidenavnet på, er å lenke til dette på følgende måte: /tekst/kontakt-oss.aspx Dette er en mer søkemotorvennlig måte å angi lenken på. Dersom det ikke er angitt noe sidenavn, kan en putte inn ID i lenken. Hva som står etterpå er ikke viktig så lenge det avsluttes med.aspx. Eksempel: /tekst/142/kontakt-oss.aspx Eksempler: 1. /sider/tekst.asp?side=142 2. /sider/tekst.asp?id=kontakt-oss 3. /tekst/142.aspx 4. /tekst/142/kontakt-oss.aspx 5. /tekst/kontakt-oss.aspx 17 av 34
Maler Nå skal jeg ta å gå gjennom de ulike malene. Hvis du går inn i Innstillinger > Tekst > Maler > Ny, vil du se at det er fem forskjellige valg under maltype. Nederst på nettsiden finner du litt hjelp i form av eksempler. Du kan gjerne lage koden ferdig i Dreamweaver eller frontpage før du kopierer den inn her. Det er også mulig å laste opp malene som LBI-filer. Disse legges i mappen templates i standardskinnet. Dersom mappen ikke eksisterer må du opprette den. Tekstmal En tekstmal bestemmer hvordan en tekstside skal vises. Her legger du inn html-koden som skal ligge rundt innholdet. Deretter plasserer du taggene der innholdet skal vises. Her er en liten oversikt over taggene som er tilgjengelige; de fleste sier seg selv: <!--e redlinje --> <!--e tittel --> <!--e topptekst --> <!--e kategori --> <!--e forfatter --> <!--e id --> <!--e publisert --> <!--e kilde --> <!--e ingress --> <!--e tekst --> Viser verktøylinje for å redigere teksten, slette den etc. Tittelen Toppteksten Tekstens kategori Navn på forfatter Tekstens ID Publiseringsdato Evt kilder Ingressen Brødteksten <!--e utskrift --> Viser utskriftsikon dersom innstillingene tillater det <utskriftslink>...</utskriftslink> Plasser din egendefinerte tekst og/eller bilde mellom. <!--e tillegg --> <!--e linker --> <!--e vedlegg --> <!--e skjema --> En samletag for de neste tre taggene. Hver av de dem plasseres i hver sin <p> </p> Lister opp relaterte lenker Lister opp vedleggene Lister opp vedlagte skjema <!--e kategorier --> Viser andre tekster fra samme kategori, og andre fra andre kategorier innen samme sidetype <!--e include:[småtekst] --> Viser en småtekst <!--e rq:[ord] --> Henter verdier fra lenken. <!--e if:[attributt] --> <!--e endif:[attributt] --> Skjuler dersom attributtet er tomt. <% %> Skriv dine egne, enkle VBScript. Se hjelp senere i dokumentet. Eksempel på en tekstmal: <!--e redlinje --> <p><!--e topptekst --></p> <h3><!--e tittel --></h3> <!--e ingress --> <!--e tekst --> <!--e tillegg --> 18 av 34
Tips og triks Dersom du ønsker å gjøre en tekst lesebeskyttet, kan du legge inn en liten kode i malen. Dersom for eksempel kun innloggede brukere skal kunne lese tekstene, kan du legge inn følgende script: <%if Session("bruker") = "" then Response.Redirect("/logginn/")%> 19 av 34
Artikkelside Artikkelsiden inneholder vanligvis en tittel, kanskje et banner, og en artikkelliste. Dette er den enkleste malen når det kommer til tagger. Som nevnt tidligere i dokumentet styres artikler.asp av lenken. Denne siden har følgende tagger: <!--e redlinje --> Viser verktøylinjen for å opprette tekster, laste opp bilder etc. <!--e tittel --> Viser evt. tittel som hentes fra lenken <!--e bunntekst --> Viser evt. standard bunntekst for nettstedet. (unngå denne) <!--e kategori --> Hvis en ønsker å skrive navnet på kategorien <!--e sidetype --> Hvis en ønsker å skrive navnet på sidetypen <!--e include:[småtekst] --> Hvis en ønsker å hente en småtekst <!--e script:[filnavn] --> Hvis en ønsker å kjøre et vbscript fra fil <% [vbscript] %> Hvis en ønsker å kjøre et vbscript Det er viktig å legge inn en artikkelliste. For å styre hvordan listen skal vises, legger enten inn en tag som henter inn en ekstern mal eller definerer den direkte. For å hente inn en ekstern mal som kan styres via querystring bruker en følgende tag: <!--e artikkelliste --> Eksempel: <h1><!--e tittel --></h1> <!--e artikkelliste --> <!--e include:bunntekst --> Dersom en ønsker å definere artikkellisten direkte legger en inn følgende tagger: <!--e artikkelliste --> <!--e /artikkelliste --> Mellom disse plasserer en koden skal repeteres. Se mer om artikkellister i neste avsnitt. Eksempel: <h1><!--e tittel --></h1> <!--e artikkelliste --> <div><h2><!--e tittel --></h2> <p><!--e ingress --></p> <p><link>les mer</link></p></div> <!--e /artikkelliste --> 20 av 34
Artikkelliste Denne malen dupliseres nedover artikkelsiden for hver artikkel. Den har noen av taggene fra tekstmalen, men er ellers mye enklere. Elementene i listen trenger ikke nødvendigvis være tekster. Det kan også være pekere til filer eller andre nettsted. <!--e topptekst --> Toppteksten <!--e tittel --> Elementets tittel <!--e ingress --> Ingressen <!--e ingressbilde --> Ingressbildet (inkl <img >) {ingressbilde} URL til ingressbildet <!--e forfatter --> Navnet på forfatteren <!--e publisert --> Publiseringsdato <!--e kilde --> Evt kilde <!--e kategori --> Tekstens kategori <!--e id --> Tekstens id <!--e link --> Lenken til teksten, filen etc. <!--e endre --> Viser en knapp for å endre teksten, hvis en har tilgang til det. <link> </link> Plasseres rundt elementer en skal kunne trykke på <!--e ingressbilde størrelse: h=150&w=120 > Viser ingressbildet men komprimerer det dersom det overstiger de oppgitte målene. Det er også mulig å velge at deler eller hele malen skal vises kun ved visse iterasjoner. For eksempel annenhver gang. For å gjøre dette, kan en omslutte den koden med følgende tagger: <!--e ifcount:[valg] --> <!--e endifcount:[valg] --> Valgene kan være positive heltall for å angi hvilken iterasjon som skal vise innholdet, eller fra følgende liste: even vises for hvert partall odd vises for hvert oddetall mod2 vises hver gang iterasjonen kan deles på 2. (samme som even) mod3 vises hver tredje gang mod4 vises hver fjerde gang mod5 vises hver femte gang mod6 vises hver sjette gang Utlistingen begynner på 1. Det er også mulig å sjekke om det ikke er en verdi. For eksempel <!--e ifcount:not1 --> <!--e endifcount:not1 --> 21 av 34
Menyliste Denne malen brukes til å vise menyen ved bruk av <!--e meny --> i index.html. Hvert menyvalg blir duplisert etter hverandre slik som artikkellisten. <!--e innrykk --> <!--e niva --> <link> </link> <!--e navn --> Putter inn mellomrom tilsvarende nivå i menytreet Skriver et tall for nivået Plasseres rundt elementer en skal kunne trykke på Navnet til menyelementet Eksempel: <link><!--e navn --></link> Generell Dette er maler som en lager selv. Det er ingen faste tagger her. De baserer seg på hvilke felt en henter ut fra databasen. Brukes blant annet av funksjonen <mal:... sql=... /> 22 av 34
Skjema Denne malen brukes for å definere utseende på skjema fra skjemageneratoren. Følgende tagger gjelder for det som er rundt feltene: <!--e tittel --> <!--e tekst --> <!--e obligatorisk --> <!--e knapp --> Navnet på skjemaet Beskrivelsen til skjemaet Dersom det finnes obligatoriske feltet skrives det ut en tekst Knappen for å sende skjemaet Følgende tagger brukes for skjemafeltet og skjematekster <skjemafelt> </skjemafelt> Disse plasseres rundt skjemafelt <skjematekst> </skjematekst> Plasseres rundt tekstfelt <!--e beskrivelse --> <!--e felt --> {farge} {style} <!--e verdi --> <!--e obligatorisk --> Feltnavnet Selve input-feltet Blir grå på annenhver linje Skriver ut verdien som en angir i style-feltet Oppgitt standardverdi Viser en stjerne * dersom feltet er obligatorisk Eksempel: <h1><!--e tittel --></h1> <p><!--e tekst --></p> <table border="0" cellpadding="2" cellspacing="0" width="100%"> <skjemafelt> <tr bgcolor="{farge}"> <td width="44%"><p style="{style}"> <b><!--e beskrivelse --> <!--e obligatorisk --></b></p></td> <td width="56%"><p style="{style}"><!--e felt --></p></td> </tr> </skjemafelt> <skjematekst> <tr bgcolor="{farge}"> <td colspan="2"><p style="{style}"><b> <!--e beskrivelse --></b> <!--e verdi --><br /><!--e felt --></p></td> </tr> </skjematekst> <tr> <td><p><strong> <!--e obligatorisk --></strong></p></td> <td><p align="right"><!--e knapp --></p></td> </tr> </table> 23 av 34
Maler i nettbutikken Malene i nettbutikken har faste navn, men bruken er veldig lik den til artikkelsider, artikkellister og tekster. Alle malene er av typen generell. Malen produktoversikt kan sidestilles med en artikkelside. Det er malen for selve nettsiden hvor produktene listes opp. Malen produktliste er som en artikkelliste. Den repeteres nedover produktsiden. Dette gjøres i tilfelle i lenken. Malen produkt er som en tekstmal, og er den siden hvor produktet presenteres. Det er mulig å overstyre malene, slik at en kan bruke andre maler. Du ser dette i lenke-eksemplene. For å plassere en handlekurv i for eksempel index.html, kan du importere et ferdig vbscript for dette, eller sette inn følgende snutt: <script src="/sider/script/handlekurv.asp"></script> Denne viser kronebeløpet som ligger i handlekurven, samt en lenke til utsjekking dersom den ikke er tom. butikk.asp Denne siden brukes for å lage oversikt over produktene, enten de siste anbefalte eller fra en valgt kategori. Det er to maler som trengs for å styre designet på denne siden. Den ene er produktoversikt. produktoversikt Følgende tagger kan brukes på oversikten <!--e liste --> <!--e tittel --> <!--e produktliste --> <!--e handlevogn --> Skriver hvilken produktliste/produktgruppe som hentes ut. Viser evt tittel som legges ved i lenken (f.eks. butikk.asp?tittel=overskrift) Her plasseres produktlisten Denne viser evt beløp som ligger i handlekurven <!--e include:[småtekst] --> Inkluderer en småtekst <!--e script:[filnavn] --> Hvis en ønsker å kjøre et vbscript fra fil <% [vbscript] %> Hvis en ønsker å kjøre et vbscript <mal sql="..."> </mal> Egendefinerte maler <mal: sql=" "/> Egendefinerte maler Eksempel på en enkel produktoversikt: <h1><!--e tittel --></h1> <!--e produktliste --> 24 av 34
produktliste For å styre hvordan produktlisten skal se ut, bruker en malen produktliste. Denne repeteres nedover siden. Det er mulig å velge at deler eller hele malen skal vises kun ved visse iterasjoner. For eksempel annenhver gang, for tospalte visning. Les mer om dette under artikkellister. Følgende tagger kan brukes i produktlisten <!--e bilde --> {bilde} {stortbilde} <!--e id --> <!--e produktid --> <!--e tittel --> <!--e pris --> <!--e salg --> <!--e salgstart --> <!--e salgslutt --> <!--e ingress --> <link> </link> Skriver ut det ingressbildet inni en img-tag Skriver ut full bildesti til ingressbildet for bruk i img-tag Skriver ut full bildesti til hovedbildet for bruk i img-tag Henter ut autogenerert id, som brukes i eredaktør Henter ut varenummeret/produktkoden Henter ut produktnavn Henter ut riktig pris i forhold til innlogging Sier ifra om produktet er på salg Henter ut evt. Startdato for salget Henter ut evt. Sluttdato for salget Skriver ut en kort beskrivelse av produktet Lager en lenke til produktet <input type="text" name="antall" /> For å bestemme antall som skal legges i kurven <input type="submit" value="legg i handlekurv" /> Legger varen(e) i kurven <!--e [attributt] --> Henter ut kontrolleren for valgt attributt. Det er mulig å skjule kode rundt attributter som ikke blir funnet, med <!--e if:[attributt] --> <!--e endif:[attributt] --> Eksempel på en produktliste: <link><strong><!--e tittel --></strong></link><br /> <img src="/sider/bilde.aspx?w=100&h=100&src={bilde}" align="right" /> Kr <!--e pris --><br /> <!--e ingress --><br /> <!--e if:farge -->Velg farge: <!--e farge --><br /><!--e endif:farge --> <input value="1" name="antall" size="2" type="text" /> <input type="submit" value="legg i handlekurv" /> Eksempel på en produktliste med skiftende bakgrunn annenhver gang: <!--e ifcount:odd --><div class= dark-bg ><!--e ifcount:odd --> <!--e ifcount:even --><div class= bright-bg ><!--e ifcount:even --> <link><strong><!--e tittel --></strong></link><br /> <img src="/sider/bilde.aspx?w=100&h=100&src={bilde}" align="right" /> Kr <!--e pris --><br /> <!--e ingress --><br /> <input value="1" name="antall" size="2" type="text" /> <input type="submit" value="legg i handlekurv" /> </div> Lenker til butikk.asp kan se noe slik ut: 1. /sider/butikk.asp?liste=div 2. /sider/butikk.asp?tittel=diverse&liste=div 3. /sider/butikk.asp?tittel=diverse&liste=div&mal=diverse&listemal=diverseliste 4. /sider/butikk.asp?sok=grønn 5. /sider/butikk.asp?ant=24 25 av 34
6. /sider/butikk.asp?kuntilbud=true 7. /sider/butikk.asp?kuntilbud=true&liste=div&ant=12 8. /sider/butikk.asp?orderby=pris Legg merke til lenke 4, hvor det søkes i produktene. Linje 6 og 7 viser kun tilbudsprodukter, enten fra alle produkter eller en valgt kategori. 26 av 34
produkt.asp produkt Følgende tagger brukes for å beskrive et produkt: <!--e tittel --> Produktnavnet <!--e ingress --> Den korte beskrivelsen av produktet <!--e ingressbilde --> Skriver ut ingressbildet inni en img-tag med klassen img-product-thumb <!--e tekst --> Teksten til produktet <!--e bilde --> Skriver ut produktbildet inni en img-tag med klassen img-product {bilde} Skriver ut bildestien til produktbildet {litebilde} Skriver ut bildestien til ingressbildet <!--e pris --> Gjeldende pris på produktet (inkl. rabatter/tilbud) <!--e veilpris --> Veiledende pris på produktet <!--e id --> Id i databasen <!--e produktid --> Henter ut varenummeret/produktkoden <!--e salg --> Skriver ut en tekst om at det er salg, samt veiledende pris <!--e ersalg --> Skriver ut true eller false avhengig av om det er salg eller ikke <!--e salgstart --> Henter ut evt. Startdato for salget <!--e salgslutt --> Henter ut evt. Sluttdato for salget <!--e lagerbeholdning -->Skriver ut gjeldende lagerbeholdning <!--e lagerinfo --> Skriver ut egendefinert lagermelding (defineres i innstillingene) <!--e relatertevarer --> Skriver ut en liste over relaterte varer <!--e _beskrivelse --> Beskrivelsen av produktet, og gjør linjeskift om til HTML (brukes sjelden) <input type="text" name="antall" /> For å bestemme antall som skal legges i kurven <input type="submit" value="legg i handlekurv" /> Legger varen(e) i kurven. Begge disse må plasseres før evt varianter. <!--e [attributt] --> Viser verdien fra attributten <!--e if:[attributt] --> <!--e endif:[attributt] --> Skjuler dersom attributtet er tomt. <!--e include:[småtekst] --> Inkluderer en småtekst <% [vbscript] %> Hvis en ønsker å kjøre et vbscript <mal sql="..."> </mal> Egendefinerte maler <mal: sql=" "/> Egendefinerte maler <varianter> </varianter> Lister ut variantene av produktet Følgende tagger kan brukes for å hente ut informasjon om en variant: <!--e tittel --> Variantnavnet <!--e ingress --> Den korte beskrivelsen av varianten <!--e ingressbilde --> Skriver ut ingressbildet inni en img-tag med klassen {ingressbilde} Skriver ut stien til ingressbildet <!--e id --> Id i databasen <!--e pris --> Gjeldende pris på produktet (inkl. rabatter/tilbud) <!--e veilpris --> Veiledende pris på produktet <!--e salg --> Skriver ut en tekst om at det er salg, samt veiledende pris <!--e ersalg --> Skriver ut true eller false avhengig av om det er salg eller ikke <!--e lagerinfo --> Skriver ut egendefinert lagermelding (defineres i innstillingene) <!--e lagerbeholdning -->Skriver ut gjeldende lagerbeholdning <!--e ifcount: --> <!--e endifcount: --> Gir mulighet til å ha forskjellige utseendeer i listen På variantene må det også legges inn boks for antall og knapp for kjøp som på hovedproduktet. 27 av 34
Et eksempel på en produktmal med mulighet for varianter: <h1><!--e navn --></h1> <p><img src="{bilde}" align="right" /> <strong><!--e introduksjon --></strong></p> <p><!--e beskrivelse --></p> <p> <strong>pris: <!--e pris --></strong> <!--e salg --><br /> <strong>antall:</strong> <input value="1" name="antall" size="2" type="text" /> <input type="submit" value="legg I handlekurv" /> </p> <varianter> <!--e ifcount:1 --><h2>varianter</h2><!--e endifcount:1 --> <h3><!--e tittel --><h3> <p> Pris: <!--e pris --><br /> <input type="text" size= 2 value="1" name="antall" /> <input type= submit value= Legg i handlekurv /> </p> <hr /> </varianter> Lenker til produkt.asp kan se noe slik ut: 1. /sider/produkt.asp?id=10 2. /sider/produkt.asp?id=10&mal=newlook 28 av 34
VBScript/Snippets Importere Det er mulig å importere og bruke serverscript i index.html og malene. Det kan enten skrives kode direkte inn, eller en kan importere ferdige script. Disse scriptene ligger klare til å importeres i ulike kategorier: - Bilder og banner - Diverse - Eksternt - Moduler - Navigering - Nettbutikk - Tekst - Variabler På de fleste scriptene som importeres ligger det noen verdier en kan skrive inn. Ved bildebanner kan det for eksempel være hvilken bildemappe bannerne skal hentes fra. Begrensninger Det er ikke noen innebygget støtte for debugging av script, så det kan kreves litt kunnskap for å arbeide med dem. En begrensning i scriptene som kjøres på serveren, er at det ikke er mulig å skrive mange -tegn etter hverandre. Det er en begrensning på to. Dermed må en i visse tilfeller bruke i stedet. Innebygde funksjoner Det ligger en del innebygde funksjoner i eredaktør som en kan bruke. Her er en liste med kort forklaring: Connect() Setter opp en kobling mot databasen. Husk å koble fra i etterkant. For alternativ kobling, kan du bruke AltConnect(). Disconnect() Tar ned kobling mot databasen som er satt opp med Connect(). For å stenge alternativ kobling, brukes AltDisconnect(). SjekkTilgang(string Gruppenavn, int Nivå) Returnerer TRUE eller FALSE ut fra om brukeren har tilstrekkelig tilgang til gruppen. Nivå kan ha følgende verdier: 0 (ingen), 1 (les), 2 (skriv) eller 3 (Admin). SiteTilgang(string Produkt, string Site) Sjekker om nettsiden har tilgang til et gitt produkt. Kan for eksempel være nettbutikk. Som sitevariabel trenger du vanligvis bare å skrive site. NDato() Returnerer dagens dato på en form som kan brukes av databasen. SafeSQLText(string SQLPart) Brukes for å verifisere strenger som skal brukes som en del av en SQL-spørring. Bruk denne dersom du henter inn variabler fra POST eller GET. SafeSQLInt(string SQLPart) 29 av 34
Brukes for å verifisere heltall som skal brukes som en del av en SQL-spørring. Bruk denne dersom du henter inn variabler fra POST eller GET. Returnerer 0 dersom tallet var ugyldig GetStr(string Ord) Henter riktig språkversjon av gitt ord. Språkversjon angis av variabelen spraak, og er av type no eller en. Verdiene hentes fra en egen xml-fil. ListeMeny(string Menynavn) Returnerer en ul-li liste ut fra angitt menynavn. IncludeVars(string Mal) Inkluderer småtekster i malen som er satt inn ved <!--e include:[malnavn] --> og returnerer den. En databasekobling må være åpen. HentMal(string Mal) Kjører maler av typen <mal: som ligger strenger som sendes inn. Returnerer ny streng. En databasekobling må være åpen. HentLiveMal(string Mal) Kjører maler av typen <mal > </mal> som ligger strenger som sendes inn. Returnerer ny streng. En databasekobling må være åpen. HentInnstilling(string Navn) Henter en innstilling for nettstedet som er definert under Globale variabler, eller tilsvarende innstillinger under for eksempel Nettbutikk. Returnerer verdien. TextPreview(string Tekst, int Lengde) Lager en kortversjon av teksten du sender inn, med maks lengde som du angir. Den prøver å kutte ved komma eller punktum. GenPassord() Returnerer et tilfeldig genereret passord IExplorer() Returnerer true hvis brukeren bruker Internet Explorer, ellers returneres false. 30 av 34
Noen vanlige SQL-spørringer Her er noen SQL-spørringer som er mye brukt. Det er mulig å kjøre spørringene i mal-spalten under Hjelp til egendefinerte maler for å se hvilke felter som er tilgjengelige. Vær oppmerksom på at disse spørringene kun fungerer mot Access databasene (standard installasjon). Ved SQL Server må funksjoner som now() og date() byttes ut. Hovedmeny: SELECT * FROM meny WHERE meny = 'hovedmeny' ORDER BY plass, navn; eredaktør MINI meny: SELECT topptekst, id FROM side WHERE type = 'tekst' AND kategori = 'menyelement' ORDER BY stikkord, topptekst; 10 siste fra alle kalendere: SELECT TOP 10 * FROM mote ORDER BY mote.dato DESC, mote.klokkeslett; 10 siste fra en bestemt kalender: SELECT TOP 10 Calendars.Name, mote.* FROM Calendars INNER JOIN mote ON Calendars.CalendarId = mote.calendarid WHERE Calendars.Name='[Navn på kalenderen]' AND dato >= date() ORDER BY mote.dato DESC, mote.klokkeslett; 5 siste saker: SELECT TOP 5 id, tittel, ingress, ingressbilde, publisert FROM side WHERE publisert < now() AND fjernes > now() ORDER BY publisert DESC, id DESC; 5 siste saker fra en gitt kategori og sidetype: SELECT TOP 5 id, tittel, ingress, ingressbilde, publisert FROM side WHERE type='nyhet' AND kategori='hovedsak' AND publisert < now() AND fjernes > now() ORDER BY publisert DESC, id DESC; Bruk av view De to siste eksemplene kan løses enklere ved å opprette et view av sidetypen. Dette kan gjøres der en redigerer sidetypen. Da kan en spare noen av testene, samt at en også kan ta med attributter. La oss si at vi har opprettet et view for nyhet, spørringen kan da se slik ut, hvis du vil ha med alle felter og attributter. SELECT TOP 5 * FROM nyhet; Eller slik hvis du vil angi hvilke felter og hvilken kategori det gjelder: SELECT TOP 5 id, tittel, ingress, ingressbilde, publisert FROM nyhet WHERE kategori='hovedsak'; 31 av 34
Faste navn på småtekster Navnene til småtekstene/notatene er egentlig Id er. Det er en del av disse som hentes ut forskjellige steder i eredaktør. Her er et forsøk på å liste opp så mange som mulig. Husk at det er forskjell på store og små bokstaver. Nettbutikk - Mersalg Vises ved utsjekkingen over betalingsmetode - portoinfo vises i bunnen av utsjekkingen Nyhetsbrev - Mailing mal Vises over listen av nyhetsbrev man kan melde seg på (nymail.asp) - Mailing [språk] Dersom det skal vises tekst på andre språk. Settes via lang i QueryString - Mailing bekreftelse Vises når en har meldt seg på et nyhetsbrev - e-post mal Standard mal for hvordan nyhetsbrevene skal se ut - [navn på nyhetsbrev] Mal for et gitt nyhetsbrev Artikkellister - [navn på sidetype] Vises dersom man har brukt <!--e sidetypetekst --> i artikkellisten - [navn på kategori] Vises dersom man har brukt <!--e kategoritekst --> i artikkellisten Andre - bekreftelse Vises når en har sendt inn et skjema/påmelding (utgått, bruk eget felt i skjema) 32 av 34