PHP-FUSION VERSION 6.0

Transkript

1 PHP-FUSION VERSION 6.0 Copyright 2005 Jan Mølgaard Håndbogen retter sig mod anvendelse af PHP-Fusion Version 6.0 Copyright 2005 Nick Jones

2 Indholdsfortegnelse: Introduktion...3 Installation...4 Ændring af rettigheder...5 Selve installationen...6 Opgradering fra tidligere versioner Opgradering fra version Opgradering fra version 5.0 eller version Sideopsætning Begreber og struktur på siden Administrationssiderne Sideopsætning Hovedindstillinger Valg af tema, ændring af temafil Indstillinger for dato og klokkeslæt Indstillinger for debat Tilmeldingsindstillinger Fotogalleri indstillinger Private beskeder Diverse indstillinger Panelet navigation Ændringer i filen theme.php Gruppedefinitioner og rettigheder Administratorer Ordstyrere Brugergrupper Artikler Nyheder Downloads Downloadkategorier Downloads Billedhåndtering Billedimport og anvendelse Fotoalbum Links Elementer og elementstyring Debat Oprette debatter Administration generelt Replikker Administration af brugere/medlemmer Brugerforslag Kommentarer Sikkerhedskopiering af database Personlige beskeder FAQ anvendelse og administration Tilpasning af systemet generelt nogle eksempler Dansksprogede knapper i debat Ændring af visningen for unikke hits og visning af tidsforbrug ved sidedannelse Ændring af pålognings- og aflogningsmeddelelse Et par såkaldte MOD s Infusions Installere en INFUSION Oprette en ny INFUSION Afsluttende om INFUSIONS Litteratur og links Afsluttende bemærkninger Credits Stikordsregister Side 2 -

3 Introduktion PHP-Fusion er et såkaldt CMS (Content Management System) baseret på scriptsproget PHP og en MySQL-database. Et CMS er en systemløsning, der integrerer en lang række funktioner til oprettelse og vedligeholdelse af en hjemmeside på internettet på en sådan måde, at alle funktionerne er del af den samme løsning og således, at al vedligeholdelse af hjemmesiden sker via en browser (som f. eks. Microsoft Internet Explorer). PHP er et scriptsprog, som bruges til at etablere forbindelser til databaser og anvende, behandle og præsentere data derfra i form af en hjemmeside. Og i et CMS som PHP-Fusion betyder det, at alle informationer, som skal bruges til at danne de sider, som brugerne ser, ligger i en database og at siderne dannes dynamisk, når brugerne kalder sidens adresse. Fordelen ved at bruge et scriptsprog som PHP er (udover at det er relativt nemt at arbejde med), at det er et såkaldt server-side scriptsprog. Og det betyder, at alt arbejdet med at slå op i databasen og danne de html-sider, som brugeren ser på, foregår på serveren ikke på brugerens maskine, som det for eksempel er tilfældet når man bruger java-script. Og fordelen ved at bruge MySQL er udover at det er et stærkt og fleksibelt databasesystem, at det er såkaldt Open Source dvs. at det er gratis at bruge for alle brugere. Både PHP og MySQL udvikler sig i en rasende fart for øjeblikket. En helt ny og mere avanceret version 5.0 af PHP er frigivet for nylig, og MySQL er også på vej med en helt ny version. Men PHP-Fusion bygger endnu kun på den gennemprøvede og stabile PHP version 4.0 og på MySQL version 3. PHP-Fusion udmærker sig ved at være meget kompakt (hele systemet fylder i den nyeste version godt 1,4 Mb), meget højtydende (siderne dannes og præsenteres meget hurtigt) og meget fleksibelt (systemet er let at tilpasse og udvide) og ved at være under konstant udvikling i et tæt samarbejde mellem systemets opfinder Nick Jones og et stadigt voksende netværk af brugere eksperter og andre. Denne vejledning er skrevet som en service overfor danske brugere. Aktuelt fås PHP-Fusion i sprogversioner på engelsk, dansk, svensk, norsk, tysk, hollandsk, spansk og russisk, men flere er med garanti på vej. Ønsker man hjælp og støtte til anvendelsen af løsningen, kan man finde den blandt andet på et af de mange officielle PHP-Fusion supportsider: England (UK): Danmark (DK): Tyskland (D): Holland (NL): Sverige (S): Polen (PL): Frankrig (F): Taiwan (TW): Litauen (LT): Tyrkiet (TR): God fornøjelse med din anvendelse af systemet. Jan Mølgaard Århus, Danmark, Juni Side 3 -

4 Installation Når man downloader løsningen får man den i form af en såkaldt zippet (dvs. komprimeret) fil, som først skal udpakkes på ens egen harddisk. Til dette formål skal man bruge et program som Winzip (eller andet tilsvarende). Efter udpakningen vil man se en filstruktur, der ser ud som følger: I folderen php-files ligger samtlige programfiler. Filerne gpl.txt, README-xx.txt i forskellige sprogversioner) angiver dels anvendelsesbetingelserne (gpl) dels de væsentligste installationsinstruktioner (README). Det er en god ide at læse README-filen igennem, navnlig hvis man skal til at opgradere. Det kan spare en for mange problemer. Men når man derefter skal have installeret sin løsning, så begynder man processen med at oprette (eller at få oprettet) en MySQL-database på den web-adresse, hvor ens hjemmeside skal ligge. Derefter kopierer man samtlige filer under folderen php-files op i rodbiblioteket på webserveren (f. eks. med et FTP-program). Og derefter skal man have ændret tilladelserne på en række filer og foldere oppe på serveren. Tilladelserne på filer og foldere styrer, hvem der har adgang til de pågældende ting og styrer også, hvad en given bruger må foretage sig med filerne eller folderne. Og disse tilladelser (eller permissions, som det hedder på engelsk) sætter man enten ved hjælp af et egnet FTPprogram eller via den brugersnitflade, som ens serverleverandør stiller til rådighed. I eksemplerne her er der brugt et FTP-program, som hedder CuteFTP, men principperne er de samme uanset hvilken løsning, man anvender. - Side 4 -

5 Ændring af rettigheder Som det fremgår af Readme_xx.txt, skal man have sat rettighederne således 1 : Folderne administration administration/db_backups images/ images/articles/ images/avatars/ images/news/ images/photoalbum/ forum/attachments/ Skal alle sættes til 777. Og koden 777 betyder her, at alle disse foldere skal have denne profil: 1 Hvis installationen sker på en Windows-server skal man normalt ikke sætte disse rettigheder op. Kontakt din udbyder, hvis du kører på en Windows server. - Side 5 -

6 Dvs. at koden 777 betyder, at ejer, gruppe og anonym bruger alle både kan læse (read), skrive (write) og udføre (execute). Samme rettighedsprofil skal man sætte på filen config.php, som ligger i rodfolderen. Dette skal man gøre for at gøre det muligt for installationsprogrammet at ændre oplysninger i filen. Når installationen er færdig, skal man så huske at gøre to ting. For det første skal man slette filen setup.php. Hvis man ikke gør det, så får man en advarsel, indtil filen er slettet. For det andet skal man sætte rettighederne på config.php tilbage til 644 (for at forhindre udefra kommende i at ændre den). Koden 644 svarer til nedenstående: Nu er man så klar til at installere PHP-Fusion. Selve installationen Man starter processen ved at åbne sin browser og skrive adressen på det site, som man er ved at oprette. Når man gør det, får man nedenstående skærmbillede frem: - Side 6 -

7 Her vælger du som det første, hvilket sprog dialogen skal foregå i. Her vælger vi Danish. Og trykker derefter på next. Hvorefter man får dette skærmbillede frem: - Side 7 -

8 Som det fremgår, kontrollerer installationsprogrammet her, at alle tilladelser er sat korrekt og at PHP-versionen er den rigtige. Hvis du ser meddelelsen Rettigheder til skrivning står korrekt, så betyder det, at alt er som det skal være. Får du en fejl her, skal du ændre rettighederne og begynde installationen forfra. Her udfylder man så også de åbne felter i formularen som det er vist i eksemplet herefter: I dette skærmbillede skal man fortælle systemet en række ting, som er nødvendige for at få alting til at virke. Navnet på databaseværten (her: localhost) har man fået opgivet hos sin leverandør det samme er tilfældet med databasens brugernavn (her: root) og password til databasen (her: vist som en række prikker). I nogle tilfælde kan man selv få lov til at bestemme navnet på sin database, men i andre tilfælde er det også noget, man får oplyst af leverandøren. Det, der står i det sidste felt, er det præfiks (det fornavn) som ens tabeller får i databasen. Har man ikke specielle præferencer her, er der ingen grund til at ændre i det, som systemet foreslår. Når man er færdig med at fylde oplysninger i, trykker man også her på næste. Og får derefter dette skærmbillede frem: - Side 8 -

9 Alle informationer er skrevet ind i config.php nu, og her skal man så oprette en superadministrator på sin side. Dette gør man ved at indskrive et brugernavn og et kodeord (som skal gentages) og en mailadresse f. eks. sådan her: Nu er alle tabeller oprettet, og systemet principielt set klar til brug. Hvilket man kan se, når man trykker på Næste og får dette skærmbillede frem: - Side 9 -

10 Og når du har gjort det, trykker du næste en sidste gang, hvorefter du får dette frem på din skærm: Som det fremgår, er din side nu installeret og klar til brug. - Side 10 -

11 Opgradering fra tidligere versioner Har du installeret PHP-Fusion før og blot ønsker at opgradere til en ny version, så følg instruktionerne herunder. Som noget nyt rummer PHP-Fusion version 6.0 opgraderingsrutiner således at du kan opgradere til version 6.0 både fra version 4.01, fra version 5.0 og fra version De tre forskellige opgraderingsforløb beskrives hver for sig i det efterfølgende. Men uanset hvilken version, du opgraderer fra, så er der nogle simple regler, som man gør sig selv en stor tjeneste ved at følge. Sikkerhedskopier din database og alle filer på din eksisterende side før opgraderingen Slå alle elementer fra, som ikke er en del af standarden i PHP Fusion Fjern alle Infusions (version 5.0 og version 5.01), som du har lagt på din side Opgradering fra version 4.01 Før du opgraderer anbefaler vi meget kraftigt, at du laver en sikkerhedskopi af alle filer på din side og af databasen. 1. Slå alle elementer fra, som ikke er standard - dvs. alle med undtagelse af: - Navigation - Online Users - Forum Threads - Latest Articles - Welcome Message - Forum Threads List - User Info - Members Poll - Shoutbox 2. Upload filen config.php fra folderen php til din server. Du gør dig selv en tjeneste ved, ved samme lejlighed at slette filen fra den folder, du uploader fra. For at du ikke skal komme til at overskrive config.php, når du senere (efter databaseopgraderingen) skal uploade alle filerne fra folderen til din server. 3. Upload filen upgrade.php fra folderen "upgrade v4.01" til folderen fusion_admin på din server. 4. CHMOD filen config.php til Log ind på din side som Super Administrator og vælg Opgradering fra administrationssiden. 6. Gennemgå de enkelte trin i opgraderingsprocessen, indtil du ser meddelelsen "Database upgrade complete". 7. Kopier (eller flyt) folderen avatars fra folderen fusion_public til folderen fusion_images. 8. Slet derefter følgende foldere fra din server: - fusion_admin - fusion_core - fusion_forum - fusion_languages - fusion_panels - Side 11 -

12 - fusion_public/avatars - fusion_themes 9. Omdøb følgende foldere: - fusion_images til images - fusion_public til forum 10. Upload alle filerne fra folderen php-files til din server (altså minus filen config.php) 11. CHMOD filen config.php tilbage til Sørg for at alle nedenstående foldere er CHMOD'et til 777: - administration/db_backups/ - images/ - images/articles/ - images/avatars/ - images/news/ - images/photoalbum/ - forum/attachments/ HUSK: Hvis du også har uploadet filen setup.php til serveren, skal du lige huske at slette den, før du går videre. Er filen ikke slettet vil du få en melding om det på din side. Du kan muligvis også få lidt problemer med sproget på administrationssiden (engelske tekster). Dette problem kan du løse ved først at skifte til engelsk sprog og derefter skifte tilbage til dansk. Opgradering fra version 5.0 eller version 5.01 Før du opgraderer, anbefaler vi meget kraftigt, at du laver en sikkerhedskopi af alle filer på din side og af databasen. 1. Afinstaller alle Infusioner fra administrationssiden. 2. Slå alle elementer fra, som ikke er standard - dvs. alle med undtagelse af: - Navigation - Online Users - Forum Threads - Latest Articles - Welcome Message - Forum Threads List - User Info - Members Poll - Shoutbox 3. Upload filen config.php fra folderen php-files til din server. Du gør dig selv en tjeneste ved, ved samme lejlighed at slette filen fra den folder, du uploader fra. For at du ikke skal komme til at overskrive config.php, når du senere (efter databaseopgraderingen) skal uploade alle filerne fra folderen til din server. 4. Upload filen upgrade.php fra folderen "upgrade v5.01" eller folderen upgrade v5.0 (afhængigt af hvilken version du kører aktuelt) til folderen fusion_admin på din server. 5. CHMOD filen config.php til Log ind på din side som Super Administrator og vælg Opgradering fra administrationssiden. - Side 12 -

