PHPackages                             statikbe/craft-contacts - 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. [Admin Panels](/categories/admin)
4. /
5. statikbe/craft-contacts

ActiveCraft-plugin[Admin Panels](/categories/admin)

statikbe/craft-contacts
=======================

Adds a crm-like layers over Craft's users

0541↓50%[6 issues](https://github.com/statikbe/craft-contacts/issues)PHP

Since Sep 1Pushed 2mo agoCompare

[ Source](https://github.com/statikbe/craft-contacts)[ Packagist](https://packagist.org/packages/statikbe/craft-contacts)[ RSS](/packages/statikbe-craft-contacts/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Contacts
========

[](#contacts)

Adds a crm-like layers over Craft's users

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 5.7.0 or later, and PHP 8.2 or later.

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

[](#installation)

You can install this plugin from the Plugin Store or with Composer.

#### From the Plugin Store

[](#from-the-plugin-store)

Go to the Plugin Store in your project's Control Panel and search for "Contacts". Then press "Install".

#### With Composer

[](#with-composer)

Open your terminal and run the following commands:

```
# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require statikbe/craft-contacts

# tell Craft to install the plugin
./craft plugin/install contacts
```

Features
--------

[](#features)

- **Contact Management**: Create and manage contacts as inactive users
- **Advanced Filtering**: Save personal and shared filters for quick access
- **Export Functionality**: Export contacts to XLSX format
- **User Conversion**: Convert contacts to active users with activation emails
- **Field Layout Customization**: Control which User fields are visible for contacts
- **Relations Table Template**: Display related data in clean, formatted tables

Displaying Related Data
-----------------------

[](#displaying-related-data)

The plugin includes a flexible relations table template for displaying related data on contact detail pages.

### Relations Table Template

[](#relations-table-template)

Include the `_relations-table.twig` template to display any related data in a formatted table:

```
{% set columns = [
    {label: 'Title', key: 'title', link: true},
    {label: 'Status', key: 'status'},
    {label: 'Created', key: 'dateCreated', type: 'date'}
] %}

{% include 'contacts/_relations-table' with {
    title: 'Related Entries',
    columns: columns,
    rows: relatedEntries,
    emptyMessage: 'No related entries found.'
} %}
```

### Column Configuration

[](#column-configuration)

Each column supports the following properties:

- **`label`** (string): Column header label
- **`key`** (string): Property key to access in row data
- **`link`** (boolean): Whether to link to element's CP edit URL (default: `false`)
- **`type`** (string): Format type for cell value (default: `'text'`)

### Supported Column Types

[](#supported-column-types)

- **`text`**: Renders value as-is (supports HTML)
- **`date`**: Formats date using `|date('short')`
- **`datetime`**: Formats datetime using `|datetime('short')`
- **`timestamp`**: Formats timestamp using `|timestamp`
- **`relation`**: Resolves relation field and displays title (automatically linked)
- **`dropdown`**: Displays dropdown field label instead of value

### Example: Display Registrations

[](#example-display-registrations)

```
{# Get related registrations for this contact #}
{% set registrations = craft.entries()
    .section('registrations')
    .relatedTo(element)
    .all() %}

{% set columns = [
    {label: 'Registration', key: 'title', link: true},
    {label: 'Course', key: 'course', type: 'relation'},
    {label: 'Status', key: 'registrationStatus', type: 'dropdown'},
    {label: 'Date', key: 'dateCreated', type: 'date'}
] %}

{% include 'contacts/_relations-table' with {
    title: 'Registrations',
    columns: columns,
    rows: registrations
} %}
```

This will display:

- **Registration**: Clickable title linking to the registration entry
- **Course**: Related course title, linking to the course entry
- **Status**: Human-readable dropdown label (e.g., "Pending Approval")
- **Date**: Formatted date (e.g., "Jan 15, 2024")

All links open in a new tab to preserve the contact detail page.

### Pagination Support

[](#pagination-support)

For large datasets, enable pagination by passing an element query and setting `paginate: true`:

```
{% set columns = [
    {label: 'Registration', key: 'title', link: true},
    {label: 'Course', key: 'course', type: 'relation'},
    {label: 'Date', key: 'dateCreated', type: 'date'}
] %}

{% include 'contacts/_relations-table' with {
    title: 'Registrations',
    columns: columns,
    rows: craft.entries().section('registrations').relatedTo(element),  {# Pass query, not .all() #}
    paginate: true,
    pageSize: 20
} %}
```

**Important**: When using pagination, pass the element query directly (don't call `.all()`). The template will handle executing the query with pagination.

**Pagination Parameters:**

- **`paginate`** (boolean): Enable pagination (default: `false`)
- **`pageSize`** (integer): Items per page (default: `20`)

Pagination works with both element queries and arrays. The template automatically uses Craft's native pagination UI for queries and a custom implementation for arrays. Array pagination uses the `relationPage` URL parameter to avoid conflicts with CP routing.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance57

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 92.7% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1250437446b84017407f7f1900194b1e1c93fcf34b332ba382fb77f69b251cb6?d=identicon)[statikbe](/maintainers/statikbe)

---

Top Contributors

[![janhenckens](https://avatars.githubusercontent.com/u/755428?v=4)](https://github.com/janhenckens "janhenckens (38 commits)")[![Numkil](https://avatars.githubusercontent.com/u/5604686?v=4)](https://github.com/Numkil "Numkil (3 commits)")

### Embed Badge

![Health badge](/badges/statikbe-craft-contacts/health.svg)

```
[![Health](https://phpackages.com/badges/statikbe-craft-contacts/health.svg)](https://phpackages.com/packages/statikbe-craft-contacts)
```

###  Alternatives

[jeroennoten/laravel-adminlte

Easy AdminLTE integration with Laravel

4.0k4.8M43](/packages/jeroennoten-laravel-adminlte)[dmstr/yii2-adminlte-asset

AdminLTE backend theme asset bundle for Yii 2.0 Framework

1.1k1.8M67](/packages/dmstr-yii2-adminlte-asset)[dwij/laraadmin

LaraAdmin is a Open source Laravel Admin Panel / CMS which can be used as Admin Backend, Data Management Tool or CRM boilerplate for Laravel with features like CRUD Generation, Module Manager, Media, Menus, Backups and much more

1.6k68.7k](/packages/dwij-laraadmin)[filament/spatie-laravel-media-library-plugin

Filament support for `spatie/laravel-medialibrary`.

1764.8M125](/packages/filament-spatie-laravel-media-library-plugin)[bezhansalleh/filament-exceptions

A Simple &amp; Beautiful Pluggable Exception Viewer for FilamentPHP's Admin Panel

193195.9k13](/packages/bezhansalleh-filament-exceptions)[filament/infolists

Easily add beautiful read-only infolists to any Livewire component.

1220.8M36](/packages/filament-infolists)

PHPackages © 2026

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