Dupoint i.site 4.0 Mallhandboken Dupoint AB Telefon: 08-441 74 80 E-post: info@dupoint.com Internet: www.dupoint.com
Innehåll Arbeta med mallar... 1 Skapa en mall 1 Metadata avancerade mallar 2 Referenslista, mallfunktioner... 4
Arbeta med mallar Dupoint AB Telefon: 08-441 74 80 E-post: info@dupoint.com Internet: www.dupoint.com
Arbeta med mallar Dupoint i.site 4.0 Arbeta med mallar i.sites mallar består av Html-kod som anropar fördefinierade PHP-funktioner för att lägga in innehållet. Det går även att skriva egen PHP-kod direkt i mallen. För mer information om PHP se http://www.php.net/manual/. Skapa en mall Under fliken Webbmallar klickar du på ikonen ny mall som finns i vänster verktygsrad. Du döper din mall och skriver in Html-kod för mallen. Exempel på enkla mallar Grundelementen i mallarna är HTML, stilmallar (CSS) och JavaScript. Vidare finns möjlighet att skriva PHP samt använda färdiga PHP-funktionsanrop för att skapa dynamik och koppla delar av webbsidan till i.sites databas. Exempel på dessa funktioner är titel, ingress och brödtext. I exemplen nedan visas funktionerna med grön text och anropen med röd text. <html> <head> <title>en enkel mall till i.site</title> </head> <body> <h1><?titel()?></h1> <strong><?ingress()?></strong> <br> <?brodtext()?> </body> </html> Dessutom finns det en rad funktionsanrop som innehåller olika argument, vilka gör att mallkonstruktören kan påverka mallfunktionens beteende. Nedan visas ett exempel för att skapa en trädmeny för navigering på webbplatsen. Funktionen som används heter tradmeny() och första argumentet anger id för mapp som ska vara trädens rot, andra argumentet avgör att menyns huvudrubriker ska skiljas åt med en horisontell linje: <html> <head> <title>en enkel mall till i.site</title> </head> <body> <table width="600" border="0"> <tr> <td> <?tradmeny(1, visa_linje)?> </td> <td> <h1><?titel()?></h1> <strong><?ingress()?></strong> <br> <?brodtext()?> </td> </tr> </table> </body> </html> 1
Arbeta med mallar Dupoint i.site 4.0 De flesta funktioner i i.site genereras med fördefinierade, vilka gör det enklare för mallkonstruktören att påverka utformningen. na kan antingen bäddas in i mallen, enligt nedan, eller i en extern CSS-fil. <head> <title>en enkel mall till i.site</title> <style type="text/css"> <!-- body { font-family: sans-serif;}.isite-brodtext {font-size: 10px;}.isite-brodtext-lank {color: blue;} --> </style> </head> Kompletta instruktioner, argument och till funktionsanropen hittar du i referenslistan över i.sites mallfunktioner. Metadata; avancerade mallar I i.site kan man skapa mer dynamiska och avancerade mallar som ger användare med administrationsrättigheter på en mapp möjlighet att välja mellan olika mallvariabler för mappen under ikonen Mappinställningar. Layoutmallar kan alltså bestå av mindre delar; valbara profiler inom samma layoutmall. Exempelvis kan man lägga in valmöjlighet för att lägga in olika bildteman på sidorna. För att göra detta måste mallkonstruktören dels ha definierat metadatavariablerna som ska vara tillgängliga för de behöriga användarna samt skrivit in i mallkoden (PHP) hur de olika värdena ska påverka mallens utformning. Definition av metadatavariabler görs under fliken Webbmallar. Klicka på önskad mall och välj Mallinställningar. När man skapar metadatavariabler måste följande anges: en beskrivning av variabelns funktion som ska vägleda användarna när de gör sitt val i Mappinställningarna. ett variabelnamn, som endast får innehålla följande tecken: a-z, 0-9 samt _ typ av variabel, här kan man skapa 3 olika typer av variabler: 1. Text variabler som kan innehålla fritext 2. Kryssruta variabler med endast två valmöjligheter; på/av 3. Flervalslista variabler med fast definierade alternativ Alla variabler som skapas hamnar i ett associativt fält (eng. array), $MALL, och kan sedan användas i mallkoden (PHP). Viktigt att känna till är att metadata för en mapp alltid ärvs av undermappar. Det betyder att om man tilldelar eller förändrar metadata i en mapp kommer undermapparna att erhålla samma förändring. 2
Arbeta med mallar Dupoint i.site 4.0 Exempel; avancerade mallar Skapa underwebbar med olika menyer för olika avdelningar Metadata beskrivning: Mapp-id för trädmenyns rot Metadatavariabel: mapp_id Metadatatyp: text <? tradmeny($mall[ mapp_id ], visa_linje);?> Sidfot av/på Metadata beskrivning: Sidfot visas ej Metadatavariabel: sidfot Metadatatyp: Kryssruta <? if($mall[ sidfot ]==false): include "sidfot.inc"; endif;?> Välja mellan olika typer av sidhuvud Metadata beskrivning: Välj sidhuvud Metadatavariabel: sidhuvud Metadatatyp: Flervalslista med följ. val: normal, avancerad resp. simplifierad <? switch($mall[ sidhuvud ]): case avancerad : include "sidhuvud_3.inc"; break; case simplifierad : include "sidhuvud_2.inc"; break; default: include "sidhuvud_1.inc"; endswitch;?> 3
Referenslista Dupoint AB Telefon: 08-441 74 80 E-post: info@dupoint.com Internet: www.dupoint.com
Mallfunktioner: referenslista Dupoint i.site 4.0 Mallfunktioner Dupoint i.site: referenslista Funktionerna är listade i bokstavsordning. Alla argument i argumentlistan är listade i den ordning de skall skickas till funktionen. ens namn finns med enbart som referens, och skall inte finnas med i anropet. utan standardvärde är argument som måste anges. Listan över är i möjligaste mån sorterad efter i vilken ordning klasserna skrivs ut av funktionen. Undantaget till detta är brodtext(), eftersom det är användaren som själv lägger in objekt på en webbsida. anvandare([$kolumn]) Skriver ut information om användaren. Funktionen har inga. $kolumn Vilka data som skall skrivas ut. Standard är förnam efternamn, men följande finns att välja mellan: epost, anvandarnamn, fornamn, efternamn, hemsida, telefon, fax. banner() Visar upp en reklambanner vilken administreras från extramodulen Reklambanners. Funktionen har inga funktionsargument. isite-banner Sätts på både länken och bilden. bastfore($meddelande) Om webbsidan är inställd på att visa en varning när det blivit äldre än en bestämd tid, och denna tid har passerat skriver funktionen ut en varningsruta. $meddelande Den text som skrivs ut i varningsrutan. isite-bastfore-varning Sätts på en <div> kring meddelandet. bildarkiv($bildarkiv, [$har_ram = 1], [$cellpadding = 0], [$visa_meta = 01 ], [$visa_metanamn = ]) Visar upp ett bildarkiv med de bilder som finns i samma mapp som webbsidan. $kolumner Antal kolumner. 4
Mallfunktioner: referenslista Dupoint i.site 4.0 $har_ram Huruvida bilderna skall ha ram eller ej. (0/1) $cellutrymme Utrymmet mellan cellerna, i pixlar. (heltal) $visa_meta Vilka metadata som skall visas, åtskiljda av kommatecken. (sträng) $visa_metanamn Vilka metadatakolumner som skall ha titel (sträng) isite-bildarkiv Tabellen. isite-bildarkiv-cell Sätts på varje enskild cell i tabellen. isite-bildarkiv-lank Länken till högupplöst version av bilden. isite-bildarkiv-bildtext Bildtexten/beskrivningen under bilden. bildspel($bildspel_mapp, [$border = 0], [$alt = ], [$showtag = true]) Visar upp en bild ur en mapp med bilder. Funktionen har inga. $bildspel_mapp Mappen att hämta bilder från, relativt i.sites rotmapp. (mapp-id) $har_ram Huruvida bilden skall ha ram eller ej. (0/1) $alt Alternativtext på bilden. (sträng) $showtag Hurvida <img /> skall skrivas ut eller bara sökvägen till filen (true/false). brodtext() Skriver ut dokumentets brödtext. Funktionen har inga funktionsargument. isite-brodtext-lank Sätts på länkar i brödtexten; dels på en <div> kring hela atomen, dels på varje individuell <a>. Samma klass för både interna och externa länkar. isite-brodtext-lank-beskrivning Beskrivning av en extern länk. (<div>) isite-brodtext Brödtextstycken. (<div>) 5
Mallfunktioner: referenslista Dupoint i.site 4.0 isite-brodtext-mailto E-postlänk. Kan sitta på antingen på egen rad eller mitt i texten. (<a>) isite-brodtext-mailto-egenrad E-postlänk som sitter på egen rad. (<div>) isite-brodtext-ul Punktlista. Elementen i punktlistan kan nås som.isite-brodtext-ul li. (<ul>) isite-brodtext-ol Nummerlista. Elementen i listan kan nås som.isite-brodtext-ol li. (<ol>) isite-brodtext-underrubrik Underrubrik. (<div>) isite-brodtext-bild Bild. Klassen sätts på en <div> runt bilden. isite-brodtext-bild-lank Länken kring en länkad bild. (<a>) isite-brodtext-fil Fil. Länken sätts på både omslutande <div> och <a>. isite-brodtext-hr Horisontell linje. (<hr>) isite-box Atomen ruta. (<table>) isite-box-rubrik Rutans titel. (<td>) isite-box-text Texten i en ruta. (<td>) isite-box-bild-vanster Vänsterställd bild i en ruta. (<img>) isite-box-bild-hoger Högerställd bild i en ruta. (<img>) isite-box-lank Länken i en ruta. (<a>) isite-brodtext-tabell En tabellatom. (<table>) isite-brodtext-tabell-td Varje enskild cell i en tabell. (<td>) 6
Mallfunktioner: referenslista Dupoint i.site 4.0 dokument($dok_id, [$useimagefortitle = false], [$visaingressbild = false], [$ingressbildposition = div ], [$visatitel = true], [$followlink = true]) Visar upp ingressbild, titel, ingress och länk till ett annat dokument. $dok_id Dokumentet som skall visas. (dokument-id) $useimagefortitle Avgör om ingressbilden i stället för titel skall användas, om det finns en ingressbild. (true/false) $visaingressbild Avgör om någon ingressbild skall visas för sidan. (true/false) $ingressposition Placering av ingressbilden, om det finns en ingressbild. (sträng; giltiga värden: left, center, right, div) $visatitel Visar dokumentet titel (true/false) $followlink Anger om läs-mer-länk skall visas.( true/false) isite-dokument-titel Dokumentets titel (<div>) isite-dokument-ingress Dokumentets ingress (<div>) isite-dokument-lasmer Läs mer-länken (<a>) dokument_brodtext($dok_id, [$usedocsections = false]) Visar upp brödtexten från ett annat dokument. $dokument Det dokument vars brödtext skall visas. (dokument-id) $usedocsections Avgör om hänsyn skall tas till ev. avsnittsindelning i sidan. (true/false) se brodtext() fillista() Listar alla filer i samma mapp som dokumentet. Funktionen har inga funktionsargument. isite-fillista Tabellen som omsluter alla filer. (<table>) 7
Mallfunktioner: referenslista Dupoint i.site 4.0 isite-fillista-rad Varje rad i tabellen. (<tr>) isite-fillista-fil Cellen som innehåller filens symbol och filnamn. (<td>) isite-fillista-lank Länken till filen. (<a>) isite-fillista-beskrivning Cellen som innehåller beskrivning av filen. (<td>) ingress() Skriver ut dokumentets ingress. Funktionen har inga funktionsargument eller. ingressbild([$target_document = null], [$alignment = null]) Skriver ut dokumentets ingressbild. Kan även anropas av meny() om det inte finns andra dokument i mappen. $target_document Sida att hämta ingressbilden från. Om null, används aktiv sida. $alignment Justering. Om null, används i.sites inställning. (sträng; giltiga värden left, center, right) isite-ingressbild Sätts på en <div> runt bilden. Själva bilden kan nås med.isite-ingressbild img. meny([$visa_ingressbild = true], [$visa_aktivt = true], [$avskiljarbild = null], [$visa_ingress = true], [$ingressbild_om_tom = true]) Skriver ut en vertikal listning av de dokument som ligger i mappen. $visa_ingressbild Bestämmer om ingressbilder skall visas. (true/false) $visa_aktivt_dokument Bestämmer om aktivt dokument skall finnas med i listningen. (true/false) $avskiljarbild Sökväg till en bild som sätts mellan dokumenten. (sträng, standard null) $visa_ingress Om ingress skall skrivas ut(true/false) $ingressbild_om_tom Avgör om ingressbild skall försöka visas upp om menyn är tom. (true/false) 8
Mallfunktioner: referenslista Dupoint i.site 4.0 isite-meny-index Sätts på en <div> kring mappens indexdokument. isite-meny-selected Sätts på en <div> kring det dokument som är markerat (förutsatt, givetvis, att $visa_aktivt_dokument är true). isite-meny-bild Sätts på länken kring ingressbilden, förutsatt att ingressbilder visas. (<a>) isite-meny-titel Dokumentets titel. Sätts på både <div> och <a>. isite-meny-ingress Dokumentets ingress. Sätts på <div>, och även <a> om ingressen länkas. isite-meny-lasmer Läs mer -länken. Sätts på både <div> och <a>, men inte på bild om någon sådan angivits i i.sites inställningar. meny_flat($separator, [$titel_max = null]) Liknande meny(), men horisontell, och skriver bara ut dokumenttitlar åtskiljda av en avskiljare. $separator Det tecken, eller den sträng, som skall sättas mellan dokumenttitlarna. (sträng) $titel_max Max antal tecken på titeln. Är titeln längre kortas den av med... och fullständiga titeln sätts som <a title=... >. (heltal, stängs av med null) isite-meny-flat Länkar i listan. isite-meny-flat-selected Sätts på aktuellt dokument, tillsammans med isite-meny-flat. nyheter($opts) Skriver ut en lista med nyheter, sorterade enligt mappen de hämtas från. $opts En array med namngivna argument. Följande nycklar är giltiga: folder Mapp att hämta nyheter från (mapp-id, krävs) maxitemsinlist Hur många åt gången (heltal) showindexpage 9
Mallfunktioner: referenslista Dupoint i.site 4.0 Avgör om indexdokumentet skall visas (true/false, standard false) forwardlinktext text för att visa nyare nyheter (standard 'Nyare»', stängs av med null) backlinktext text för att länka till äldre nyheter (standard '» Äldre', stängs av med null) offset hur många nyheter som skall hoppas över för ex. spaltvisning(heltal, standard 0) readmorelinktext Text till Läs mer-länk (sträng; standard null = använd i.siteinställning) showdocumentimages om ingressbild skall visas (true/false, standard false) documentimage_align Placering av ingressbilden, om det finns en ingressbild. (sträng; giltiga värden left, center, right, div; standard div ) showactivedocument Om vald nyhet skall visas i nyhetslistan. (true/false) showdate Avgör om och var datum på nyheten skall visas. (sträng eller false; standard false; giltiga strängar: first ) dateformat datelocale Formateringssträng för datumet som visas om datum visas. Se PHPfunktionen strftime() för referens. (sträng; standard %Y-%m-%d %H:%M:%S ) Lokalisering att använda med strftime() om datum visas. Se PHP-funktionen setlocale() för referens på vilka lokaliseringar som finns. (heltal; standard LC_SWEDISH) isite-nyhet-bild På länken till en bild. (Bilden själv nås med.isite-nyhet-bild img ) isite-nyhet-titel Sätts kring titeln; dels på <div>, dels på <a> innanför <div>. isite-nyhet-ingress Sätts på en <div> kring ingressen. isite-nyhet-datum Sätts på en <div> kring datumet. 10
Mallfunktioner: referenslista Dupoint i.site 4.0 isite-nyhet-lasmer Läs mer -länken på nyheten. Sätts på både <div> och <a>. isite-nyhet-bakat Länken för att läsa äldre nyheter. (<a>) isite-nyhet-framat Länken för att läsa nyare nyheter. (<a>) rostning($pollnode) Visar upp en ruta med aktuell omröstning från en viss omröstningsmapp. Administreras med modulen Åsiktsbarometer. Vid röstning sätts en kaka (Cookie), som används för att hålla reda på om användaren röstat. Om denna kaka är satt, visas i stället resultaten från omröstningen upp. Resultaten visas dels som stapeldiagram, dels som procentsats. Stapeldiagrammets längd bestäms av bilden img/rostning.stapel.gif, vars bredd motsvarar en stapel på 100 %. Finns två alternativ som vardera fått 50% av rösterna, blir staplarna alltså hälften så breda som img/rostning.stapel.gif. $pollnode Den mapp med frågor som skall användas. (id från Åsiktsbarometer) isite-rostning-ruta Själva rutan. Sätts på <form> om användaren inte röstat, <div> om användaren röstat och resultaten visas upp. isite-rostning-fraga Frågan. Sätts på <div> om användaren inte röstat, eller <td> om användaren röstat. isite-rostning-alternativ Varje enskilt alternativ. Även procentsatsen, om användaren redan röstat. Sätts på <div> om användaren inte röstat, eller <td> om användaren röstat. isite-rostning-knapp Knapparna för att skicka sin röst eller se resultat av omröstningen. (<input>, endast om användaren inte röstat) Bilder img/rostning.stapel.gif: En fullstor stapel. Denna trycks sedan ihop på bredden beroende på hur många som röstat på ett visst alternativ. sidansvarig([$kolumn = null]) Visar upp information om sidansvarig. Identisk med anvandare(), bortsett från den information som matas ut. Funktionen har inga. se anvandare() 11
Mallfunktioner: referenslista Dupoint i.site 4.0 sidskapare([$kolumn = null]) Visar upp information om den som skapade sidan. Identisk med anvandare(), bortsett från den information som matas ut. Funktionen har inga. se anvandare() sokvag() Visar upp i.sites sökväg till aktuellt dokument. Funktionen har inga funktionsargument. isite-sokvag Sätts på länken till respektive steg i sökvägen. (<a>) titel() Skriver ut dokumentets titel. Funktionen har inga funktionsargument och. tidpunkt([$format = Y-m-d H:i ]) Skriver ut vilken tid dokumentet senast ändrades. Funktionen har inga. $format Formateringssträng enligt PHP:s dokumentation för date(). (Sträng) tidtill($datum, $kvartxt, $redantxt) Visar tiden som är kvar till en viss tidpunkt, t.ex. ett evenemang. När tiden inträffat visas ett annat meddelande. Funktionen har inga. $datum Det datum som avses. Kan även innehålla klockslag. (sträng) $kvartext Skrivs ut före tidsangivelsen. (sträng) $redantext Skrivs ut om tiden redan inträffat. (sträng) tradmeny($startmapp, [$opts = null]) Visar upp i.sites trädmeny. $startmapp Vilken mapp som skall vara rot för trädmenyn. (mapp-id) $opts En array med namngivna argument. Följande nycklar är giltiga: visa_linje 12
Mallfunktioner: referenslista Dupoint i.site 4.0 Huruvida menyn skall ha en linje mellan alla mappar i översta nivån. Med linje kommer första nivån inte ha några pilar. (true/false, standard false) fall_alla klipp_max Huruvida alla mappar skall fällas ner, eller bara de som leder ner till aktuell mapp. (true/false, standard false) Max antal tecken i mappnamnet. Mappar med fler tecken i namnet kortas av med..., och fulla namnet läggs i title på länken. Påverkar ej översta nivån om visa_linje är true. (heltal, standard 0 = obegränsat) klipp_niva Hur många tecken varje nivå av mappar motsvarar. klipp_max minskas med klipp_niva tecken för varje menynivå. (heltal, standard 0) bildmapp indentera nivabild Den mapp bilder skall hämtas från. (sträng, standard img ) Avgör om trädmenyn skall vara indenterad. (true/false, standard true) Bild att upprepa för varje nivåsteg på varje menyalternativ. (sträng, standard null = avstängd) berakna_alltid_barn Avgör om i.site alltid skall beräkna om en mapp har barn, för att indikera att den är nerfälld. Gör nytta ihop med fall_alla. (true/false, standard false) showtype Bestämmer vilken typ av noder som skall visas. (Bitfält, standard FOLDER_WEB) prefixstring Sträng att alltid lägga framför länktexten. (sträng, standard null = avstängd) alwayshighlightl1 Avgör om mappar översta nivån alltid skall markeras när en mapp under den är markerad. Gäller endast i kombination med visa_linje. (true/false, standard true) isite-tradmeny-lvl1 Länken till en mapp i översta nivån. isite-tradmeny-lvl1-selected Länken till en markerad mapp i översta nivån. isite-tradmeny-tabell-lvl1 13
Mallfunktioner: referenslista Dupoint i.site 4.0 Den tabell som omsluter varje menyalternativ i översta nivån. Kan bl.a. användas till att sätta fast bredd på alla menyval. Gäller ej om visa_linje = true. isite-tradmeny-lvl2 Länken till en mapp i alla nivåer utom den översta. isite-tradmeny-lvl2-selected Länken till en markerad mapp i alla nivåer utom den översta. isite-tradmeny-tabell-lvl2 Den tabell som omsluter varje menyalternativ i alla nivåer utom den översta. Kan bl.a. användas till att sätta fast bredd på alla menyval. Bilder Vilken mapp bilderna ligger i går att ändra med argumentet bildmapp, men standard är img/. tradmeny.linje.gif Den linje som placeras mellan mapparna i översta nivån, om visa_linje = true. tradmeny.pil.gif Normal pil. tradmeny.pil.ner.gif Nerfälld pil, på mapp som öppnats för att nå aktuell mapp. tradmeny.pil.markerad.gif Markerad mapp utan undermappar. tradmeny.pil.ner.markerad.gif Markerad mapp som har undermappar. 14
Dupoint AB Telefon: 08-441 74 80 E-post: info@dupoint.com Internet: www.dupoint.com