PHPackages                             systopia/de.systopia.xcm - 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. systopia/de.systopia.xcm

ActiveCivicrm-ext

systopia/de.systopia.xcm
========================

CiviCRM contact matching extension

1.15.0-beta2(2mo ago)6987↓42.6%13[3 issues](https://github.com/systopia/de.systopia.xcm/issues)[2 PRs](https://github.com/systopia/de.systopia.xcm/pulls)1AGPL-3.0-or-laterPHPPHP ^8.1CI passing

Since Feb 3Pushed 2mo ago7 watchersCompare

[ Source](https://github.com/systopia/de.systopia.xcm)[ Packagist](https://packagist.org/packages/systopia/de.systopia.xcm)[ RSS](/packages/systopia-desystopiaxcm/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (4)Used By (1)

Extended Contact Matcher (XCM)
==============================

[](#extended-contact-matcher-xcm)

Creates an API action `Contact.getorcreate` that will return a contact Id for the input parameters. First a search is done for the given contact (see settings in Installation section below), and if that's not conclusive a new contact will be created.

Only the contact id is returned.

The settings page offers lots of options such as:

- determining how contacts are matched.
- recording an activity when contacts are created/updated
- adding contacts to groups or adding a tag.

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

[](#installation)

Install in the usual way. Then go to *Administer* → *Adminstration Console* → *Xtended Contact Matcher Settings* (/civicrm/admin/setting/xcm) to visit the settings panel.

**At the very least you need to visit that settings page and add a rule, or the extension will always create new contacts.**

Usage
-----

[](#usage)

Let's say this person is not in your database:

```