Konfigurera SAC:s webbplats

SAC:s webbplats använder COOPsite, en skriptmotor som tillåter att många jobbar med webbplatsen. Användarna behöver bara lägga upp innehållet, COOPsite skapar allt runt omkring. Detta går att kontroller genom att ändra konfigureringen för hela webbplatsen eller en avdelning av den. Hur det går till förklaras här.

Ett mera användarvänligt gränsnitt mot konfigureringen kommer så småning om. Men detta gäller tills vidare.

Mallar

Sidorna byggs upp av mallar. Huvudmallen sätts av parametern frame, men en sajt/sida kan byggas upp av många olika mallar. I mallarna finns bytutmärken som börjar med { och slutar med }. Därimellan står det en text som börjar med PHF_ och fortsätter med siffror bokstäverna A-Z och understrykningstecken (_).

Dessa märken byts ut mot värdet av den konfigureringsparameter med samma namn som det som kommer efter PHF_ men med små bokstäver istället för stora. Märket {PHF_SIDE_BAR} byts alltså ut mot värdet av side_bar. Om en parameter inte finns byts märket ut mot ingenting.

Några märken är speciella, det är:

• {MAINBODY} som byts ut mot sidans huvudinnehåll! Det är dock rekomenderat att använda {PHF_MAINBODY} och sätta parametern mainbody till något som inehåller {MAINBODY}, då blir det lätt att på alla sidor lägga till något före eller efter huvudinehållet. NÖDVÄNDIG i huvudmallen!
• {PHF_CDATE} som byts ut mot sidans skapandedatum.
• {PHF_MDATE} som byts ut mot sidans senaste ändringsdatum.
• {PHF_MESS} som byts ut mot meddelanden från coopsite... VIKTIG. Rekomenderad plats är antingen överst i body, eller direkt före huvudinehållet.
• {PHF_TOOLBOX} som byts ut mot de länkar som behövs för att redigera/underhålla en sajt.

Det finns fler... Fullständig dokumentation är inte skapad än... Men ovanstående bör räcka för att skapa en fungerande sajt.

Ärvda parametrar

Parametrarna ligger på katalognivå. De får sitt värde från kattalogen ovanför i webbstrukturen, det kallas att parametrarna ärver sitt värde från föräldrakatalogen. Det gör att man inte behöver mata in alla parametrar överallt, bara de man vill ändra (överrida) för den avdelningen (katalogen).

Parametrarna i webbplatsens startkatalog som inte har någon katalog ovanför ärver istället sina värden från COOPsite:s förvalda värden.

Hur ändrar jag konfigureringsparametrarna?

Gå in i konfig som du hittar i dir-info för den katalog du vill ändra konfigureringen i. Då får du upp en lista på de parametrar som är satta.

Den första kryssrutan avgör om parametern ska överida (override) ärvt värde. Om den rutan inte är förkryssad visas bara ärvt värde. Vill du kunna ändra parametern, kryssa i rutan och spar med knappen längst ner på formuläret.

Om överidarutan är ikryssad visas en inmatningsruta med aktuellt värde under raden med överidarrutan och parameterns namn. I den rutan kan du ändra värdet. Ändringen gäller inte förrän du sparat formuläret. Du kan ändra fler värden innan du sparar.

Om du matar in ett tomt värde byts det mot *NULL*. Det motsvarar inget värde men inget värde skulle ge ärvt värde så denna funktion gör det möjligt att ta bort värden i en underkatalog som finns som finns högre upp i webbstrukturen.

Om aktuellt värde skiljer sig från ärvt värde så visas ärvt värde under inmatnigsrutan för aktuellt värde. Om du avmarkerar överridarrutan och sparar den nya inställningen kommer aktuellt värde att försvinna och parametern återtar ärvt värde

Lägga till nya parametrar

Längst ner på sidan finns tre tomma rader. Där kan du mata in namn och värde på nya parametrar. De nya parametrarna dyker sedan upp insorterade i listan med ärvda/överridna parrametrar men märkta 'ny' istället för owerideruta.

Om du ger en sådan ny parameter ett tomt värde så tas den bort.

Olika värden beroende på användarens rättigheter

Du kan få en parameter att ha olika värden för inloggade användare med olika rättigheter. Det gör du genom att först mata in de olika nivåer som ska finnas. Det gör du med en speciell parameter som heter parameternamn;levels. Den ska sättas till en lista av tal som skiljs åt av mellanslag, t.ex:

5 9000

Det betyder att om användaren inte är inloggad eller har lägre rättigheter än 5 så har parametern inget värde. Om användaren har nivå 5-8999 så bestäms parameterns värde av pseudoparametern paremeternamn;5. Har användaren rättigheter på 9000 eller mer bestämms värdet av parameternamn;9000.

Om parameternamn;levels inte är satt tas parameterns värde direkt från parameter. Om talet 0 finns med i parameter;levels så tas även värdet för den nivån från parameter, m a o pseudoparametern parameternamn;0 används aldrig.

Flaggor

Under parametervärdet finns en upsättning kryssrutor som motsvara flaggor som styr hur CoopSite använder värdet. De är:

• File: Betrakta parametervärdet som ett filnamn och läs den filen för att hämta slutligt värde. Den läsningen görs först när sidan visas så att ändringar i filen alltid kommer med.
• Hyper: Betrakta parametervärdet som en mall och byt ut bytutmarkörer i den innan värdet levereras. Utbytningeng sker efter ev filläsning enlig föregåend punkt.
• Template: Änvänd parametermall, se eget stycke.
• FixHTML: Om CoopSite ska fixa (ballansera) htmlkod i parrametervärdet. Kan se till att undvika svårspårade renderingsfel på sajten. Kan dock bara användas då parameterns inhåll ska vara ballanserat.

Om levels används för en parameter så ligger flags på varje nivå. Exemplet ovan skulle alltså vara parameternamn;5;flags och parameternamn;9000;flags.

Parametermall

Om parametermall är påslaget för en parameter så hämtas värdet från parametern parameternamn_tpl och det värdet förväntas innehålla bytutmärket {DATA} som ersätts med värdet av parametern efter alla övriga bearbetningar av flags.

Vad flags var då parametern eller den level den anropades från har ingen betydelse. Parametermallen betraktas som en helt egen parameter med egna levels och flags psedouparametrar. Om den ursprungliga parametern inte är satt kommer den dock inte att läsas över huvud taget.

Om parametermallen inte innehåller bytutmärket {DATA} så kommer parameterns värde inte att visas. I det läget slår parameterns värde bara av eller på visningen av mallen. Ett faktum man kan dra nytta av.

Sätta parametrar från innehållet

När man redigerar en fil så kan man faktiskt sätta parametervärden för bara den filen.

Det görs med 'Extra parametrar' som visas längst ned på redigeringsidan om dina rättigheter är tillräckligt höga. Före det finns lite mer användarvänliga kontroller för vanliga parrametrar.

Varför {PHF_PARAMETERNAMN}

Vad kommer PHF_ ifrån?

- Jo PHF står för Parameter Hyper Find and replace.

Verkligen?

-Ja, delvis kanske även att COOPsite tidigare hade arbetsnamnet PHF ;-)

Varför börjar en del speciella bytuttaggar inte med PHF_?

- Därför att de är speciella. På det sättet kan de ligga i parametrar som har utbytningsflaggan påslagen utan att bytas ut. Det är praktiskt!

Buggar

Buggar i skriptmotorn och dokumentationen kan raporteras till lah at micropp dot se.

OBS! Raportera inte fel på inehållet eller länkar på SAC:s sajt dit, bara fel på skriptmotorn.