PHPackages                             statamic/twitter - 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. statamic/twitter

ActiveStatamic-addon

statamic/twitter
================

5102JavaScript

Since Mar 14Pushed 7y ago4 watchersCompare

[ Source](https://github.com/statamic/twitter)[ Packagist](https://packagist.org/packages/statamic/twitter)[ RSS](/packages/statamic-twitter/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Twitter
=======

[](#twitter)

> A fieldtype for Statamic v3

[![](capture.gif)](capture.gif)

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

[](#installation)

```
composer require statamic/twitter
php artisan vendor:publish --provider="Statamic\Twitter\ServiceProvider"

```

### Adding API Keys

[](#adding-api-keys)

This addon uses the [Jonathan Thuau's Twitter package](https://github.com/thujohn/twitter) under the hood. You will need to [create a Twitter app](https://apps.twitter.com/) and hook your API keys.

Once you've made your app, add the following to your `.env` file and enter the values:

```
TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN=
TWITTER_ACCESS_TOKEN_SECRET=

```

Fieldtype
---------

[](#fieldtype)

Use the `twitter` fieldtype to select tweets from a given user.

```
fields:
  -
    handle: tweets
    field:
      type: twitter
      max_items: 3
      screen_name: jason_varga
```

The fieldtype will save a list of tweet status IDs.

```
tweets:
  - 12345
  - 67890
```

Templating
----------

[](#templating)

The saved tweet IDs will be automatically augmented to useful data. Just use an array syntax to loop over them.

```
{{ tweets }}

        {{ text }}
        – {{ user }}

{{ /tweets }}
```

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/284c5b58bdd27f11208613351d7e9b04b9b8b7f9acc024b480630cd51e5f7df6?d=identicon)[statamic](/maintainers/statamic)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/statamic-twitter/health.svg)

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

PHPackages © 2026

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