13 7. Gennemgå de enkelte trin i opgraderingsprocessen, indtil du ser meddelelsen "Database upgrade complete". 8. Flyt (eller kopier) folderen avatars under fusion_public til folderen fusion_images. 9. Slet derefter følgende foldere fra din server: - fusion_admin - fusion_includes - fusion_infusions - fusion_forum - fusion_languages - fusion_themes 10. Omdøb følgende foldere: - fusion_images --> images - fusion_public --> forum 11. Upload alle filerne fra folderen php-files til din server. 12. CHMOD filen config.php tilbage til Sørg for at alle nedenstående foldere er CHMOD'et til 777: - administration/db_backups/ - images/ - images/articles/ - images/avatars/ - images/news/ - images/photoalbum/ - forum/attachments/ HUSK: Hvis du også har uploadet filen setup.php til serveren, skal du lige huske at slette den, før du går videre. Er filen ikke slettet vil du få en melding om det på din side. Du kan muligvis også få lidt problemer med sproget på administrationssiden (engelske tekster). Dette problem kan du løse ved først at skifte til engelsk sprog og derefter skifte tilbage til dansk. - Side 13 -

14 Sideopsætning Begreber og struktur på siden Før vi går i gang med at gennemgå opsætningen af en PHP-Fusion side, skal vi lige have nogle helt fundamentale begreber og referencer på plads. Og det gør vi ved hjælp af nedenstående illustration: Dette er sidens toplogo. Det er en jpg- eller gif-fil, der gerne skulle passe til sidens tema og som er med til at præsentere din side. Så tænk over, hvad du anbringer der. Topmenuen eller menubjælken her får dine brugere de helt overordnede menuvalg, som gør det muligt for brugerne at navigere rundt på din side. Navigationspanelet eller navigationselementet. Her kan du gentage elementerne i menubjælken og du kan supplere dem med andre, mere specifikke ting, som du vil stille til rådighed for brugerne. Velkomstteksten, som byder dine brugere velkommen til siden. Denne velkomsttekst behøver du ikke at vise. Indlogningselementet hvor de registrerede brugere (og du selv) logger på siden. - Side 14 -

15 6 Replikboksen en simpel facilitet til udveksling af korte tekstbeskeder mellem brugerne af siden. 7 8 Bundteksten eller sidefoden fast format men kan rumme visse oplysninger antal unikke brugere f. eks. men også andre ting. Brugerinformationspanelet hvor brugerne kan se, hvor mange registrerede brugere en side har hvem der er den nyeste bruger og hvor mange brugere respektive gæster, som for øjeblikket er online. Dette er de helt fundamentale begreber, som du har brug for til at finde rundt i din PHP- Fusion side. Og som vi bruger videre fremme i denne håndbog. Administrationssiderne Når man ser sin nye PHP-Fusion-side for første gang, så står den med standardopsætningen. Og det betyder selvfølgelig, at der er en lang række ting, man skal have ændret. I dette afsnit skal vi se på opsætning via sideopsætning, temavalg, ændring af datovisning og tilpasning af panelet navigation. Størsteparten af tilpasningerne sker via den administrationsside, som du kommer ind på ved at logge dig på din side og trykke på linket Administrationsside. Administrationssiden ser sådan her ud, første gang du ser den: Som du kan se, så består siden af tre hovedsektioner indholdsadministration, brugeradministration og systemadministration. Og før vi går i gang med tilpasningen skal du lige have en oversigt over, hvad man kan finde af funktioner på denne administrationsside. Den følger herunder: - Side 15 -

16 Indholdsadministration Her kan du oprette brugerafstemninger, som dine brugere kan deltage i. Her opsætter man kategorier, som bruges til at strukturere de tekster, man stiller til rådighed for sine brugere. Artikler alle slags tekster, som du ønsker at dele med brugerne på din side. Her uploader du og ser billeder, som du kan bruge som illustration i tekster nyheder og artikler. Brugeroprettede sider ikke artikler. Sider som du opretter til specielle formål f. eks. kan disse sider indeholde PHP-kode. Debatforum alle opsætninger vedrørende det indbyggede debatmodul. Downloadkategorier bruges på samme måde som artikelkategorierne. Og du er nødt til at have oprettet mindst en kategori før du kan oprette downloads. Downloads adresser og beskrivelser af de filer, som du lægger op på din side, således at brugerne kan downloade dem. Frequently Asked Questions ofte stillede spørgsmål som du stiller til rådighed som en service for dine gæster. Her kan du oprette fotoalbums og tilføje billeder til dem. Ligesom ved artikler og downloads, så skal du oprette mindst en kategori før du kan føje links til din linksamling. Links tilføjes her. Her skriver du de nyheder, som dine brugere kan læse på siden. Eller du redigerer eller sletter gamle nyheder. - Side 16 -

17 Brugeradministration Systemadministration Her kan du oprette administratorer på din side ud fra en liste over registrerede brugere. Og du kan give dem rettigheder i forhold til sidens elementer. Administrer de registrerede brugere på din side tilføj nye brugere slet brugere - lav om på brugeroplysninger eller udeluk kendte brugere. Brugerne kan stille forslag til indhold på din side, både link, artikler eller nyheder. Her kan du administrere disse forslag se dem, acceptere dem eller slette dem. Her kan du oprette eller redigere brugergrupper, der kan anvendes til at regulere adgangen til bestemte dele af din side. Herfra kan du administrere replikkerne i replikboksen blandt andet kan du redigere eller slette replikker. Udeluk medlemmer fra oprettelse på din side enten ved at udelukke domænenavne eller IP-adresser. Overskriften siger næsten det hele tids- og datoformater, som anvendes rundt omkring på siden. Her opsætter du de helt generelle værdier omkring debatten på din side hvor mange indlæg som skal vises pr. side om det skal være tilladt at tilknytte filer og så videre. Diverse opsætninger blandt andet af ordcensur, antal replikker i boksen. Men det er også her du slår vedligeholdelse til eller fra. Administration af elementer på din side. Alle hovedindstillingerne omkring fotoalbums finder du her. Hovedindstillingerne for din side valg af tema, sprog, navn og så videre. Her installerer du nye infusioner eller afinstallerer de gamle. Interne links de links som findes i dit navigationspanel og i menulinjen øverst på din side. - Side 17 -

18 Når en opgradering er tilgængelig så er det her, du skal udføre den. Systeminformation klik her for at se oplysninger om din servers konfiguration. Opsætning af det indbyggede system til administration af Private Beskeder. Her bestemmer du f. eks. grænserne for, hvor mange beskeder der må være i folks indbakker og arkiv. Skal du lave en sikkerhedskopi af databasen på din side, så er det her det sker. Indstillinger vedrørende registrering på din side skal der bruges mailbekræftelse skal tilmelding i det hele taget være åben skal der en administratorgodkendelse af brugere til, før kontoen kan åbnes. - Side 18 -

19 Sideopsætning De grundlæggende opsætninger for ens site foretages fra administrationssiden / administrationspanelet, som man finder ved først at logge sig på som superadministrator og derefter trykke på linket Administrationsside (øverste højre hjørne). Når man gør det, skal man vælge Systemadministration og Hovedindstillinger, hvorefter man får dette skærmbillede frem: I en række sektioner (der kan åbnes og lukkes med et tryk på pil-ikonerne) kan du her bestemme, hvordan din side i hovedtrækkene tager sig ud. Lad os ganske enkelt begynde fra toppen. - Side 19 -

20 Hovedindstillinger Siden skal selvfølgelig have et navn. Navnet viser sig øverst i browseren (i den blå ramme) og du kan naturligvis kalde din side, hvad du vil. Her kalder vi siden for PHP-Fusion : Håndbog til version 6.0. Siden skal også have en adresse (oplysningen skal bruges af forskellige tilføjelser, så det er fornuftigt nok at angive den korrekt). Her er sideadressen: Nu skal man så overveje, om ens side skal have sit helt eget banner. Et banner er en grafikfil i gif eller jpg format, der vises øverst på alle enkeltsider. Jeg har her lavet et banner til håndbogs-sitet, som jeg har kaldt haandbog.gif, og navnet på det skriver jeg ind i det tilsvarende felt (efter at jeg har anbragt grafikfilen i folderen images). Husk at bredden på dit banner er med til at bestemme, hvor bred din side kommer til at være i dine gæsters browser. Du skal også lige rette mail-adressen, så den passer (det er den, der bliver sendt mails til, når den indbyggede mailfunktion i PHP-Fusion anvendes) Kaldenavnet behøver du ikke at ændre. Velkomstteksten behøver du ikke udfylde. Men skriver du noget her, så vil det blive vist øverst på din første side som en velkomst til dine gæster. Og introduktion og nøgleord skal du kun udfylde af hensyn til de søgetjenester, som gerne skulle være i stand til at finde og præsentere din side. Skriv kort og forklarende om siden under introduktionen og skriv alle relevante nøgleord i dette felt husk at nøgleord skal være adskilt med et komma. Endelig kan du angive en copyright den vises nederst på alle dine sider. Det sidste, man kan gøre i denne sektion af sideindstillingerne er at vælge sit tema. Det handler næste afsnit om. Valg af tema, ændring af temafil PHP-Fusion leveres med en række standardtemaer dvs. kombinationer af farvevalg, baggrundsvalg, skrifttypevalg og så videre, som du kan vælge frit imellem. Nogle eksempler er vist herunder: - Side 20 -

21 Figur 1: Fusion3 Figur 2: Laguna - Side 21 -

22 Figur 3: Simplicity Der er en del flere forsøg dig frem for at finde det tema, som passer bedst til dig og din side. Længere fremme i håndbogen her får du nogle tips til, hvordan du kan tilpasse et tema (ændre farver med videre). Men hvis du ikke har lyst til selv at lave den slags tilpasninger, så besøg en af PHP-Fusions støttesider. Der kan man downloade en del ekstra temaer, og der kommer hele tiden flere til. I håndbogen her vælger vi temaet Journal, som bruges i alle illustrationer fremover. Med dette tema valgt og de indstillinger, vi foreløbig har valgt for håndbogssiden, kommer siden altså til at se sådan her ud: Figur 4: Forside efter de første tilpasninger - Side 22 -

23 Hvilke valgmuligheder, der bliver vist i henholdsvis topmenuen (den lysegrå bjælke her) og i navigationsafsnittet bestemmes inde fra administrationssiden via menupunktet Interne links, som vi ser på senere. Vi skal også under kodetilpasning senere kigge lidt nærmere på et par eksempler, hvor vi går ind og ændrer koden i den tema-fil, som er valgt. Indstillinger for dato og klokkeslæt Skærmbilledet for opsætning af dato og klokkeslæt (som bruges rundt omkring i systemet og som vælges fra administrationssiden - systemadministration) ser sådan her ud: Anvendelsen af de enkelte datoformater fremgår af nedenstående tabel: Dataformatets betegnelse Anvendes i: Kort datoformat Replikboks Langt datoformat Nyheder, Artikler, Gæstebog Datoformat i debatmodul Debatten Datoformat i menulinjen Bruges i den menulinje, som står i toppen af alle ens sider Forklaring på datokoderne: %d dagens nummer i måneden (f. eks. 6 for 6. juni) %m månedens nummer i året (f. eks 6 for juni) %y to sidste cifre i årstallet (f. eks. 05 for 2005) %A dagens navn efter den valgte landekode (f. eks. mandag) %H: - timedelen i klokkeslæt (f. eks 15 for timedelen af 15:45) %M minutdelen i klokkeslæt (f. eks. 45 for minutdelen i 15:45) %Y årstallet med 4 cifre (f. eks. 2005) %M kort repræsentation af månedsnavnet (3 positioner) (f. eks. jun for juni) %S dagens navn i kort form (tre positioner) (f. eks. man for mandag) Du kan læse mere om de koder, man kan bruge på adressen: - Side 23 -

24 I PHP-Fusion version 6.0 har du i modsætning til tidligere mulighed for at vælge mellem en række prædefinerede datoformater, som kommer frem, hvis man åbner drop-down-menuerne, sådan her: Her vælger man det format, som man foretrækker, hvorefter man indsætter formatet i indsætningsfeltet nedenunder ved at trykke på knappen >>. I forbindelse med manualen her, ændrer vi koderne således: Formatnavn Format Resultat Kort datoformat d. %d.%m.%y %H:%M Langt datoformat <br>%d %B %Y Datoformat i debatmodul %d-%m-%y Datoformat i menulinje %A d. %d %B %Y Bemærk, at man sagtens kan indskrive tekststumper eller html-tags ind i datoformatet. Indstillinger for debat Skærmbilledet for opsætning af debatværdier (vælg systemadministration + debatopsætning) ser sådan her ud: - Side 24 -

25 Øverst vælger man, hvor mange debatemner, som skal vises i elementet sidst aktive debatemner (elementet kan vises i en af kolonnerne på forsiden). Derunder bestemmer man, om man vil tillade brugerne at tilknytte filer og i de to linjer derunder fastlægger man, hvilke filtyper, som må tilknyttes og hvor store filerne maksimalt må være. Den sidste linje er ikke en egentlig indstilling, men en facilitet til at trimme debatten. Vælger man et antal dage her (120 eller mindre) og trykker på knappen Tilpas, vil alle debatindlæg, som er ældre end det angivne blive fjernet. Brug denne knap med eftertanke. Tilmeldingsindstillinger Skærmbilledet for opsætning af tilmeldingsindstillinger (vælg systemadministration + tilmeldingsopsætning) ser sådan her ud: Her skal du først og fremmest beslutte dig for, om det skal være muligt at tilmelde sig som medlem på din side. Må man det, skal der stå ja i det første felt må man ikke skal der stå nej. Hvis tilmelding er mulig, skal du derefter beslutte dig for, om der skal bruges mail til godkendelse. Svarer du ja her, så vil systemet afsende en bekræftelsesmail til den nye bruger, som han eller hun først skal svare på (ved at trykke på et link i mailen), før medlemskabet - Side 25 -

