PHPackages                             common-gateway/huwelijksplanner-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. common-gateway/huwelijksplanner-bundle

ActiveSymfony-bundle

common-gateway/huwelijksplanner-bundle
======================================

A symfony package for dutch municipality marriage functionality

0.0.111(2y ago)0313[4 PRs](https://github.com/CommonGateway/HuwelijksplannerBundle/pulls)EUPL-1.2PHPPHP &gt;=7.4

Since Dec 14Pushed 1y ago3 watchersCompare

[ Source](https://github.com/CommonGateway/HuwelijksplannerBundle)[ Packagist](https://packagist.org/packages/common-gateway/huwelijksplanner-bundle)[ Docs](https://commongatway.nl)[ RSS](/packages/common-gateway-huwelijksplanner-bundle/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (7)Versions (136)Used By (0)

HuwelijksplannerBundle [![Codacy Badge](https://camo.githubusercontent.com/d6628b616e1a58946bfc7def2094c38e46394e1226206f628fbc967f6bf51582/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6138366661393535623632353432653461326539623838643965653631386434)](https://app.codacy.com/gh/CommonGateway/HuwelijksplannerBundle/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
======================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#huwelijksplannerbundle-)

The HuwelijksplannerBundle is a powerful Symfony bundle that provides essential functionality for handling Dutch marriage requests within municipalities. This bundle is specifically designed to streamline and simplify the process of managing marriage-related operations, making it an indispensable tool for municipal authorities.

Changes from Huwelijksplanner 2020
----------------------------------

[](#changes-from-huwelijksplanner-2020)

In the previous iteration of the Huwelijksplanner project, the decision was made to fully separate the Huwelijksplanner into individual registers, each developed as a separate Common Ground component. These components were then required to be installed independently.

However, this approach led to several issues. Numerous installations were necessary to get the Huwelijksplanner up and running, and the large number of codebases posed maintenance challenges.

In the current iteration of the Huwelijksplanner, we have addressed these concerns by reorganizing the individual components as plugins. This change offers two primary advantages:

1. Smaller Codebases: By restructuring the components into plugins, the underlying codebases are now more manageable and easier to maintain.
2. Unified Gateway Installation: These different plugins can now be run on a single installation of the Common Gateway. This streamlines the deployment process and simplifies the setup for developers.

Optionally, municipalities still have the flexibility to choose between running the components in separate installations or combining them in a unified setup.

### Bundles Used in the HuwelijksplannerBundle

[](#bundles-used-in-the-huwelijksplannerbundle)

The [**HuwelijksplannerBundle**](https://github.com/CommonGateway/HuwelijksplannerBundle) currently utilizes the following bundles:

1. **CoreBundle**: [GitHub Repository](https://github.com/CommonGateway/CoreBundle)
2. **BRPBundle**: [GitHub Repository](https://github.com/CommonGateway/BRPBundle)
3. **KlantenBundle**: [GitHub Repository](https://github.com/CommonGateway/KlantenBundle)
4. **ZGWBundle**: [GitHub Repository](https://github.com/CommonGateway/ZGWBundle)

While all these bundles can still be installed as standalone components (please refer to their respective installation guides), the HuwelijksplannerBundle now defaults to installing these bundles as additional plugins on the same gateway.

This new approach offers greater modularity, making it easier for developers to work with the HuwelijksplannerBundle and allowing for more flexible configurations based on the needs of individual municipalities.

If you have any questions, suggestions, or new ideas, please don't hesitate to share them in the project repository. Let's work together to create an exceptional wedding planning experience that brings joy and happiness to couples preparing for their special day.

Backend Installation Instructions
---------------------------------

[](#backend-installation-instructions)

The Huwelijksplanner backend codebase utilizes the Common Gateway as an open-source installation framework. This means that the Huwelijksplanner library, in its core form, functions as a plugin on this Framework. To learn more about the Common Gateway, you can refer to the documentation [here](https://commongateway.readthedocs.io/en/latest/).

Please note that the Huwelijksplanner frontend codebase is a separate docker container.

To install the backend, follow the steps below:

### Gateway Installation

[](#gateway-installation)

1. If you do not have the Common Gateway installed, you can follow the installation guide provided [here](https://github.com/ConductionNL/commonground-gateway#readme). The Common Gateway installation is required for the backend setup. You can choose any installation method for the gateway, such as Haven, Kubernetes, Linux, or Azure, and any database option like MySQL, PostgreSQL, Oracle, or MsSQL. The gateway framework handles this abstraction.

### HuwelijksplannerBundle Installation - Admin-UI

[](#huwelijksplannerbundle-installation---admin-ui)

1. After successfully installing the Gateway, access the admin-ui and log in.
2. In the left menu, navigate to "Plugins" to view a list of installed plugins. If you don't find the "Huwelijksplanner" plugin listed here, you can search for it by clicking on "Search" in the upper-right corner and typing "Huwelijksplanner" in the search bar.
3. Click on the "Huwelijksplanner" card and then click on the "Install" button to install the plugin.
4. The admin-ui allows you to install, upgrade, or remove bundles. However, to load all the required data (schemas, endpoints, sources), you need to execute the initialization command in a terminal.

### HuwelijksplannerBundle Installation - Terminal

[](#huwelijksplannerbundle-installation---terminal)

1. Open a terminal and run the following command to install the Huwelijksplanner bundle:

    ```
    docker-compose exec php composer require common-gateway/huwelijksplanner-bundle

    ```

### Initialization Command (Terminal)

[](#initialization-command-terminal)

1. To load all the data without any specific content, execute the following command:

    ```
    docker-compose exec php bin/console commongateway:initialize

    ```

    OR

    To load all the data along with specific content, run:

    ```
    docker-compose exec php bin/console commongateway:initialize -data

    ```

With these steps completed, the backend setup for the Huwelijksplanner project should be ready to use. If you encounter any issues during the installation process, seek assistance from the development team. Happy coding!

Frontend Installation Instructions
----------------------------------

[](#frontend-installation-instructions)

These instructions will guide you through the setup process for the Huwelijksplanner project. Please follow the steps below to get started:

### Prerequisites

[](#prerequisites)

Before you begin, ensure you have the following software installed on your system:

1. Git
2. Node.js (npm)
3. Docker
4. Docker Compose

### Installation

[](#installation)

1. Clone the Utrecht Huwelijksplanner repository by running the following command in your terminal:

    ```
    git clone https://github.com/frameless/utrecht-huwelijksplanner.git

    ```
2. In the project directory, find the `.env` file and modify the `NEXT_PUBLIC_API_URL` to use the local API. Change it to:

    ```
    NEXT_PUBLIC_API_URL=http://localhost/api

    ```
3. Run the following command in the terminal to install the project dependencies and generate necessary code:

    ```
    npm install && npm run codegen

    ```
4. Build and start the development environment using Docker Compose:

    ```
    docker-compose -f docker-compose.dev.yml build
    docker-compose -f docker-compose.dev.yml up --remove-orphans

    ```

    If you encounter an error during this step, try running the production Docker Compose file located in the repository under `Docker-compose.yml`. After a successful build, you can retry step 4.

With these steps completed, the frontend setup for the Huwelijksplanner project should be ready to use. If you encounter any issues during the installation process, seek assistance from the development team. Happy coding!

Admin UI - Setup Instructions
-----------------------------

[](#admin-ui---setup-instructions)

Once the backend (and frontend) is up and running, the HuwelijksplannerBundle can be configured. To ensure proper functionality, the sources and Security Group (Default Anonymous user) need to be modified. Other adjustments are optional.

### Configuration Steps:

[](#configuration-steps)

1. **Users**

    - Change the passwords of the users if necessary. It is recommended that you change the email of the admin user.
        - Go to `Settings` in the Admin UI.
        - Navigate to the `Users` tab.
        - Select the user and edit the password.
2. **Sources**

    - Provide the required API keys for the following sources:
        - SendInBlue API
        - Mollie API
        - MessageBird API
3. **Actions**

    - Change the sender of the SMS in the `MessageBird` action:
        - Go to `Actions` in the Admin UI.
        - Locate and select `MessageBird` to view its details
        - Set the `Originator` to the sender of the SMS.
4. **Mappings**

    - Configure SMS and Email data for the partner and/or the witnesses:
        - Go to `Mappings` in the Admin UI.
        - Locate and select `EmailAndSmsDataPartner` or `EmailAndSmsDataWitness` to view its details
        - Change the values of body, assentName, assentDescription and url.
            - `body` is the body of the sms
            - `assentName` is the name of the assent that is made for this partner
            - `assentDescription` is the description of the assent that is made for this partner
            - `url` is the url that the partner is directed to, to confirm the marriage

Once you have completed these steps, the Huwelijksplanner Admin UI should be fully configured and is the Huwelijksplanner project ready to use.

Huwelijksplanner Test Data - Developer Guide
--------------------------------------------

[](#huwelijksplanner-test-data---developer-guide)

Here is information on the test data used in the Huwelijksplanner. We load two files containing test data: BRP (Basisregistratie Personen) `BRPTestData.json` and SDG products `HuwelijksPlannerTestData,json`.

### Test Data Details:

[](#test-data-details)

#### BRP Test Data:

[](#brp-test-data)

The BRP test data includes entries for registered persons in the BRP system, linked to the users being loaded. Each user has a `person` property that contains a BSN (Burger Service Nummer) corresponding to the BSN in the BRP registered persons object.

#### SDG Products Test Data:

[](#sdg-products-test-data)

The SDG products test data consists of the following objects:

1. Types of Marriages:

    - Omzetting (Conversion)
    - Partnerschap (Partnership)
    - Huwelijk (Marriage)
    - Eenvoudig Huwelijk (Simple Marriage)
    - Flits/Baliehuwelijk (Express/Counter Marriage)
    - Gratis Trouwen (Free Marriage)
2. Marriage Officials:

    - Toegewezen (Assigned)
    - Eigen Trouwambtenaar (Own Marriage Official)
    - Keuze Trouwambtenaar (Choice of Marriage Official)
3. Marriage Locations:

    - Eigen Locatie (Own Location)
    - Loge (Lodge)
    - Trouwzaal (Wedding Hall)
    - Balie (Counter)
4. Extra Products:

    - Trouwboekje (Marriage Booklet)

All SDG products have translations with additional information about the product.

These test data files are used to populate the Huwelijksplanner with sample information for testing and development purposes.

Feel free to explore and utilize this test data as needed during your development workflow.

To gain a deeper understanding of the services and commands offered by the HuwelijksplannerBundle, we encourage you to explore the detailed documentation available at . This documentation provides comprehensive insights into the bundle's capabilities, service usage, and available commands.

Whether you are a developer working on a municipal wedding planning project or an enthusiast seeking to learn more about the HuwelijksplannerBundle, this documentation is an invaluable resource to help you navigate and utilize the bundle effectively.

Join us in harnessing the power of the HuwelijksplannerBundle to create seamless and efficient marriage request handling solutions for Dutch municipalities. Happy coding!

###  Health Score

29

—

LowBetter than 63% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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 ~4 days

Recently: every ~56 days

Total

108

Last Release

736d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cff7b7d6181ae47b0bebdc58b3d2818f8202839a24c323a3c9bfe7d4fe947f0a?d=identicon)[bbrands02](/maintainers/bbrands02)

![](https://www.gravatar.com/avatar/0d0bcbfb73c04dd948e4c66dd51f64d543e4b8e6917b55e815d774b2f4e1cf77?d=identicon)[smisidjan](/maintainers/smisidjan)

---

Top Contributors

[![smisidjan](https://avatars.githubusercontent.com/u/55533449?v=4)](https://github.com/smisidjan "smisidjan (85 commits)")[![bbrands02](https://avatars.githubusercontent.com/u/57346398?v=4)](https://github.com/bbrands02 "bbrands02 (69 commits)")[![WilcoLouwerse](https://avatars.githubusercontent.com/u/3785488?v=4)](https://github.com/WilcoLouwerse "WilcoLouwerse (38 commits)")[![rjzondervan](https://avatars.githubusercontent.com/u/10433082?v=4)](https://github.com/rjzondervan "rjzondervan (34 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (21 commits)")[![rubenvdlinde](https://avatars.githubusercontent.com/u/4021899?v=4)](https://github.com/rubenvdlinde "rubenvdlinde (19 commits)")[![NovaEBA](https://avatars.githubusercontent.com/u/63096721?v=4)](https://github.com/NovaEBA "NovaEBA (3 commits)")[![MWest2020](https://avatars.githubusercontent.com/u/66728126?v=4)](https://github.com/MWest2020 "MWest2020 (1 commits)")[![britt11654](https://avatars.githubusercontent.com/u/85314362?v=4)](https://github.com/britt11654 "britt11654 (1 commits)")

---

Tags

symfonycommongatewayconductioncommongatewaycommon-gateway-plugin

### Embed Badge

![Health badge](/badges/common-gateway-huwelijksplanner-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/common-gateway-huwelijksplanner-bundle/health.svg)](https://phpackages.com/packages/common-gateway-huwelijksplanner-bundle)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
