PHPackages common-gateway/woo-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. common-gateway/woo-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) common-gateway/woo-bundle ========================= A bundle for storing OpenWoo objects and synchronizing these objects from OpenWoo & xxllnc zaaksysteem. 0.0.162(1y ago)06252[5 PRs](https://github.com/CommonGateway/WooBundle/pulls)EUPL-1.2PHPPHP >=8.2 Since Jul 26Pushed 1y ago3 watchersCompare [ Source](https://github.com/CommonGateway/WooBundle)[ Packagist](https://packagist.org/packages/common-gateway/woo-bundle)[ Docs](https://commongateway.nl)[ RSS](/packages/common-gateway-woo-bundle/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (182)Used By (0) OpenWoo Service =============== [](#openwoo-service) De OpenWoo Service versterkt de toegankelijkheid van overheidspublicaties volgens de Wet open overheid (Woo) door organisatiebronnen naadloos te synchroniseren met Open Index. Deze kernservice ondersteunt efficiënte zoekacties binnen Woo-categorieën en bevordert data-uitwisseling via het Common Ground OpenServices framework. Het faciliteert integratie met lokale en landelijke publicatieplatformen, inclusief koppelingen met het Kennis- en Exploitatiecentrum Officiële Publicaties (KOOP). OpenWoo.app is ontworpen voor zowel open source als proprietary platforms, waardoor het een centrale oplossing biedt voor het beheer en de zoekbaarheid van overheidsinformatie.. Kernfunctionaliteiten --------------------- [](#kernfunctionaliteiten) - **Automatische Synchronisatie:** Naadloze integratie met Open Index om overheidspublicaties automatisch bij te werken en te synchroniseren. - **Efficiënt Zoeken:** Maakt geavanceerde zoekopdrachten mogelijk binnen Woo-categorieën door de data-uitwisseling met Open Index. - **Veelzijdige Ondersteuning:** Geschikt voor zowel lokale als landelijke publicatieplatformen, waaronder een verbinding met het Kennis- en Exploitatiecentrum Officiële Publicaties (KOOP). - **Federale Zoekopdrachten:** Ondersteunt federale zoekopdrachten via koophulpje.nl, waardoor een breder bereik en toegankelijkheid van overheidspublicaties wordt gegarandeerd. - **OpenServices Framework:** Geïntegreerd met het Common Ground OpenServices framework voor gestandaardiseerde data-uitwisseling en interoperabiliteit. Installatie ----------- [](#installatie) ### Vereisten [](#vereisten) - PHP 7.4 of hoger - Symfony 5 of hoger - Docker (voor containerisatie en lokale ontwikkeling) ### Stap-voor-stap Installatiegids in een Common Gateway [](#stap-voor-stap-installatiegids-in-een-common-gateway) 1. Clone het OpenWoo repository: `git clone https://github.com/OpenWoo/OpenWooService.git` 2. Installeer afhankelijkheden met Composer: `composer install` 3. Pas de `.env` bestanden aan met uw specifieke configuraties voor de database en andere diensten. 4. Start de OpenWoo Service met Docker: `docker-compose up -d` ### Docker container [](#docker-container) Er is ook een docker-compose.yml beschikbaar voor de OpenWoo service om bovenstaande snel op te bouwen. Deze file is beschikbaar in de root folder van deze repository. Om deze te draaien is docker benodigd en zet u de volgende stappen: 1. Open een terminalvenster waarmee Docker kan worden gedraaid 2. Navigeer naar de map waarin u de repository heeft gecloned 3. Draai het commando `docker compose up` 1. Indien de image nog niet in docker beschikbaar is, zal de image opnieuw worden opgebouwd op basis van de latest versie van de [common gateway images](https://github.com/conductionnl/commonground-gateway). 2. Daarna worden de containers gestart (als de image wel beschikbaar is zal dit direct gebeuren) 4. De admin omgeving komt beschikbaar op , de frontend op Op de admin omgeving kan worden ingelogd met de default credentials `username: no-reply@test.com, password: !ChangeMe!`. Daarmee kan dan de configuratie van de omgeving worden beïnvloed. Wijzigingen die in de code van deze repository (de map src) worden gedaan worden lokaal direct overgenomen. Changes in de configuratiebestanden in deze repository (Installation-folder) worden eveneens overgenomen, maar moeten om actief te worden in de lokale omgeving nog worden ingeladen met het commando `docker compose exec php bin/console commongateway:initialize` Gebruik ------- [](#gebruik) Na de installatie kunt u de OpenWoo Service configureren om te beginnen met de automatische synchronisatie van uw organisatiebronnen naar Open Index. De synchronisaties werken aan de hand van een action in combinatie met een source. Hieronder wordt uitgelegd hoe deze ingevuld moeten worden, er zijn ook genoeg voorbeelden in de `/Installation/Action` en `/Installation/Source` folders. Er kan vanuit de volgende brontypen gesynchroniseerd worden: - Zaaksysteem - OpenWoo (en OpenConvenant) Voor elk brontypen verschilt de configuratie voor de source en action die ingevuld moet worden. ### Source [](#source) Een source heeft standaard een reference en een name nodig. De reference moet uniek zijn als bijvoorbeeld `https://commongateway.woo.nl/source/example.zaaksysteem.source.json`. #### Zaaksysteem [](#zaaksysteem) Voor een source voor een zaaksysteem moeten de location ingevoerd worden. Dat is de volledige url van het zaaksysteem url, dus inclusief `https://` aan het begin en `/api` aan het eind. Ook moeten er headers geset worden met auth gegevens om te kunnen autoriseren voor het ophalen van documenten, hier een voorbeeld: ` "headers": { "Accept": "*/*", "API-Interface-ID": "{apiInterfaceId}", "API-KEY": "{apiKey}", "Content-Type": "application/json" } ` Als je al de velden van je source goed ingevuld heb kan je hem aanzetten door `isEnabled` op true te zetten. De volledige POST van een goed ingevulde source voor het zaaksysteem ziet er als volgt uit: ` { "reference": "https://commongateway.woo.nl/source/example.zaaksysteem.source.json" "name": "Jouw zaaksysteem", "location": "https://{zaaksysteemUrl}/api", "isEnabled": true, "headers": { "Accept": "*/*", "API-Interface-ID": "{apiInterfaceId}", "API-KEY": "{apiKey}", "Content-Type": "application/json" } }` #### OpenWoo en OpenConvenant [](#openwoo-en-openconvenant) Voor een source voor OpenWoo of OpenConvenant hoeft alleen de `location` geset te worden, inclusief `https://` aan het begin en `/wp-json` aan het eind (bijv: `https://{openWooUrl}/wp-json`). Als je wilt dat je source en dus synchronisatie aanstaat moet `isEnabled` op true staan. De volledige POST van een goed ingevulde source voor het OpenWoo of OpenConvenant ziet er als volgt uit: ` { "reference": "https://commongateway.woo.nl/source/example.openwoo.source.json" "name": "Jouw OpenWoo", "location": "https://{openWooUrl}/wp-json", "isEnabled": true }` ### Action [](#action) Voor een voorbeeld van een action voor het zaaksysteem kan je kijken naar SyncEpeAction en als voor OpenWoo naar SyncBurenOpenWooAction. Voor OpenConvenant kan er gekeken worden naar SyncBurenOpenConvenantAction. Een action heeft standaard een reference en een name nodig. De reference moet uniek zijn als bijvoorbeeld `https://commongateway.nl/woo.SyncExampleAction.action.json`. Een action heeft ook een `listens` veld. Deze is in deze context meestal gelijk aan de `throws` van de algemene cronjob: `woo.default.listens`. Dit zorgt ervoor dat de action (synchronisatie) elke x minuten afgaat als in de cronjob ingesteld staat (standaard 10 minuten). Het `conditions` veld. Dit zijn extra regels waneer een action af mag gaan. In dit geval gaan de actions standaard op de `throws` van de cronjob af, ingesteld via het `listens` van de action, dus mag hier de `conditions` standaard op `{"==": [1,1]}`. Deze json logic betekend dat hij altijd afgaat (op het `listens` event). Het `class` veld. Dit geeft aan welke code uitgevoerd gaat worden voor deze action. Voor verschillende bronnen kan dit anders zijn: - zaaksysteem: `CommonGateway\\WOOBundle\\ActionHandler\\SyncXxllncCasesHandler`. - OpenWoo en OpenConvenant: `CommonGateway\\WOOBundle\\ActionHandler\\SyncOpenWooHandler`. De action heeft in de `configuratie` array een aantal velden wat geconfigureerd moet worden, sommige velden zijn verplicht en andere niet. Het verschilt ook vanuit wat voor type source (zaaksysteem, OpenWoo of OpenConvenant) gesynchroniseerd wordt: - oin (required): oin vanuit het oin register van Logius. Deze waarde wordt gebruikt zodat er later op gefiltered kan worden `?organsiatie.oin=value`. - portalUrl (required): Wordt gebruikt om de link naar de frontend mee te genereren. - source (required): De reference van de source, die je meegeeft aan je source bij het aanmaken daarvan (bijv: `https://commongateway.woo.nl/source/example.zaaksysteem.source.json`). - schema (required): Meestal de reference van het publicatie schema, voor bijna alle Woo synchronisaties wil je naar het publicatie schema mappen:` https://commongateway.nl/woo.publicatie.schema.json` - mapping (required): De mapping die gebruikt wordt om het van source object naar publicatie object te krijgen. Voor het zaaksysteem is dit `https://commongateway.nl/mapping/woo.xxllncCaseToWoo.mapping.json` en voor OpenWoo is dit `https://commongateway.nl/mapping/woo.openWooToWoo.mapping.json`, voor OpenConvenant is het `https://commongateway.nl/mapping/woo.openConvenantToWoo.mapping.json`. - organisatie (required): Textueele representatie van de organisatie waar de publicaties van zijn, meestal de gemeente naam in het geval van een gemeente. - zaaksysteemSearchEndpoint (required in geval zaaksysteem): Het endpoint wat gebruikt wordt om de publicaties op te halen in het zaaksysteem. - sourceEndpoint (required in geval OpenWoo of OpenConvenant): Endpoint waar publicaties vandaan gehaald worden. - fileEndpointReference (required in geval zaaksysteem): De reference naar het view-file endpoint voor de gesynchroniseerde documenten. Zorgt ervoor dat binnengehaalde documenten een endpoint hebben en bekeken kunnen worden. Standaard: `https://commongateway.nl/woo.ViewFile.endpoint.json` invoeren. - sourceType (required in geval OpenWoo, OpenConvenant of Notubiz): Niet verplicht in geval zaaksysteem, staat default op zaaksysteem. Anders voor OpenWoo of OpenCovenant 'openWoo' invoeren en voor Notubiz 'notubiz' invoeren. - autoPublish: Niet verplicht, standaard op true. Als de wens is dat gesynchroniseerde publicaties niet meteen op te halen zijn, dan moet dit veld op false staan. - allowPDFOnly: Niet verplicht. Op true zetten als de wens is om alleen pdf documenten te synchroniseren en geen andere bestandstypen. Check altijd ook of de action aan staat met het `isEnabled` veld. Deze moet op true staan als er gesynchroniseerd moet worden. De POST van een action voor het zaaksysteem ziet er als volgt uit: `{ "reference": "https://commongateway.nl/woo.SyncExampleAction.action.json", "name": "SyncExampleCasesAction", "listens": [ "woo.default.listens" ], "conditions": { "==": [ 1, 1 ] }, "class": "CommonGateway\\WOOBundle\\ActionHandler\\SyncXxllncCasesHandler", "configuration": { "oin": "{oinNummer}", "portalUrl": "https://conductionnl.github.io/woo-website-example", "source": "https://commongateway.woo.nl/source/example.zaaksysteem.source.json", "schema": "https://commongateway.nl/woo.publicatie.schema.json", "mapping": "https://commongateway.nl/mapping/woo.xxllncCaseToWoo.mapping.json", "organisatie": "Example", "zaaksysteemSearchEndpoint": "{zaaksysteemZoekEndpoint}", "fileEndpointReference": "https://commongateway.nl/woo.ViewFile.endpoint.json" }, "isEnabled": true }` De POST van een action voor het OpenWoo of OpenConvenant ziet er als volgt uit: `{ "reference": "https://commongateway.nl/woo.SyncExampleOpenConvenantAction.action.json", "name": "SyncExampleOpenConvenantAction", "listens": [ "woo.default.listens" ], "conditions": { "==": [ 1, 1 ] }, "class": "CommonGateway\\WOOBundle\\ActionHandler\\SyncOpenWooHandler", "configuration": { "oin": "{oinNummer}", "portalUrl": "https://conductionnl.github.io/woo-website-example", "source": "https://commongateway.woo.nl/source/example.openwoo.source.json", "schema": "https://commongateway.nl/woo.publicatie.schema.json", "mapping": "https://commongateway.nl/mapping/woo.openConvenantToWoo.mapping.json", "sourceType": "openWoo", "organisatie": "Exanoke", "sourceEndpoint": "{sourceEndpoint}" }, "isEnabled": true }` Als de action en source aangemaakt/ingeregeld zijn en `isEnabled` staat op true. Zou de cronjob elke x minuten deze action afvuren en de synchrosatie aftrappen. Check de logs of om te kijken of deze de 1e keer goed gaat. Bijdragen --------- [](#bijdragen) Wij verwelkomen bijdragen aan de OpenWoo Service, of het nu gaat om bugrapporten, feature suggesties, of codebijdragen. Zie onze `CONTRIBUTING.md` voor meer informatie over hoe u kunt bijdragen. Licentie -------- [](#licentie) De OpenWoo Service is uitgegeven onder de EUPL 1.2 licentie. Voor meer details, zie het `LICENSE.md` bestand in onze GitHub repository. Contact ------- [](#contact) Voor meer informatie over de OpenWoo Service en hoe deze in uw organisatie geïmplementeerd kan worden, kunt u contact met ons opnemen via . ### Health Score 36 — LowBetter than 82% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community19 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Recently: every ~21 days Total 162 Last Release 518d ago PHP version history (2 changes)0.0.1PHP >=7.4 0.0.124PHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4021899?v=4)[Ruben van der Linde](/maintainers/rubenvdlinde)[@rubenvdlinde](https://github.com/rubenvdlinde) ![](https://www.gravatar.com/avatar/8a7f1a91dc2ccd4cba1ee706c9691640e75220cdba7efc4b5ca9385290bfe9c1?d=identicon)[rjzondervan](/maintainers/rjzondervan) ![](https://www.gravatar.com/avatar/cff7b7d6181ae47b0bebdc58b3d2818f8202839a24c323a3c9bfe7d4fe947f0a?d=identicon)[bbrands02](/maintainers/bbrands02) ![](https://www.gravatar.com/avatar/6d1a9c1c6487a55066f3790891a1580cfb0f3508516ce31077bb55731aeb0147?d=identicon)[WilcoLouwerse](/maintainers/WilcoLouwerse) --- Top Contributors [![bbrands02](https://avatars.githubusercontent.com/u/57346398?v=4)](https://github.com/bbrands02 "bbrands02 (264 commits)")[![rjzondervan](https://avatars.githubusercontent.com/u/10433082?v=4)](https://github.com/rjzondervan "rjzondervan (108 commits)")[![WilcoLouwerse](https://avatars.githubusercontent.com/u/3785488?v=4)](https://github.com/WilcoLouwerse "WilcoLouwerse (105 commits)")[![smisidjan](https://avatars.githubusercontent.com/u/55533449?v=4)](https://github.com/smisidjan "smisidjan (30 commits)")[![rubenvdlinde](https://avatars.githubusercontent.com/u/4021899?v=4)](https://github.com/rubenvdlinde "rubenvdlinde (12 commits)")[![yoeriacato](https://avatars.githubusercontent.com/u/110175617?v=4)](https://github.com/yoeriacato "yoeriacato (11 commits)")[![MWest2020](https://avatars.githubusercontent.com/u/66728126?v=4)](https://github.com/MWest2020 "MWest2020 (7 commits)") --- Tags commongroundvngwoosymfonycommongatewayconductioncommongatewaycommon-gateway-pluginwoo ### Embed Badge ![Health badge](/badges/common-gateway-woo-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/common-gateway-woo-bundle/health.svg)](https://phpackages.com/packages/common-gateway-woo-bundle) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)