.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ==================================== EXT: Producten en diensten catalogus ==================================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2013-12-19T18:51:13.357520659 :Author: Frans van der Veen :Email: extensions@netcreators.com :Info 3: :Info 4: .. _EXT-Producten-en-diensten-catalogus: EXT: Producten en diensten catalogus ==================================== Extension Key: **ncgov\_pdc** Copyright 2000-2002, Frans van der Veen, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: Producten en diensten catalogus 1** **Copyright 1** **Credits 1** **Netcreators 1** **Sponsors 1** **Introduction 2** What does it do? 2 **Introductie 3** Wat doet deze extensie? 3 Screenshot 3 Flexibel inzetbaar 4 **Gebruikershandleiding 5** Terminologie 5 Beheer van pdc records 6 **Installatiehandleiding 10** Installatie 10 Minimale installatie 10 **Extensie opties 11** Verschillende weergaven 11 Plugin opties 12 **TS configuratie 13** **Troubleshooting 19** **Known problems 20** **TODO 20** **Changelog 20** **Sources 20** .. _Copyright: Copyright --------- .. _Credits: Credits ------- Netcreators .. _Sponsors: Sponsors -------- - TYPO3\|gem - Gemeente Leiden - Gemeente Heemskerk - Netcreators .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension enables publication of product and service information on the municipality website. This extension is aimed for the dutch market, therefore this manual will continue in dutch. If you have questions regarding usage, feel free to contact the author. .. _Introductie: Introductie ----------- .. _Wat-doet-deze-extensie: Wat doet deze extensie? ^^^^^^^^^^^^^^^^^^^^^^^ Deze extensie is een implementatie van een producten en diensten catalogus voor het publiceren van informatie over producten en diensten op de gemeentelijke websites. Daarnaast kan deze extensie worden ingezet als een kennisbank, waarbij de content collectie (vraag-antwoordcombinaties) van de overheid gebruikt kan worden. Deze extensie voldoet aan de eisen gesteld door `http://www.e-overheidvoorburgers.nl `_ (voormalig overheid heeft antwoord). .. _Screenshot: Screenshot ^^^^^^^^^^ *Picture 1: Examples* |img-1| .. _Flexibel-inzetbaar: Flexibel inzetbaar ^^^^^^^^^^^^^^^^^^ Deze extensie is opgezet met de achterliggende gedachten dat deze veelzijdig moet zijn. Hij moet ingezet kunnen worden bij verschillende gemeenten en daarom ook flexibel zijn en makkelijk aan te passen aan de wensen van de gemeente. Met dat in gedachten is deze extensie opgezet. Er is dan ook veel tijd besteed aan het configureerbaar maken van deze extensie. Dit zorgt ervoor dat deze extensie vrij krachtig is geworden en veel configuratieopties heeft. Deze handleiding legt uit waar de verschillende opties voor zijn en welke waarden hierin verwacht worden. Deze handleiding gaat niet in op de mogelijkheden van TypoScript zelf, die wel nodig zijn voor het laten werken van de extensie zoals hieronder aangegeven (met in de linkerkolom 1 instantie van de extensie): *Picture 2: Examples* |img-2| .. _Gebruikershandleiding: Gebruikershandleiding --------------------- Het beheren van pdc records gebeurt net als andere records in een TYPO3 omgeving. Deze handleing gaat er vanuit dat de lezer hiermee bekend is. Let op: Niet alle velden worden altijd getoond voor een product of vraag-antwoordcombinatie. Dit is afhankelijk van hoe de PDC is geconfigureerd (html templates) en of iemand is ingelogd. Wat ook uitmaakt is of de ingelogde gebruiker(sgroep) is toegekend aan het product / VAC. .. _Terminologie: Terminologie ^^^^^^^^^^^^ Product: Een product of dienst. Record: Het huidige product wat wordt bewerkt, of een product die in de context van de zin van toepassing is. Bezoeker: Een niet ingelogde persoon die de website bekijkt (Frontend). Gebruiker: Een ingelogde gebruiker die de website bekijkt (Frontend). Administrator: Een ingelogde beheerder (Backend). Redacteur: Een beheerder met beperkte rechten (Backend). KCC medewerker: Een gebruiker, die werkzaam is bij het klant contact centrum. .. _Beheer-van-product-records: Beheer van product records ^^^^^^^^^^^^^^^^^^^^^^^^^^ Dit hoofdstuk zal uitwijden over de (vele) velden die beschikbaar zijn voor een PDC record. **Tabblad Algemeen** Veld: Ingeladen RTE velden *Afbeelding 3: ingeladen RTE velden* |img-3| Met het veld 'ingeladen RTE velden' is te bepelen welke RTE velden voor dit record ingeladen zullen worden als het record bewerkt wordt. Het doel van dit veld is het versnellen van het inladen / opslaan van het record door minder (browserintensieve) RTE velden te tonen voor het record. De opties 'geen' zorgt ervoor dat er geen RTE veld wordt getoond, de optie 'alle velden' zorgt dat alle RTE velden zijn ingeladen. Veld: Type Dit veld bevat het type van het record. Dit kan zijn product of dienst. Sorteergewicht Dit veld bevat het gewicht van het product. Het gewicht bepaalt hoe hoog het product in zoekresultaten getoond moet worden als er een match is op een zoekterm. Hoe groter dit getal, des te hoger het product in de zoekresultaten tevoorschijn zal komen. Product unique identifier (owms / zaak) Een waarde die het product uniek identificeert voor de Samenwerkende Catalogi. Naam De naam van het product. Wijzigingen In dit veld kunnen notities mbt de wijzigingen van het product worden bijgehouden (voor redacteuren). Leges De URL naar een pagina die de leges bevat die bij het product horen. Leges (tabel) Content-elementen die de leges voor het betreffende product bevatten. Doorlooptijd De duur van de behandeling van het product. Eenheid kan worden afgesproken (seconden, uren, dagen, weken) Contactadressen Dit zijn de adressen die getoond worden aan de bezoeker of KCC medewerker. Hiervoor moet de extensie tt\_address ook zijn geinstalleerd op deze TYPO3 installatie. **Tabblad Overig** Synoniemen Hier zijn de synoniemen te selecteren die van toepassing zijn op dit product. Zoektermen Hier zijn de zoektermen te selecteren die betrekking hebben op dit product. Deze zoektermen zorgen voor een direct match: Als iemand in de kennisbank zoekt op een van de termen die geselecteerd zijn voor een product, dan zal dit product getoond worden in de zoekresultaten. De positie is afhankelijk van het gewicht en de volgorde van het product in de database. Vraag-antwoordcombinaties De aan dit product gekoppelde vraag-antwoordcombinaties. Deze worden getoond bij het product, in de detail weergave van het product. Als een vraag-antwoordcombinatie gevonden wordt bij het zoeken, dan kan het bijbehorende product ook getoond worden in de resultaten (afhankelijk van het gewicht van het product). Informatie bij vraag-antwoordcombinaties Extra informatieveld wat getoond wordt bij vraag-antwoordcombinaties. Afbeelding Afbeelding die bij het product getoond wordt. Bijlagen Documenten die bij het product horen. Gerelateerde producten Producten die een relatie hebben met dit product. Notities Krabbels/Notities van collega's (KCC medewerkers) over het betreffende product. Achterliggende gedachte is dat men samenwerkt om de burger zo goed mogelijk van dienst te kunnen zijn: hiervoor kunnen specifieke productgerelateerde krabbels zinvol. Authoriteit (gebruikersgroep) De frontend gebruikersgroep waar het product bij hoort. Leden van deze groep krijgen alle waarden van het product te zien en zijn ook in staat om krabbels toe te voegen. Ook zijn deze gebruikers in staat om een registratie af te handelen. Verantwoordelijke gebruiker(s) voor dit product Frontend gebruikers die toegang hebben tot dit product. Deze gebruikers krijgen alle waarden van het product te zien en zijn ook in staat om krabbels toe te voegen. **Tabblad Links** Aanvraagformulier Een link naar het aanvraagformulier behorende bij dit product. Dit kan een link naar een interne TYPO3 pagina zijn, echter dit mag ook een externe URL zijn. Werkinstructies Een link naar de werkinstructies behorende bij dit product. Dit kan een link naar een interne TYPO3 pagina zijn, echter dit mag ook een externe URL zijn. Proces beschrijving Een link naar de producs beschrijving van dit product. Dit kan een link naar een interne TYPO3 pagina zijn, echter dit mag ook een externe URL zijn. Wet- en regelgeving Gerelateerde wet- en regelgeving behorende bij dit product. Dit kan een link naar een interne TYPO3 pagina zijn, echter dit mag ook een externe URL zijn. Bron Brongegevens voor dit product. Dit kan een link naar een interne TYPO3 pagina zijn, echter dit mag ook een externe URL zijn. Doelgroep Doelgroep gedefinieerd door samenwerkende catalogi. Dit kan organisatie / ondernemer of particulier zijn. Taal De taal van dit product. Themas Samenwerkende Catalogi Een of meerdere thema's die van toepassing zijn op dit product. Minimaal 1 thema moet geselecteerd zijn om het product geldig te laten zijn voor de samenwerkende catalogi. Gebruikers voor doorverbinden Hier kunnen gebruikers worden geselecteerd die getoond zullen worden aan KCC medewerkers als zij een product bekijken. KCC medewerkers kunnen dan in een oogopslag zien naar welke gebruikers / afdelingen zij moeten doorverbinden om de burger goed te kunnen helpen met vragen die betrekking hebben op dit product. **De overige tabbladen (Beschrijving, Aanvragen, Extra Informatie, Contact Info, Bijzonderheden, Wettelijke grondslag, Voorwaaren, Resultaten)** Deze tabbladen zijn zichtbaar afhankelijk van de waarde gekozen bij 'ingeladen rte velden' van dit product. De opbouw van de volgende tabbladen is hetzelfde (afgezien van beschrijving, daar is een extra veld opgenomen wat getoond wordt als korte product-beschrijving in lijsten): Elk tabblad heeft een 3-tal teksten en een 3-tal checkboxes. Met de checkboxen geef je aan of het eerstvolgende element getoond moet worden. *Afbeelding 4: RTE velden voorbeeld* |img-4| De indeling is als volgt: Gebruik tekst voor ... Tekst voor … Gebruik generiek tekst Generieke tekst Gebruik tekst na ... Tekst na … Met deze indeling is heel fijn te bepalen welke teksten van een product getoond moeten worden op de webste en welke niet. Er wordt vanuit gegaan dat in de toekomst de generieke teksten gesynchroniseerd zullen worden met een externe voorziening. Deze teksten mogen (vanwege juridische afspraken) niet gewijzigd worden, daarom is de inhoud van de 'generieke tekst' velden ook niet te wijzigen. De generieke tekst kan altijd vooraf en achteraf worden aangevuld met een lokale tekst. Daar zijn de 'tekst voor...' en 'tekst na...' velden voor. .. _Zoekterm: Zoekterm ^^^^^^^^ De tabel zoekterm bevat de zoektermen die gekoppeld (kunnen) worden aan producten in de PDC. Als een product gekoppeld is aan een zoekterm, dan wordt het product direct vindbaar op die term. Afhankelijk van het 'gewicht' van het product wordt deze hoger in de resultaten weergegeven als er een match is. Een zoekterm record bevat 2 kolomen: Verbergen Hiermee is de zoekterm (tijdelijk ) te verbergen Zoekterm. Deze kolom bevat de daadwerkelijke zoekterm. .. _Synoniem: Synoniem ^^^^^^^^ De tabel synoniem bevat synoniemen van elkaar. Een Synoniem kan gekoppeld worden aan 0 of meer andere synoniemen. Een product kan gekoppeld worden aan 0 of meer synoniemen. Een product is vindbaar via de synoniemen van de gekoppelde synoniemen. Als de synoniem 'paspoort' is gekoppeld aan de synoniem 'identiteitsbewijs' en de synoniem 'paspoort' is gekoppeld aan het product, dan wordt het product gevonden op het woord 'identiteitsbewijs'. De velden van een synoniem record: Verbergen Hiermee is de synoniem (tijdelijk) te verbergen. Synoniem De synoniem (het woord zelf) Gerelateerd aan De synoniemen waar deze synoniem aan gerelateerd is. .. _Afhandeling: Afhandeling ^^^^^^^^^^^ De tabel afhandeling bevat alle afhandelingen die geregistreerd zijn. Hieruit is af te leiden welke stappen een medewerker uitvoert om tot een antwoord te komen, en hoe lang de medewerker hierover doet. Een afhandeling bevat de volgende kolommen: Onderwerp vraag Dit is de actuele zoekvraag die is ingevoerd, of het handmatig opgegeven onderwerp van de vraag (bij handelingen staan ook de vraag vermeld die is ingevoerd). Begin tijd Tijd waarop de afhandeling is begonnen (wanneer de vraag is binnengekomen). Eind tijd Tijd waarop de afhandeling is afgelopen. Gesloten (Closed) Is de afhandeling gesloten? Indien deze niet is aangevinkt kan het zijn dat deze afhandeling nog bezig is. Resultaat Het (geselecteerde) resultaat van de afhandeling. Opmerkingen Opmerking die geplaatst is door de medewerker mbt de afhandeling. Handelingen uitgevoerd De acties die zijn ondernomen om de de vraag af te handelen. Een handeling is een record van het type 'Acties gedaan'. Zie definitie bij 'overige tabellen'. Vervolgvraag Eventuele aansluitende vervolgvraag die gesteld is (ander onderwerp). Door gebruiker De ingelogde FE user die de afhandeling heeft gedaan. .. _Statistieken: Statistieken ^^^^^^^^^^^^ Het is mogelijk om in de PDC te registreren welke producten / vraag- antwoordcombinaties bekeken worden en hoe vaak. Hiervoor wordt de statistiekentabel gebruikt. Deze gegevens worden weer gebruikt in de top-x weergave van de PDC. Een record van de statistieken tabel bevat de volgende kolommen: Actie Wat is er gedaan (product- of VAC bekeken) VAC (afhankelijk van actie) De vraag-antwoordcombinatie die is bekeken. Product (afhankelijk van actie) Het product wat is bekeken. Aantal bezichtigingen ingelogd Hoe vaak het product of VAC record op het registratiemoment is bekeken, door een ingelogde gebruiker. Totaal aantal bezichtigingen Hoe vaak het product of VAC record op het registratiemoment is bekeken, ongeacht of de gebruiker was ingelogd of niet. Registratiemoment Het moment waarop de registratie telt. Hiervoor wordt een in TypoScript (plugin.tx\_ncgovpdc.settings.statistics.timestampFormat) ingestelde grofkorreligheid genomen: des te nauwkeuriger dit moment, des te meer statisiek records er worden aangemaakt – des te nauwkeuriger is te bepalen wanneer wat het meest wordt bekeken. Als dit moment heel onnauwkeurig wordt bijgehouden, dan is er minder gedetailleerd te bepalen wanneer wat het meest wordt bekeken; er worden minder statistiek records aangemaakt dan. De default instelling is dat er per maand wordt bijgehouden hoe vaak de records worden bekeken. Let er op: dit timestamp formaat moet een aansluitend geheel nummer zijn, waarop gesorteerd kan worden (dus yyyymmddhhmmss). .. _Beheer-vraag-antwoordcombinaties-VAC: Beheer vraag-antwoordcombinaties (VAC) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ De PDC biedt de mogelijkheid om de content-collectie van de overheid te gebruiken. Zie hierover: `http://www.e-overheidvoorburgers.nl/standaarden,contentmodellen `_ Er is de mogelijkheid om regelmatig de gegevens te laten downloaden en synchroniseren met de collectie die beheerd wordt door de overheid. Het is ook mogelijk om naast de content-collectie van de overheid een eigen (lokale) verzameling bij te houden. Een vraag-antwoordcombinatie bestaat uit twee delen: 1- De vraag-antwoordcombinatie Dit is een soort 'container' waar metadata met betrekking tot de vraag-antwoordcombinatie in wordt opgeslagen. Deze metadata wordt aangeleverd. 2- De vraag-antwoordcombinatie per kanaal Elke vraag-antwoordcombinatie kan een vraag en antwoord bevatten specifiek gericht op een kanaal. Bijvoorbeeld website of e-mail. .. _Vraag-antwoordcombinatie: Vraag-antwoordcombinatie """""""""""""""""""""""" **Algemeen** Verbergen Hiermee is aan te geven of het record getoond mag worden aan de frontend. Sorteervolgorde in zoekresultaten Dit veld geeft het gewicht aan van de vraag-antwoordcombinatie binnen de zoekresultaten, des te hoger dit getal, des te hoger de VAC in de resultaten. Unieke Identifier Dit is de unieke identifier waarmee de VAC uniek geidentificeerd kan worden binnen de VAC collectie van de overheid. Doelgroep De doelgrooep van toepassing voor de VAC. Onderwerpen / zoektermen De onderwerpen van toepassing op de VAC. Vraag-antwoordcombinatie per kanaal Dit zijn de VACs, specifiek per kanaal. Deze elementen bevatten de daadwerkelijke vraag en antwoord voor het specifieke kanaal. Referentie naar product Referenties naar een product. Dit is een link-element aangezien hier doorgaans links naar overheidsproducten in staan. Dit zijn referenties naar externe bronnen. Referentie naar vraag-antwoordcombinatie Referenties (links) naar VACs (doorgaans interne links). **Overheid webmetadata** Taal De taal van de VAC Creator scheme Schema van de maker van de VAC Creator De maker van de VAC Laatst gewijzigd De datum waarop de VAC het laatst is gewijzigd. Spatial scheme Schema van de ruimtelijke indeling Spatial waarde Schema van de ruimtelijke waarde Temporal periode start De start van de periode waar de VAC betrekking op heeft Temporal periode eind Het eind van de periode waar de VAC betrekking op heeft Authoriteit De partij die bevoegdheid heeft over deze VAC Contributor De partij die bijdrage heeft geleverd aan de VAC Beschikbaar periode start De periode vanaf wanneer de VAC beschikbaar is. Beschikbaar periode eind De periode tot wanneer de VAC beschikbaar is. Behorend tot de topN collectie Of deze VAC tot de topN collectie behoort. Prioriteit De belangrijkheid van de VAC. Vergelijkbaar met gewicht edoch minder fijnmazig (mogelijk waarden: laag, medium, hoog). Leverancier systeem Het systeem waarmee de VACs ontsloten zijn. Status redactie De status van de VAC – aangegeven door de redactie. Datum wanneer VAC gecontroleerd wordt Dit is de datum waarop de VAC wordt gecontroleerd door de eigenaar, het kan dus zijn dat de VAC op deze datum gewijzigd wordt en de volgende synchronisatieronde gewijzigd zal zijn. Historie wijzigingen De versie history van de VAC. Gebruikersgroep die deze VAC mag zien (leeg voor alle) Als een gebruiker is ingelogd en lid Is van de gebruikersgroep die hier geselecteerd is, dan zal de gebruiker de VACs kunnen zien als hij aan het zoeken is. .. _Vraag-antwoordcombinatie-per-kanaal: Vraag-antwoordcombinatie per kanaal """"""""""""""""""""""""""""""""""" Verberg Hiermee is de VAC per kanaal te verbergen Vraag (max 90 karakters, verplicht) De vraag is de vraag die gesteld is. Deze vraag moet voldoen aan de richtlijnen opgesteld door de overheid (zie `http://www.e-overheidvoorburgers.nl/standaarden,contentmodellen `_ ). Dit element moet worden ingevuld en kan niet leeg blijven. Antwoord (eerste deel, max 650 karakters, verplicht) Dit is het eerste (enigszins beknopte) deel van het antwoord. Dit moet de vraag al beantwoorden. Antwoord (uitgebreid vervolg op antwoord, maximaal 2500 karakters, optioneel) Dit deel is een toevoeging op het antwoord en zal aanvullende informatie bevatten. Onderwater antwoord (zichtbaar voor ingelogde medewerkers, maximaal 100 karakters, optioneel) Dit antwoord is alleen zichtbaar voor ingelogde gebruikers (bijvoorbeeld medewerkers KCC) en bevat specifieke informatie die gericht is op medewerkers van de gemeente. Overige informatie (meerdere bronnen mogelijk) Bevat links naar externe of interne bronnen. Kanaal van toepassing (verplicht) Het kanaal waarop de VAC per kanaal van toepassing is. .. _Overige-tabellen: Overige tabellen ^^^^^^^^^^^^^^^^ **Revisie** Deze tabel worden de revisies in opgeslagen die gekoppeld zijn aan vraag-antwoordcombinaties, die worden meegeleverd in de feed die de overheid aanbiedt. Het is natuurlijk mogelijk om voor de lokale vraag- antwoordcombinaties de wijzigingen (handmatig) met een revisie record bij te houden, om zo de historie bij te houden. **Log** In de log tabel worden meldingen opgeslagen die kunnen helpen bij de ontwikkeling van de applicatie, of als er iets mis gaat met de applicatie. **Onderwerp** De onderwerp tabel is gekoppeld aan de vraag-antwoordcombinaties. Het is mogelijk om hier zelf records aan toe te voegen, maar dit Is af te raden, aangezien hier in principe alleen onderwerpen inkomen die uit de collectie VraagstructuurRijkThema komen: `http://standaarden.overhe id.nl/owms/3.5/doc/waardelijsten/overheid.vraagstructuurrijkthema.html `_ **Tip** De tip tabel bevat alle gebruikers notities van de producten. Het is af te raden om direct via deze tabel records te wijzigen of toe te voegen, dit moet vanuit de gekoppelde producten gebeuren. Een tip heeft 4 kolommen: Verbergen Hiermee is aan te geven of het record getoond mag worden aan de frontend. Naam Dit is de naam/ondewerp van de notitie Beschrijving Dit is de notitie zelf Auteur Dit is de frontend user die de notitie gemaakt heeft. **Acties gedaan** Deze tabel bevat de afzonderlijke handelingen die zijn uitgevoerd bij het afhandelen van een registratie. Het heeft weinig zin om hier zelf records aan toe te voegen. Deze tabel bevat de kolommen: Actie De handeling die is uitgevoerd Zoekvraag gesteld (afhankelijk van de actie) Informatie over de zoekvraag die is uitgevoerd. Product (afhankelijk van de actie) Het product dat is bekeken. VAC (afhankelijk van de actie) De vraag-antwoordcombinatie die is bekeken. **Afhandeling resultaat** Deze tabel bevat de te kiezen resultaten voor een afhandeling bij het registreren van een afhandeling. Het is mogelijk om bestaande resultaten te wijzigen / of hier zelf resultaten aan toe te voegen. Dit record kan worden verborgen om deze niet meer zichtbaar te maken bij het registreren van een afhandeling. **Let op** : Er moet altijd een record zijn wat gebruikt wordt als de afhandeling te lang duurt (sessie verlopen is). Het systeem gebruikt dit om afhandelingen automatisch te sluiten als ze te lang open staan. De duur van de sessie is in te stellen met TypoScript: (plugin.tx\_ncgovpdc.settings.registration.sessionTimeout). Als dit record wordt verwijderd (of niet is aangemaakt) dan zal de extensie een error geven. .. _Installatiehandleiding: Installatiehandleiding ---------------------- .. _Installatie: Installatie ^^^^^^^^^^^ Voor deze installatie is TYPO3 versie 4.3 vereist, daar deze versie de minimale vereiste versie is voor de benodigde systeem extensies *fluid* en *extbase* . Zonder deze extensies kan de PDC NIET functioneren. Zorg dat zowel extbase als fluid daadwerkelijk zijn geinstalleerd. .. _Minimale-installatie: Minimale installatie ^^^^^^^^^^^^^^^^^^^^ Daarna zijn minimaal de volgende stappen nodig voor een minimale installatie (product A-Z index + product detail): Installeer de pdc extensie, via de extension manager. Maak een storage folder aan, waar de PDC records geplaatst zullen worden. Maak een TypoScript template aan voor de extensie. Zorg dat deze template wordt geinclude door de 'hoofd' TypoScript template. Zorg dat 'Producten en diensten catalogus (ncgov\_pdc)' bij 'Statisch opnemen (vanuit extensies):' in 'Opnames' is toegevoegd. Installeer de plugin op een pagina naar wens. Kies hiervoor de 'Product: A-Z index'. Zie de afbeeldingen hieronder voor de te volgen stappen. *Afbeelding 5: Installeren van de plugin* |img-5| *Klik aan de linkerkant op list, in het midden op de gewenste pagina, rechts op het plusje.* *Afbeelding 6: Installeren van de plugin* |img-6| *Klik hier op pagecontent.* *Afbeelding 7: Installeren van de plugin* |img-7| *Afbeelding 8: Installeren van de plugin* |img-8| *Bij tabblad general: selecteer 'insert plugin' bij type.* *Bij tabblad plugin Product- en dienstencatalogus bij plugin.* Optioneel is het mogelijk om een productdetail pagina te maken, waar de producten zelf op getoond worden. Maak hiervoor een extra pagina aan, installeer hierop de plugin. Stel de volgende TypoScript waarde in: plugin.tx\_ncgovpdc.settings.pages.productDetailPage, deze moet verwijzen id van de net aangemaakte pagina. De extensie zorgt er dan voor dat als een product wordt aangeklikt deze op zijn eigen pagina wordt getoond. .. _Templates-wijzigen: Templates wijzigen ^^^^^^^^^^^^^^^^^^ Het is mogelijk om de templates lokaal te wijzigen. Kopieer hiervoor de templates (inclusief mappen) vanuit de extensie folder (EXT:ncgov\_pdc/Resource/Private/Templates/\*) naar een benaderbaar pad op de webserver (bijvoorbeeld fileadmin/tmpl/pdc/). **Let op:** is belangrijk dat de mappen waar de templates in staan ook worden gekopieerd! Hierna moet de TypoScript waarde plugin.tx\_ncgovpdc.view.templateRootPath worden ingesteld op het pad waar de templates zijn neergezet (in bovenstaand voorbeeld: plugin.tx\_ncgovpdc.view.templateRootPath = fileadmin/tmpl/pdc/). .. _Extensie-opties: Extensie opties --------------- .. _Verschillende-weergaven: Verschillende weergaven ^^^^^^^^^^^^^^^^^^^^^^^ De extensie is veelzijdig en heeft verschillende weergaven, elk voor een specifiek doel. Hieronder een toelichting voor elke weergave: *Afbeelding 9: weergaven pdc* |img-9| .. ### BEGIN~OF~TABLE ### .. _Product-A-Z-index: Product: A-Z index """""""""""""""""" .. container:: table-row Weergave Product: A-Z index Beschrijving Toont een index (A-Z) en geeft een overzicht van producten die met een bepaalde letter beginnen (dus alle producten beginnende met 'A'). Toont ook het aantal producten wat begint met de betreffende letter. .. _Product-Top-bekeken-producten: Product: Top bekeken producten """""""""""""""""""""""""""""" .. container:: table-row Weergave Product: Top bekeken producten Beschrijving Productoverzicht van producten die het vaakst zijn bekeken. .. _Product-Samenwerkende-catalogi-index-feed: Product: Samenwerkende catalogi index feed """""""""""""""""""""""""""""""""""""""""" .. container:: table-row Weergave Product: Samenwerkende catalogi index feed Beschrijving XML index feed, nodig voor aansluiting met de Samenwerkende Catalogi. .. _Product-test: Product: test """"""""""""" .. container:: table-row Weergave Product: test Beschrijving Niet gebruiken. .. _Kennisbank-zoeken: Kennisbank: zoeken """""""""""""""""" .. container:: table-row Weergave Kennisbank: zoeken Beschrijving Bevat de zoekengine van de PDC. Via deze weergave is het mogelijk om producten als vraag- antwoord combinaties te doorzoeken. .. _Kennisbank-Top-bekeken-VACs: Kennisbank: Top bekeken VACs """""""""""""""""""""""""""" .. container:: table-row Weergave Kennisbank: Top bekeken VACs Beschrijving Overzicht van de meest bekeken vraag- antwoord combinaties. .. _Kennisbank-Synchronisatie: Kennisbank: Synchronisatie """""""""""""""""""""""""" .. container:: table-row Weergave Kennisbank: Synchronisatie Beschrijving Deze weergave wordt gebruikt voor het synchroniseren van de content collectie vraag- antwoord combinaties van de overheid. .. _Registratie-Status: Registratie: Status """"""""""""""""""" .. container:: table-row Weergave Registratie: Status Beschrijving Hier is het mogelijk om een registratie te beginnen, af te handelen of de status te bekijken. .. _Product-import-expert-only: Product: import (expert only) """"""""""""""""""""""""""""" .. container:: table-row Weergave Product: import (expert only) Beschrijving Neem contact op om deze weergave te gebruiken. .. _Product-Tabs: Product: Tabs """"""""""""" .. container:: table-row Weergave Product: Tabs Beschrijving Deze weergave maakt het mogelijk om product- elementen als link te gebruiken voor in het menu. .. ###### END~OF~TABLE ###### .. _Plugin-opties: Plugin opties ^^^^^^^^^^^^^ *Afbeelding 10: Plugin opties* |img-10| De plugin heeft de volgende opties: - Gebruik template voor detailweergave: Hiermee is in te stellen dat in de detailweergave een andere template wordt gebruikt. Gebruik dit om de TypoScript te overrulen. Dit is te gebruiken om in een linker- of rechterkolom een alternatieve weergave van een product te realiseren (bijvoorbeeld voor het tonen van contactinformatie, of gerelateerde producten). - Kennisbank: Toon enkele VAC vraag (ongeacht parameters) Toon alleen de vraag, waarvan het id is meegegeven aan de URL (dus geen zoekresultaten) - Registratie voor deze instantie uitschakelen Schakelt de registratie uit voor deze plugin instantie. Gebruik dit om dubbele registratieregels te voorkomen als de plugin meerder malen op de dezelfde pagina wordt gebruikt. - Statistiekenregistratie voor deze instantie uitschakelen Schakelt de statistieken registratie voor deze instantie uit. Gebruik dit om te voorkomen dat er dubbel geteld wordt als er meer dan 1 plugin instantie op dezelfde pagina wordt gebruikt. - Extensieweergave: De gekozen weergave van de extensie. Zie vorige paragraaf. - Startpunt: De folder waar de pdc records zich bevinden. .. _TS-configuratie: TS configuratie --------------- Hieronder een opsomming van de plugin configuratie opties die beschikbaar zijn voor deze extensie: .. ### BEGIN~OF~TABLE ### .. _database: database ^^^^^^^^ .. container:: table-row Property database Data type Description Zie **database** .. _wordsNotRelevantForSearch: wordsNotRelevantForSearch ^^^^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property wordsNotRelevantForSearch Data type string Description Bevat kommagescheiden lijst met stopwoorden. Deze woorden worden uit de zoekopdracht gefilterd. Default: is,de,een,het,met,wat,en,ik,kan .. _controllers: controllers ^^^^^^^^^^^ .. container:: table-row Property controllers Data type Description Zie **controllers** .. _registration: registration ^^^^^^^^^^^^ .. container:: table-row Property registration Data type Description Zie **registration** .. _statistics: statistics ^^^^^^^^^^ .. container:: table-row Property statistics Data type Description Zie **statistics** .. _contentMyQuestionWasNotAnswered: contentMyQuestionWasNotAnswered ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property contentMyQuestionWasNotAnswered Data type Int Description id van het contentelement wat getoond wordt als de vraag (van de gebruiker) niet was beantwoord (ahv zoekopdracht). .. _contentNoResultsFound: contentNoResultsFound ^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property contentNoResultsFound Data type Int Description Id van het contentelement wat getoond wordt als er geen resultaten gevonden zijn op de gestelde vraag. .. _contentPoseQuestion: contentPoseQuestion ^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property contentPoseQuestion Data type Int Description Id van het content element wat getoond wordt als er geen vraag is gesteld of de vraag was leeg. .. _vraagAntwoordCombinaties: vraagAntwoordCombinaties ^^^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property vraagAntwoordCombinaties Data type Description Zie **vraagAntwoordCombinaties** .. _samenwerkendeCatalogi: samenwerkendeCatalogi ^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property samenwerkendeCatalogi Data type Description Zie **samenwerkendeCatalogi** .. _pages: pages ^^^^^ .. container:: table-row Property pages Data type Description Zie **pages** .. _Persistence-storagePid: Persistence.storagePid ^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property Persistence.storagePid Data type Description PageId van de storagefolder. De folder waar alle pdc records zijn opgeslagen. .. _csvImport: csvImport ^^^^^^^^^ .. container:: table-row Property csvImport Data type Description Zie **csvImport** .. ###### END~OF~TABLE ###### .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _Database-database: Database (database.) """""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _FrequentlyAskedQuestion: FrequentlyAskedQuestion ~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property FrequentlyAskedQuestion .searchableColumns Data type String Description Kommagescheiden lijst met database kolommen die doorzocht worden als iemand een zoekopdracht invoert in de kennisbank. .. _Product: Product ~~~~~~~ .. container:: table-row Property Product .searchableColumns Data type String Description Kommagescheiden lijst met database kolommen die doorzocht worden als iemand een zoekopdracht invoert in de kennisbank. .. _Product-userAvailability: Product.userAvailability ~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property Product.userAvailability Data type Description Zie hieronder. Hiermee is in te stellen hoe de extensie gebruikers voor doorverbinden weergeeft (en uit welke tabel de gebruikers info wordt gehaald). Dit systeem gaat er vanuit dat een gebruiker een kolom heeft waaruit is af te leiden wat de status van de gebruiker op dit moment is. .. ###### END~OF~TABLE ###### database.Product.userAvailability { useUsersAvailableColumn = 1 lookupTable = orderBy = r. columnToDetermineAvailability = displayColumns = } Als useUserAvailableColumn 1 is, wordt het mogelijk om zelf een andere tabel te gebruiken. moet dan de andere tabel zijn, bevat de kolom waarop gesorteerd wordt, is de kolom die gebruikt wordt om de status uit te lezen en bevat de kolommen die getoond worden uit de tabel. Verder is het mogelijk verschillende statussen te definieren voor de gebruikers. Op het moment zijn er 4 statussen gedefinieerd: ongedefineerd, beschikbaar, niet beschikbaar, bezet. database.Product.userAvailability.columnStatusesAvailable { { match = description = icon = } noMatch { description = icon = } is een status naam, om de status een naam te geven. reguliere expressie om de status van de gebruiker mee te identificeren (bijvoorbeeld /IN/ voor de waarde 'IN'. beschrijving van de status, deze wordt weergegeven in de frontend bij de gebruiker. pad naar het icoon waarmee de status van de gebruiker wordt weergegeven. De noMatch conditie bestaat altijd. Deze wordt actief als er geen geldige match gevonden kan worden. De zogenaamde 'default' status van een gebruiker. .. _Controllers-controllers: Controllers (controllers.) """""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _Product-detail-image-maxWidth: Product.detail.image.maxWidth ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property Product.detail.image.maxWidth Data type String Description De maximale breedte van het image voor het product. .. _Product-detail-image-maxHeight: Product.detail.image.maxHeight ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property Product.detail.image.maxHeight Data type String Description De maximale breedte van het image voor het product. .. _FrequentlyAskedQuestion-actions-find: FrequentlyAskedQuestion.actions.find ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property FrequentlyAskedQuestion.actions.find Data type Description Instellingen met betrekking tot de kennisbank. Zie onder .. ###### END~OF~TABLE ###### find { maxFrequentlyAskedQuestionResultCount = maxFrequentlyAskedQuestionKeywordResultCount = maxFrequentlyAskedQuestionProductResultCount = maxFrequentlyAskedQuestionSynonymResultCount = maxSamenwerkendeCatalogiResultCount = showSearchBox = otherSearchFormMethodIsPost = otherSearchFormElement = hiermee kan een zoekveld worden uitgelezen van een andere extensie (bijvoorbeeld Solr) searchOptions { // Show or hide search options checkboxes display { matchExactPhrase = 0 includePrivateResults = 1 includeBusinessResults = 1 includeRemoteProducts = 1 } // Set default values for search options (regardless of if checkboxes are shown or hidden) defaultValues { matchExactPhrase = 0 includePrivateResults = 1 includeBusinessResults = 1 includeRemoteProducts = 0 } } } .. _Registration-registration: Registration (registration.) """""""""""""""""""""""""""" Configuratieopties ten behoeve van registratie afhandelen. .. ### BEGIN~OF~TABLE ### .. _sessionTimeout: sessionTimeout ~~~~~~~~~~~~~~ .. container:: table-row Property sessionTimeout Data type int Description Duur voordat een sessie aan wordt gemerkt als timed out. (niet afgehandeld binnen de gestelde duur) In seconden. .. _expiredResult: expiredResult ~~~~~~~~~~~~~ .. container:: table-row Property expiredResult Data type int Description Waarde van het resultaat record waarmee wordt aangegeven dat de sessie niet tijdig is afgehandeld. .. _registerFrequentlyAskedQuestionForSearch: registerFrequentlyAskedQuestionForSearch ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property registerFrequentlyAskedQuestionForSearch Data type int Description Als een VAC wordt opgengeklapt, moet deze dan worden meegeteld in de registratie? .. _enabled: enabled ~~~~~~~ .. container:: table-row Property enabled Data type int Description Hiermee is het mogelijk de registratie in- of uit te schakelen. .. _registerEmptySearch: registerEmptySearch ~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property registerEmptySearch Data type Int Description Of een lege zoekopdracht moet worden geregistreerd .. ###### END~OF~TABLE ###### .. _Statistics-statistics: Statistics (statistics.) """""""""""""""""""""""" Instellingen voor de statistieken registratie- en weergave. .. ### BEGIN~OF~TABLE ### .. _enabled: enabled ~~~~~~~ .. container:: table-row Property enabled Data type int Description Statistieken ingeschakeld. .. _timestampFormat: timestampFormat ~~~~~~~~~~~~~~~ .. container:: table-row Property timestampFormat Data type String Description Formaat van de tijd waarop geteld wordt. Default Ym ( in januari 2010 dus voor 201001 wordt er geturfd hoe vaak een product wordt getoond) Als dit Ymd is dan wordt er per dag bijgehouden hoe vaak een product wordt getoond. Dit levert meer records op, maar wel een beter zicht van wanneer de producten / VACS bekeken worden. .. _topView-numberOfItems: topView.numberOfItems ~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property topView.numberOfItems Data type Int Description Het aantal records wat getoond wordt in de top X. .. _topView-timeOffset: topView.timeOffset ~~~~~~~~~~~~~~~~~~ .. container:: table-row Property topView.timeOffset Data type String Description Offset van de tijd ten opzichte van het huidgige moment waarop de top X getoond wordt. Default '-1 month' (dus top X van tot 1 maand terug). .. ###### END~OF~TABLE ###### .. _Vraag-antwoordcombinaties-vraagAntwoordCombinaties: Vraag-antwoordcombinaties (vraagAntwoordCombinaties.) """"""""""""""""""""""""""""""""""""""""""""""""""""" Instellingen benodigd voor het gebruik van de vraag- antwoordcombinaties. .. ### BEGIN~OF~TABLE ### .. _skipDownload: skipDownload ~~~~~~~~~~~~ .. container:: table-row Property skipDownload Data type Int Description Niet de laatste xml downloaden van de overheid, maar de laatst gedownloade versie gebruiken (voornamelijk voor debug gebruiken) .. _source: source ~~~~~~ .. container:: table-row Property source Data type String Description Bron waar de vraagantwoordcombinaties gedownload kunnen worden. .. ###### END~OF~TABLE ###### .. _Samenwerkende-catalogi-samenwerkendeCatalogi: Samenwerkende catalogi (samenwerkendeCatalogi.) """"""""""""""""""""""""""""""""""""""""""""""" De instellingen benodigd voor de samenwerkende Catalogi. .. ### BEGIN~OF~TABLE ### .. _Use: Use ~~~ .. container:: table-row Property Use Data type Int Description Gebruik maken van samenwerkende catalogi? .. _apiUrl: apiUrl ~~~~~~ .. container:: table-row Property apiUrl Data type String Description Url van de samenwerkende catalogi api voor het opvragen .. _apiUsername: apiUsername ~~~~~~~~~~~ .. container:: table-row Property apiUsername Data type String Description Gebruikersnaam voor het opvragen .. _apiPassword: apiPassword ~~~~~~~~~~~ .. container:: table-row Property apiPassword Data type String Description Wachtwoord voor het opvragen .. _typeInformatie: typeInformatie ~~~~~~~~~~~~~~ .. container:: table-row Property typeInformatie Data type String Description Type informatie. Default 'productbeschrijving' .. _author: author ~~~~~~ .. container:: table-row Property author Data type String Description Auteur voor publiceren (gemeentenaam) .. _authorType: authorType ~~~~~~~~~~ .. container:: table-row Property authorType Data type String Description Auteur type (gemeente) .. _publisher: publisher ~~~~~~~~~ .. container:: table-row Property publisher Data type String Description Publicerende organisatie (naam) .. _publisherType: publisherType ~~~~~~~~~~~~~ .. container:: table-row Property publisherType Data type String Description Type publicerende organisatie (gemeente) .. _defaultLanguage: defaultLanguage ~~~~~~~~~~~~~~~ .. container:: table-row Property defaultLanguage Data type String Description Standaardtaal (nl) .. ###### END~OF~TABLE ###### .. _Pages-pages: Pages (pages.) """""""""""""" Hier staan de pagina's gedefinieerd die gebruikt worden door de PDC. .. ### BEGIN~OF~TABLE ### .. _productDetailPage: productDetailPage ~~~~~~~~~~~~~~~~~ .. container:: table-row Property productDetailPage Data type String Description PageId waar een product single getoond wordt. .. _frequentlyAskedQuestionDetailPage: frequentlyAskedQuestionDetailPage ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property frequentlyAskedQuestionDetailPage Data type String Description PageId waar een VAC single getoond wordt. .. _closeRegistrationPage: closeRegistrationPage ~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property closeRegistrationPage Data type String Description Pagina waar de registratie wordt afgesloten. .. ###### END~OF~TABLE ###### .. _CsvImport: CsvImport """"""""" Configuratie voor eenmalige import van een CSV bestand. De PDC bevat de mogelijkheid om geautomatiseerd product records te laten aanmaken en deze te laten vullen met gegvens vanuit een csv bestand. Let op met het gebruik hiervan, de import is vrij krachtig. .. ### BEGIN~OF~TABLE ### .. _delimiter: delimiter ~~~~~~~~~ .. container:: table-row Property delimiter Data type String Description Scheidingsteken .. _enclosure: enclosure ~~~~~~~~~ .. container:: table-row Property enclosure Data type String Description Teken waarmee een string wordt ingepakt. .. _columnLength: columnLength ~~~~~~~~~~~~ .. container:: table-row Property columnLength Data type String Description Vaste lengte van kolom. .. _firstLineContainsColumnNames: firstLineContainsColumnNames ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property firstLineContainsColumnNames Data type int Description Eerste regel bevat klomnamen. .. _useFirstLineForCsvLineColumNameMapping: useFirstLineForCsvLineColumNameMapping ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property useFirstLineForCsvLineColumNameMapping Data type int Description De eerste regel wordt gebruikt om kolomnamen mee te identificeren voor het mappen op kolomvelden. .. _useMappingArrayKeysForCsvLineColumnNameMapping: useMappingArrayKeysForCsvLineColumnNameMapping ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property useMappingArrayKeysForCsvLineColumnNameMapping Data type int Description De velden gedefinieerd in mapping. worden gebruikt voor het mappen van de kolomnamen op de csv velden. (mapping. moet dan wel compleet zijn) .. _file: file ~~~~ .. container:: table-row Property file Data type String Description Pad naar het csv bestand. .. _Mapping: Mapping. ~~~~~~~~ .. container:: table-row Property Mapping. Data type String Description Hier wordt de mapping gedefinieerd. Format is: = to: Dit veld wordt direct geimporteerd in de gespecificeerde kolom. of = skip Dit veld wordt overgeslagen. of = userFunc Dan wordt de hieronder gedefineerde userfunc aangeroepen voor het converteren van het veld. .. _columnSpecificImport-includeLibs: columnSpecificImport.includeLibs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property columnSpecificImport.includeLibs Data type String Description Bestand dat wordt geinclude. .. _columnSpecificImport-userFunc: columnSpecificImport.userFunc ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property columnSpecificImport.userFunc Data type strnig Description Pad naar userfunc die wordt aangeroepen voor het converteren van gespecivieerde veld. .. ###### END~OF~TABLE ###### .. _Troubleshooting: Troubleshooting --------------- .. _Known-problems: Known problems -------------- None so far. .. _TODO: TODO ---- .. _Changelog: Changelog --------- De wijzigingen worden bijgehouden in Changelog in de root van de extensie. Versie handleiding: 2010-01-22 \*\* DRAFT\*\* eerste versie. 2010-01-24 \*\* DRAFT\*\* tweede versie. .. _Sources: Sources ------- |img-11| EXT: Producten en diensten catalogus - 27 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 400 .. :id: graphics1 .. :name: graphics1 .. :width: 326 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 464 .. :id: graphics10 .. :name: graphics10 .. :width: 582 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 145 .. :id: graphics4 .. :name: graphics4 .. :width: 362 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 211 .. :id: graphics5 .. :name: graphics5 .. :width: 284 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 171 .. :id: graphics6 .. :name: graphics6 .. :width: 515 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 226 .. :id: graphics7 .. :name: graphics7 .. :width: 343 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 203 .. :id: graphics8 .. :name: graphics8 .. :width: 258 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 221 .. :id: graphics9 .. :name: graphics9 .. :width: 330 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 201 .. :id: graphics2 .. :name: graphics2 .. :width: 281 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 363 .. :id: graphics3 .. :name: graphics3 .. :width: 419 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102