PHPackages                             jobinja/threads-io-php-plug - 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. jobinja/threads-io-php-plug

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

jobinja/threads-io-php-plug
===========================

Plug Threads.io to your PHP application and start collecting events data from your users.

v1.0.1(10y ago)01.1kMITPHPPHP >=5.4

Since Jan 27Pushed 10y ago2 watchersCompare

[ Source](https://github.com/Jobinja/threads-io-php-plug)[ Packagist](https://packagist.org/packages/jobinja/threads-io-php-plug)[ Docs](https://jobinja.ir)[ RSS](/packages/jobinja-threads-io-php-plug/feed)WikiDiscussions master Synced 1mo ago

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

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/e43772d79e3bc73f71a2603986e03845d70c02d73722126f09caa5b5337f6fbe/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f576162656c2f746872656164732d696f2d7068702d706c75672f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Wabel/threads-io-php-plug/?branch=1.0)[![Build Status](https://camo.githubusercontent.com/517687ed4a7a31e1c4969d04798a3b5546013eec5bb5031792992ab940bf54e9/68747470733a2f2f7472617669732d63692e6f72672f576162656c2f746872656164732d696f2d7068702d706c75672e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Wabel/threads-io-php-plug)[![Coverage Status](https://camo.githubusercontent.com/739bd0c4180b6b7967fa63fd749fe3ac732e59cc128aa351ff6852962b1631e9/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f576162656c2f746872656164732d696f2d7068702d706c75672f62616467652e7376673f6272616e63683d6d617374657226736572766963653d676974687562)](https://coveralls.io/github/Wabel/threads-io-php-plug?branch=master)

Jobinja's Threads.io PHP plug
=============================

[](#jobinjas-threadsio-php-plug)

What is this?
-------------

[](#what-is-this)

This project is a PHP connector to [Threads.io](http://threads.io) originally forked from [wabel/threads-io-php-plug](https://github.com/Wabel/threads-io-php-plug). Use this plug to identify your users, track events and page visits or remove them from your Threads.io account. Initialize
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#this-project-is-a-php-connector-to-threadsio-originally-forked-from-wabelthreads-io-php-plug-use-this-plug-to-identify-your-users-track-events-and-page-visits-or-remove-them-from-your-threadsio-accountinitialize)

Here is a basic example on how you can use Wabel's Threads.io PHP Plug :

```
use \Jobinja\ThreadsIo\ThreadsIoClient;
use \Jobinja\ThreadsIo\ThreadsIoService;

// The ThreadsIoClient class is the low level class used to make the API calls.
// It takes your eventKey in parameter, which is provided to you by Threads.io
$client = new ThreadsIoClient(YOUR_EVENT_KEY);

// The ThreadsIoService class is the high level class that you will use with the Entities to make your API Calls
// It takes your fresh new ThreadsIoClient object in argument to be instantiate
$service = new ThreadsIoService($client);
```

The two main compound of this package are the **ThreadsIoClient** and **ThreadsIoService**.

The **ThreadsIoClient** is a programmatic implementation of the Threads.io API. It ensures that the data are sent with the format expected by the API. The **ThreadsIoService** is the main class to instantiate and use. It's meant to use the package Entity system, meaning manipulating **Users**, **Event** and **Page** objects easily. Every call methods expects an object implementing the **ThreadableInterface** or one of the provided Entity of this package.

Interfaces and Entites
----------------------

[](#interfaces-and-entites)

As explained earlier, the **ThreadsIoService** is manipulating entities. A User entity, Event entity or Page entity is the instantiation of an existing class of your PHP application implementing respectively the **UserThreadableInterface**, **EventThreadableInterface**, **PageThreadableInterface**. For instance, a Member class that is used for manipulating users in your application is a good candidate for implementing the **UserThreadable** interface. If you have no classes that could implement the ThreadableInterfaces, you can instantiate manually one of the Wabel\\Entities (User, Event or Page) provided in this package.

```
use \Jobinja\ThreadsIo\Entities\User;
use \Jobinja\ThreadsIo\Entities\Event;
use \Jobinja\ThreadsIo\Entities\Page;

// Whether you retrieve an object implementing the UserThreadableInterface from your DB...
$yourUser = $dao->getMemberById(2103);

// ...or that you create one using the provided entity class User...
$threadsIoUser = new User("ID254632", [
    "name" => "Jesus Christ",
    "company" => "Christian Church",
    "date_of_birth" => "24/12/0001",
]);

...

// ... you'll be able to use them both with the ThreadsIoService
$service->identify($yourUser);
$service->identify($threadsIoUser);
```

How to use the ThreadsIoService
-------------------------------

[](#how-to-use-the-threadsioservice)

In version 1.0.0, we introduced the first use of the basic functions "identify", "track", "page" and "remove". Here's a basic usage of the service :

```
use \Jobinja\ThreadsIo\Entities\User;
use \Jobinja\ThreadsIo\Entities\Event;
use \Jobinja\ThreadsIo\Entities\Page;
use \Jobinja\ThreadsIo\ThreadsIoClient;
use \Jobinja\ThreadsIo\ThreadsIoService;

// Instantiate an object that implements one of the Wabel\ThreadsIo\Interfaces
// (one of the provided classes in this case)
$user = new User("4815162342", [
     "name" => "Hugo Reyes",
     "status" => "Lost",
     "other" => "Lottery winner"
 ]);

$event = new Event("New Lost Person Report", [
     "plane" => "Oceanic 815",
     "crash_location" => "Pacific Ocean"
 ]);

$page = new Page("New plane crash: Oceanic 815 on fire in the Pacific Ocean", [
     "url" => "http://www.bignews.com/New-plane-crash-Oceanic-815-on-fire-in-the-Pacific-Ocean",
     "referer" => "http://www.bignews.com",
     "time_spent_on_page" => "18s"
 ]);

// Then grab or create a ThreadsIoService object
$client = new ThreadsIoClient($eventKey);
$service = new ThreadsIoService($client);

// Your now able to :

// Identify a user
$service->identify($user);

// Track an event
$service->track($user, $event);

// Track a page view
$service->page($user, $page);

// Remove a user
$service->remove($user);
```

Feature To-Do
-------------

[](#feature-to-do)

- Add ability to send request on PHP's shutdown event.
- Add ability to use Guzzle6's async requests for sending multiple requests asynchronously.

About Threads.io
----------------

[](#about-threadsio)

[Threads.io](https://threads.io/) provide a service meant for sending "Automated Behavior-Driven Emails" based on user activity and workflow rules setted by the account administrator. You can consult the original API [here](https://docs.threads.io/). Feel free to make any pull requests if you notice any API upgrades.

About Jobinja
-------------

[](#about-jobinja)

[Jobinja](https://jobinja.ir) is an online Job seeking and HR platform.

About Wabel
-----------

[](#about-wabel)

[Wabel](http://www.wabel.com) is the online marketplace for the european food industry. In our effort to integrate our web platform to more and more web services, we (Wabel's dev team!) are happy to share our work with Threads.io's community.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~11 days

Total

2

Last Release

3744d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4ce48e840de2a338377b9c076bb90fc36407b3264bc91bda3ecb9248d57b193f?d=identicon)[jobinja](/maintainers/jobinja)

---

Top Contributors

[![WizMik](https://avatars.githubusercontent.com/u/5702056?v=4)](https://github.com/WizMik "WizMik (1 commits)")

---

Tags

phpeventwrapperThreads.io

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jobinja-threads-io-php-plug/health.svg)

```
[![Health](https://phpackages.com/badges/jobinja-threads-io-php-plug/health.svg)](https://phpackages.com/packages/jobinja-threads-io-php-plug)
```

###  Alternatives

[zoon/rialto

Manage Node resources from PHP

12199.4k3](/packages/zoon-rialto)[wujunze/money-wrapper

MoneyPHP Wrapper

113.8k](/packages/wujunze-money-wrapper)

PHPackages © 2026

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