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(2y ago)07712GPL-2.0PHP

Since May 31Pushed 2y 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 today

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

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity61

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

737d 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

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[typo3/cms-lowlevel

TYPO3 CMS Lowlevel - Technical analysis of the system. This includes raw database search, checking relations, counting pages and records etc.

178.2M317](/packages/typo3-cms-lowlevel)[typo3/cms-redirects

TYPO3 CMS Redirects - Create manual redirects, list existing redirects and automatically createredirects on slug changes.

167.4M80](/packages/typo3-cms-redirects)[typo3/cms-form

TYPO3 CMS Form - Flexible TYPO3 frontend form framework that comes with a backend editor interface.

147.6M266](/packages/typo3-cms-form)[derhansen/sf_event_mgt

Event management and registration - Configurable event management and registration extension based on ExtBase and Fluid

66338.4k10](/packages/derhansen-sf-event-mgt)

PHPackages © 2026

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