johannschopplich / kirby-helpers

🍬 Dotenv support, meta tag generation and more for Kirby CMS

Hi, I’m Johann. I work somewhere in between development and design —
A JavaScript one-trick pony with an aesthetic sense.

Projects

My current focus is on the Nuxt and Vue development experience.

Multi-Framework

• unlazy: 🪧 Universal lazy loading library for placeholder images leveraging native browser APIs

Nuxt.js & Vue.js

• @nuxtjs/plausible: 🎟️ Plausible Analytics integration for Nuxt
• nuxt-api-party: 🐬 Securely connect to any API with a server proxy and generated composables
• nuxt-prepare: 🦎 Run initialization steps at build time
• nuxt-kql: 🫧 Kirby's Query Language API for Nuxt
• nuxt-gtag: 🔸 Google Tag integration for Nuxt: Google Analytics, Google Ads and more
• vue-stickers: 🍦 One component, multiple fancy sticker variants
• @byjohann/vue-i18n: 🌐 Lightweight internationalization plugin for Vue

Tooling

• @unocss/cli: 🎨 The CLI for UnoCSS. A perfect fit for traditional backends.
• nitro-test-utils: 🧪 Testing environment and utilities for Nitro
• pdfjs-serverless: 🪭 Serverless build of PDF.js for Deno, workers, and other nodeless environments
• kirbyup: 🆙 Official bundler for Kirby Panel plugins

Libraries

• unpdf: 📄 Utilities to work with PDFs in Node.js, browser and workers
• tokenwise: 📐 GPT token estimation and context size utilities without a full tokenizer
• apiverse: ✴️ Unified, pluggable API client management for ofetch, route building and typed OpenAPI clients

Demos / Templates / App Starters

• cacao-kit-frontend: 🍫 Best practice Nuxt and KQL starter for your headless Kirby CMS
• kirby-headless-starter: 🦭 Headless Kirby starter – KQL, Express-esque middlewares & more
• kirby-nuxt-starterkit: 💚 Kirby's sample site – ported to Nuxt 3 and KirbyQL

Kirby Plugins

Commercial

• kirby-live-preview: 🪩 Real-time page preview in the Kirby Panel
• kirby-seo-audit: 🏃 State-of-the-art SEO analysis for Kirby CMS
• kirby-copilot: 🪁 Your everyday AI companion for the Kirby Panel

Open Source

• ⭐️ kirby-content-translator: 🌐 Kirby Panel plugin to translate content at once with DeepL or other services
• kirby-headless: 🦭 Kirby, but headless only – bearer token, Express-esque middlewares & more
• kirby-algolia-docsearch: 🔦 Index and search your Kirby site with Algolia DocSearch
• kirby-serp-preview: 🔍 Kirby Panel plugin for search engine result page previews
• kirby-punctuation-section: ✒️ Insert punctuation marks into your text with a single click

kirby-helpers's Issues

pregmatch error in SiteMeta, if excludePages include subpages

Hi Johann,
I get the following error, if i include subpages in the exclude.pages-Option:

// Sitemap
    'kirby-extended.sitemap' => [
        'enable' => true,
        'exclude' => [
            'pages' => ['pagexy', 'pagexy/subpagexy'],
            /*
            'pages' => function () {
                return site()->index()->unlisted()->pluck('id', ',');
            },*/
            'templates' => [
                'default',
                'error',

In the original SiteMeta-Plugin from Bastian,the preg_match-function is slightly different.

//if (preg_match('/^(?:' . implode('|', $excludePages) . ')$/i', $item->id())) {
if (preg_match('!^(?:' . implode('|', $pages) . ')$!i', $item->id())) {

if i change that line, it works for me.
Didn't you have an issue with that before?
I dont know if your SiteMeta is from an older version or if you changed that intentionally...

Would be nice, if you can have a look and maybe change the above line.
i you like me to, i can do a PR.

Thx!

Remove unlisted pages from `sitemap.xml` by option

Hi Johann,
in my opinion, unlisted pages should not be part of the sitemap.xml, so google won't index them.
it would be nice to have an option to remove all unlisted pages from the sitemap.xml by adding an option.
something like

$excludeUnlisted = option('kirby-extended.sitemap.exclude.unlisted', false);
if($excludeUnlisted) {
  $items = site()->index()->listed();
} else {
  $items = site()->index();
}

...

foreach ($items as $item) {

...

i think that would be much faster, than add all unlisted pages by an exclude.pages-Array, and preg_match them with site()->index()

what do you think about that?

Thx!

ish

Calrify options name

Hi Johann,

With the latest update you mention "Rename your config options from kirby-helpers.<some-key> to johannschopplich.helpers.<some-key>".

However, in the main Kirby config file, the name kirby-helpers still needs to be used (see https://github.com/johannschopplich/kirby-vue3-starterkit/blob/main/site/config/config.php).

It's very much a small detail but caused me some confusion,
Thanks,
Luke