Template-funktioner i Instans CMS

Nedenfor gennemgås først og fremmest de vigtigste template-funktioner, og sekundært en række andre funktioner, som kan være anvendelige i særlige tilfælde.

Funktionsnavn	Kort beskrivelse
buildPageMainContent	Bygger en sides primære indhold i samtlige system-modes
calendarBox	Laver en kalender-boks til brug i f.eks. højrekolonne
cmsTranslate	Oversætter ledetekster og interface-tekster til det valgte sprog
customBoxes	Bygger bokse fra CMS'ets "Bokse"-funktion
metaTagGenerator	Bygger meta-tags, som indsættes i templaten
modeHtmlHeaderIncludes	Inkluderer system-mode-specifikke CSS- og Javascript-filer
newBuildFrontendMenu	Bygger rekursivt en menu over side-hierarkiet
newReturnHTMLMenuPath	Bygger "brødkrumme"-stien til den aktuelle side
newsBox	Laver en nyheds-boks til brug i f.eks. højrekolonne
printerFriendly	Laver en link-bar med link til printvenlig udgave m.m.
return_customfielddata	Returnerer data fra specialfelter (CUSTOMFIELDS)
return_feed_url	Returnerer absolut URL til et RSS-feed på blog eller nyhedsarkiv
returnImageThumbUrl	Returnerer absolut URL til en billed-thumbnail
returnImageUrl	Returnerer absolut URL til et billede
returnNiceDateTime	Returnerer en DK-formatteret dato/tid
returnPageTitleTag	Returnerer sidetitel til title-tag
searchBox	Laver en søgeboks til site-intern søgemaskine
shopProductMenu	Laver en produktmenu over varegrupper i shop-modul

Funktion: buildPageMainContent

Beskrivelse af funktionen

