PHPackages                             nordkirche/nkc-address - 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. nordkirche/nkc-address

ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility)

nordkirche/nkc-address
======================

TYPO3 Extension zur Darstellung von Personen und Institutionen aus der NAPI

12.4.1(1y ago)07672GPL-2.0PHP

Since May 31Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Nordkirche/nkc-address)[ Packagist](https://packagist.org/packages/nordkirche/nkc-address)[ RSS](/packages/nordkirche-nkc-address/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (18)Used By (0)

TYPO3 Extension nkc\_address
============================

[](#typo3-extension-nkc_address)

Die Extension stellt PlugIns bereit, um Inhalte der Nordkirche API (Personen und Institutionen) auf einer Website darzustellen.

- Personen

    - Listenansicht / Suchergebnis
    - Detailansicht (Visitenkarte)
    - Suchformular
    - Helper: Weiterleitung per ID auf die Visitenkarte
- Institutionen

    - Listenansicht / Suchergebnis
    - Detailansicht (Visitenkarte)
    - Suchformular
    - Helper: Weiterleitung per ID auf die Visitenkarte
- Kartendarstellung

    - mit Liste unter der Karte
    - alleinstehend ohne Liste

Abhängigkeiten
--------------

[](#abhängigkeiten)

Diese Extension basiert auf

```
nordkirche/nkc-base ^12.4
nordkirche/nk-google-map ^12.4
fluidtypo3/vhs ^6.1 || ^7.0
TYPO3 ^12.4

```

Installation
------------

[](#installation)

Die Installation der Extension erfolgt über composer, da bei dieser Installation auch alle Abhängigkeiten mit installiert werden müssen.

```
composer req nordkirche/nkc-address

```

Bitte binden Sie anschließend das statische Template der Extension in Ihr TypoScript Template ein.

Konfiguration
-------------

[](#konfiguration)

Bitte beachten Sie die Dokumentation von nordkirche/nkc-base, um Zugriffe auf die NAPI zu ermöglichen.

Es gibt im statischen TypoScript umfangreiche Konfigurationen, die für die eigenen Bedürfnisse angepasst werden können und müssen (z.B. Pfade Icons für die Kartendarstellung) Für TYPO3 Integratoren sollten sich die meisten Dinge von selbst erklären.

Grunsätzlich ist es so, dass Konfigurationen teilweise sowohl in TypoScript als auch in den Plug-Ins möglich sind. Hier zu beachten, dass Plug-In Konfigurationen TypoScript überschreiben, wenn sie einen Wert haben.

Die Templates der Extension haben ein sehr rudimentäres Markup, um die Möglichkeiten der Extension zu zeigen. Die darzustellenen Inhalte sind so komplex, dass ein Standard-Layout wenig Sinn ergeben hätte.

PSR-14 Events
-------------

[](#psr-14-events)

Es gibt PSR-14 Events, um die NAPI Queries und die Ausgabe der Daten anzupassen:

ControllerActionEventDaten holenDaten überschreibenInstitutionControllerlistActionModifyAssignedListValuesForInstitutionEventgetAssignedListValues()setAssignedListValues()InstitutionControllerlistActionModifyInstitutionQueryEventgetInstitutionQuery()setInstitutionQuery()InstitutionControllershowActionModifyAssignedValuesForInstitutionEventgetAssignedValues()setAssignedValues()PersonControllerlistActionModifyAssignedListValuesForPersonEventgetAssignedListValues()setAssignedListValues()PersonControllerlistActionModifyPersonQueryEventgetPersonQuery()setPersonQuery()PersonControllershowActionModifyAssignedValuesForPersonEventgetAssignedValues()setAssignedValues()Wichtige Hinweise
-----------------

[](#wichtige-hinweise)

Bitte stellen Sie sicher, dass in der TYPO3-Konfiguration die Debug Option deaktiviert ist:

```
$GLOBALS['TYPO3_CONF_VARS']['FE']['debug'] = 0;

```

Andernfalls wird bei einer JSON Responses von TYPO3 ein Cache Hinweis angefügt und die Karten-Marker können nicht nachgeladen werden.

Wenn statische Google Karten in der Listenansicht generiert werden sollen, muss in TYPO3 folgende TypoScript-Konfiguration vorliegen:

```
config.forceAbsoluteUrls = 1

```

Damit wird sichergestellt, dass die Icons, die bei EXT:nkc\_base mitgeliefert werden, über den Asset Ordner verknüpft werden.

### Breaking Changes

[](#breaking-changes)

Mit Version 12.4 gibt es für alle Actions eigene Plug-in Instanzen, weil TYPO3 keine Switchable Controller Actions mehr unterstützt. Für die Migration gibt es einen Upgrade Wizard.

Das Template Markup für Suchformulare hat sich geändert, da nun Fluid Form Elemente in Suchformularen eingesetzt werden, um cHash Fehler und Cash-Probleme zu vermeiden

Fehler gefunden?
----------------

[](#fehler-gefunden)

Bitte melden Sie Fehler via github

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 70% of commits — single point of failure

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

Recently: every ~54 days

Total

17

Last Release

684d ago

Major Versions

10.4.2 → 11.52023-07-10

11.5.11 → 12.4.02024-04-30

### Community

Maintainers

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

---

Top Contributors

[![derhansen](https://avatars.githubusercontent.com/u/2629896?v=4)](https://github.com/derhansen "derhansen (7 commits)")[![hmccloy](https://avatars.githubusercontent.com/u/1900080?v=4)](https://github.com/hmccloy "hmccloy (3 commits)")

### Embed Badge

![Health badge](/badges/nordkirche-nkc-address/health.svg)

```
[![Health](https://phpackages.com/badges/nordkirche-nkc-address/health.svg)](https://phpackages.com/packages/nordkirche-nkc-address)
```

###  Alternatives

[eliashaeussler/typo3-form-consent

Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form

1481.0k](/packages/eliashaeussler-typo3-form-consent)[b13/assetcollector

Add CSS and SVG files and strings as inline style tag/inline svg to the html code.

10118.4k](/packages/b13-assetcollector)[mfd/ai-filemetadata

Automatically generates FAL metadata for files by means of public LLMs

1142.1k](/packages/mfd-ai-filemetadata)[mautic/mautic-typo3

Add-on TYPO3 extension that enhances the "EXT:marketing\_automation" TYPO3 extension by connecting it to the Mautic Marketing Automation platform: Determine "Persona" from Mautic segments. Also provides additional services e.g. language synchronisation between Mautic and TYPO3.

236.3k](/packages/mautic-mautic-typo3)

PHPackages © 2026

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