# v1.3.1: Release notes

## Introduction

**OpenCRVS v1.3.1** is a minor release which includes a hotfix to the previous OpenCRVS v1.3.0 release.\
It is to be used in conjunction with a forked country configuration release [v1.3.1](https://github.com/opencrvs/opencrvs-countryconfig/releases/tag/v1.3.1)

### Non breaking hotfixes

1. In some countries, informant phone numbers are not captured in the form as the chosen method of beneficiary comms is Email. Therefore the search component in the UI should not offer the option to search by phone number. Now the search UI will dynamically check if either informant email or informant phone number is included in the forms and show "Email" as a searchable parameter in search in place of "Phone" where necessary
2. The FHIR Location API now contains query validation. This is an important security improvement.
3. It is now possible to add signatures for Registration Agents which can appear on the certificates.
4. A collection of bugfixes and minor improvements have also been introduced as outlined in the changelog below
5. Certificate handlebars now enable custom formatting via offering the possibility to create custom [helper](https://handlebarsjs.com/guide/block-helpers.html#basic-blocks) functions. An [endpoint](https://github.com/opencrvs/opencrvs-countryconfig/blob/d2af4b9894dcd494bd504f46f0bc449742fed7c4/src/index.ts#L341) exists in the country config repository to load in handlebar helper functions. These must be common JS functions with no library dependencies. A basic [example](https://github.com/opencrvs/opencrvs-countryconfig/blob/master/src/form/common/certificate/handlebars/helpers.ts) is given. Thanks to this discussion: <https://github.com/opencrvs/opencrvs-core/discussions/5927>
6. Dashboard configuration is now possible in Metabase without the requirement to fork Core. A new [endpoint](https://github.com/opencrvs/opencrvs-countryconfig/blob/d2af4b9894dcd494bd504f46f0bc449742fed7c4/src/index.ts#L363) exists in the country config repository to load in a customisable [query](https://github.com/opencrvs/opencrvs-countryconfig/blob/master/src/api/dashboards/queries.ts) to populate the performance database and additionally, the [Metabase .sql](https://github.com/opencrvs/opencrvs-countryconfig/blob/master/src/api/dashboards/file/metabase.init.db.sql) file can be customised to allow any UI change required.
7. Crude birth rates were mistakenly halved in order to calculate male/female gender disaggregation in performance metrics. Crude birth rate is a ratio that is the same for both sexes. A database migration automatically recalculates and updates all crude birth rates to the correct value.

### Breaking hotfixes

1. A new environment variable must be added to Github Actions during deployment: CONTENT\_SECURITY\_POLICY\_WILDCARD. This is supplied to the clients and nginx config like this: \*. and ensures that the format of your domain can be configurable. Previously it was hardcoded in nginx to assume that hostname is the domain name concatenating beyond a dot separated subdomain. Resolved in: <https://github.com/opencrvs/opencrvs-core/pull/6123>

### What's Changed

* Release v1.1.2 by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/4220>
* Hotfix v1.1.2 by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/4219>
* Release v1.2.0 by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/4619>
* Hotfix v1.2.1 by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/5139>
* Ocrvs 6031 Show correct button for certified declarations by @tahmidrahman-dsi in <https://github.com/opencrvs/opencrvs-core/pull/6041>
* Ocrvs 5795 - search by email by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/5872>
* ocrvs-6063 query validation for location endpoint by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6076>
* Ocrvs 5793 Cameroon improvements by @tahmidrahman-dsi in <https://github.com/opencrvs/opencrvs-core/pull/6054>
* Ocrvs 6021 - in progress declaration data fix by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/6050>
* Ocrvs 5794 - configurable signature for different users by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/6024>
* signature row fix for create user by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/6003>
* Fix deps vulnerabilities by @tahmidrahman-dsi in <https://github.com/opencrvs/opencrvs-core/pull/5999>
* Requirements for Niue by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6016>
* OCRVS 6085: Configurable handlebar helpers by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6086>
* Ocrvs 5994 - list for certificator collector and correction requester by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/6058>
* Add registration location to email as a variable by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6104>
* Add core support for configurable death event by @tahmidrahman-dsi in <https://github.com/opencrvs/opencrvs-core/pull/6116>
* Add support for passing intl and other context variables to custom handlebar helpers by @rikukissa in <https://github.com/opencrvs/opencrvs-core/pull/6115>
* Replace hard coded messages by @tahmidrahman-dsi in <https://github.com/opencrvs/opencrvs-core/pull/6122>
* Fix nginx config paths in client Dockerfiles by @rikukissa in <https://github.com/opencrvs/opencrvs-core/pull/6127>
* Configurable domains & whitelist by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6123>
* Id verifier and collector form fix by @Nil20 in <https://github.com/opencrvs/opencrvs-core/pull/6106>
* Skip decorative types when checking for unknowns by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6135>
* Fix crude birth rates & pass performance metrics as a Float to 2 decimal places to support small populations by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6109>
* ocrvs-6126 Introduce a new handlebar "printInAdvance" by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6146>
* feat(v1.3.1): allow configuring dashboard queries from country config by @naftis in <https://github.com/opencrvs/opencrvs-core/pull/6121>
* ocrvs-6080 Handle empty deceased/child resource in search by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6152>
* ocrvs-6147 Support single location level in verify certificate by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6151>
* Fix death reg notification and copy amend on review page by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6159>
* Fix mother / father details getting mixed up when informant type is changed by @rikukissa in <https://github.com/opencrvs/opencrvs-core/pull/6149>
* OCRVS-6022: Allow null values for user mobile and emailForNotification when creating users but still check for uniqueness by @euanmillar in <https://github.com/opencrvs/opencrvs-core/pull/6166>
* Fetch certificate configuration from country config by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6165>
* ocrvs-6080 Initialize object before setting value by @Zangetsu101 in <https://github.com/opencrvs/opencrvs-core/pull/6173>