buildPageMainContent er en central funktion, som bygger sidens primære indhold, uanset om der er tale om en almindelig side, en nyhed, et arrangement, en arkiv-oversigt, osv. Funktionen kigger på $arr_content variablen og afgør, hvilken mode, systemet er i - pages, news, events, blog, shop, osv. På baggrund af den aktuelle mode og andre parametre (f.eks. ID'et på valgte side/nyhed/blog/kalender/...) bygges en blok HTML-kode, som funktionen returnerer, og som efterfølgende kan indlejres i templaten outputter (echo). Fra version 2.7.9 kan enkelte indholdselementer udelukkes vha. CMS config variablen $arr_content_exclude.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	Klik her for at læse mere om $arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Jf. beskrivelse ovenfor returneres den aktuelle sides primære indhold, beregnet til placering i templatens "indholds-kolonne", hvis en sådan eksisterer

Typisk brug

Typisk vil man bruge funktionen i en templates centrale indholdsfelt, hvor man vil skrive:

echo buildPageMainContent($arr_content)

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: newBuildFrontendMenu

Beskrivelse af funktionen

newBuildFrontendMenu er en central funktion, som bygger side-menuer (funktionens navn har historiske årsager - "new" indikerer, at der engang var en anden udgave af funktionen - vi beklager). Funktionen er rekursiv, og den kan således kravle gennem hele sidetræet og outputte side-hierarkiet som en standard XHTML unordered list (ul). Funktionen kan konfigureres til kun at outputte udvalgte grene i sidetræet. Funktionen bygger altid sidetræet på baggrund af det aktuelle pageid, således at menuen outputtes i en udgave, der er udfoldet til den aktuelle side. Funktionen medtager ikke sider, som er skjulte, slettede eller upublicerede. BEMÆRK: Det aktuelt valgte menupunkt outputtes altid med en class "selected", således at man kan style dette - f.eks. "ul a.selected{color: red}".

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$siteid	integer	ID på det site, som menuen tilhører (SITES.ID)	JA
$menuid	integer	ID på den menu, som skal outputtes (MENUS.ID)	JA
$parentid	integer	ID på den side, som funktionskaldet skal starte ved (PAGES.ID). Hvis hele sidestrukturen skal outputtes, er $parentid=0. Bemærk, at funktionen er rekursiv, så den kalder sig selv med $parentid = $row[ID], indtil hele sidetræet er traverseret.	JA
$level	integer	En variabel, som initieres med værdien 0 og derefter altid indeholder "dybden" i træet på den side, der traverseres.	JA
$arr_content	array	$arr_content	JA
$prefixIfHasChilds	string	En optional variabel, som kan indeholde et tegn eller en stump HTML, der outputtes foran menupunkter, der har underpunkter. F.eks. "+".	Nej
$CSS_id	string	En optional variabel, som kan indeholde en ønsket CSS id-attribut på det yderste ul-element i menuen. F.eks. "hovedmenu", som så kan styles i CSS med "ul#hovedmenu". Eftersom funktionen outputter nestede ul'er, kan man style dybere grene og list items i sidetræet med "ul#hovedmenu ul ul" og "ul#hovedmenu ul ul li", osv. Principielt kan samme id på elementet også bruges, hvis man vil manipulere sidetræet med javascript eller føje eventhandlers til elementer.	Nej
$arrPath	array	En optional array variabel, som initieres med en tom array() og holder styr på stien ned til den aktuelle side - array'en indeholder altså samtlige side-id'er, der er i samme "thread" som den aktuelle side, der traverseres af funktionen. Hvis man f.eks. er på under-undersiden "Produkter -> Frugt -> Røde æbler", vil alle disse 3 siders pageid (PAGES.ID) være med i $arrPath. Funktionen bruger dette til at påklistre en CSS-class, "inpath", til disse siders list item (li) OG link (a) i menuen, således at man kan style dem på en bestemt måde. F.eks. "ul#hovedmenu li.inpath{font-weight:bold}"	Nej
$maxLevels	integer	En optional variabel, som indeholder det maksimale antal levels - den maksimale "dybde" - som skal outputtes, målt fra den side, hvor funktionen starter. Hvis man f.eks. bygger en hovedmenu, som kun indeholder sider på øverste niveau i hierarkiet, vil man typisk sætte denne værdi til "1" og starte sit output fra $parentid=0.	Nej
$only_thread_id	integer	En optional variabel, som kan indeholde den eneste tråd (PAGES.THREAD_ID) i sidetræet, der skal outputtes af funktionen. Et THREAD_ID svarer til PAGES.ID på den side i en tråd, som har PARENT_ID=0. Alle denne sides undersider og under-under...-sider vil få et THREAD_ID, der svarer til PAGES.ID på deres øverste "parent". Variablen $only_thread_id bruges typisk, hvis man har 2 kald til newBuildFrontendMenu i samme template. Det ene kald outputter så hovedmenuen (se eksempel ovenfor), mens det andet kald outputter underpunkterne til det valgte hovedpunkt. Man ville så kalde newBuildFrontendMenu med et $only_thread_id = PAGES.ID på det valgte hovedpunkt.	Nej

Output/return-variabler

Funktionen har ingen return-variable, da den outputter (echo'er) sit output undervejs. Dette bør på sigt laves om.

Typisk brug

Typisk vil man bruge funktionen i en templates menu-div, hvor man vil skrive (i den mest enkle udgave):

newBuildFrontendMenu(1, 1, 0, 0, $arr_content)

... for at outputte menuen med MENUS.ID=1 tilhørende sitet med SITE.ID=1, startende fra $parentid=0.

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: calendarBox

Beskrivelse af funktionen

calendarBox er en funktion, som kan outputte en boks med de kommende arrangementer. Sådan en boks kan typisk placeres i et websites højre kolonne eller lignende sted, hvor man vil give et overblik. Funktionen viser de næste X kommende arrangementer, hvor X = $calendarBoxCount. $calendarBoxCount er en variabel, som sættes i cms_config.inc.php. I boksen vises ikke upublicerede eller slettede arrangementer. Boksen, som outputtes af calendarBox, kan styles med CSS - kig på funktionens output for at se navnene på de relevante CSS-classes og -id'er.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$feed	integer	ID på den kalender, boksen trækker arrangementer fra (svarer til et CALENDARS.ID)	JA
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Boksen returneres i sin helhed i $html

Typisk brug

Typisk vil man bruge funktionen i en kolonne i en template, hvor man vil skrive:

echo calendarBox(1, $arr_content)

... for at outputte en boks vedr. kalenderen med CALANDARS.ID = 1.

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: cmsTranslate

Beskrivelse af funktionen

cmsTranslate er en funktion, som bruges til at outputte forskellige tekster på det aktuelle sprog. Det drejer sig særligt om tekster, der er en del af "interfacet", f.eks. ledetekster til input-felter, tekster i knapper, titler på bokse, osv. Funktionen trækker på filen /cms/cms_baselanguage.inc.php (samt evt. overskrevne værdier i /cms_language.inc.php), og derudover på det aktuelle sprog, som kan udlæses af $_SESSION superglobal-variablen i $_SESSION["CURRENT_LANGUAGE"].

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$key	string	Key til det ord eller den sproglige enhed, der skal outputtes på det aktuelle sprog. Svarer til en plads i $cmsLang array'et, som findes i /cms/cms_baselanguage.inc.php og/eller /cms_language.inc.php.	JA
$optionalKey	string	En optional ekstra key til de værdier i $cmsLang, som er en array. Eksempelvis er navnene på de 12 måneder på dansk gemt i $cmsLang[da][MonthsLower] = array(1=>"januar", "februar", "marts", "april", "maj", "juni", "juli", "august", "september", "oktober", "november", "december"). I det tilfælde vil man bruge "MonthsLower" i $key (se ovenfor), og så en værdi fra 1-12 i $optionalKey for at oversætte navnet på en specifik måned.	Nej
$str_translate_to_shortname	string	En optional variabel til at gennemtvinge en oversættelse til et bestemt sprog. Normalt vil cmsTranslate oversætte teksten associeret med $key til det sprog, som er sat i $_SESSION["CURRENT_LANGUAGE"]. F.eks. kan $_SESSION["CURRENT_LANGUAGE"] være "da" eller "en" for hhv. dansk og engelsk, og disse peger således på de respektive pladser i $cmsLang - $cmsLang[da] og $cmsLang[en] er hver især en array med alle teksterne på de to sprog. Ved at sætte $str_translate_to_shortname kan man oversætte til et andet sprog end det aktuelle i $_SESSION["CURRENT_LANGUAGE"] - relevant, hvis f.eks. interfacet ikke er sprogversioneret, mens sideindholder er sprogversioneret.	Nej

Output/return-variabler

Navn	Type	Beskrivelse
	string	Det oversatte ord returneres i en string

Typisk brug

Typisk vil man bruge funktionen et sted i en template, eller i en custom funktion:

echo "<a href='/index.php?mode=stf'>".cmsTranslate("SendToFriend")."</a>";

... for at outputte teksten i $cmsLang[da][SendToFriend] = "Send siden til en ven" (eller i $cmsLang[en][SendToFriend] = "Send page to a friend", etc, alt efter aktuel værdi af $_SESSION["CURRENT_LANGUAGE"]).

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: customBoxes

Beskrivelse af funktionen

customBoxes er en funktion, som bruges til at outputte brugerdefinerede bokse tilknyttet en specifik side i en template. Brugerdefinerede bokse oprettes/redigeres under modulet "Bokse" (/cms/modules/customboxes) i Instans CMS, og boksene tilknyttes specifikke sider under modulet "Sider" i fanebladet "Relateret indhold". Det aktuelle side-id afgøres via $arr_content ($arr_content[pageid], svarende til et PAGES.ID). Funktionen er type-mæssigt i familie med calendarBox, se ovenfor.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Samtlige bokse returneres som én HTML-blok

Typisk brug

Typisk vil man bruge funktionen i en kolonne i en template, hvor man vil skrive:

echo customBoxes($arr_content)

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: metaTagGenerator

Beskrivelse af funktionen

metaTagGenerator er en funktion til at outputte metatags i en template. Funktionen returnerer bl.a. metatags for keywords, description, robots, content-type, language, samt en række DC (Dublin Core) metatags og (hvis relevant) stil til RSS-feed.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Samtlige metatags returneres som én HTML-blok

Typisk brug

Funktionen bruges inden for <head> tagget i en template, altså:

<head> ... echo metaTagGenerator($arr_content) ... </head>

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: modeHtmlHeaderIncludes

Beskrivelse af funktionen

modeHtmlHeaderIncludes er en funktion til at inkludere særlige javascript- eller CSS-filer i en sides <head> tag. Instans CMS har en række moduler placeret i mappen /cms/modules - modul-mapperne er navngivet på formen /cms/modules/modulnavn. Hver af disse mapper kan have en mappe med frontend-kode i mappen /cms/modules/modulnavn/frontend. Filerne i frontend-mappen er navngivet efter en særlig konvention, således at frontend-CSS til et modul altid ligger i filen /cms/modules/modulnavn/frontend/modulnavn.CSS, og tilsvarende ligger javascript til modulet i /cms/modules/modulnavn/frontend/modulnavn.js. Modulnavn svarer her i øvrigt til værdien af $arr_content[mode] - dvs. at når man er "inde i" blog-modulet (f.eks. når man læser en blog-side), vil $arr_content[mode] være "blogs". På baggrund af værdien af $arr_content[mode] afgør modeHtmlHeaderIncludes, om der skal inkluderes CSS og/eller javascript (funktionen skal køre én gang for hver type, hvor $type er "CSS" eller "javascript").

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA
$type	string	Kan være "CSS" eller "javascript"	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Returnerer et <link rel='stylesheet'> tag for CSS og et <script src='...'> tag for Javascript

Typisk brug

Funktionen bruges inden for <head> tagget i en template, altså:

<head> ... echo modeHtmlHeaderIncludes($arr_content, 'CSS') ... </head>

for at få inkluderet evt. modulspecifikke CSS-filer.

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: newReturnHTMLMenuPath

Beskrivelse af funktionen

newReturnHTMLMenuPath er en funktion, som kan returnere "brødkrumme"-stien ned til en speficik almindelig side eller en "side" i en anden mode, f.eks. en specifik nyhed, blogpost eller lignende. Den kan således returnere en sti på formen Produkter -> Frugt -> Æbler -> Granny Smith eller Blogs -> Christoffers Blog -> Nu skal I høre, hvor det er muligt at tilføje præ- og postfix samt definere adskille-tegnet (her "->") mellem sider.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$pageid	integer	Sidens ID (PAGES.ID), kan typisk udledes af $arr_content[pageid]	JA
$mode	string	Den mode, systemet kører i - kan tages fra $arr_content[mode]	JA
$prefix	string	Hvad skal stå før hele stien - f.eks. "Du er her: " eller bare "" (en tom streng)	JA
$postfix	string	Hvad skal stå efter hele stien - kan f.eks. være outputtet fra en anden funktion, hvis man har skrevet custom plugins, som (fra brugerens synspunkt) logisk/strukturelt set laver "undersider" til den side, pluginnet kører i, men CMS-kernen er ikke bevidst om disse "undersider".	JA
$seperator	string	Adskille-tegn mellem links i stien - f.eks. "»"	JA
$arr_content	string	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Returnerer hele brødkrumme-stien som en blok HTML

Typisk brug

Funktionen kunne bruges således:

<div id='breadcrumb'>echo newReturnHTMLMenuPath($arr_content[pageid], $arr_content[mode], "Du er her: ", "", "->", $arr_content)</div>

for at outputte brødkrumme-stien et sted i en template.

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: newsBox

Beskrivelse af funktionen

newsBox er en funktion, som kan outputte en boks med udvalgte nyheder. Sådan en boks kan typisk placeres i et websites højre kolonne eller lignende sted, hvor man vil give et overblik. Funktionen viser de nyheder, som er afkrydset med "vis på forside" i nyhedsmodulet i Instans CMS. I boksen vises ikke upublicerede eller slettede nyheder. Boksen, som outputtes af newsBox, kan styles med CSS - kig på funktionens output for at se navnene på de relevante CSS-classes og -id'er.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$feed	integer	ID på det nyhedsarkiv, boksen trækker nyheder fra (svarer til et NEWSFEEDS.ID)	JA
$arr_content	array	$arr_content	JA
$newsdate	string	Hvor skal nyhedsdatoen placeres i forhold til den enkelte nyhed - værdier "before", "after" (default) eller "none"	Nej

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Returnerer hele brødkrumme-stien som en blok HTML

Typisk brug

Typisk vil man bruge funktionen i en kolonne i en template, hvor man vil skrive:

echo newsBox(1, $arr_content)

... for at outputte en boks vedr. nyhedsarkivet med NEWSFEEDS.ID = 1.

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: printerFriendly

Beskrivelse af funktionen

printerFriendly er en funktion, som kan outputte en "sidefod" med links til printvenlig udgave, "gå til toppen af siden" og "tip en ven". Man kan slå alle 3 links til/fra efter behov. Linket til den printvenlige udgave vises kun, hvis der er en print-template tilknyttet den aktuelle side-template (dette kan checkes i databasefeltet TEMPLATES.PRINTTEMPLATE_PATH). Den aktuelle side-template kan udlæses af feltet PAGES.TEMPLATE, som peger på et TEMPLATES.ID. Linket til "tip en ven" peger på standard-"tip en ven" funktionen i Instans CMS' frontend.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA
$topofpage	boolean	Vælger, om der skal vises "gå til toppen af siden" link. Sættes til true eller fale. Default = true.	Nej
$printversion	boolean	Vælger, om der skal vises "printvenlig udgave" link. Sættes til true eller fale. Default = true.	Nej
$tipafriend	boolean	Vælger, om der skal vises "tip en ven" link. Sættes til true eller fale. Default = true.	Nej

Output/return-variabler

Navn	Type	Beskrivelse
$html	string	Returnerer hele sidefoden som en blok HTML

Typisk brug

Typisk vil man bruge funktionen under sidens primære indhold:

echo buildPageMainContent($arr_content);
echo printerFriendly($arr_content);

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: return_customfielddata

Beskrivelse af funktionen

return_customfielddata er en funktion, som henter data fra de såkaldte "specialfelter", hvis sådanne er tilknyttet den aktuelle side. Læs mere om specialfelter her. Data i specialfelter er indtastet i Instans CMS under fanebladet " _fcksavedurl="">Læs mere om specialfelter her. Data i specialfelter er indtastet i Instans CMS under fanebladet "Specialfelter" i sideredigering. Funktionen return_customfielddata returnerer en array med specialfelt-data (customfielddata), hvor hver plads i array'et svarer til en CUSTOMFIELDS.FIELDKEY. Funktionen køres typisk i toppen af en template (eller i en custom funktion), hvorefter de returnerede data puttes ind på de korrekte pladser i templaten. Funktionen skal kun bruge $arr_content som input, fordi den herfra kan hente et pageid. BEMÆRK, at funktionen (og systemet som helhed) pt. kun understøtter specialfelter på sider (PAGES-tabellen) - dette lader sig dog relativt nemt udbygge; læs mere i frontend_common.inc.php under selve funktionen.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
	array	Returnerer alle sidens customdata i et array på formen array("FIELDKEY" => "Indtastet værdi i specialfeltet")

Typisk brug

Typisk vil man bruge funktionen under sidens primære indhold:

<?php
 $specialfeltdata = return_customfielddata($arr_content);
?>
...

...
<div id="custom_felt_i_template"><?php echo $specialfeltdata[MIT_SPECIALFELT]; ?></div>

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: returnPageTitleTag

Beskrivelse af funktionen

returnPageTitleTag er en funktion, som returnerer indholdet af en sides <title> tag. Funktionen finder selv den korrekte system-mode, og hvis der er angivet særlige titler under fanebladet "søgeoptimering" i sideredigering, benyttes disse. Man kan angive et prefix, som skal stå foran titlen. F.eks. "Instans: ".

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA
$prefix	string	Tekst, evt. kan stå foran titlen	Nej

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer sidetitlen i en string

Typisk brug

Funktionen bruges i en templates <head>:

<head><title><?php echo returnPageTitleTag($arr_content, "Instans: "); ?></title></head>

... for at få en titel på formen <title>Instans: Sidens titel</title>

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: searchBox

Beskrivelse af funktionen

searchBox er en funktion, som returnerer en lille søgeboks til søgning i sitets interne søgemaskine. Boksen placeres typisk i websitets højre kolonne. oksen, som outputtes af searchBox, kan styles med CSS - kig på funktionens output for at se navnene på de relevante CSS-classes og -id'er.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer boksen i en string som en blok HTML

Typisk brug

Funktionen bruges i en template et passende sted:

<?php echo searchBox($arr_content); ?>

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: shopProductMenu

Beskrivelse af funktionen

shopProductMenu er en funktion, som automatisk bygger en produktmenu over varegrupper i Instans CMS' shop-modul. Funktionen er rekursiv og fungerer på samme måde som newBuildFrontendMenu, blot med varegrupper i stedet for sider. Funktionen kan indsættes på det sted i en template, hvor man gerne vil vise sin shop-produktmenu.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$parentId	integer	PARENT_ID (SHOP_PRODUCTGROUPS.PARENT_ID) på den varegruppe, hvorfra rekursionen skal initieres. Start med 0 for at bygge hele varegruppe-hierarkiet.	JA
$arr_content	array	$arr_content	JA

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer menuen i en string som en blok HTML

Typisk brug

Funktionen bruges i en template et passende sted:

<?php echo shopProductMenu(0, $arr_content); ?>

Hvis man bruger samme template til "almindeligt indhold" og shop, kan man lave en if-sætning, som kun viser produktmenuen, hvis man er i shoppen:

if ($arr_content[mode] == "shop"){echo shopProductMenu(0, $arr_content); } else { /* her kan man f.eks. echo newBuildFrontendMenu i stedet, eller echo "" */ }

Placering i filsystem

Funktionen ligger i filen /cms/frontend/frontend_common.inc.php.

Funktion: returnNiceDateTime

Beskrivelse af funktionen

returnNiceDateTime returnerer en pæn, dansk-formatteret dato på baggrund af et UNIX timestamp.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$unixtime	integer	UNIX timestamp, f.eks. fra time() funktionen i PHP, eller fra et CREATED_DATE felt på en tabel i Instans CMS	JA
$medklokkeslet	boolean	Medtag klokkeslæt? 0 for nej, 1 for ja.	JA
$medsekunder	boolean	Medtag sekunder i klokkeslæt? 0 for nej, 1 for ja.	Nej

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer dato/klokkeslæt som en string

Typisk brug

Kan bruges alle mulige steder.

Placering i filsystem

Funktionen ligger i filen /cms/sharedfunctions.inc.php.

Funktion: returnImageUrl

Beskrivelse af funktionen

returnImageUrl returnerer en absolut URL på et billede fra Instans CMS billedarkivet på baggrund af billedets ID i PICTUREARCHIVE_PICS tabellen.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$image_id	integer	ID svarende til et PICTUREARCHIVE_PICS.ID	JA

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer absolut billed-URL som en string

Typisk brug

Kan bruges alle mulige steder. F.eks. hvis man arbejder med en USER fra USERS-tabellen og har select'et vedkommendes data fra databasen, inkl. USERS.IMAGE_ID. Så kan man benytte returnImageUrl til at få den rigtige URL ud, som man kan putte ind i et <img> tag (i src-atributten).

Placering i filsystem

Funktionen ligger i filen /cms/sharedfunctions.inc.php.

Funktion: returnImageThumbUrl

Beskrivelse af funktionen

returnImageThumbUrl returnerer en absolut URL på en thumbnail af et billede fra Instans CMS billedarkivet på baggrund af billedets ID i PICTUREARCHIVE_PICS tabellen.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$image_id	integer	ID svarende til et PICTUREARCHIVE_PICS.ID	JA

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer absolut thumbnail-billed-URL som en string

Typisk brug

Kan bruges alle mulige steder. F.eks. hvis man arbejder med en USER fra USERS-tabellen og har select'et vedkommendes data fra databasen, inkl. USERS.IMAGE_ID. Så kan man benytte returnImageUrl til at få den rigtige URL ud, som man kan putte ind i et <img> tag (i src-atributten).

Placering i filsystem

Funktionen ligger i filen /cms/sharedfunctions.inc.php.

Funktion: return_feed_url

Beskrivelse af funktionen

return_feed_url returnerer en absolut URL til et RSS-feed fra en blog eller et nyhedsarkiv.

Input-variabler

Navn	Type	Beskrivelse	Obligatorisk
$tablename	string	Pt. enten BLOGS eller NEWSFEEDS	JA
$requestid	integer	ID på den pågældende blog (BLOGS.ID) eller det pågældende nyhedsarkiv (NEWSFEEDS.ID)	JA

Output/return-variabler

Navn	Type	Beskrivelse
	string	Returnerer absolut feed-URL som en string

Typisk brug

Kan bruges alle mulige steder. Bruges automatisk af flere andre funktioner til at lave RSS-links i meta-tags m.v.

Placering i filsystem

Funktionen ligger i filen /cms/sharedfunctions.inc.php.