PHPackages                             omz13/kirby3-byline - 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. omz13/kirby3-byline

AbandonedArchivedKirby-plugin[Utility & Helpers](/categories/utility)

omz13/kirby3-byline
===================

kirby3 plugin to provide field methods to generate author bylines

313PHP

Since Mar 22Pushed 7y ago1 watchersCompare

[ Source](https://github.com/omz13/kirby3-byline)[ Packagist](https://packagist.org/packages/omz13/kirby3-byline)[ RSS](/packages/omz13-kirby3-byline/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Kirby3 byline
=============

[](#kirby3-byline)

**Requirement:** Kirby 3.0

Coffee, Beer, etc.
------------------

[](#coffee-beer-etc)

This plugin is free but if you use it in a commercial project to show your support you are welcome to:

- [make a donation 🍻](https://www.paypal.me/omz13/10) or
- [buy me ☕☕](https://buymeacoff.ee/omz13) or
- [buy a Kirby license using this affiliate link](https://a.paddle.com/v2/click/1129/36191?link=1170)

Purpose
-------

[](#purpose)

This is a plugin for kirby3 that provides field methods to make generating a byline very easy. Multiple authors are turned into a (comma-separated-and) list, author names can link to their website or whatever, and localization is provided.

- It can cope with a field that either contains a single author or a structured (yaml) list of one or more authors.
- When generating the byline, it adds separators (typically a comma) and a coordinator between the last entries (typically an "and") which are *localized* for `fr`, `de`, `el`, `es`, `it`, `nl`, `sv` and `zh`.
- Can prefix the byline with "By", which is similarly *localized*.
- For an author, can wrap their name as a links to their website, twitter handle, or instagram (as set on their user page if the appropriate fields are available, *viz.*, respectively `website`, `twitter`, `instagram`).
- Provides a default attribution (`Staff Writer`) if the author field is empty; c.f. `author` in `config.php`.

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

[](#installation)

Install as per usual into your kirby 3 site.

For composer-based sites it can be installed from packagist.

configuration
-------------

[](#configuration)

#### `config.php`

[](#configphp)

In your site's `site/config/config.php` the following entries prefixed with `omz13.byline.` can be used:

- `author` - optional - string - default `'Staff Writer'` - the name to be used when the author is unknown.

fieldMethods
------------

[](#fieldmethods)

### byline

[](#byline)

This plugin provides a field method called `byline` that should be passed a field that contains the author or authors; the field passed can be either a simple field or a structured field and it will automaticlly cope with either.

When there are multiple authors it will return a comma-separated-and list of the authors' names.

For a single author, it will return the author's name.

If the author's details are missing, it will return `"Staff Writer"` (or whatever has been specified by the configuration option `author`).

This field method is intended for use in a *blueprint*, for example:

```
info: "{{ page.author.byline }} - {{ page.date('Y-m-d') }}"
```

### bylineLinked

[](#bylinelinked)

This field method is similar to the `byline` field method except that each authors' name is 'wrapped' in an html link to their (in order of preference) website, twitter, or instagram (as determined by `website`, `twitter`, or `instagram` fields in a user's blueprint).

The `bylineLinked` field method is intended for use in a *template* or a *snippet*:

```

```

For example, for the Kirby [starterkit](https://github.com/k-next/starterkit), you would change in `snippets/article` the lines:

```

By

```

to:

```
by
```

### bylineBy

[](#bylineby)

This is identical to `byline`, but the result is prefixed with "By" (or its l10n).

### bylineByLinked

[](#bylinebylinked)

This is identical to `bylineLinked`, but the result is prefixed with "By" (or its l10n).

Example:

```

```

Disclaimer
----------

[](#disclaimer)

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please [create a new issue](https://github.com/omz13/kirby3-feeds/issues/new).

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity37

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/1dbc3ce8468cef79b4169051bca9138f8fc9b8e68f509b4069345febec8ac986?d=identicon)[omz13](/maintainers/omz13)

---

Top Contributors

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

---

Tags

bylinekirby3-plugin

### Embed Badge

![Health badge](/badges/omz13-kirby3-byline/health.svg)

```
[![Health](https://phpackages.com/badges/omz13-kirby3-byline/health.svg)](https://phpackages.com/packages/omz13-kirby3-byline)
```

###  Alternatives

[misterphilip/maintenance-mode

An enhanced drop-in replacement for Laravel's maintenance mode

120176.7k](/packages/misterphilip-maintenance-mode)[log1x/plugin-meta

A simple meta package for my commonly used WordPress plugins

164.3k](/packages/log1x-plugin-meta)

PHPackages © 2026

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