26 aktiveres. Det kan være en god ide at bruge denne facilitet, fordi man på den måde får en garanti for, at den mail-adresse, som brugeren opgiver, faktisk eksisterer. I næste linje skal du beslutte dig for, om et medlemskab først bliver aktiveret, når en administrator har godkendt det. I næstsidste linje skal du tage stilling til, om sikkerhedskoden skal vises. Sikkerhedskoden er indbygget i systemet for at gøre det sværere for hackere at misbruge din side, så vi vil anbefale, at du bruger den. Skulle der ikke være understøttelse af billedfunktionen i forbindelse med sikkerhedskoden på din server, kan du slå billedfunktionen fra i den nederste linje. Endelig skal du beslutte, i hvilket format sikkerhedskoden skal vises dvs. om det skal være i form af et billede eller som tekst. Det mest sikre er at bruge grafikvisningen, men grafikvisningen kræver, at der er understøttelse af GD2 på din server. Hvis der ikke er det, kan du vælge tekstvisning. Fotogalleri indstillinger Skærmbilledet for opsætning af fotogalleri eller fotoalbum (det indbyggede album), ser sådan her ud: I dette afsnit fastlægger du, hvordan det indbyggede fotoalbum skal sættes op. 1: Her fastlægges størrelsen af de miniaturer, som de enkelte albums repræsenteres af. 2: Her fastsættes miniaturestørrelsen for de enkelte billeder i det enkelte album. I begge tilfælde angives størrelsen som bredde x højde målt i pixels. - Side 26 -

27 3: Valg af kompressionsmetode (GD1 eller GD2) er med for at tage hensyn til opsætningerne på den server, hvor din side afvikles. Det bedste er GD2 (bedste billedkvalitet). Men hvis din server ikke understøtter det, så vælg GD1. 4: Vælg om brugere skal have lov til at kommentere billederne. 5 og 6: Vælg hvor mange albums som skal vises pr række og hvor mange albums som skal vises pr side. Og så videre nedad. 10: Og endelig skal det besluttes, hvor store billederne maksimalt må være (tænk i den forbindelse på designet af din side) og hvor store billedfilerne må være målt i bytes. I den aktuelle version understøtter det indbyggede fotoalbum kun billeder i jpg-format. Gifbilleder kan derfor ikke anvendes og ikke vises. Private beskeder Der er indbygget en funktion i PHP-Fusion, som gør det muligt for registrerede brugere at sende små private beskeder til hinanden lidt ligesom mails men uden at bruge mailserveren. Denne funktion kan man også opsætte via administrationssidens sektion for systemadministration. Vælger man Private beskeder herfra, får man dette frem på sin skærm: De tre øverste indstillinger regulerer, hvor mange beskeder ens brugere må have liggende i henholdsvis indbakken, udbakken og arkivet. I eksemplet her står standardværdierne (20). Men ønsker du f. eks. at give brugerne ret til at have et ubegrænset antal beskeder liggende, skal du bare skrive et 0 i de tre felter. - Side 27 -

28 I linjerne nedenunder opsætter man standarden på siden for, om der skal sendes en mail til brugerne, hver gang der kommer en ny besked og for, om afsendte beskeder skal gemmes i brugernes udbakke. Som der står i noten på skærmen, så kan brugeren selv ændre de to sidste værdier. Men gør brugeren ikke det (via de valgmuligheder, som stilles til rådighed se senere), så er det dine standardværdier, som slår igennem. Du skal tænke over, når du træffer dine valg her, at disse beskeder fylder i databasen. Hvis du har mange brugere, der skriver mange beskeder, så er det måske en god ide at lave nogle begrænsninger, hvis du har begrænset databasekapacitet. Selve anvendelsen af beskedfunktionen vender vi tilbage til senere i denne håndbog. Diverse indstillinger Den sidste sektion i sideindstillingen ser sådan her ud i udfoldet tilstand: Her er samlet en del ting, som ikke rigtigt passer ind andre steder. PHP-Fusion har indbygget en funktion til at filtrere uønskede ord fra overalt på siden (replikbokse, debat osv.). Så hvis der er ord eller udtryk, som du ikke ønsker at se på din side (af den ene eller den anden årsag), så kan du angive disse ord i den øverste boks et ord pr. linje. Og i indstilling to skrive, hvad de bortcensurerede ord skal erstattes med. Ønsker du så at slå denne censur-funktion til eller fra, så gør du det i linje 1 her. I linje 3 kan du give gæster (altså ikke-medlemmer) lov til at skrive replikker eller udelukke dem fra det og i linjen derunder fastlægger du, hvor mange replikker, som skal vises på forsiden. - Side 28 -

29 Endelig er der to funktioner nederst, som du kan bruge, når du skal vedligeholde din side. Hvis vedligeholdelsestilstand er slået til, vil den meddelelse, som du har indskrevet i tekstfeltet, blive vist i stedet for selve siden. Og samtidig er det kun administratorer, som kan logge sig ind på siden. En god ting at have, når man er i gang med større ændringer. - Side 29 -

30 Panelet navigation Navigationspanelet på en PHP-Fusion side styres fra administrationssiden. Hvis du åbner det, skal du kigge efter teksten interne links under Systemadministration Og trykker man på dette link, får man dette her frem på sin skærm: Som det fremgår, så er listen herover ordnet i samme rækkefølge som linkene under overskriften Navigation på forsiden. Og ud for hvert af linkene får man at vide, hvad linkets navn er (overskriften), hvilke grupper (se senere i håndbogen), som skal kunne se dette link og hvilket nummer i rækkefølgen, linket har. I toppen af menuen kan man tilføje nye links eller revidere de eksisterende. Og her kan man også beslutte, om det pågældende link skal vises i navigationspanelet i topmenuen eller begge steder. Udover at skrive regulære links ind, kan man også her lægge streger eller underoverskrifter ind. Hvis vi nu forestiller os, at vi ønsker at dele navigationspanelet op i tre sektioner med hver sin overskrift, så gør vi det ved at skrive links ind, der ser sådan her ud: - Side 30 -

31 Når man gemmer dette interne link (og to mere lidt længere nede), kommer navigationspanelet til at se sådan her ud: Ønsker man blot at adskille sektionerne med streger, skriver man i stedet et link ind, som ser sådan her ud: Ændringer i filen theme.php I PHP-Fusion v. 6.0 er der ikke som i tidligere versioner grund til at rette så meget. Det meste af indholdet kan nu styres fra administrationssiden. Men der er en enkelt ting, som man som dansk bruger godt kan ændre udelukkende for at få sin dato vist i et rigtigt format på forsiden. Og desuden er det stadigvæk i theme.php - Side 31 -

