PHPackages                             tatter/chat - 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 &amp; Helpers](/categories/utility)
4. /
5. tatter/chat

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

tatter/chat
===========

Embedded chat widget for CodeIgniter 4

v2.2.0(4y ago)211.8k6[2 issues](https://github.com/tattersoftware/codeigniter4-chat/issues)[1 PRs](https://github.com/tattersoftware/codeigniter4-chat/pulls)MITPHPPHP ^7.4 || ^8.0

Since Feb 6Pushed 2y ago4 watchersCompare

[ Source](https://github.com/tattersoftware/codeigniter4-chat)[ Packagist](https://packagist.org/packages/tatter/chat)[ Docs](https://github.com/tattersoftware/codeigniter4-chat)[ Fund](https://paypal.me/tatter)[ GitHub Sponsors](https://github.com/tattersoftware)[ RSS](/packages/tatter-chat/feed)WikiDiscussions develop Synced 2w ago

READMEChangelog (8)Dependencies (9)Versions (12)Used By (0)

Tatter\\Chat
============

[](#tatterchat)

Embedded chat widget for CodeIgniter 4

[![](https://github.com/tattersoftware/codeigniter4-chat/workflows/PHPUnit/badge.svg)](https://github.com/tattersoftware/codeigniter4-chat/actions/workflows/phpunit.yml)[![](https://github.com/tattersoftware/codeigniter4-chat/workflows/PHPStan/badge.svg)](https://github.com/tattersoftware/codeigniter4-chat/actions/workflows/phpstan.yml)[![](https://github.com/tattersoftware/codeigniter4-chat/workflows/Deptrac/badge.svg)](https://github.com/tattersoftware/codeigniter4-chat/actions/workflows/deptrac.yml)[![Coverage Status](https://camo.githubusercontent.com/5bd3e8b2c85b5f0bf36ca9624e5f7fdf9f27b17fe851c4a4293257b5ff5480cc/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f746174746572736f6674776172652f636f646569676e69746572342d636861742f62616467652e7376673f6272616e63683d646576656c6f70)](https://coveralls.io/github/tattersoftware/codeigniter4-chat?branch=develop)

Quick Start
-----------

[](#quick-start)

1. Install with Composer: `> composer require tatter/chat`
2. Update the database: `> php spark migrate --all`
3. Publish asset files: `> php spark publish`
4. Add Chat JS to your layout: ``
5. Add a chat to any view: ``

Features
--------

[](#features)

**Chat** allows developers to add a lightweight Bootstrap-style chat client to any page.

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

[](#installation)

Install easily via Composer to take advantage of CodeIgniter 4's autoloading capabilities and always be up-to-date:

```
> composer require tatter/chat
```

Or, install manually by downloading the source files and adding the directory to **app/Config/Autoload.php**.

Once the files are downloaded and included in the autoload, run any library migrations to ensure the database is setup correctly:

```
> php spark migrate --all
```

### Assets

[](#assets)

**Chat** has JavaScript code as well as asset dependencies that need to be included with any view that has a conversation on it. Assets are managed by the [Tatter\\Assets](https://github.com/tattersoftware/codeigniter4-assets) library; you can publish all files with CodeIgniter's Publisher: `spark publish`. Be sure to configure the **Assets** filter and apply it to routes (see docs).

### Authentication

[](#authentication)

**Chat** uses `Tatter\Users` to determine participants username and display name. You must be sure to include a package that provides `codeigniter4/authentication-implementation`(like **Shield**) or make your own (see [Authentication](https://codeigniter4.github.io/CodeIgniter4/extending/authentication.html)for framework requirements).

Usage
-----

[](#usage)

The easiest way to start a chat is with the helper. Load the helper file (`helper('chat')`) and then use the `chat($uid, $title)` command wherever you would use a partial view:

```

	Yellow Widgets
	Main product info here!

...
```

The parameters to `chat()` are optional, and excluding them will load a one-time chat with a random UID (e.g. for a one-time site visitor).

Extending
---------

[](#extending)

Conversations are stored and loaded from the database with the `ConversationModel`, and most of the logic is handled by the Entities. For example, a `Conversation` entity can `$conversation->addUser($userId)` to join or refresh a user and get back a `Participant`. A `Participant` can `$participant->say('hello world')` to add a `Message`.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 98.4% 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 ~129 days

Recently: every ~102 days

Total

8

Last Release

1425d ago

Major Versions

v1.0.1 → v2.0.02021-03-05

v2.2.0 → v3.0.0-beta.12022-07-29

PHP version history (3 changes)v1.0.0PHP &gt;=7.2

v2.0.0PHP ^7.3 || ^8.0

v2.2.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ebe908b4fe73807ecdd9f88733342199c9991b7de800329f5b2b787c8210d62?d=identicon)[MGatner](/maintainers/MGatner)

---

Top Contributors

[![MGatner](https://avatars.githubusercontent.com/u/17572847?v=4)](https://github.com/MGatner "MGatner (61 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

codeigniterbootstrapchatcodeigniter4

### Embed Badge

![Health badge](/badges/tatter-chat/health.svg)

```
[![Health](https://phpackages.com/badges/tatter-chat/health.svg)](https://phpackages.com/packages/tatter-chat)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[tatter/workflows

Job task control through dynamic workflows, for CodeIgniter 4

211.7k](/packages/tatter-workflows)[codeigniter4/settings

Settings library for CodeIgniter 4

94555.3k31](/packages/codeigniter4-settings)[codeigniter4/tasks

Task Scheduler for CodeIgniter 4

122167.0k1](/packages/codeigniter4-tasks)[codeigniter4/devkit

Development toolkit for CodeIgniter libraries and projects

68195.7k114](/packages/codeigniter4-devkit)[tatter/alerts

Lightweight user alerts for CodeIgniter 4

3978.7k6](/packages/tatter-alerts)

PHPackages © 2026

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