PHPackages                             msenkpiel/kirby-iframe - 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. msenkpiel/kirby-iframe

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

msenkpiel/kirby-iframe
======================

Plugin to add an iFrame to Kirby CMS

v1.1.0(1mo ago)550MITShell

Since Oct 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/msenkpiel/kirby-iframe)[ Packagist](https://packagist.org/packages/msenkpiel/kirby-iframe)[ RSS](/packages/msenkpiel-kirby-iframe/feed)WikiDiscussions main Synced 1w ago

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

kirby-iframe
============

[](#kirby-iframe)

Plugin to add an iFrame to Kirby Panel.

[![Desktop Screen](./doc/screen_desktop.png)](./doc/screen_desktop.png)

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

[](#installation)

```
composer require msenkpiel/kirby-iframe

```

Config options
--------------

[](#config-options)

Due to the iframe security policies, it is not possible to read the height of the iFrame content and embed the frame at the appropriate height. Therefore, you can only define fixed heights for the iFrame. To ensure responsive behavior, it is possible to define breakpoints and corresponding iFrame heights.

[![Mobile Screen](./doc/screen_mobile.png)](./doc/screen_mobile.png)

### Config

[](#config)

```
// site/config/config.php
return [
    'msenkpiel.iframe' => [

         // panel navigation settings
        'label' => 'Navigation Label',
        'icon' => 'box',

        // panel frame title
        'title' => 'Frame title',

        // iframe url
        'url' => '',

        // iframe height based on container width
        'breakpoints' => [
            0 => 500, // mobile
            992 => 3000 // desktop
        ]
    ]
]
```

Development
-----------

[](#development)

You can test the plugin locally without installing Kirby on your machine. The Docker setup creates a temporary Kirby Plainkit installation, mounts this plugin into `site/plugins/kirby-iframe` and starts Kirby's built-in PHP server.

### Docker test environment

[](#docker-test-environment)

```
make docker-up
```

- Website:
- Panel:
- Login: `admin@example.test` / `admin1234`

The default Panel account is only intended for this local test environment. The Docker setup configures Kirby's public URL as `http://localhost:8080` so Panel redirects point to the host URL instead of the container bind address.

You can override the credentials, Kirby URL and iframe URL with environment variables:

```
KIRBY_ADMIN_EMAIL=admin@example.test KIRBY_ADMIN_PASSWORD=admin1234 KIRBY_SITE_URL=http://localhost:8080 IFRAME_URL=/iframe-target make docker-up
```

To use a different host port, set both the published port and Kirby's public URL:

```
KIRBY_PORT=8081 KIRBY_SITE_URL=http://localhost:8081 make docker-up
```

To test with Kirby 4:

```
make docker-up-kirby4
```

To test with the Kirby 6 preview:

```
make docker-up-kirby6
```

To remove the temporary Kirby installation and start fresh:

```
make docker-reset
```

### Run Kirby-Up

[](#run-kirby-up)

The Panel view is built from a Vue component with kirbyup.

```
make install
make dev
make build
```

Run local build and Docker Compose config checks:

```
make test
```

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance93

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

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

Recently: every ~152 days

Total

6

Last Release

35d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

iframe-embedskirby-cmskirby-panelkirby-pluginkirby4kirby5

### Embed Badge

![Health badge](/badges/msenkpiel-kirby-iframe/health.svg)

```
[![Health](https://phpackages.com/badges/msenkpiel-kirby-iframe/health.svg)](https://phpackages.com/packages/msenkpiel-kirby-iframe)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k606.6k541](/packages/getkirby-cms)[medienbaecker/kirby-modules

Easily add modules to your pages

895.6k1](/packages/medienbaecker-kirby-modules)[fabianmichael/kirby-meta

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

7011.8k1](/packages/fabianmichael-kirby-meta)[tobimori/kirby-dreamform

Kirby DreamForm is an opiniated form builder plugin for Kirby CMS 4+ that makes forms work like magic

6012.6k1](/packages/tobimori-kirby-dreamform)[medienbaecker/kirby-alter

262.5k](/packages/medienbaecker-kirby-alter)[grommasdietz/kirby-hidden-characters

Kirby CMS plugin for visualising hidden characters in the Panel

462.2k](/packages/grommasdietz-kirby-hidden-characters)

PHPackages © 2026

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