32 (svarende til det tema, du har valgt), du skal rette til for at få den rigtige sidebredde og de rigtige kolonnebredder til dit design. Lad os tage det med datoen først. Åbner man filen theme.php med en PHP-editor eller med en simpel teksteditor (f. eks. Notepad), så ser den øverste del af filen sådan her ud (det valgte tema er Journal): For at rette sidebredden til skal vi have fat i udtrykket $theme_width = 100% ; og rette det til $theme_width = 850 ; - i eksemplet fordi topgrafikken er 850 pixels bred. Derefter springer vi ned til linje 68, hvor der står: For at få den danske dato til at stå korrekt skal vi her rette udtrykket: ucwords(showdate($settings[ subheaderdate ] sådan at der i stedet kommer til at stå: ucfirst(showdate($settings[ subheaderdate ] - Side 32 -

33 Når vi gør det, kommer forsiden af vores testside til at se sådan her ud: Som det fremgår passer sidebredden nu til topgrafikken og datoen i den øverste menubjælke står rigtigt (forudsætningen er dog, at du også har rettet datoudtrykket under opsætning af dato og klokkeslæt som beskrevet tidligere her). Der kan godt være problemer med at få den dato rettet til om opskriften her virker, afhænger af, hvordan dato og tid håndteres på den server, som ens side ligger på. Men får du problemer, så henvend dig eventuelt til udbyderen og spørg ham, hvordan du skal forholde dig. Det hele hænger nemlig i sidste ende på, hvordan serveren leverer datoen. Resten er egentlig bare en formatering af dette (UNIX)datestamp. Men hvis datoen i menulinjen står forkert (uanset hvad man retter), så står datoer på nyheder og debatindlæg osv. sikkert også forkert. Og hvis det er tilfældet, så skal du opfordre din udbyder til at få rettet dato og klokkeslæt på serveren. Ellers - kan man eksperimentere en smule med datoopsætningen i filen global.php under locale\danish. Standardopsætningen er sådan her: - Side 33 -

34 Og som det fremgår, så er den beregnet på en UNIX-server. Hvis man har sin side liggende på en Windows-server, skal man udkommentere UNIX-indstillingen og i stedet bruge den Windows-indstilling, som man får opgivet hos sin leverandør. Nogle gange kan det hjælpe, at skifte LC_ALL ud med LC_TIME (i UNIX-indstillingen). Og andre gange kan det hjælpe at skifte "da" / DK ud med "danish" / DANISH sådan her: Man kan se mere om setlocale her: Og man kan se mere om landeforkortelserne her: Nu er den helt grundlæggende opsætning på plads, og så kan man egentlig godt begynde at lægge nyheder, artikler og links ind på sin side. Flere detaljer i opsætningen (dato-formater, debat osv.) vender vi tilbage til senere. Men først kigger vi på lidt nærmere på gruppe- og rolledefinitioner, og på hvad de betyder for adgangen til at redigere og se indhold på siden. - Side 34 -

35 Gruppedefinitioner og rettigheder PHP-Fusion arbejder med 3 niveauer af brugere nemlig administratorer, registrerede brugere og gæster de faste roller. Men derudover kan administratorerne have meget forskellige rettighedsprofiler, således at man i realiteten kan lave lige så mange rettighedsprofiler, som man har brug for. Og endelig arbejder PHP-Fusion version 6.0 med brugergrupper og ordstyrere (moderatorer). Dette afsnit handler om denne rettighedsstyring. Administratorer Mens medlemmernes rettigheder er temmelig fast definerede, kan man i PHP-Fusion version 6.0 sætte administratorernes rettigheder helt frit. Den superadministrator, som oprettes automatisk i forbindelse med installationen, har naturligvis adgang til at opsætte og rette på alle områder. Men efterfølgende administratorer sætter man rettigheder for via administrationssiden (brugeradministration + administratorer). Vælger du her Administratorer, får du dette skærmbillede frem (under forudsætning af, at der er mere end et medlem på siden): Herfra kan man nu vælge andre medlemmer ud i eksemplet her vælges testbrugeren Haandbog. Hvorefter man får dette skærmbillede frem: Som det fremgår, er den nye administrator (medmindre man har valgt at krydse af i feltet Giv ny administrator alle rettigheder ) oprettet uden nogen rettigheder. - Side 35 -

36 For at give administratoren de rettigheder, som man har tænkt sig, skal man her vælge Rediger ud for den nye administrator, hvorefter man får dette frem på sin skærm: Som du kan se, så svarer afkrydsningsmulighederne til de administrative hovedgrupper (administrationspanelet). Og du tildeler rettigheder for den nye administrator ved at krydse de administrative funktioner af, som den pågældende skal have adgang til. For eksempel sådan her: - Side 36 -

37 Afslut rettighedstildelingen ved at trykke på knappen Opdater administrator. Når rettighedsprofilen er gemt, kommer listen over administratorerne til at se sådan her ud: - Side 37 -

38 Som du kan se, har hvert af områderne sin egen nøgle (eller key). Hvis du vil se, hvilke nøgler, som svarer til hvilket område, kan du åbne tabellen admin i din database, hvor listens værdier kan læses. Listen ser således ud: - Side 38 -

39 Når den nye administrator så åbner siden og går til administrationspanelet, får han eller hun adgang til de områder, som du har angivet i profilen, således som det fremgår af nedenstående illustration: Du kan på et hvilket som helst tidspunkt vælge at fjerne rettigheder fra eller tilføje nye rettigheder til eksisterende administratorer. Ordstyrere Ordstyrerbegrebet er naturligt nok kun relevant i forhold til debatfunktionen. Og her er ordstyrerne karakteriserede ved at have en række muligheder, som det almindelige medlem ikke har. Hvilke muligheder, en ordstyrer har, fremgår af nedenstående illustration: - Side 39 -

40 Ordstyreren kan opfriske emnet dvs. få gendannet listen over indlæg, således at alle de nyeste indlæg kan ses af alle. Ordstyreren kan slette emnet dvs. fjerne et debatemne helt fra det pågældende tema. Ordstyreren kan låse emnet dvs. lukke emnet for yderligere indlæg. Ordstyreren kan vælge at låse et bestemt emne fast i toppen af listen, således at det ikke rykker ned i listen, efterhånden som der starter nye debatter. Og endelig kan ordstyreren flytte emnet fra et tema eller en debat til en anden. Ordstyrere og administratorer kan være identiske grupper. Men de behøver ikke at være det. Og ordstyreren for et tema eller en debat behøver heller ikke at være de samme som for andre debatter. Det kan man helt selv bestemme som administrator på siden hvis man ellers har ret til at oprette nye temaer og debatter. Man tildeler ordstyrere til de enkelte debatter ved at vælge rediger fra den liste, som man kan se på illustrationen herunder (vælg indholdsadministration + debat for at få den frem): Vælger man rediger her, får man dette frem på sin skærm: - Side 40 -

41 Fra den liste over samtlige brugere / medlemmer, som står i venstre side af skærmen kan man markere de medlemmer, man ønsker at tildele ordstyrerfunktionen. Og man kan afslutte processen ved at trykke på knappen Gem ordstyrere. Når der så er oprettet ordstyrere på de enkelte debatter, så vil det fremgå af debatoversigten, således som man kan se det af den denne illustration: - Side 41 -

42 Brugergrupper Den tredje og sidste del af rettigheds- og adgangsstyringen er brugergrupperne. Brugergrupper er et begreb som blev indført i PHP-Fusion version Og brugergrupperne der kan sammensættes helt frit og efter ens eget behov kan anvendes til at styre adgangen til debatemner, nyheder, brugerdefinerede sider og interne links. Man opretter en ny brugergruppe ved at vælge menupunktet brugergrupper fra administrationspanelet (brugeradministration + brugergrupper): Første gang man gør det, får man dette frem på sin skærm: Her opretter man den nye brugergruppe ved at give den et navn og lave en kort beskrivelse af den f. eks. således: Når man har trykket på gem gruppen, og åbner brugergrupper igen, kommer ens skærm til at se sådan her ud: Vælger man herefter Rediger i den øverste del af skærmbilledet, får man dette frem på sin skærm: - Side 42 -

43 Fra dette skærmbillede kan man nu vælge at tilknytte udvalgte brugere (her er der ikke så mange at vælge imellem) eller at tilføje alle brugere. Vi vælger for eksemplets skyld at tilknytte de to brugere / medlemmer, som er oprettet her og at gemme de valgte brugere. Nu er brugergruppen så oprettet. Vender man herefter tilbage til debatadministration, og opretter et nyt emne, så kan man anvende sin brugergruppe til at regulere adgangen både til at se og til at deltage i debatten, som det fremgår af den næste illustration: - Side 43 -

44 Som det fremgår, optræder gruppen nu på valglisten både under hvem der skal kunne se debatten og under, hvem som skal have lov til at deltage i den. På samme måde kan man vælge at begrænse adgangen til interne links. Det ser sådan her ud: Det samme gælder nyhederne: - Side 44 -

45 Som noget nyt i PHP-Fusion kan man nu også anvende brugergrupper til at styre adgangen til artikelkategorier (dog ikke enkelte artikler) og downloadkategorier. Det vil sige, at man kan oprette sektioner af tekster og sektioner af downloads, som man skal være medlem af en bestemt brugergruppe, for at få adgang til. For downloadkategoriens vedkommende ser det sådan her ud: - Side 45 -

46 Og for artikelkategoriernes vedkommende sådan her: Endelig kan man nu også bruge grupper til at styre adgangen til brugeroprettede sider (se mere om dem senere). - Side 46 -

47 Artikler Artikler er alle former for større tekster, som du ønsker at vise på din side. Det kan være opskrifter, anmeldelser, vejledninger og meget mere. Før man begynder at lægge artikler ind på sin side, skal man have lavet et sæt af kategorier, som man benytter til at strukturere artiklerne med. Du begynder med at gå tilbage til administrationssiden og her (fra indholdsadministration) vælge artikelkategorier, hvorefter du får dette skærmbillede frem: Her opretter man en kategori ved at give kategorien et navn, ved at lave en beskrivelse af kategorien (en kort introduktion til den) og ved at trykke på Gem kategorien. Opretter vi her to kategorier (Vejledninger og Forklaringer), så kommer det til at se sådan her ud: De to kategorier er nu oprettet og her fra administrationssiden kan man derefter enten tilføje nye kategorier eller slette kategorier, man allerede har lavet. - Side 47 -

48 Du skal bare være opmærksom på, at systemet ikke accepterer sletning af kategorier, hvis der er knyttet artikler til dem. Ønsker du altså at slette en kategori, skal du først slette eller flytte alle de artikler, som er knyttet til den. Lad os så gå videre til artikel-faciliteten og oprette den første artikel. Det gør man ved fra administrationssiden at vælge artikler, hvorefter man får dette skærmbillede frem: Det man ser på skærmen er den indbyggede editor i PHP-Fusion. Der er engelske forkortelser på de små knapper, men de er dels til at ændre i koden dels er de egentlig relativt nemme at forstå (på PHPFusion.dk kan du finde en opskrift på, hvordan man integrerer en mere avanceret WYSIWIG-editor i PHP-Fusion, men det bruger vi ikke tid og plads på her). Der er ikke mange ben i at skrive selve artiklen. Man skal bare huske på, at rubrikteksten kun vises i oversigten over artiklerne altså ikke når man først som bruger sidder og læser en artikel. Det kan derfor være en god ide at gentage rubrikteksten øverst i selve teksten. - Side 48 -

49 Ellers bruger man de små knapper på følgende måde: Fed skrift Kursiv Understregning Indsæt link Centrer tekst Lille tekst Mindre tekst Indsæt billede (på phpfusion.dk kan du finde en opskrift til, hvordan du integrerer en egentlig billedebrowser) Alternativ style Indsæt sideskift / ny side Knapperne fungerer på den måde, at de indsætter (html)-koder i teksten, som man så selv skal gøre færdige. Hvis vi f. eks. siger, at vi ønsker at indsætte et billede i den artikeltekst, som er indskrevet i illustrationen herunder, så trykker vi på knappen img, hvorefter der indsættes en kode i teksten, sådan her: Koden ser sådan her ud: <img src= images/articles style= margin:5px align= left > Og for at gøre den færdig, så der faktisk indsættes et billede i teksten, skal man skrive en smule til, nemlig sådan her: <img src= images/articles/nesser.jpg style= margin:5px align= left > - dvs. navnet på billedet. Man skal selvfølgelig også sørge for, at man har et billede med navnet nesser.jpg liggende i folderen images/articles. Ellers virker det ikke. - Side 49 -

50 Udover at man skal skrive billedets navn ind i koden, så kan man vælge at ændre ting i den også. Man kan øge marginbredden (skrive 8px i stedet for 5px f. eks.) eller man kan vælge at lade billedet flugte med højre side af præsentationen i stedet for venstre (ved at skrive align= right ). På principielt set samme måde fungerer de andre knapper. Prøv dig eventuelt frem. Og ønsker du inden du gemmer artiklen at se, hvordan den kommer til at tage sig ud, når en bruger ser den, så kan du benytte dig af knappen Se artikel i bunden af skærmbilledet. Så vises din artikel frem øverst på skærmen. To ting mere angående artikler. Ligeledes nederst på skærmen er der et lille afkrydsningsfelt med overskriften Automatiske linjeskift. Markerer du det, så kan du nøjes med at lave blanke linjer i din tekst, hver gang du vil have et nyt afsnit. Markerer du det ikke, så skal du selv indsætte linjeskiftkoder og det er htmlkoden <br> man skal anvende. For det andet: hvis du indskriver en meget lang tekst, kan det være en fordel at dele teksten op i flere sider. Det gør du ved at anbringe cursoren på det sted, hvor sideskiftet skal ske og derefter trykke på knappen new page. Denne knap indsætter også en kode. Koden ser sådan her ud: <--PAGEBREAK-->, og når PHP-Fusion møder den kode, så skiftes der til en ny side. I praksis fungerer det sådan, at der nederst på hver af siderne indsættes en navigationsboks, der gør det muligt for brugerne at blade rundt mellem siderne og for resten også se, hvor mange sider, en artikel består af. Vi gemmer artiklen og kigger derefter på, hvordan den præsenteres for brugerne af hjemmesiden. - Side 50 -

51 Som du kan se på illustrationen får brugeren her både mulighed for at kommentere artiklen og for at vurdere den. Og det får brugeren, fordi jeg da jeg skrev artiklen accepterede, at både kommentarer og vurdering var slået til. Det så sådan her ud: Havde jeg valgt at slå dem fra, så var de ikke blevet vist i forhold til denne artikel. Men som du kan se, så vises teksten altså frem og billedet også. Desuden placeres der et direkte link til artiklen på forsiden (under Nyeste artikler) under forudsætning af, at man har slået dette element til. Men elementstyringen kigger vi først på lidt senere. Vælger man bare at åbne Artikler, ser det sådan her ud: - og sådan her: Trykker man her på overskriften En artikel om Håkan Nesser, så bliver artiklen åbnet, så man kan læse den. - Side 51 -

52 Nyheder Et site baseret på PHP-Fusion har indbygget en nyhedsfunktion. Nyhederne laves fra administrationssiden, og de vises altid på hjemmesidens forside. Vælger man nyheder fra administrationssiden (indholdsadministration + nyheder), får man dette skærmbillede frem: Som det fremgår, så er siden struktureret på nøjagtig samme måde som den side, man bruger til at lægge artikler ind dog med nogle tilføjelser. Øverst er der et felt, hvor man kan vælge imellem de nyheder, som allerede er oprettet (med henblik på at redigere dem eller slette dem) derunder finder man den indbyggede editor med felter til en overskrift en nyhedstekst og endelig et felt til en uddybende tekst. Benytter man sig af den mulighed, vil der i præsentationen af nyheden dukke et aktivt link op med teksten læs mere, og trykker brugerne på dette link, får man vist den uddybende tekst frem. - Side 52 -

53 I bunden af skærmbilledet er der tilføjet et par mindre felter, som gør det muligt at datostyre nyhederne. Dvs. således at en nyhed først publiceres på en bestemt dato og sådan at den fjernes fra siden igen på en bestemt dato. Denne funktion skal man anvende, hvis man vil være lidt på forkant og hvis man vil være sikker på, at nyheder, som bliver uaktuelle, fjernes fra siden automatisk. Vær opmærksom på, at felterne skal tolkes sådan her: For startdato 1. juni 2005 kl og udløbsdato 1. juli 2005 kl , skal indstillingen se sådan her ud: Læg også mærke til feltet Vælg billede. Her kan du fremkalde en liste over de billeder, du på forhånd har anbragt i folderen images/news (se om billedadministration senere) og sætte et af dem ind i din nyhed både i selve nyhedsteksten og i den uddybende tekst. Og læg endelig mærke til, at man for hver enkelt nyhed kan styre adgangsrettighederne. Det sker via feltet Adgang for, hvor man dels kan vælge en af de faste brugerdefinitioner eller en brugergruppe, som man har oprettet tidligere. Vi lægger den første nyhed ind og ser så lidt på, hvordan den præsenteres på forsiden. Nyheden ser sådan her ud: - Side 53 -

54 Øverst har overskriften og under selve nyhedsteksten en boks, der rummer oplysninger om, hvem der har publiceret nyheden, hvornår det er sket, at der er mere tekst end man kan se på forsiden (Læs mere), at der indtil videre ikke er knyttet kommentarer til nyheden (0 kommentarer), at nyheden her er vist 0 gange, og endelig er det et printerikon, som man kan trykke på for at få vist siden i en printervenlig udgave. Tilsvarende ikoner føjes automatisk til alle nyheder og artikler. Trykker man på linket Læs mere, får man denne side frem: Her kan man så se den uddybende tekst og man kan bunden af siden som medlem på en side knytte kommentarer til nyheden eller afgive en vurdering under forudsætning af, at redaktøren har valgt at slå disse funktioner til på nyheden. Som det fremgår, kan man også her sætte links ind i sin kommentar, bruge fed og kursiv sætte et link ind til et billede (i linkangivelsen skal man gengive den fulde sti til billedet billedet bliver ikke uploadet) og så videre. Billedsamlingen har man som sagt også adgang til direkte fra editoren, som det fremgår af den næste illustration: - Side 54 -

55 Billedet vælges fra nyhedsfolderen i feltet til højre. Nyhederne i PHP-Fusion slettes ikke automatisk, medmindre man har angivet en udløbsdato. Og selv hvis der er lavet en udløbsdato, gemmes nyheden stadig i databasen, således at en administrator kan finde den og eventuelt aktivere den igen. Udløber en nyhed, bliver den bare ikke vist på siden mere. Men efterhånden som der kommer flere af dem, så vil de ældste blive flyttet til nye sider, som man så kan finde ved at scrolle helt ned i bunden af forsiden og trykke på navigationsboksen der. - Side 55 -

56 Downloads På en side lavet med PHP-Fusion kan man også gemme downloads dvs. filer, som ens besøgende kan hente ned til sig selv. Downloadkategorier Man skal også her begynde med at oprette en struktur til at gemme sine downloads i. Det gør man ved at vælge downloadkategorier fra indholdsadministration. Gør man det, så får man dette skærmbillede frem: En ny kategori oprettes ved at skrive et kategorinavn ind i det øverste felt, en beskrivelse af kategorien i felt nummer 2 og derefter trykke på knappen Gem kategori. Som det fremgår af illustrationen, kan man også fra dette skærmbillede redigere sine kategorier (ændre i navnet eller beskrivelsen) og slette kategorierne. Man får dog ikke lov til at slette en kategori, hvis der er downloads knyttet til den. Ønsker man at slette kategorien alligevel, skal man så først slette eller flytte de downloads, som er knyttet til den. Når man har gjort det, kan man få lov til at slette kategorien. Vi opretter et par kategorier her, og så kommer siden til at se sådan her ud: - Side 56 -

57 Downloads Når først downloadkategorierne er oprettet, kan man efterfølgende oprette sine downloads. Det anbefales at oprette en folder på serveren, som er specielt lavet til formålet vi kunne jo kalde den for downloads. Og har man sådan en folder, så kan man oprette nye downloads ved dels at anbringe downloadfilerne i folderen (via FTP) dels at oprette selve downloaden i nedenstående skærmbillede (som fremkommer, når man fra administrationssiden trykker på downloads): En ny download oprettes ved, at man udfylder samtlige felter i skabelonen ovenfor. Det kunne for eksempel se sådan her ud: - Side 57 -

58 Når alle oplysninger er skrevet ind, trykker man så på Gem download, hvorefter den nyoprettede download dukker op på listen i bunden af skærmbilledet: - Side 58 -

59 Herfra kan man som det fremgår så også redigere oplysningerne eller slette dem, hvis den pågældende download ikke længere er aktuel. På listen over downloads, som ens brugere kan kigge på, dukker den nye download op sådan her: Her kan man se den kategori, vi lige har oprettet ligesom man kan se, at der er oprettet 1 download under denne kategori. Trykker man på overskriften, får man dette frem på sin skærm: Her dukker alle de oplysninger op, som blev skrevet ind, da downloaden blev oprettet. Og herfra kan ens brugere så downloade de filer, som man stiller til rådighed. Det er en god ide at bruge beskrivelsesfeltet til ganske kort at redegøre for, hvordan brugeren håndterer den pågældende download for eksempel ved at skrive lidt om, hvad man skal gøre for at få den installeret og til at fungere. Der findes MOD s til PHP-Fusion, som gør det muligt at tilknytte små billeder til de enkelte downloads, men den side af sagen berører vi ikke her i håndbogen. - Side 59 -

60 Billedhåndtering Der er to elementer i det her. Dels den almindelige billedhåndtering dvs. import (upload) af grafiske filer til anvendelse i artikler, nyheder og så videre dels anvendelsen af det indbyggede fotoalbum. De to elementer behandles hver for sig i nedenstående. Billedimport og anvendelse PHP-Fusion går som hovedregel ud fra, at de billedfiler (jpg og gif) som skal anvendes til illustration i artikler og nyheder fysisk skal placeres i folderen images. Men fra og med version 5.01 er det desuden blevet muligt at uploade billeder til (og bruge billeder fra) to specialfoldere, som knytter sig til henholdsvis artikler og nyheder. Til alle tre foldere kan man enten uploade billeder direkte via en FTP-klient eller andet tilsvarende, eller man kan bruge den indbyggede billedimport, som der er adgang til fra administrationssiden. Trykker man Billeder (indholdsadministration), får man dette på sin skærm: I nederste del af skærmbilledet ser man en liste over de billedfiler, som man aktuelt har liggende i folderen images og her har man mulighed for at slette dem enkeltvis. Ligesom man kan se dem ved at trykke på Se. Ønsker man at se indholdet af artikelbilleder, trykker man på overskriften, hvorefter man får nedenstående frem på sin skærm: - Side 60 -

61 Trykker man Se ud for et billede, ser ens skærm sådan her ud: - Side 61 -

62 Herfra kan man enten vælge at slette det aktuelle billede eller at gå tilbage til billedadministrationen. I den øverste del af skærmbilledet finder man en dialogboks, der gør det muligt at importere nye billedfiler til den folder, som man aktuelt står i. Trykker man på gennemse, får man mulighed for at udpege en billedfil på sin egen harddisk, som man ved et tryk på Upload kan få importeret til PHP-Fusions billedfolder. Resultatet af processen præsenteres f. eks. således: Når billedet er importeret, optræder det på listen sammen med de øvrige billeder og kan derefter anvendes som illustration. Ønsker man at anvende en anden folder eller flere foldere til at gemme grafiske filer i, kan man naturligvis gøre det. Men import-faciliteten peger altid på folderen images (medmindre man går ind og retter i koden) eller på folderen news eller folderen articles under images. Ligesom billed-knapperne i editoren også altid som standard vil foreslå folderen news under nyheder og articles under artikler. Også det kan man lave om men det kræver et indgreb i koden. Fotoalbum PHP-Fusion version 6.0 leveres som standard med et fotoalbum, der er lavet til at vise større samlinger af billeder frem på en struktureret måde. Dette afsnit handler om, hvordan man bruger sit fotoalbum. - Side 62 -

63 Man starter oprettelsen af et nyt album fra administrationssiden ved at trykke på fotoalbums, (indholdsadministration + fotoalbums) og får derefter dette skærmbillede frem: Som det fremgår, er der endnu ikke oprettet albums i denne installation, men hvis man udfylder felterne Overskrift, Information osv. så vil albummet blive oprettet. Vi vælger at oprette et album, som vi kalder for Testalbum. Ikonet her er det overskriftbillede som det nye album vil blive præsenteret med i listen over albums. Som ikon kan man bruge et JPG-billede i størrelsen maksimalt 100 x 100 pixels og billedet vil derefter blive reduceret til den størrelse, som angives under sideopsætning for fotoalbum (se herom tidligere). Når alle oplysninger er opgivet, trykker man på Gem album, og derefter vil det nye album optræde i listen Aktuelle fotoalbums, som det fremgår af det næste skærmbillede: - Side 63 -

64 Der er nu dukket et album op i listen forneden, der er sat flueben ved ikonet (der er importeret korrekt), og der mangler endnu at blive fyldt billeder i dette album. For at lægge billeder ind skal man trykke på Indsæt. Gør man det, så får man dette frem på sin skærm: Her skal man så billede for billede indsætte en overskrift og hente sit billede. Man skal bare huske, at det indbyggede fotoalbum kun accepterer JPG-filer og kun billeder der er mindre end 300 pixels høje (ønsker man at ændre det, skal man ændre standardopsætningen under sideindstillinger fra administrationssiden). Teksten under feltet billede betyder, at billedet i en oversigt over billeder i akkurat dette album bliver præsenteret i en størrelse på 120 x 100 pixels (bredde x højde). Også denne indstilling kan ændres via sideindstillinger. Hvis vi nu prøver at lægge to billeder ind i dette album, så kommer skærmbilledet til at se sådan her ud: - Side 64 -

65 De to billeder er lagt ind, og nu er det første album så oprettet. Ønsker man at lave flere albums, så gentager man blot processen. Og man kan på et hvilket som helst tidspunkt vælge, enten at lægge flere billeder ind i et eksisterende album eller at slette billeder fra albummet. Det album, som vi lige har oprettet, præsenteres for brugerne af siden på denne måde: Når brugeren trykker på fotoalbum under navigation, får han dette frem på skærmen: Her kan man se, hvilke albums som findes på siden. Lader man cursoren glide hen over ikonet, så kommer der farve på det sort-hvide billede. Og trykker man på ikonet, så får man dette frem på skærmen: - Side 65 -

66 Her præsenteres albummet med en forstørret udgave af ikonet foroven (her i farver), samt med miniatureudgaver af de billeder, som er lagt ind i albummet. Trykker man herefter som bruger på et af disse billeder, så ser det sådan her ud: - Side 66 -

67 Her kan man dels se selve billedet dels en række oplysninger om det (størrelse, tilføjelsesdato, hvor mange gange billedet er blevet set), dels kan man forneden på skærmen føje kommentarer til billedet. Og endelig kan man blade videre i albummet ved at trykke på pilene foroven. - Side 67 -

68 Links Man anvender PHP-Fusions link-funktion principielt set på samme måde som man anvender artikelfunktionen eller downloadfunktionen. Dvs. at der før man kan lægge links på skal oprettes et antal linkkategorier, som linkene kan tilknyttes. Hvorefter man så kan lægge alle de links på, som man har lyst til. En ny linkkategori oprettes fra administrationssiden. Trykker man på linkkategorier (indholdsadministration + linkkategorier) får man nedenstående skærmbillede frem: Her giver man sin kategori et navn og laver en beskrivelse, og når man så er færdig med det, trykker man Gem kategorien, hvorefter kategorien gemmes. I skærmbilledet herunder kan man se, hvordan det tager sig ud, når der er oprettet nogle kategorier til at gemme links i: Man kan altid vende tilbage til denne side for at tilføje nye kategorier eller for at slette nogle af de gamle kategorier. Husk bare, at systemet ikke vil acceptere sletning af kategorier, som der er knyttet links til. Ønsker man at slette sådan en, så skal man først flytte sine links til en anden kategori eller slette dem. - Side 68 -

69 Nu er vi så parat til at knytte links til vores kategorier. Vælger man links fra administrationssiden, får man nedenstående skærmbillede frem: I sidens øverste del kan man oprette sine links og i nederste del af skærmbilledet kan man se en liste over de kategorier, som er oprettet og de links, som er knyttet til dem. Tilføjer man et nyt link her, så kunne det for eksempel se sådan her ud: Her har man en mulighed for at teste linket (ved at trykke på linkets overskrift), for at redigere linket (tryk på Rediger) eller for at slette det pågældende link (tryk på Slet). - Side 69 -

70 Det er også fra dette skærmbillede, man kan flytte sit link fra en kategori til en anden. Trykker man på rediger, får man nemlig mulighed for at vælge en anden kategori. Og man flytter ganske enkelt sit link ved at gøre det og derefter trykke Gem link. - Side 70 -

71 Elementer og elementstyring Grundlayoutet i et PHP-Fusion baseret website er bygget på hvad der kaldes paneler og panelerne består igen af elementer. Et panel er for eksempel venstre spalte på siden eller højre spalte. Og på den side indgår en række elementer (der fungerer lidt ligesom Legoklodser). Et panel kunne for eksempel se sådan ud: Og i dette panel indgår to elementer brugerinfoboksen foroven og replikboksen forneden. Dette her er således et element: Administratoren af et site (en hjemmeside) kan via elementadministrationen, der nås fra administrationssiden, styre standardelementernes placering og tilføje nye elementer, der kan placeres relativt frit i de to sidepaneler på sitet (henholdsvis i venstre og højre side) og i midterpanelet. Trykker man elementadministration fra administrationssiden (systemadministration + elementer), får man dette frem på sin skærm: - Side 71 -

72 På denne liste kan man se, hvilke elementer der aktuelt er aktive listen under elementnavn (aktive står der slå fra ud for inaktive står der slå til ud for) man kan se, i hvilken side af skærmbilledet de aktuelt er placeret (de grønne pile under Står til), man kan se i hvilken rækkefølge i henholdsvis venstre og højre kolonne elementerne står og endelig kan man se, hvilken type, elementet er og hvem, der har adgang til det. Derudover kan man administrere elementerne. Med den første række af pile (under Står til/flyt) kan man flytte et element fra venstre til højre side eller omvendt. Med den næste række af pile (under rækkefølge) kan man flytte et element op eller ned i rækken i den side af skærmbilledet, hvor det aktuelt er placeret. Endelig kan man redigere et element, slå det til eller fra eller slette det helt. Og man kan oprette nye elementer. Vi skal nu først kigge lidt nærmere på, hvad et element kan rumme. Hvis vi vælger elementet nyeste debatemner her og trykker rediger, får vi dette frem på skærmen: - Side 72 -

73 Vi kan her se, at elementet er et standardelement, der trækker på filen forum_threads_panel.php. som er lokaliseret i folderen infusions og installeret som standard i PHP-Fusion. Vi kan også se, at dette element kan ses af alle at der er anonym adgang til det. Men trykker man på pilen ud for Kan ses af, kan man også se, at man let kan ændre adgangsforholdet til elementet: - Side 73 -

74 Ønsker man at ændre i dette element, er man nødt til at ændre i elementets kildefil. Man kan se det, man kan slette elementet (hvilket ikke er det samme som at slette kildefilen) eller man kan slå det til og fra. Men man kan ikke inde fra PHP-Fusion ændre i selve kildefilen. Det samme er tilfældet med alle andre også brugeroprettede elementer som betjener sig af eksterne kildefiler. Du kan se princippet i ovenstående illustrationer. Man opretter altså et nyt element ved at give det et navn (også selvom man anvender en eksisterende fil) og derefter enten vælge en eksisterende kildefil fra filnavn for element eller selv fylde noget indhold i skabelonen. Vælger man at navngive elementet og undlader at vælge navnet på en eksisterende fil fra listen (der er en liste over filer i folderen infusions), så kan man oprette elementet sådan her: Dette element der benytter sig af en modifikation (en såkaldt MOD) til PHP-Fusion viser en liste over de sidste 10 kendte brugere, som har været på besøg på siden. Listen genereres af den kode, som er lagt ind i elementet. Og som panel præsenteres listen med overskriften Sidst online (indholdet i Senest Online, on ). Når man er færdig med at lave sit nye element, trykker man på Gem element og vender derefter tilbage til elementadministration, hvor listen nu ser sådan her ud: - Side 74 -

75 Som det kan ses ved pilen, er der dukket et nyt element op det vi lige har lavet men standard er elementet slået fra. For at aktivere det, skal man først trykke på Slå til. Når man har gjort det, dukker elementet op på ens forside i venstre kolonne som nummer 6. Således som det fremgår af dette skærmbillede: Man kan altid redigere disse brugeroprettede elementer. Man skal bare trykke på Rediger, ud for det pågældende element, så åbnes den side, hvor man kan redigere i koden tilføje ting og så videre. - Side 75 -

76 Debat Der er indbygget et debatmodul i PHP-Fusion. Men før brugerne kan anvende dette modul, skal man som administrator have oprettet nogle strukturer, som debatindlæggene kan knytte sig til lidt i stil med hvad man skal gøre under artikler og links. Strukturens øverste lag udgøres af temaer dvs. debatkredse. Og under dem tilføjer man debatter. Og hver enkelt debat kan så rumme flere emner. Oprette debatter Man starter med at trykke Debat fra administrationssiden (indholdsadministration + debat) og får derefter dette skærmbillede frem: I skærmbilledet herunder er der oprettet tre temaer og under et af disse temaer er der også oprettet en debat. Og endnu en debat er under oprettelse en debat der kun er adgang til for medlemmer på sitet. I illustrationen længere fremme kan man se, hvordan denne struktur ser ud set fra en besøgendes synsvinkel. - Side 76 -

77 Som det fremgår, kan man bruge administrator brugere eller en brugergruppe til at definere adgangen både til at se en debat og til at skrive i den. Når man så har oprettet en struktur i debatten, ser en besøgende på ens side det sådan her: - Side 77 -

78 Forudsætningen for at et debattema vises i listen er, at der er oprettet emner under debatten. Har man kun oprettet selve temaet, men ikke defineret emner, så vises debatten ikke på listen. Åbner man den øverste debat som bruger, så ser det sådan her ud: Der er lagt dansksprogede knapper på inde i forum (se herom senere), men princippet er det samme uanset om man anvender danske eller engelske knapper. For at oprette et nyt emne under dette tema og denne debat, trykker man på knappen New thread (eller Nyt Emne), hvorefter dette skærmbillede åbnes: - Side 78 -

79 Herfra kan man så skrive en overskrift og en tekst (hvor der kan anvendes forskellige teksteffekter) og man kan tilføje smileys. Når man er færdig med at skrive sit debatindlæg, trykker man på gem indlæg, hvorefter debatten kommer til at se sådan her ud: Under sideopsætning er der også en sektion, hvor man som administrator kan angive forskellige værdier i relation til debatten. Denne sektion er omtalt tidligere i håndbogen. Derudover kan man som administrator (eller ordstyrer) foretage sig en del ting inde i selve debatmodulet, således som det fremgår af skærmbilledet. Herfra kan man: Opfriske emne dvs. rette datoen på sit emne til dags dato Slette emnet Låse emnet (således at emnet stadigvæk kan ses, men ikke længere er aktivt) Fastholde et emne i toppen af emnelisten Flytte emnet til en anden debat - Side 79 -

80 Afstemninger Som et ekstra krydderi på din hjemmeside kan du med PHP-Fusion tilføje medlemsafstemninger dvs. små afstemninger af formen et spørgsmål og flere svaralternativer. Afstemningerne kan gemmes, når de afsluttes, således at du selv og brugerne kan slå tilbage i tidligere afstemninger. Og afstemningen vises på forsiden således at man ser resultatet, hvis man har stemt (og har fået lagt en cookie på sin maskine) eller afstemningstemaet, hvis man endnu ikke har stemt eller ikke er medlem på siden. Trykker du Afstemninger fra din administrationsside (indholdsadministration + afstemninger), får du dette skærmbillede frem: Herfra opretter man en afstemning ved at skrive afstemningens tema (det spørgsmål, som brugerne skal svare på) i det øverste felt og svaralternativerne i felterne svar 1 2 og så fremdeles. Det kunne for eksempel se sådan ud: Her har vi trykket to gange på knappen tilføj svar, således at det totale antal svaralternativer er kommet op på 4. Trykker man fra dette skærmbillede Se afstemning, kan man se, hvordan ens afstemning kommer til at tage sig ud fra forsiden: - Side 80 -

81 Og man afslutter altså oprettelsen ved at trykke på Gem. Nu er afstemningen oprettet. Men vi mangler stadigvæk at aktivere elementet brugerafstemning på forsiden. Det gør vi via elementadministration (systemadministration + elementer). Først skal vi have tilføjet elementet. Vælg Tilføj nyt element og kig på drop down listen: - Side 81 -

82 Det element, som skal bruges, hedder member_poll_panel. Vælger man det og giver det et navn, kommer listen over elementer til at se sådan her ud (det nye element er markeret med en pil): Som det fremgår, er boksen standard slået fra, men trykker man på Slå til ud for Afstemning, dukker afstemningsboksen op på ens forside sådan her: - Side 82 -

83 Ønsker man på et senere tidspunkt at ændre i eller slette sin afstemning, vælger man igen Afstemninger fra administrationssiden (indholdsadministration + afstemninger), og får denne gang dette skærmbillede frem: Her kan man vælge at oprette en ny afstemning men man kan også vælge at redigere en eksisterende afstemning (ved at vælge afstemningen fra listen og trykke Rediger). Vælger man det, ser skærmbilledet således ud: - Side 83 -

84 Her kan man som det fremgår tilføje en svarmulighed, se afstemningen, gemme eventuelle ændringer eller slet og ret afslutte afstemningen. Og gør man det sidste beholdes afstemningen fra sitets forside, men med en tekst på, hvoraf det fremgår, at afstemningen er lukket. Ønsker man helt at fjerne afstemningsboksen fra forsiden, kan man gøre det via Elementer. Man skal bare huske, at når man så vil lave en ny afstemning, så skal elementet aktiveres fra elementadministration, før det bliver vist igen på forsiden. - Side 84 -

85 Administration generelt I dette afsnit skal vi se lidt nærmere på, hvordan man administrerer en række af PHP-Fusions faciliteter. Grundlæggende handler denne administration om at kunne rette, slette eller styre ting. Replikker PHP-Fusion er forsynet med en lille messaging -funktion i form af en replikboks, som kan ses på forsiden af ens site. Replikboksen ser sådan her ud: Replikboksen med en enkelt replik i kan ses nederst på skærmbilledet. I denne replikboks kan registrerede medlemmer lave korte replikker (maksimalt 250 tegn) stille hurtige spørgsmål eller kommentere hinanden. Og for at gøre replikkerne lidt livligere, kan man også her bruge de såkaldte smileys dvs. små ansigter, der indskrives som specialtegn. Det brede smil i replikken herover skrives f. eks. sådan her: (et kolon med en parentes bagefter). Andre smileys kan ses på funktionens hjælpeside. Administratoren af sitet har flere muligheder for at administrere disse replikker. - Side 85 -

86 For det første kan man fra administrationssiden under systemadministration (systemadministration + diverse) opsætte nogle helt generelle værdier for, hvordan ens replikboks kan anvendes. Udover denne administrationsdel, kan man også fra administrationssiden (brugeradministration + replikboks) vælge Replikboks. Gør man det, kan man se alle de replikker, som er gemt på siden og foretage sig forskellige ting med dem. Man kan for det første vælge at slette alle replikker der er ældre end et vist antal dage. Sletningen sker omgående, men først når man trykker på knappen Slet replikker. Herudover kan man få en række oplysninger på dette skærmbillede. Man kan se, hvem der har skrevet de enkelte replikker (og slå op i medlemsfortegnelsen og se flere oplysninger om den pågældende). Man kan se, hvilken IP-adresse den pågældende replik er afsendt fra. Og endelig kan man enten redigere eller slette enkelte replikker. Administration af brugere/medlemmer Lidt på samme måde er det med medlemsadministrationen. Vælger man brugeradministration fra administrationssiden (brugeradministration + brugere), får man dette frem på sin skærm: Her kan man se en liste over de brugere, som aktuelt er registreret på ens site. Man kan se brugernavnene og brugerrollen, og man kan redigere i brugernes oplysninger f. eks. for at tildele dem en anden rolle, end den de har aktuelt. Når man har mange medlemmer på siden, så kan man ved at trykke på bogstaverne i tabelopstillingen få vist kun de medlemmer, hvis brugernavne begynder med et givet bogstav. For hvert enkelt medlem kan man desuden vælge imellem at redigere at udelukke og at slette et medlem. - Side 86 -

87 Trykker man Rediger her (det virker ikke på superadministratoren), så får man dette skærmbillede frem: Som det fremgår, kan man her rette i en række felter, der er helt identiske med felterne på den oprindelige tilmeldingsskærm eller felterne i skærmbilledet Rediger profil. Fra medlemsadministrationen kan man også oprette nye medlemmer. Dvs. hvis man har slået tilmelding fra på sin side, så kan man fra medlemsadministration oprette nye medlemmer ved at trykke Tilføj øverst på skærmbilledet. Gør man det, åbnes dette skærmbillede: - Side 87 -

88 Her opretter man en bruger ved at angive et brugernavn et kodeord og en mailadresse og ved afslutningsvis at trykke på knappen Tilføj bruger. Den pågældende bruger kan derefter selv logge sig på for at udfylde resten af oplysningsfelterne (via rediger profil). Fra medlemsadministrationen kan man endelig vælge at udelukke et medlem. Vælger man det, betyder det, at den pågældende er ude af stand til at logge sig på sitet og i stedet får en meddelelse om, at han eller hun er udelukket som medlem. Men man kan selvfølgelig ikke forhindre den pågældende i at melde sig til igen med et andet brugernavn og en anden mailadresse. I version 6.0 er det desuden muligt helt at lukke for gæster fra en bestemt IP-adresse eller for tilmelding fra gæster med bestemte mail-adresser. Trykker man udeluk fra administrationspanelet (brugeradministration + udeluk), får man dette frem på sin skærm: Denne facilitet kan man anvende for at gøre en udelukkelse mere effektiv, end den er når man blot bruger udeluk fra medlemsadministration. Et udelukket medlem kan jo oprette sig som - Side 88 -

89 bruger igen, og så er man lige vidt. Men lukker man også for bestemte IP-adresser eller udelukker man tilmelding fra bestemte mailadresser (eller domænenavne), så bliver udelukkelsen mere total. MEN: vær lige opmærksom på, at en udelukkelse af medlemmer f. eks. med domænenavnet hotmail.com i adressen også kan risikere at udelukke nye medlemmer, som man egentlig gerne vil have ind. Og vær ligeledes opmærksom på, at man kan komme til at ramme brugere, der blot anvender samme internetudbyder, hvis man udelukker specifikke IP-adresser (eller dele af en IP-adresse), fordi de fleste udbydere arbejder med såkaldte IP-scopes (altså intervaller af IP-adresser, som brugerne får tildelt dynamisk). Brug kun den avancerede udelukkelsesmetode, hvis det virkelig er nødvendigt. Brugerforslag Brugerne af din side kan hvis de er medlemmer - stille forslag til indhold. De kan foreslå artikler, nyheder og links. Men forslaget offentliggøres ikke umiddelbart. Før offentliggørelsen skal en administrator på siden gennemse forslaget og tage stilling til, om det skal offentliggøres eller ej. Fra administrationssiden kan du altid se, om der ligger ikke godkendte brugerforslag. Det fremgår i bunden af skærmbilledet (her markeret ved en pil): For at godkende eller forkaste brugerforslagene trykker man på brugerforslag (brugeradministration + brugerforslag). Det skærmbillede, du får frem, kunne for eksempel se sådan her ud: - Side 89 -

90 I eksemplet her er der forslag i alle tre kategorier. Og fra skærmbilledet ovenfor kan du herefter vælge enten at slette forslaget uden at se nærmere på det eller at se det, hvorefter du så kan slette det eller acceptere det, således at sidens andre brugere kan få fornøjelse af det. Vælger man Se her under artikler, kunne det for eksempel se således ud: I dette tilfælde står der ikke så meget hverken i overskriften, den korte beskrivelse (introduktionen) eller i selve artikelteksten. Men princippet er altså, at du herfra kan vælge offentliggør eller slet. Offentliggøres artiklen, placeres den ind under den kategori, som brugeren har valgt. Ønsker du at flytte den til en anden kategori, skal du kalde artiklen frem til redigering og gøre det her. Kommentarer Både nyheder og artikler kan kommenteres og bedømmes af medlemmerne på siden. Og både medlemmet selv og administratoren af siden kan jo få lyst til enten at ændre en kommentar eller helt slette den. Ønsker medlemmet at redigere eller slette en kommentar, skal medlemmet imidlertid rette henvendelse til administratoren, da det kun er administratorer på en side, som kan bruge kommentaradministrationen. Du får adgang til faciliteten ved at vælge Rediger kommentarer fra enten den nyhed eller den artikel, som kommentaren er knyttet til. Det kunne for eksempel se sådan her ud: - Side 90 -

91 Trykker man på Administrer kommentarer herfra, kommer dette frem på skærmen: Her kan man så se, hvem der har lavet kommentarerne fra hvilken ip-adresse, det er sket og på hvilken dato. Man kan også vælge at slette en given kommentar eller at rette den. Trykker man for eksempel rediger til den øverste kommentar her, så får man nedenstående frem på sin skærm: - Side 91 -

92 Øverst kan man nu redigere teksten fjerne eller tilføje dele af den og gemme den ændrede kommentar. Ændrer administrator en kommentar kan man imidlertid ikke (endnu) se det på selve kommentaren i modsætning til hvis administrator ændrer et indlæg i debatten, hvor det automatisk bliver noteret nederst i indlægget, at indlægget er redigeret af en anden. Sikkerhedskopiering af database I PHP-Fusion version 6.0 er der som standard etableret en funktion på administrationssiden, så superadministratoren kan lave en sikkerhedskopi af databasen og med udgangspunkt i denne sikkerhedskopi rulle siden tilbage til en tidligere tilstand. Du finder funktionen under systemadministration og sikkerhedskopiering. Det er en god ide med mellemrum at lave sådanne kopier i hvert fald hver gang man står over for at skulle lave ændringer i databasen. Skulle ændringerne så vise sig at volde problemer, kan man altid vende tilbage til den tidligere (fungerende) tilstand. Derudover er det også en god ide at opbevare sine sikkerhedskopier et andet sted end på serveren. Dels fordi der altid er en risiko for, at hackere forsøger at bryde ind på siden, dels fordi man teoretisk set kan risikere, at udbyderens server går ned, således at filerne slettes. Så hver gang du har lavet en sikkerhedskopi, så flyt kopien ned på din egen maskine og gem den der i stedet for at lade den blive liggende på driftsserveren. Når man skal lave en sikkerhedskopi starter man med at tage to beslutninger. For det første en beslutning om, hvorvidt man vil kopiere alle tabeller i databasen eller blot grundtabellerne. Og for det andet om man ønsker at gemme sin sikkerhedskopi i komprimeret form (.sql gz) eller i form af en ukomprimeret form (.sql). Er ens database meget stor, bør man vælge den komprimerede form (hvis udbyderens serveropsætning understøtter det hvad den ikke altid - Side 92 -

93 gør). Men selv en side med mange artikler, mange nyheder og mange debatindlæg fylder faktisk forbavsende lidt i ukomprimeret form, så man kan jo forsøge sig lidt frem. I eksemplet her er der valgt ukomprimeret og alle tabeller. Og som det fremgår, så fylder tabellerne totalt set lidt over 70 Kb, hvilket ikke kan vælte nogen af pinden. Trykker man nu kopier herfra, så kan man (på det næste skærmbillede) se, at der bliver lavet endnu en sikkerhedskopi (vi prøver at lave både en komprimeret og en ukomprimeret kopi, så du kan sammenligne størrelsen på de to). - Side 93 -

94 Man kan også se, at selvom databasen (de valgte tabeller) fyldte godt 70 Kb, så fylder selve sikkerhedskopien kun godt 8 Kb (fordi der er valgt komprimeret format). Mens den fylder næsten 50 Kb ukomprimeret. Nu da sikkerhedskopien er lavet, kan man foretage sig flere forskellige ting med den. Man kan slette den direkte (eller man kan slette en af de gamle kopier, hvis man skønner, at man ikke får brug for den igen). Men man kan også se en række informationer om kopien eller man kan vælge at genskabe sin database ud fra sikkerhedskopien. Trykker man information her, så får man nedenstående frem på sin skærm (trykker du information på en komprimeret kopi, vil systemet forsøge at downloade den, så lad være med det): Her kan man se en liste over de tabeller, som er blevet kopieret. Man kan (i parentes efter de enkelte tabeller) også se, hvor mange poster, hver enkelt tabel rummer. Og endelig kan man i - Side 94 -

95 detaljer se, hvilket kopiformat, der er anvendt, hvornår kopien er lavet, hvilken database, der er kopieret og det præfiks, som tabellerne har. Og er man ikke tilfreds med disse oplysninger, så kan man gå et skridt videre ved at trykke på Se her. Gør man det, får man dette frem på sin skærm: Der er kun vist et lille udsnit af skærmbilledet herover. Faktisk får man vist alt, hvad der står i den sql-fil, som er blevet dannet ved sikkerhedskopieringen og kan blade igennem den og læse detaljer i den. Denne sikkerhedskopi kan man nu bruge enten til at gendanne sin side på serveren, eller til at oprette en kopi af siden på sin lokale maskine (hvis man har en lokal server installeret). Den lokale kopi kan enten laves ved at køre en direkte SQL-kørsel på databasen (ved hjælp af phpmyadmin eller et tilsvarende administrationsværktøj). Eller ved at lægge sikkerhedskopien i den korrekte folder på sin lokale maskine og derefter køre genskab fra PHP-Fusions administrationsside. Vælger man at genskabe sin database ud fra en sikkerhedskopi i PHP-Fusion (ved at trykke genskab ud for en af de tilgængelige sikkerhedskopier), så får man dette skærmbillede frem: - Side 95 -

96 I venstre kolonne er der en liste over de tabeller, som ens sikkerhedskopi giver mulighed for at genoprette. Og i højre kolonne er der en liste over de data, som sikkerhedskopien rummer. Hvis ens databasestruktur ikke er beskadiget (eller hvis man genskaber en side ud fra en ny installation f. eks. efter flytning og geninstallation af siden) så behøver man ikke genskabe tabelstrukturen. Og så kan man altså vælge ingen i venstre kolonne og alle i højre kolonne. Men ønsker man at genskabe både tabelstruktur og data, så vælger man alle i begge kolonner. Selve rekonstruktionen igangsættes, når man trykker på knappen Genskab og man kommer ud af dette skærmbillede ved at trykke Fortryd. - Side 96 -

97 Genskabelse af tabelstruktur og data via et MySQL-værktøj (phpmyadmin eller andet) gennemgås ikke i denne håndbog. Men i litteraturlisten bagerst i håndbogen er der henvist til nogle adresser og bogtitler, som måske kan hjælpe en, hvis man vil bruge den metode. Personlige beskeder I PHP-Fusion er der som tidligere omtalt indbygget en facilitet, således at de enkelte brugere kan sende små beskeder til hinanden uden brug af . Disse beskeder kan ses, besvares eller slettes i brugernes (medlemmernes) private postkasser. Og hver gang man som registreret bruger (medlem) logger på en side, så får man også automatisk besked om, hvorvidt der er skrevet personlige beskeder til en. Når et medlem logger sig på, kommer der automatisk besked, hvis der er kommet nye meddelelser. I eksemplet herunder kan man se, at der er kommet en enkelt ny besked. Trykker man her på private beskeder, får man nedenstående frem på sin skærm: I skærmbilledet her, har man flere muligheder. Man kan vælge at se den enkelte besked ved at trykke på beskedens emne man kan se profilen for den bruger, som har sendt beskeden - Side 97 -

98 (ved at trykke på brugernavnet under fra) man kan slette sine beskeder én for én ved at markere beskeden og trykke på slet ud for den, og endelig kan man vælge at markere alle og gøre forskellige ting ved dem (gemme dem i arkivet, slette dem og så videre). Vælger vi her at trykke overskriften en privat besked, får man nedenstående frem på sin skærm: Og her kan man så vælge at svare på den private besked eller at vende tilbage til sin private indbakke. I de private beskeder kan man bruge forskellige virkemidler, således som det fremgår af nedenstående skærmbillede: Man kan formatere sin tekst (fed skrift, kursiv osv.) man kan indsætte links (url husk at fjerne i linket for at få det til at virke) og billeder, man kan indsætte citater (quote) - Side 98 -

99 eller kode (code) og endelig kan man bruge smileys. Hvis man sender kode eller lignende, kan man med fordel vælge at slå smileys fra. Det får koden til at stå klarere og mere læsbar. I PHP-Fusion version 6.0 kan man endvidere vælge en række ting under Valgmuligheder fra hovedskærmbilledet til private beskeder. Du kan som registreret bruger f. eks. vælge at få en mail, hver gang der indløber en ny besked. Du skal dog tænke dig om, før du vælger dette (eller slå det til som en mulighed for brugerne, hvis du er administrator). Der kan komme temmelig mange mails ud af det, hvis der er stor aktivitet på din side. Du kan også vælge at gemme beskeder automatisk. Øvrige opsætningsmuligheder omkring de private beskeder er omtalt andetsteds i denne håndbog, så de skal ikke kommenteres her. - Side 99 -

100 FAQ anvendelse og administration I PHP-Fusion er der indbygget en facilitet til oprettelse og fremvisning af såkaldte FAQ (Frequently Asked Questions dvs. ofte stillede spørgsmål). Denne facilitet kan man bruge til en række ting afhængigt af, hvad ens side handler om. Men først og fremmest så er faciliteten beregnet på sider, der yder en eller anden form for rådgivning. Som ved links og artikler tager man faciliteten i brug ved at oprette nogle kategorier, som de enkelte spørgsmål og svar kan lægges ind under (Indholdsadministration + FAQ): Vi opretter tre kategorier her, og så kommer skærmen til at se sådan her ud: Når man så har oprettet sine kategorier (og man kan altid supplere med nye kategorier løbende), kan man begynde at skrive spørgsmål og svar ind. - Side 100 -

101 Som det fremgår af ovenstående har man de samme redigeringsmuligheder i forbindelse med FAQ-funktionen, som man har en række andre steder i PHP-Fusion fed skrift, kursiv, indsættelse af link osv. Når man derefter har indskrevet et spørgsmål og et svar (eller flere), så kan ens besøgende kigge efter i FAQ for at se, om der allerede der skulle være en beskrivelse af brugerens problem og en opskrift på, hvordan problemet kan løses. Det kunne for eksempel se sådan her ud: - Side 101 -

102 Brugeroprettede sider I PHP-Fusion kan brugeren (dvs. administratoren altså ejeren af den pågældende side) oprette sine egne sider, der kan indsættes i navigationsboksen på forsiden eller kaldes via et link fra en anden side. Man opretter en brugeroprettet side fra administrationssiden ved at vælge Brugeroprettede sider (indholdsadministration + brugeroprettede sider). Vælger man dette fra menuen, kommer dette her frem på ens skærm: I en brugeroprettet side kan man indskrive tekst men man kan f. eks. også indsætte PHPkode (ved at trykke på knappen <?php?>) man kan indsætte links, billeder og så videre. I eksemplet her er der bare anbragt en smule tekst under sideindholdet. Samtidig med at man opretter sin brugeroprettede side, skal man også tage stilling til, hvem der må se denne side. Og ønsker man for eksempel at yde en speciel medlemsservice på sin hjemmeside, så kan man vælge at begrænse adgangen ved at vælge f. eks. registrerede brugere fra boksen Adgang for. Og endelig kan man vælge, om siden automatisk skal tilføjes navigationsmenuen eller ej. - Side 102 -

103 Sideoverskriften på skærmbilledet her, er også overskriften på det link, som dukker op i navigationsområdet. Så det er fornuftigt her at vælge en sigende overskrift. Før man gemmer sin side, kan man ligesom ved artikler og nyheder vælge at se sin side, sådan som den kommer til at tage sig ud for brugerne. Trykker man se siden i eksemplet her, så ser det sådan her ud: Når man derefter trykker på gem siden, får man dette frem på sin skærm: - Side 103 -

104 Heraf fremgår, at siden nu er gemt og at siden er oprettet med linket: viewpage.php?page_id=2 dvs. at siden er gemt i databasen og kan kaldes frem ved at kalde filen viewpage.php med parameteren page_id=2. Kigger vi på forsiden, efter at den brugeroprettede side er gemt, så ser navigationspanelet nu sådan her ud: Som det fremgår, er den nye side sat på nederst i rækken her, og trykker man på linket, så får man dette frem på sin skærm: - Side 104 -

105 - Side 105 -

106 Tilpasning af systemet generelt nogle eksempler Du kan finde et utal af funktioner. som du kan tilføje systemet på brugernes hjemmesider og på de officielle projektsider i England, Sverige, Tyskland, Estland, Polen, Danmark, Holland og så videre. Desuden findes der en speciel side, som udelukkende drejer sig om systemmodifikationer, og hvor alle de nye modifikationer testes omhyggeligt og registreres i en database (adressen på siden er: Fordi der er så mange, er det en håbløs opgave i denne sammenhæng at give et overblik over dem alle sammen. I stedet har vi valgt at tage nogle få eksempler frem, der kan give dig som bruger en fornemmelse af, hvad der skal til for at anvende disse modifikationer. Husk som en hovedregel altid at tage en kopi af din database og af dine originalfiler, før du begynder at eksperimentere med at integrere systemtilpasninger. På den måde kan du altid restaurere din hjemmeside, hvis noget skulle vise sig at drille eller ikke fungere ordentligt. Husk også at dokumentere dine ændringer. Ændringer af denne karakter er ikke en del af standardløsningen. Og du kan risikere at skulle arbejde ganske meget for at få dit system op at køre igen efter at have installeret en ny version, fordi den nye version enten ikke understøtter ændringerne eller kræver, at disse ændringer skal laves en gang til med den nye version. Det, der er mest risikabelt, er at lave ændringer, som kræver indgreb i databasen. Kræver en ændring det, så skal du i hvert fald altid tage en backup af din database, inden du går i gang, så du har en mulighed for at få din side til at fungere igen bagefter, hvis noget går galt. I øvrigt vil jeg anbefale, at du installerer en lokal webserver (Apache) med PHP-understøttelse og MySQL på din egen maskine, hvor du kan afprøve ændringerne inden du forsøger at lægge dem på din produktionsside. En samlet installationspakke til det hele kan hentes på adressen: (og andre steder se f. eks. på den spændende side den kræver ikke meget af din maskine, og det er en fortræffelig platform at eksperimentere på. Dansksprogede knapper i debat Vi starter med en ganske simpel tilpasning, som ikke kræver nogen form for systemændringer: dansk sprog på knapperne i debatten. I modsætning til de fleste andre steder i PHP-Fusion, så er knapperne i debatten ikke lavet dynamisk. De er produceret som små stykker grafik. Og skal man således ændre teksterne til dansk, så skal man lave nye knapper. Det er imidlertid vigtigt, at man laver knapperne, så de i størrelse helt præcis svarer til originalknapperne, da det ellers kan risikere at ødelægge designet. Knapfilerne ligger i en mappe under det tema, man har valgt. Hvis temaet er Journal, så ligger knapfilerne der, hvor det er markeret med pilen: - Side 106 -

107 Herunder kan du se en liste over de grafikfiler, du skal ændre: Der er kun nogen af dem, der er tekster på resten kan du bare lade være med at røre ved. Selve ændringen sker i et grafikprogram (Paint Shop Pro Photoshop eller hvad du nu bruger). Start med at kontrollere størrelsen af knapfilen (målt i pixels) opret en ny fil med samme mål giv denne nye fil en baggrundsfarve, der passer til dit design og skriv en dansk tekst ind på denne baggrund (husk at tekstfarven skal stå i kontrast til baggrundsfarven) og gem endelig hver af de nye filer med samme navn som den fil, den skal erstatte. Et sæt nye knapper kunne for eksempel se sådan her ud: - Side 107 -

108 Når de nye knapper så er lagt ind i folderen, kommer debatten til at se sådan her ud: - Side 108 -

109 Ændring af visningen for unikke hits og visning af tidsforbrug ved sidedannelse Det første eksempel på en tilpasning kræver ikke ret meget af dig som bruger. Men det demonstrerer meget godt, hvordan man fordi man har adgang til selve kildekoden i systemet kan ændre og tilføje ting til den, der er med til at gøre ens side mere personlig. Eksemplet demonstrerer også noget, som man skal være opmærksom på i forbindelse med ændringer. Nemlig det, at man når man laver den slags ændringer selv skal holde styr på dem og selv senere (ved opdateringer eller opgraderinger) skal genskabe sine ændringer. Så vi vil anbefale, at man fører en slags dagbog (en journal) over sine ændringer, og at man dokumenterer dem, således at det senere hen bliver nemmere for én at genskabe dem ved systemomlægninger og opgraderinger. Nederst på alle ens sider kan man altid se en række oplysninger: Øverst i midten (placeringen kan variere afhængigt af, hvilket tema, du bruger) står der den copyright-meddelelse, som du har indskrevet under sideopsætning fra administrationspanelet. Længst til højre (illustrationen her er hentet fra phpfusion.dk) står der en meddelelse om, hvor mange unikke besøg, ens side har modtaget. Og længst til venstre (med dette tema) står der en oplysning om, at siden er lavet med PHP- Fusion version 6.0. Denne oplysning må man ikke fjerne eller ændre, så længe man ikke har købt en kommerciel licens til systemet. De mere præcise regler kan læses både på den engelske moderside og på den danske støtteside (i dansk oversættelse). Får ens side mange besøg, så kan det måske være en fordel at vise tallet ud for unikke besøg på en anden måde (visningen ovenfor er ikke standard her er der indsat et skilletegn for tusinder). Hvis man gerne vil have tallet vist med et dansk skilletegn for tusinder, kan man opnå det ved at lave en lille ændring i den theme.php, som svarer til det tema, man har valgt. - Side 109 -

110 Man åbner filen og finder denne del af koden (under funktionen render_footer): I denne kode ændrer man herefter formatet for fremvisningen af tællertallet ($settings[ counter ] ved at indskrive: ".number_format($settings['counter'], 0, '', '.')." Funktionen number_format ændrer formatet på det tal, som tælleren leverer i eksemplet her således, at tallet vises med et punktum for tusinder. Den ændrede kode ser sådan her ud: Og resultatet af ændringen kan ses ovenfor. Hvordan man kan styre fremvisningen, kan man se f. eks. i en online-manual til PHP (som også findes på dansk). F. eks. her: Hvis man også ønsker at vise, hvor lang servertid det har taget at danne siden, så kan man gøre det ved at tilføje endnu en stump kode i to af systemfilerne hhv. subheader.php og footer.php. I subheader.php skal vi have startet funktionen ved at registrere starttidspunktet for sidens indlæsning. Det gør vi ved at indføje denne stump kode (linjerne 29 31): Derefter skal vi have registreret afslutningstidspunktet have trukket de to tidsangivelser fra hinanden og have vist resultatet nederst på siden. Det gør vi ved at tilføje denne stump kode i filen footer.php: - Side 110 -

111 Og det er denne stump kode, der resulterer i, at dannelsestiden angives nederst på siden. Resultatet ser sådan her ud: Ændring af pålognings- og aflogningsmeddelelse Flere brugere har spurgt, hvordan man ændrer den meddelelse, som kommer når en bruger logger på eller logger af en PHP-Fusion-side, den der ser sådan her ud: Denne ændring er egentlig et meget godt eksempel på, hvordan man kan rette til i systemet, så det passer til ens egne behov, så den tager vi også lige med her. Først skal man finde ud af, hvilken fil, som varetager pålogning og aflogning. Det kan man f. eks. gøre ved at spore de tekster, som anvendes. I dette tilfælde er det disse to: $locale['192'] = "Logger ud som "; $locale['193'] = "Logger ind som "; De står begge to i sprogfilen global.php. Og søger man efter f. eks. $locale['192'] i sine scriptfiler, så finder man ud af, at den og 193 begge anvendes i filen setuser.php. De optræder i denne kodepassage (her markeret med pile): - Side 111 -

112 Man kan de samme to steder se, at der her bruges en global variabel (indeholdende brugerens navn) det er den, der hedder $user. Vil man nu ændre teksterne, således at der i stedet skrives : Logger dig på + sidens navn og Logger dig af + sidens navn, så skal man også ændre i koden de to steder altså i linje 39 og i linje 57. Men før vi gør det, skal vi have ændret i sprogfilerne. De to faste tekster, som vi kiggede på før, skal laves om til: $locale['192'] = "Logger dig af "; $locale['193'] = "Logger dig på "; Det gør vi i filen global.php, hvorefter vi gemmer filen. Nu skal vi så have lavet om på setuser.php. De to linjer ændres, således at det nu er sidenavnet, som vises sammen med de faste tekster. Det ser sådan her ud: Linje 39: Linje 57: Når disse ændringer er lavet og filerne gemt, så kommer pålogningsskærmen til at se sådan her ud: - Side 112 -

113 Det var endnu en ændring, som man selv kan lave. Men rundt omkring i PHP-Fusion-verdenen kan du også finde en del såkaldte MOD s (systemmodifikationer), som du kan låne kvit og frit og bruge ændringer eller tilføjelser til systemet, som andre har lavet og som du kan anvende. I det følgende afsnit gennemgår vi et par stykker af dem. Et par såkaldte MOD s I dette eksempel skal vi tilføje to paneler på forsiden, som henholdsvis rummer oplysninger om hvilke 10 medlemmer, som sidst har været på besøg på siden og hvilke downloads, som har været de mest populære. Begge systemtilføjelser (eller MOD s som de kaldes i denne verden) er lavet af PHP-Fusionbrugere og stillet til rådighed for alle andre til fri afbenyttelse. Begge funktioner tilføjes som elementer (i en af siderne). Og den kode, som står i det første element (som er hentet på fusion.uk og derefter tilrettet), ser sådan her ud (som du sikkert husker, har vi brugt den som eksempel tidligere her i håndbogen): - Side 113 -

114 Skal man forklare den ganske kort, så er det der sker følgende: Linje 2: Først laves der et opslag i databasen hvis resultat gemmes i array-form i udtrykket $result. Linje 6 13: Nu bruges disse data til at regne forskellige værdier ud (while sætningen med de 6 linjer ned til det første if). Linje 14 28: Derefter håndteres disse værdier i en række if-sætninger. Linje 29 33: Endelig udskrives resultaterne i den anden echo-linje i bunden af filen. Koden lægges som sagt ind i et element, og det ser sådan her ud: - Side 114 -

115 Elementet får et navn her ( Sidst online ) og gemmes. Vi har her valgt funktionen opensidex for at der kan blive tilføjet en lille knap (en pil i andre temaer), som kan åbne og lukke elementet, og vi har valgt on for at elementet som standard altid er åbent. Endelig skal vi bruge et par små grafikfiler online.gif og offline.gif de to grafikfiler anbringes i folderen images. Når elementet så gemmes og aktiveres (husk det) fra elementadministration, vil vi få dette element på forsiden: Det andet element, vi skal tilføje, viser de fem mest populære downloads. Koden til elementet ser sådan her ud: - Side 115 -

116 Når elementet er gemt og aktiveret, ser det sådan her ud på forsiden (illustrationen er hentet fra fordi du skal kunne se, hvordan det virker, når der er mange downloads): På de officielle PHP-Fusion-sider og på en del brugersider kan du finde flere MOD s af samme karakter, som alle sammen skal håndteres på samme måde. Faktisk behøver man ikke at kende så voldsomt meget til PHP-kodning for at kunne lægge den slags på sin side. Kopier den kode, som passer til den version af PHP-Fusion, som du anvender, læg kopien ind via administrationspanelet, gem og aktiver. Så vil det i de fleste tilfælde fungere med det samme. Dertil kommer, at der med frigivelsen af version 5.0 blev introduceret en ny standard for systemtilføjelser, der gør det væsentligt nemmere for den almindelige bruger også at anvende temmelig avancerede systemtilføjelser. Denne standard, som er blevet yderligere udviklet i forbindelse med frigivelsen af version 6.0 INFUSIONS handler næste afsnit om. - Side 116 -

117 Infusions Med frigivelsen af PHP-Fusion version 5.0 blev der introduceret en ny standard for tilføjelse af systemudvidelser kaldet INFUSIONS, en standard som er ændret og udvidet med version 6.0. Det, der er styrken ved denne standard, er at systemtilføjelser nu kan lægges på systemet på en måde, som gør fremtidige opgraderinger langt enklere, end de har været før. Installere en INFUSION En INFUSION kan bestå af flere filer. Hvis vi bruger den først frigivne INFUSION (Nyhedsbreve) som eksempel, så ser filstrukturen (folderen newsletter_panel) således ud: Installationen af nyhedsbrevet er meget enkel. Man kopierer ganske enkelt hele folderen newsletter_panel til systemfolderen infusions der så kommer til at se sådan her ud: - Side 117 -

118 Derefter går man ind på administrationssiden (systemadministration + Infusioner) trykker på Infusioner og får derefter dette skærmbillede frem: Man vælger blandt de uploadede infusioner og trykker Installer hvorefter infusionen installeres. På skærmen kan man se det på denne måde: Og når man derefter vender tilbage til administrationssiden, kan man se, at der er føjet endnu en side til, så der nu er fire administrationssider: - Side 118 -

119 Fra den nye side (som bruges til at administrere alle infusioner), kan man nu administrere sine nyhedsbreve. Når man åbner siden, ser det sådan her ud: Og trykker man på Nyhedsbreve, så får man dette frem på sin skærm: Hvad er det egentlig, som sker, når en infusion installeres? Det afhænger naturligvis af, hvor kompliceret den pågældende INFUSION er. Men i dette tilfælde udføres følgende operationer: - oprettelse af to nye tabeller i ens database (xxx_newsletters og xxx_newsletter_subs der rummer hhv. de nyhedsbreve, man laver og de subskriptioner, som bliver tegnet) - etablering af et panel (der lige skal aktiveres først via elementadministration, før det vises på siden) hvor brugerne løbende kan melde sig til og fra nyhedsbrevsfunktionen - Side 119 -

120 - oprettelse af links til administrationsfaciliteten fra INFUSION-delen af administrationssiden - indføjelse af værdier, der gør, at nyhedsbrevsadministrationen kan bruge dansk (den vedlagte danske sprogfil, som ligger i folderen locale). Men så kompliceret behøver det ikke at være. En INFUSION kan for eksempel bestå udelukkende af et enkelt panel. Forudsætningen for, at den kan håndteres af administrationsværktøjet er den enkle, at der i den nye INFUSION er inkluderet en fil (infusion.php), som rummer en række oplysninger, som administrationsværktøjet skal bruge for at kunne lægge INFUSIONEN på systemet. Hvis vi stadigvæk bruger nyhedsbrevsfaciliteten som eksempel, så står der dette i den infusion.php, som følger med nyhedsbrevet (de enkelte afsnit er kommenteret nedenfor): - Side 120 -

121 1: Ledeteksten til administrationspanelet 2: Beskrivelsen af infusionen 3: Versionsnummeret 4: Forfatteroplysninger 5: Nødvendige filnavne 6: Filnavn på administrationspanel 7: Antallet af nyoprettede tabeller og eventuelle tabelændringer - Side 121 -

122 8: Den første nye tabel 9: Den anden nye tabel 10. Efternavnet på den første af de tabeller, som skal slettes, hvis infusionen fjernes 11. Efternavnet på den anden af de tabeller, som skal fjernes, hvis infusionen afinstalleres. Installationsfunktionen er (selvom den kodemæssigt set er ret kompliceret) ganske enkel. Den åbner den faste folder (infusions) ser efter om der ligger infusions i folderen, som ikke er lagt på præsenterer informationerne om dem (hentet fra filen infusion.php) og udfører derefter (når administratoren beslutter det) de instruktioner, som ligger i informationsfilen. Ligger der i den pågældende INFUSION-folder en fil med efternavnet _panel kan systemtilføjelsen også tilføjes via elementadministration. I eksemplet med nyhedsbrevene er der sådan en fil (newsletter_panel) en fil, der som tidligere bemærket skal aktiveres efter installationen af nyhedsbrevene. Men en INFUSION kan altså også blot bestå af en sådan PANEL-fil og så sker installationen udelukkende via elementadministration. Når elementet er oprettet og aktiveret, ser det sådan her ud: Oprette en ny INFUSION Vi vil ikke gå i detaljer her med, hvordan man gør det det kan man se beskrevet blandt andet på Men vi gennemgår og kommenterer et eksempel, som er hentet på den engelske moderside. Ønsker du at lave en ny INFUSION, skal du begynde med at downloade den SDK-pakke, som kan findes både på den engelske og på den danske PHP-Fusion side. Når du har downloadet denne pakke (SDK står for Software Development Kit) og pakket den ud, så står du med disse filer: SDK-kittet til nye Infusioner omfatter altså følgende filer: - Side 122 -