PHPackages                             hashandsalt/kirby3-webp - 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. hashandsalt/kirby3-webp

AbandonedArchivedKirby-plugin

hashandsalt/kirby3-webp
=======================

Kirby 3 WebP plugin

v0.0.6(5y ago)328841[2 issues](https://github.com/HashandSalt/kirby3-webp/issues)MITPHP

Since Nov 1Pushed 5y ago1 watchersCompare

[ Source](https://github.com/HashandSalt/kirby3-webp)[ Packagist](https://packagist.org/packages/hashandsalt/kirby3-webp)[ RSS](/packages/hashandsalt-kirby3-webp/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

WebP Plugin for Kirby 3
=======================

[](#webp-plugin-for-kirby-3)

A snippet and Kirby tag for using WebP images in templates and within textareas. Plugin will convert uploaded files to WebP on the server. This requires having the appropriate extensions installed for IM, GD or whatever you are using. Plugin was tested with GD &amp; [cwebp](https://developers.google.com/speed/webp/docs/cwebp)

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

[](#installation)

### Manual

[](#manual)

To use this plugin, place all the files in `site/plugins/kirby3-webp`.

### Composer

[](#composer)

```
composer require hashandsalt/kirby3-webp

```

---

Commerical Usage
----------------

[](#commerical-usage)

This plugin is free but if you use it in a commercial project please consider to

- [make a donation 🍻](https://paypal.me/hashandsalt?locale.x=en_GB) or
- [buy a Kirby license using this affiliate link](https://a.paddle.com/v2/click/1129/36141?link=1170)

---

Usage
-----

[](#usage)

### Using the Kirby Tag

[](#using-the-kirby-tag)

On a basic level, this is enough:

```
(webp: yourimage.webp)

```

This will generate a picture tag with images for the default range of sizes: `[1920, 1140, 640, 320]`.

Will also accept `width`, `height`, `type`, `class`, `imgclass`, and `alt`.

The type allows you to set wether the fall back image is a jpg or a png.

Full example:

```
(webp: yourimage.webp width: 800 height: 600 type: png class: picturetagclass img: imgtagclass alt: my awesome alt text)

```

### Using the snippet

[](#using-the-snippet)

The tag uses a snippet, which you can use in your templates:

```
snippet('webp', ['sizes' => [1920, 1140, 640, 320], 'src' => 'yourimage.webp', 'type' => 'png', 'class' => 'picturetagclass', 'width' => 800, 'height' => 600])

```

If you want to modify the output of the snippet, you can copy it from the plugin into the usual snippet folder and it will get over ridden with your customised version. This is useful if you want to use `focusCrop` plugin rather then the built in `resize()`.

Options
-------

[](#options)

```
// Tag Options
'hashandsalt.kirby-webp.range' => [1920, 1140, 640, 320], // Default range of image sizes

// Convert Options
'hashandsalt.kirby-webp.template' => 'images', // file blueprint for converted files
'hashandsalt.kirby-webp.meta' => true,  // all|none|exif|icc|xmp

'hashandsalt.kirby-webp.png.encoding' => 'auto', // auto|lossy|lossless
'hashandsalt.kirby-webp.png.quality'  => 85, // 1 - 100

'hashandsalt.kirby-webp.jpeg.encoding' => 'auto', // auto|1 - 100
'hashandsalt.kirby-webp.jpeg.quality'  => 85, // 1 - 100

```

Roadmap
-------

[](#roadmap)

The following features will be implemented over time:

- Field Method.
- File Method.
- Convert source image to WebP on the server.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

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 ~63 days

Recently: every ~79 days

Total

6

Last Release

2066d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d18b7200637c15341417dfabb7c51c7ec3fda44f6a24cb4780b5e7c14f309118?d=identicon)[hashandsalt](/maintainers/hashandsalt)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/hashandsalt-kirby3-webp/health.svg)

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

###  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)[arnoson/kirby-vite

Vite helper for Kirby CMS

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

Static site performance on demand

9615.4k](/packages/getkirby-staticache)[fabianmichael/kirby-meta

Your all-in-one powerhouse for any SEO and metadata needs imaginable.

6910.7k1](/packages/fabianmichael-kirby-meta)[thathoff/kirby-oauth

Kirby OAuth 2 Plugin

3823.9k](/packages/thathoff-kirby-oauth)

PHPackages © 2026

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