Hjälp: Macros, använder

WebGUI macros används för att skapa dynamiskt innehåll bland statiskt innehåll. Till exempel så kan användarnamnet för inloggad användare visas på varje sida. Macros börjar alltid med "^", följs alltid med minst ett tecken och avslutas alltid med ";". Vissa macron kan konfigureras genom att man lägger in en parameter. Ett vanlig macro kan skrivas: ^x; men med en paramater ser det ut som: ^x("parameter, vad du vill"); Här följer en beskrivning av samtliga macron i WebGUI. ^a; eller ^a(); - Mitt konto-länk En länk för att se din kontoinformation. Du kan ändra länktexten genom att skriva macrot som ^a("Kontoinformation");. Note: Du kan använda specialparametern linkonly (^a(linkonly)) för att bara skapa en URL till kontosidan och inget mer. .myAccountLink stilmallen är knuten till detta macro. ^AdminBar; ! Placerar administrativa menyn på sidan. Detta är ett obligatoriskt macro i "body"-delen av stilhanteraren. ^AdminText(); Visar ett litet textmeddelande om en användare är i administrationsläge. Exempel: ^AdminText("Du är nu i administrationsläge");. ^AdminToggle; eller ^AdminToggle(); Placerar en länk på sidan som bara är synlig för innehållshanterare och administratörer. Länken sätter på/stänger av administrationsläget. Du kan även välja andra namn på länkarna genom att skriva ^AdminToggle("Redigera","Visa");. ^C; eller ^C(); - Vägspårning Visar vilken väg man gått genom webbplatsen i en hierarkisk struktur. Du kan själv välja vilken avgrönsare du vill ha mellan de olika sidorna genom att skriva ^C(::). Standard avgränsare är ">". Note: .crumbTrail stilklass anger hur den ser ut. ^c; - Företagsnamn Namnet på ditt företag, angett av administratören. ^D; eller ^D(); - Datum T! id just nu. Du kan själv välja datumformat genom att använda vissa symboler. ^D("%c %D, %y"); skulle generera September 26, 2001. Följande format och symboler finns tillgängliga: %% % %y 4-siffrigt årtal %Y 2-siffrigt årtal %m 2-siffrig månad %M månad %c månadsnamn %d 2-siffrig månadsdag %D månadsdag %w namn på veckodag %h 2-siffrig klocka bas 12 timmar %H klocka bas 12 timmar %j 2-siffrig klocka bas 24 timmar %J klocka bas 12 timmar %p gemen am/pm %P versal AM/PM %z användarinställt datumformat %Z användarinställt tidsformat ^e; - Företagets e-postadress E-postadressen som inställd av adminstratören. ^Env(); Används för att visa serverns variabler. Du kan se alla serverns variabler genom att gå till "www.dinwebplats.tld/env.pl". Macrot ska skrivas som ^Env("REMOTE_ADDR");. ^Execute(); Tillåter innehållshanterare eller administratör att köra ett externt program.! Används vanligtvis som ^Execute("/this/file.sh"). ^Extras; Returnera sökvägen till WebGUI "extras" mapp som innehåller saker som WebGUI ikoner. ^FlexMenu; Skapar en expanderbar meny. Fungerar ungerfär som trädstrukturen i Utforskaren på en Windows-dator. ^FormParam(); Används oftast för att skapa dynamiska frågor genom SQL-rapporter. Genom att använda det här macrot kan du få värdet från valfritt formulärfält bara genom att använda fältets namn. Exempel: ^FormParam("telefonnummer"); ^GroupText(); Visar en kort text för användare som är medlemmar i en specifik grupp. Exempel: ^GroupText("Visitors","Du behöver ett konto för att använda den här webbplatsen!"); ^H; or ^H(); - Home Link En länk till webbplatsens förstasida. Du kan själv välja länktexten genom att skicka med den som en parameter. Exempel: ^H("Hem");. Note: Du kan även skriva ^H(linkonly); för att bara få en URL t! ill förstasidan. .homeLink stilklassen används för att ändra utseende på länken. ^I(); - Bild-tagg från bildhanteraren Returnerar en image-tag (HTML) till en bild definierad i bildhanteraren. Välj vilken bild du vill ha genom att skicka namnet som parameter. Exempel: ^I("bildnamn");. ^i(); - Image Manager Image Path Returnera sökvägen till en bild som är uppladdad via bildhanteraren. Välj vilken bild du vill ha sökvägen till genom att skicka namnet som parameter. Exempel: ^i("bildnamn");. ^Include(); Låter administratör eller innehållshanterare att inkludera filer från lokala filsystemet i HTML-dokumenten. Skicka dokumentets plats som parameter. Exempel: ^Include("/denna/filen.html"); ^L; or ^L(); - Login Ett litet inloggningsformulär. Du kan bestämma hur bred rutan ska vara och även ett meddelande som ska visas efter användaren loggat in. För att bestämma storleken så skriver man: ^L(20);. För att skriva ! ett meddelande som visas för användaren så skriver man: ^L(20,Hej ^a(^@;);. Klicka %here% om du vill logga ut!) Note: .loginBox stilklassen bestämmer utseendet. ^LoginToggle; or ^LoginToggle(); Visar ett "Logga in"- eller "Logga ut"-meddelande beroende på om man är ut- eller inloggad. Du kan även välja andra texter genom att skriva såhär: ^LoginToggle("Klicka här för att logga in.","Klicka här för att logga ut."); ^M; or ^M(); - Nuvarande meny (vertikal) En vertikal meny som visar de underalternativ som finns tillgängliga från nuvarande sida och neråt. Som standard så visar den bara de menyalternativ som leder ner en nivå, men du kan själv välja hur många nivåer ner som ska visas. För att gå tre nivåer ner kan du skriva såhär: ^M(3);. Byter du 3'an mot en 0'a (noll) så visas hela webbplatsens undersidor. ^m; - Nuvarande meny (horisontell) En horisontell meny som innehåller undersidorna räknat från nuvarande! nivå. Du kan själv välja en avgränsare genom att skriva ^m(:--:);. Standard avgränsare är ·. ^P; or ^P(); - Tidigare meny (vertikal) En vertikal meny som innehåller länkar till sidorna innan nuvarande nivå. Som standard så visar den bara de menyalternativ som leder ner en nivå, men du kan själv välja hur många nivåer ner som ska visas. För att gå tre nivåer ner kan du skriva såhär: ^P(3);. Byter du 3'an mot en 0'a (noll) så visas hela webbplatsens undersidor. ^p; - Tidigare meny (horisontell) En horisontell meny som innehåller länkar till sidorna innan nuvarande nivå. Du kan själv välja en avgränsare genom att skriva ^m(:--:);. Standard avgränsare är ·. ^Page(); Kan användas för att hämta information om aktuell sida. Till exempel så kan macrot användas för att hämta sidans URL såhär: ^Page("urlizedTitle"); eller sidans title såhär: ^Page("menuTitle");. ^PageTitle; Visar titeln på aktuell sida. Note: Om du använder administratörsfunktioner eller "indepth"-funktioner i wobjects så kommer sidans titel bli en länk som tar dig tillbaka till sidan. ^r; or ^r(); - Utskriftsbar version Skapar en länk som visar aktuell sida, men med annan design. Du kan ändra text på länken genom att skriva såhär: ^r("Skriv ut");. När en användare klickar på länken kommer sidans stil att bytas ut mot "Make Page Printable"-stilen i stilhanteraren. Detta kan dock ändras till vilken stil som helst genom att skicka med stilen som paramter. Exempel: ^r("Print!","WebGUI");. Utrskriftssidan kommer då få WebGUI-stilen. Note: Du kan även använda specialmacrot ^r(linkonly); för att få en URL till utskriftsbar version. .makePrintableLink stilmallen bestämmer utseende på länken. ^rootmenu; eller ^rootmenu(); (horisontell) Skapar en horisontell meny med rötterna i WebGUI (förutom system-menyer). Du kan välja menyavgränsare genom att skriva s! åhär: ^rootmenu(|); ^RootTitle; Returnerar titlen på roten till nuvarande sida. Till exempel är roten till WebGUI "Hem"-sidan Avancerade sidor kan ha flera rötter och behöver således ett sätt att beskriva för användaren vilken rot denna befinner sig i. ^S(); - Specifik undermeny (vertikal) Detta macro ger dig en vertikal undermeny från vilken sida som helst. Undermenyn startar från sidan du anger som parameter till macrot. Till exempel kan du få en undermeny till alla sidor under "Hem" genom att skriva ^S("hem",0);. Det första värdet är URL'iserade titeln av sidan och den andra paramtern är hur djup du vill att trädstrukturen ska vara. Standardinställningen är att bara visa en nivå. För att gå tre nivåer ner skriver du: ^S("hem",3);. ^s(); - Specifik undermeny (horisontell) Detta macro ger dig en horisontell undermeny från vilken sida som helst. Undermenyn startar från sidan du anger som parameter till macrot. Till exe! mpel kan du få en undermeny till alla sidor under "Hem" genom att skriva ^s("hem");. Parametern är den URL'iserade titeln av sidan. Du kan även själv välja en avgränsare genom att skriva ^s("hem", ":--:");. Standard avgränsare är ·. ^SQL(); En en-rads-SQL-rapport. Ibland vill bara bara ha lite snabba data från databasen och då kan du använda detta macro. Det här macrot kan också användas för att utöka ett. Detta macro använder de numeriska macrona (^0; ^1; ^2; etc) för att positionera data. Macrot ^rownum; för att få fram radnummer kan också användas här. Exempel: ^SQL("select count(*) from users","Det finns ^0; användare på det här systemet."); ^SQL("select userId,username from users order by username","^1;
"); ^Synopsis; eller ^Synopsis(); Meny Detta macro ger dig en undermeny till sidor under en viss sida, tillsammans med kort beskrivning av respektive länk. Du kan sätta ett ! heltal som parameter för att välja hur många nivåer djup menyn ska vara. Notera: .synopsis_sub, .synopsis_summary, och .synopsis_title stilklasser används av detta macro. ^T; eller ^T(); - Toppnivåmeny (vertikal) En vertikal meny som innehåller alla huvudsidor på webbplatsen, dvs undersidor från hemsidan. Du kan själv välja hur djup du vill ha trädstrukturen genom att skriva ett heltal som parameter. Som standard visar den bara första nivån. För att gå ner tre nivåer skriver du ^T(3). Om du skickar "0" (noll) så kommer hela webbplatsen trädstruktur visas. ^t; - Toppnivåmeny (horisontell) En vertikal meny som innehåller alla huvudsidor på webbplatsen, dvs undersidor från hemsidan. Du kan själv välja en avgränsare mellan sidnamnen genom att skriva ^t(:--:);. Standard avgränsare är ·. ^Thumbnail(); Returnerar en URL av en minitayrbild av en bild från bildhanteraren. Välj vilken bild du vill ha genom att skicka ! med namnet på bilden som parameter: ^Thumbnail("bildnamn");. ^ThumbnailLinker(); Du kan använda detta macro för att enkelt göra en sida med skärmdumpar eller ett fotogalleri. Skicka med namnet på en bild i bildhanteraren som parameter till macrot: ^ThumbnailLinker("Min hund"); och på sidan kommer det visas en miniatyrbild men länk under som länkar till bilden i full storlek. ^u; - Företags-URL URL till ditt företag, som det är inställt av administratören. ^URLEncode(); Detta macro är mest användbart i SQL-rapporter, men kan självklart användas på andra ställen också. Macrot tar en sträng som parametera och kodar om den i URL-format så man kan använda den i just en URL. Så här kan du använda den: ^URLEncode("Detta är en sträng med tecken!"); ^User(); Använd detta macro för att visa information om en användare från dennes kontouppgifter eller profil. Om du vill visa användaren dennes e-postadress skriver du:! ^User("email");. ^/; - System-URL URL till WebGUI-scriptet (exempel: /index.pl/). ^\; - Sid-URL URL till nuvarande sida (exempel: /index.pl/pagename). ^@; - Användarnamn Användarnamnet på nu inloggad användare. ^?; - Sök En sökbox på sidan. Knuten till WebGUI's inbyggda sökmotor. Note: .searchBox stilklass används av detta macrot. ^#; - Användar-ID Användar-ID för nu inloggad användare. ^*; or ^*(); - Slumpmässigt nummer Slumpmässigt genererat nummer. Kan användas för att rotera banners eller andra typer av bilder. Du kan även välja högsta nummer för slumptalsfunktionen såhär: ^*(100) för att skapa ett slumptal mellan 0 och 100. ^-;,^0;,^1;,^2;,^3;, etc. Dessa macros är reserverade för system/wobject-specifika funktioner som i SQL-rapporten och Body i stilhanteraren.

Se vidare:

Ändrad: 2 december 2008