Quick Guide VivianCMS

Quick Guide VivianCMS Gastenboek creëren

Versie: 1.0 Startdatum: 24 juli 2006 Datum laatste wijziging: 24 juli 2006 Opmerking: Gepubliceerd op http://www.viviancms.nl

Inhoud 1 Inleiding............................................................................................................................................3 1.1 Contactformulier creëren.......................................................................................................... 3 2 Het formulier creëren....................................................................................................................... 4 2.1 Invulvelden creëren...................................................................................................................4 2.1.1 Een veld voor de naam van de bezoeker...........................................................................5 2.1.2 Een veld voor het e-mailadres van de bezoeker................................................................6 2.1.3 Een veld voor het typen van een berichtje........................................................................ 6 2.2 Een preview van de velden bekijken........................................................................................ 7 3 Een gegevenslijst aanmaken.............................................................................................................9 4 Het template creëren.......................................................................................................................11 5 Formulier in een document plaatsen...............................................................................................13 6 Gegevenslijst in een document plaatsen.........................................................................................16 7 Vragen of opmerkingen.................................................................................................................. 19

1 Inleiding VivianCMS is een content management systeem. VivianCMS is speciaal ontworpen om u in staat te stellen om uw website op een eenvoudige manier van inhoud te voorzien of deze inhoud te wijzigen. Het doel van de “Quick Guides” is om bepaalde basisfuncties van VivianCMS op een eenvoudige, “stap-voor-stap” manier uit te leggen. Hierdoor zult u snel met VivianCMS aan de gang kunnen. In de “Quick Guide” geven we allereerst een beschrijving van de stappen die u moet doorlopen om een bepaalde mogelijkheid te gebruiken. Vervolgens vatten we deze stappen nog eens puntsgewijs voor u samen. Mocht u behoefte hebben aan een meer uitgebreide uitleg van bepaalde functies, dan verwijzen wij u naar de basishandleiding. Mocht u nog verzoeken hebben voor een “stap-voor-stap”-uitleg niet als quick guide beschikbaar is, meldt u dit dan via de vraagbaak (http://vivian.ivinity.nl/vraagbaken.html).

1.1 Contactformulier creëren In deze quick-guide zullen we een gastenboek creëren. Via een gastenboek kunnen de bezoekers een berichtje op uw site zetten. Hierdoor kunnen bezoekers op uw site zeggen wat ze van uw site vinden, wat ze vinden van de dingen die u hebt geschreven en soms ook kleine discussies op gang brengen. Hierdoor wordt uw site een beetje interactiever, wat uw site sterk kan verlevendigen. Om een gastenboek op uw site te zetten, creëert u eerst een formulier waar mensen een berichtje op in kunnen typen. Vervolgens creëert u een gegevenslijst, waar de berichtjes die zijn ingetypt in worden gezet. Met behulp van een eenvoudig template zorgt u er vervolgens voor dat deze berichtjes ook weer op de site te zien zijn.

2 Het formulier creëren De eerste stap is het creëeren van een nieuw formulier. Dit doen we door naar de map te gaan waar we het formulier willen creëren en vervolgens te klikken op “nieuw-->formulier. Vervolgens geven we het nieuwe formulier met “hernoemen” een nieuwe naam. In dit geval kiezen we voor de naam “formulier gastenboek”. Het nieuwe formulier “formulier gastenboek” kunnen we openen door erop te dubbelklikken. We krijgen nu het volgende scherm te zien:

Zoals te zien is op het scherm, is het formulier op dit moment nog leeg. We zullen dit moeten gaan vullen met de velden die we nodig hebben. Kort samengevat: 1. Ga naar de map waar u het formulier wilt hebben. 2. Klik op “Nieuw --> formulier”. 3. Klik op “Hernoemen” en geef het formulier de naam “formulier gastenboek”. 4. Dubbelklik om het formulier te openen.

2.1 Invulvelden creëren Het creëren van nieuwe velden doen we door op de knop “Nieuw...” te klikken. We krijgen nu het volgende scherm te zien:

Hier moeten we aangeven wat voor type veld we willen creëren. In de het

bovenste van de twee velden geven we het soort veld aan dat we willen hebben, bijvoorbeeld een veld met tekst, met getallen, met de datum enzovoorts. In het onderste veld specificeren we onze keuze. In het geval van tekst kunnen we bijvoorbeeld aangeven of we een enkele lijn tekst willen, een tekstblok, een e-mailadres of een ander soort veld. Als we hebben aangegeven dat we een getallenveld willen, kunnen we aangeven of dit kommagetallen of gehele getallen moeten zijn. Voor een compleet overzicht van de mogelijkheden kunt u kijken in de handleiding. Op het formulier voor een gastenboek hoeven eigenlijk alleen de naam van de bezoeker, het bericht dat hij wil plaatsen en eventueel een e-mailadres te staan. Deze zullen we in dit hoofdstuk dus ook aanmaken. Natuurlijk kunt u voor uw eigen gastenboek de gegevens zo uitgebreid maken als u zelf wilt.

2.1.1 Een veld voor de naam van de bezoeker Allereerst maken we een veld aan voor de naam van bezoeker. We zullen dus eerst een veld moeten maken waar mensen hun naam kunnen invullen. Dit doen we door te kiezen voor het type “tekst” in het bovenste vak, en “tekst” in het onderste vak. Vervolgens klikken we op “Volgende”. We komen dan in het volgende scherm:

Hier vullen we vervolgens de verschillende velden in. Voor de functies van de verschillende velden kunt u kijken in de handleiding. Om een veld te maken voor de naam van de persoon, vullen we de velden “Naam” en “Alias” in. Beide velden noemen we “naam”. We willen ook graag weten wie het berichtje achterlaat, dus klikken we ook de checkbox aan achter het veld “Verplicht”. Vervolgens klikken we op opslaan. Kort samengevat: 1. Klik in het overzichtsscherm op “Nieuw”. Een nieuw scherm opent. 2. Selecteer in het scherm “Veld toevoegen” in het bovenste en onderste veld van “Type” de optie “Tekst” en klik op “Volgende”. 3. Vul achter het veld “Naam” “Naam” in, in het veld “Alias” “naam” en klik de checkbox aan achter het veld “Verplicht”. 4. Klik op “Opslaan”.

2.1.2 Een veld voor het e-mailadres van de bezoeker Het creëren van een veld voor het e-mailadres van de bezoeker gaat in principe op dezelfde manier. Hier selecteert u in het scherm “Veld toevoegen” de opties “Tekst” en “E-mail”. Vervolgens klikt u op “Volgende”.

U komt nu weer in het scherm “Veld bewerken”. Hier vult u als naam “E-mail” en als alias “email”. In dit geval willen we het achterlaten van een e-mailadres niet verplicht maken, dus vinken we de checkbox “Verplicht” niet aan.

Vervolgens klikken we weer op “Opslaan”. Kort samengevat: 1. Klik in het overzichtsscherm op “Nieuw”. Een nieuw scherm opent. 2. Selecteer in het scherm “Veld toevoegen” in het bovenste veld van “Type de optie “Tekst” en in het onderste veld de optie “E-mail” en klik op “Volgende”. 3. Vul achter het veld “Naam” “E-mail” in, in het veld “Alias” “email”. 4. Klik op “Opslaan”.

2.1.3 Een veld voor het typen van een berichtje Om een veld voor het typen van een berichtje in te voeren selecteren we in het scherm “Veld toevoegen” weer boven de optie tekst. Nu selecteren we in het onderste veld echter de optie “Tekstblok”. We klikken wederom op “Volgende”. In het volgende scherm “Veld bewerken” geven we het tekstblok de naam “Bericht” en de alias “bericht”. Om de bezoeker duidelijk te maken dat hij in het tekstblok zijn bericht kan typen, vullen we ook het vak “Beschrijving” in. We typen hier “Type hier uw berichtje. Omdat we daarnaast willen dat mensen geen al te lange verhalen plaatsen in het gastenboek, zetten we ook een limiet

aan het aantal tekens. Dit doen we door achter de optie “Max” het maximale aantal tekens in te typen. In dit geval maken we hier 1000 van. Het invoeren van een berichtje is natuurlijk wel verplicht, dus klikken we de checkbox achter “Verplicht” weer aan. We klikken weer op “Opslaan” om de gegevens te bewaren. Kort samengevat: 1. Klik in het overzichtsscherm op “Nieuw”. Een nieuw scherm opent. 2. Selecteer in het scherm “Veld toevoegen” in het bovenste veld van “Type de optie “Tekst” en in het onderste veld de optie “Tekstblok” en klik op “Volgende”. 3. Vul achter het veld “Naam” “Bericht” in, in het veld “Alias” “bericht”. Vult achter “Beschrijving” de tekst “Type hier uw bericht in” en zet bij “max” het maximale aantal tekens op “1000”. Vink weer de checkbox “Verplicht aan. 4. Klik op “Opslaan”.

2.2 Een preview van de velden bekijken Ons formulier is nu af. In het overzichtsscherm van het formulier zien we een overzicht van de velden die we hebben aangegeven. Door op “Preview” te klikken, krijgen we een preview van het formulier te zien. Als we dan op “Editor” klikken, komen we weer in het overzichtsscherm terecht.

Kort samengevat: 1. Open het formulier.

1. Klik op “Nieuw...” om een nieuw veld te creëren. 2. Selecteer in het typescherm het type veld dat u wilt creëren en klik vervolgens op “Volgende”. 3. Vul de naam, alias en eventuele andere opties in in het veldbewerkscherm en klik op “Opslaan”. 4. Bekijk het resultaat in het overzichtsscherm, of klik op “preview” om een preview van het formulier te zien. Als u de preview bekijkt, klikt u weer op “editor” om terug te gaan naar het ovezichtsscherm.

3 Een gegevenslijst aanmaken Na het aanmaken van het formulier, maken we de gegevenslijst aan. Hierin worden de gegevens geplaatst die de bezoekers in het formulier invullen. Hiervoor gaan we naar de map waar de gegevenslijst gemaakt moet worden en klikken we op “Nieuw... --> Datalijst” Met “Hernoemen” geven we de gegevenslijst de naam “Gegevenslijst gastenboek”. Als we vervolgens de datalijst openen zien we het volgende scherm:

We moeten nu het formulier instellen dat we willen gebruiken voor de datalijst. Dit formulier geeft aan welke gegevens in de gegevenslijst gebruikt moeten worden. Hiervoor moeten we dus het “Formulier gastenboek” gebruiken. Om dit te selecteren klikken we op “Eigenschappen”. We krijgen nu tabblad “Eigenschappen” van het eigenschappenscherm van de gegevenslijst te zien. Hier klikken we op “Kiezen...” en selecteren we vervolgens het formulier “Formulier gastenboek”.

Vervolgens klikken we op “Toepassen” of “Sluiten” om onze selectie te bevestigen. Omdat we geen andere dingen hoeven in te stellen, kunnen we hier rustig voor “Sluiten” kiezen. Kort samengevat: 1. Ga naar de map waar u de gegevenslijst van het gastenboek wilt plaatsen en klik op “nieuw... --> datalijst” om een nieuwe gegevenslijst te creëren. Geef met “Hernoemen de gegevenslijst de naam die u wilt. 2. Open de gegevenslijst en klik op “Eigenschappen”.

3. Klik op “Kiezen” en selecteer het formulier voor het gastenboek. 4. Klik op “Sluiten”.

4 Het template creëren Om het gastenboek goed op de site te zetten, moeten we eerst aangeven hoe dit gastenboek eruit moet komen te zien. Dit doen we met behulp van een template. Een template is een document dat aangeeft waar bepaalde gegevens (bijvoorbeeld uit datalijsten) moeten komen te staan. In het geval van een gastenboek, zet VivianCMS alle gegevens in de gegevenslijst onder elkaar in het document. Wat u moet doen in het template is aangeven hoe de naam, email en het geplaatste bericht moeten worden weergegeven. Een template werkt met behulp van 'tags'. Een 'tag' geeft aan waar VivianCMS bepaalde gegevens moet plaatsen. Het heeft de vorm '{TAG}', waar op de plaats van 'TAG' in dit geval de alias komt te staan van de verschillende velden in het formulier en de gegevenslijst. Om een template te maken, creëren we eerst een document in de map waar we het template willen zetten. Met 'Hernoemen' geven we het document de naam “Template gastenboek”. Vervolgens openen we het document en maken we hierin een tekstcomponent door op “Toevoegen ( ) --> Tekst” te klikken. We dubbelklikken op deze component en krijgen nu de teksteditor te zien. Hier kunnen we nu de lay-out aanmaken voor een rij in het gastenboek. Hiervoor typen we de tags {NAAM}, {EMAIL} en {BERICHT} in het editorscherm. Dit waren de aliassen die we gegeven hebben aan de verschillende velden in het fomulier voor het gastenboek. Het resultaat ziet er zo uit:

Bij het bovenstaande template wordt achter de tekst “Naam:” de naam ingevuld, achter de tekst “E-mail” het e-mailadres en onder de tekst “Bericht” het bericht. Kort samengevat: 1. Ga naar de map waar u het template wilt hebben en creëer hier een document. 2. Maak in het document een of meerdere tekstcomponenten aan voor de lay-out van de berichten. 3. Creëer de lay-out in de componenten, waarbij tags met de vorm “{TAG}” gebruikt worden op de plaatsen waar VivianCMS de woorden moet

invullen. 4. Klik op “definitief” om het template definitief te maken.

5 Formulier in een document plaatsen Als de bezoekers een bericht willen plaatsen, zullen ze natuurlijk wel het formulier op de site moeten zien. Dit hoofdstuk en het volgende hoofdstuk zullen behandelen hoe we het formulier om berichten te plaatsen en de gegevenslijst in een document kunnen zetten. In dit geval zullen we ze allebei in hetzelfde document zetten en publiceren. Dit is natuurlijk niet noodzakelijk. Het is bijvoorbeeld ook mogelijk om het formulier om een berichtje te plaatsen op een andere plek van de site te zetten dan het gastenboek zelf en vervolgens een link naar het formulier te creëren. Allereerst moeten we natuurlijk een document aanmaken voor het gastenboek en het formulier. We noemen dit document “Gastenboek”. Vervolgens openen we dit document en maken hier een formuliercomponent in. Dit doen we door te klikken op “Toevoegen ( )” --> “Formulier”.

In de cel komt nu de mededeling te staan: “Dubbelklik om een formulier te selecteren”. Open de component door hierop te dubbelklikken. We komen nu in het instellingenscherm van het formulier. Dit scherm heeft 3 tabbladen, 'Formulier', 'Knoppen' en 'Bewerken'. Het scherm opent automatisch het tabblad 'Formulier'. Hier kunnen we instellen welk formulier we willen gebruiken. Om dit te doen klikken we achter het veld 'Formulier:' op de knop “Kiezen...”. In het volgende scherm selecteren we het formulier voor ons gastenboek en klikken vervolgens weer op “Kiezen...”. Het geselecteerde formulier krijgen we nu in het instellingenscherm te zien.

We klikken op “Toepassen” om onze keuze te bevestigen. Het formulier zal nu in het document verschijnen. Vervolgens klikken we op het tabblad “Knoppen” om de knoppen bij het formulier in te stellen. Hier zijn nu nog geen knoppen

aangemaakt.

We hoeven maar één knop aan te maken, namelijk een knop om het bericht te plaatsen. Dit is een actie, dus moeten we een actieknop aanmaken. We klikken eerst op “Toevoegen”. In het volgende scherm moeten we de knop een naam geven. Dit is ook de naam die op de knop op de webpagina verschijnt. We noemen de knop “Plaatsen”. Bij “Type” kiezen we voor actie”. Vervolgens klikken we weer op “Toevoegen”. De knop verschijnt nu in het lijstje met knoppen.

Onder de lijst zijn nu ook twee tabbladen verschenen. In het tabblad “Acties” stellen we in wat er moet gebeuren als er op de knop wordt geklikt. In het tabblad “Goed resultaat” geven we aan wat er moet gebeuren nadat het formulier is goedgekeurd en de actie is uitgevoerd. We moeten nu een actie aan de knop toewijzen, zodat duidelijk wordt wat er moet gebeuren als er op de knop geklikt wordt door de gebruiker. In ons geval moet het bericht dan aan de gegevenslijst worden toegevoegd. Hiervoor moeten we een nieuwe actie aanmaken. Klik onder het tabblad “Acties” op de knop “Nieuw”. Er verschijnt nu een scherm waar ons gevraagd wordt om de actie een naam te geven, en welk type actie uitgevoerd moet worden. We geven de actie de naam “Plaatsen” en selecteren als type actie “Aan datalijst toevoegen”. Vervolgens klikken we op “Volgende”. In het volgende scherm wordt ons gevraagd om de datalijst uit te zoeken. Hiervoor klikken we op “Kiezen...”. We selecteren het bestand “Gastenboek datalijst” en klikken weer op “Kiezen...”. Vervolgens klikken we op “Opslaan”. De actie staat nu in de lijst van acties weergegeven.

Nu moeten we nog instellen wat er moet gebeuren als het formulier goed is ingesteld en het bericht geplaatst wordt. Hiervoor gaan we naar het tabblad “Goed resultaat”. In dit tabblad kunnen we aangeven of de mensen een boodschap te zien moeten krijgen nadat ze een bericht hebben ingestuurd, of ze naar een andere pagina moeten worden doorverwezen en of het formulier na insturen gewist moet worden. In dit geval willen we dat de bezoeker bedankt wordt na het insturen van het formulier, dus vinken we de checkbox achter “Bericht” aan en vullen we in het tekstveld de tekst “Bedankt” in. Verder willen we dat het bericht vervolgens gewist wordt, dus vinken we ook de checkbox “Formulier wissen” aan.

Vervolgens klikken we op de knop “Bewerken” om de gegevens op te slaan. Vervolgens kunnen we het scherm sluiten. 1. Ga naar de map waar u het gastenboek in wilt creëren, en maak hier een document aan. 2. Klik op “Toevoegen ( )” --> “Formulier”. 3. Open het Formuliercomponent door hierop te dubbelklikken. 4. Klik onder het tabblad “Formulier” op “Kiezen...” om een formulier te selecteren. Klik vervolgens op “Toepassen”. 5. Ga naar het tabblad “Knoppen”. 6. Klik op de knop “Toevoegen”. 7. Geef de knop de naam “Plaatsen”,selecteer het type “Actie” en klik vervolgens op “Opslaan”. 8. Klik vervolgens onder het tabblad “Actie” op “Nieuw”. 9. Geef de actie een naam (hier “Plaatsen”) en selecteer “Aan datalijst toevoegen” als actie. Klik vervolgens op “Volgende”. 10.Klik op “Kiezen...” en selecteer de datalijst waar de ingevoerde berichten in moeten worden gezet. 11.Ga vervolgens naar het tabblad “Goed resultaat”. 12.Vink de checkbox “Bericht” aan en type het bericht in. 13.Vink ook de checkbox “Formulier wissen” aan en klik vervolgens op “Bewerken”. 14.Het formulier is nu ingesteld en u kunt het venster sluiten.

6 Gegevenslijst in een document plaatsen We plaatsen de gegevenslijst in hetzelfde document als het formulier voor het gastenboek. Dit doen we door een gegevenslijstcomponent in dit document aan te maken via “Toevoegen ( )” --> “Gegevenslijst”.

We krijgen nu een component te zien met daarin de mededeling “Dubbelklik om een gegevenslijst te selecteren”. We openen deze component door erop te dubbelklikken. We komen nu in het instellingenscherm voor gegevenslijsten. Hier kiezen we allereerst de gegevenslijst die we willen gebruiken, door achter “Datalijst” te klikken op “Kiezen”. Vervolgens selecteren we de gegevenslijst “Gegevenslijst gastenboek” en klikken op “Kiezen”. We willen ons eigen template gebruiken voor het gastenboek. Om dit te kunnen doen moeten we allereerst in het tabblad “Algemeen” achter het veld uiterlijk de optie “Lijst met navigatie” selecteren. We kunnen hier ook instellen bij welk bericht de weergave moet stoppen en eindigen en hoeveel berichten per pagina moeten worden weergegeven. Daarnaast klikken we ook de checkbox “Geavanceerde weergave” aan achter “Weergave”. Dit stelt ons in staat om de verschillende velden van het formulier toe te wijzen aan de tags in het template. Vervolgens klikken we op “Toepassen”.

Vervolgens moeten we instellen welke template we willen gebruiken. Om dit te doen gaan we naar het tabblad Layout. Hier klikken we achter “Template” op de knop “Kiezen...” en selecteren we de template die we gemaakt hebben (template gastenboek). Vervolgens klikken we weer op “Toepassen”.

Nu de gegevenslijst en het template zijn ingesteld, kunnen we de verschillende velden van het formulier toewijzen aan het template. Hiervoor gaan we naar het tabblad “Gegevens”. In dit tabblad staan de tags die u in het template hebt ingesteld. Hier moeten we nu de velden aan toewijzen. Vooralsnog zijn deze niet ingesteld en dit staat ook vermeld in het overzicht.

Om nu de naam in te stellen, selecteren we “Naam” en klikken vervolgens op bewerken. Er opent nu een scherm waar we aan de tag “naam” in de template,

een kolom van de gegevenslijst kunnen koppelen. Dit kunnen we vervolgens voor de andere tags doen. Als we een tag hebben ingesteld, zal deze dikgedrukt in het overzicht verschijnen en zal erachter worden aangegeven dat deze ingesteld is.

Op deze manier kunnen we alle tags instellen. Als alle tags zijn ingesteld, kunnen we het scherm verlaten. Als we nu het document publiceren, zullen bezoekers voortaan in staat zijn om een berichtje achter te laten op ons gastenboek. Dit berichtje zal meteen nadat ze het hebben ingezonden te zien zijn op onze site. 1. Creëer een nieuw document in de map waar u het gastenboek wilt, of gebruik een al eerder gecreëerd document (in dit geval is hetzelfde document gebruikt als dat waar het formulier in staat). 2. Klik op “Toevoegen ( )” --> “gegevenslijst”. 3. Open de gebruikerslijstcomponent door hierop te dubbelklikken. 4. Klik onder het tabblad “Algemeen” achter “Datalijst” op de knop “Kiezen” en selecteer de gegevenslijst voor het contactformulier. 5. Kies bij het uiterlijk “lijst met navigatie” en selecteer de startpositie en het aantal berichten per pagina. Vink ook de checkbox achter “geavanceerde weergave” aan. Klik vervolgens op “Toepassen”. 6. Ga naar het tabblad “Layout” en selecteer achter “Template” het template voor het gastenboek. Klik weer op “Toepassen”. 7. Ga naar het tabblad “Gegevens”. 8. Selecteer een tag en klik op “Bewerken”. Selecteer vervolgens de kolom van de gegevenslijst die bij de tag ingevuld moet worden. Stel op deze manier alle tags in. 9. Als alle tags zijn ingesteld kunt u het scherm afsluiten.

7 Vragen of opmerkingen In deze quick-guide hebben we stap voor stap het creëren van een gastenboek doorlopen. We hopen dat de uitgebreide uitleg, gecombineerd met de stapvoor-stap aanwijzingen u een duidelijk beeld geven van de stappen die u moet doorlopen om dit voor elkaar te krijgen. Mocht u er met deze quick-guide niet uitkomen, kijkt u dan even op de ondersteuningspagina van VivianCMS (www.viviancms.nl/ondersteuning.html). Hier kunt u antwoord zoeken op uw vragen via de “Meest gestelde vragen”-pagina of de “User tips”. Mocht u er dan nog niet uitkomen of mocht u andere vragen of opmerkingen hebben, dan kunt u altijd uw vragen stellen via de “Vraagbaak”. Mocht u zelf een handige tip hebben die u gebruikt bij het maken van een contact formulier en u wilt dat delen met andere VivianCMS gebruikers, laat het aan ons weten! U kunt dit doen via de contactpagina op www.viviancms.nl/contact.html, of door een e-mail te sturen naar [email protected].