PHPackages                             notmyhostname/posse - 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. notmyhostname/posse

ActiveKirby-plugin

notmyhostname/posse
===================

POSSE plugin for Kirby CMS

v1.2.0(10mo ago)18571[1 PRs](https://github.com/dewey/kirby-posse/pulls)MITPHPCI failing

Since May 20Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/dewey/kirby-posse)[ Packagist](https://packagist.org/packages/notmyhostname/posse)[ Docs](https://github.com/dewey/kirby-posse)[ RSS](/packages/notmyhostname-posse/feed)WikiDiscussions main Synced 1mo ago

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

POSSE Plugin for Kirby
======================

[](#posse-plugin-for-kirby)

This plugin enables Publish (on your) Own Site, Syndicate Elsewhere (POSSE) functionality for your Kirby site. Automatically syndicate your posts to Mastodon and Bluesky (For now), or manually decide which ones you want to syndicate.

[![Overview](./Overview.png)](./Overview.png)

Features
--------

[](#features)

- Automatically syndicates your posts to Mastodon and Bluesky
- Customizable post template with support for title, URL and tags
- Queue system for managing which posts get syndicated when
- Configurable delay before syndication (To fix typos, etc.)
- Support for syndication image limits (Up to 4 images) and image size presets
- Automated cron job endpoint for scheduled syndication
- SQLite database for storing syndication history and queue

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

[](#installation)

1. Download or clone this repository to `/site/plugins/posse`
2. Configure the plugin through the Panel at "POSSE > Settings"

Optional: Add `/site/db/posse.sqlite` and `/site/config/posse.yml` to `.gitignore` for git-based deployment strategies.

Configuration
-------------

[](#configuration)

Everything related to the plugin can be configured through the Kirby Panel. The automated syndication feature requires Basic Auth to be enabled in your config.php:

```
return [
    'api.basicAuth' => true
];
```

### Configuration File Structure

[](#configuration-file-structure)

The plugin stores all settings in a YAML file at `site/config/posse.yml`, making settings persistent even when reinstalling the plugin. The `posse.yml` file contains all plugin settings with the following structure:

```
# Content types to track (post, photo, etc.)
contenttypes:
  post: true
  photo: true

# Delay in minutes before syndication
syndication_delay: 60

# Post template using placeholders: {{title}}, {{url}}, {{tags}}
template: |
  {{title}}

  {{url}}

  {{tags}}

services:
  mastodon:
    enabled: true
    instance_url: https://mastodon.social
    api_token: your-api-token
    image_limit: 4
  bluesky:
    enabled: true
    instance_url: https://bsky.social
    api_token: yourname.bsky.social:1234-4567-...
    image_limit: 4
```

Database
--------

[](#database)

The plugin uses SQLite to store the syndication history and queue. The database file is automatically created and located at:

```
/site/db/posse.sqlite

```

This database tracks which posts have been syndicated to which services and manages the queue of pending syndications.

Automated Syndication
---------------------

[](#automated-syndication)

To set up automated syndication with a cron job:

1. Make sure Basic Auth is enabled in your config.php
2. Set up a cron job that runs a few times per hour. In this example every 10 minutes:

```
*/10 * * * * curl -s -u "USERNAME:PASSWORD" "https://yourdomain.com/api/posse/cron-syndicate" > /dev/null 2>&1

```

Replace USERNAME and PASSWORD with your Kirby panel credentials.

For monitoring with Healthchecks.io:

```
*/10 * * * * curl -s -u "USERNAME:PASSWORD" "https://yourdomain.com/api/posse/cron-syndicate" && curl -fsS -m 10 https://hc-ping.com/YOUR-UUID > /dev/null 2>&1

```

Post Templates
--------------

[](#post-templates)

The post template supports these placeholders:

- `{{title}}` - The post title
- `{{url}}` - The URL to your post
- `{{tags}}` - Hashtags generated from the post's tags

Example template:

```
{{title}}

{{url}}

{{tags}}

```

License
-------

[](#license)

MIT License

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance54

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.6% 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 ~9 days

Total

7

Last Release

308d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/73e54d78caa38061f8b500954f509630c188641aecc64b7b8c1067a190681646?d=identicon)[tehwey](/maintainers/tehwey)

---

Top Contributors

[![dewey](https://avatars.githubusercontent.com/u/790262?v=4)](https://github.com/dewey "dewey (35 commits)")[![maxhoffmann](https://avatars.githubusercontent.com/u/1227441?v=4)](https://github.com/maxhoffmann "maxhoffmann (2 commits)")

---

Tags

blueskyindiewebkirbykirby-pluginmastodonposse

### Embed Badge

![Health badge](/badges/notmyhostname-posse/health.svg)

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

###  Alternatives

[getkirby/cms

The Kirby core

1.5k535.5k352](/packages/getkirby-cms)[distantnative/retour-for-kirby

Manage redirects and track 404s right from the Kirby CMS Panel

14689.4k1](/packages/distantnative-retour-for-kirby)[getkirby/staticache

Static site performance on demand

9615.4k](/packages/getkirby-staticache)[arnoson/kirby-vite

Vite helper for Kirby CMS

9759.2k3](/packages/arnoson-kirby-vite)[getkirby/kql

Kirby Query Language

15124.3k](/packages/getkirby-kql)[getkirby/starterkit

Kirby Starterkit

20612.3k](/packages/getkirby-starterkit)

PHPackages © 2026

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