Kirby 4 plugins

$form = new Form([
    'name' => [
        'rules'   => ['required'],
        'message' => ['Name is required']
    ],
]);

- kirby install
- kirby install:kit
- kirby install:repo
- kirby make:blueprint
- kirby make:collection
- kirby make:command

<?= $page->myfield()->inherit() ?>

return [
    'afbora.loader.roots' => [
        '/plugins/core',
        '/plugins/payment',
        '/plugins/shipping',
    ]
];

foreach ($page->fruits()->toChoices() as $fruit) {
    echo $fruit;
}

fields:
  security: fields/locked-pages

env('APP_DEBUG');

{
    "query": "page('photography').children",
    "select": {
        "url": true,
        "title": true,
        "text": "page.text.markdown"
    }
}

<button <?= attributes([
    'type' => $type ?? 'button',
    'class' => [
        'btn',
        'btn--large' => $size === 'large'
    ],
 ])->merge($attr ?? []) ?>>

return [
    'bnomei.securityheaders.headers' => [
        'X-Frame-Options'        => 'SAMEORIGIN',
        'X-XSS-Protection'       => '1; mode=block',
        'X-Content-Type-Options' => 'nosniff',
        ...
    ]
];

<?= $page->counterImage() ?>

sections:
  redirects:
    extends: plugin-redirects3xx

return [
    'afbora.kirby-minify-html' => [
        'enabled' => true,
        'options' => [...]
    ]
];

[^This is a footnote.]

$form = new Form();

if ($kirby->request()->is('POST')) {
    // Call security
    $form->spamWordsGuard();

    // .. more code
}

monolog()->info('test-' . time()), [
    'title' => $page->title(),
    'page'  => $page->id()
]);

use Beebmx\KirbyDB\DB;

DB::table('users')->get();

blueprints
  ├── pages
  │   ├── default.yml
  │   ├── home.policy.yml
  │   ├── simple.policy.yml
  │   ├── content.yml
  │   └── post.policy.yml
  ├── users
  │   ├── admin.yml
  │   └── editor.yml
  └── site.yml

\Beebmx\KirbyEnv::load('main/path');

return [
    'debug'  => env('KIRBY_DEBUG', false),
    'secret' => env('SECRET_KEY'),
    'public' => env('PUBLIC_KEY'),
];

'beebmx.kirby-middleware' => [
    'global' => [
        MyOwnGlobalMiddleware::class,
    ],
]

$point = Geo::point(49.4883333, 8.4647222);

echo $point->lat();
echo $point->lng();

return [
  'cache' => [
    'pages' => [
      'active' => true,
      'type'   => 'static'
    ]
  ]
];

> Lorem ipsum dolor sit amet, consectetur adipiscing elit. 
> Morbi tincidunt sagittis aliquet. Interdum et malesuada 
> fames ac ante ipsum primis in faucibus. Cras eu 
> elementum sem, at ornare quam.

return Field::make(FieldTypes::TEXT)
    ->label('Description')
    ->toArray();

$page
  ->date()
  ->toDateTime()
  ->modify('+1 month')
  ->format('Y-m-d');

site
└ methods
  └ file.php
  └ page.php
  └ site.php
  └ user.php

// using the username
$users->toList();

// using the page title
$pages->toList();

// using the filename
$files->toList();

<p
    <?= attrs([
        'id' => 'introduction',
        'class' => 'highlighted'
    ])?>
>
    An introductory paragraph.
</p>

snippetWhen('article', $category->isNotEmpty())

$object->isPage();
$object->isUser();
$object->isFile();
$page->isType('article');

$plugins->filterBy('category', 'includes all', ['field', 'section']);

// As helper
<?= blindtext() ?>

// As site methods
<?= $site->blindtext() ?>

// As page methods
<?= $page->blindtext() ?>

// As user methods
<?= $user->blindtext() ?>

<?= $page->text()->kirbytext()->handleLinks() ?>

class MigrationTest extends Migration
{
    public function up()
    {
        $result = Db::query(
            'ALTER TABLE `my_table`
            ADD COLUMN `test` INT DEFAULT NULL;
        ');

        if (!$result) throw Db::lastError();
    }
}

'nerdcel.kirby-oauth2-email' => [
    'callback-path' => 'callback-path',
    'enabled' => true,
    'email' => 'example@your-provider.tdl',
    'service' => 'azure',
    'client-id' => 'your-client-id',
    'client-secret' => 'your-client-secret',
    'refresh-token' => 'your-refresh-token',
];

$page->file('ukulele.pdf')->fingerprint();

$page->title()
  ->merge($page->artist())
  ->prefix('Coming soon: ')
  ->when($page->release()->toDate() > time())

return [
    'bnomei.robots-txt' => [
        'content' => '...'
    ]
];

fields:
  alt:
    type: atai
    label: Alternative text

    fields:
      mylayout:
        label: Translated Layout Demo
        type: translatedlayout
        translate: true
        layouts:
          - "1/1"
          - "1/2, 1/2"
          - "1/3, 1/3, 1/3"

(vidembed: video.mp4 poster: poster.jpg)

$config = [
  'presprog.auto-file-templates' => [
    // Every uploaded image will be assigned the `my-image` template
    'image' => 'my-image',
    // Every uploaded video will be assigned the `video` template
    'video => true
  ]
];

<html <?= $site->langAttr() ?>>
  <head>
    <meta charset="utf-8">
    <?= $page->htmlhead() ?>
  </head>
  ...

<!doctype html>
<head>
  <?= vite(['assets/css/app.css', 'assets/js/app.js']) ?>
</head>

page('blog')->children()->feed([
    'title'       => 'Latest articles',
    'link'        => 'blog'
]);

'/^(?=.*[0-9])(?=.*[!@#$%^&*])[A-Za-z\d!@#$%^&*]{16,}$/'

$pages->bettersearch($string, $options)

Kirby::plugin('bnomei/example', [
    'blueprints' => autoloader(__DIR__)
                      ->blueprints(),
    'snippets' => autoloader(__DIR__)
                      ->snippets(),
    // other extensions
]);

return [
    'dgsiegel.kirby-tidy-html' => [
        'enabled' => true,
        'options' => [...]
    ]
];

// site/blueprints/pages/blueprint.php
$fields = [...]; // Fields for all users

if (kirby()->user()->isAdmin()) {
    $fields = [...] // Fields for admins
}

return [
    'title' => 'PHP-based blueprint',
    'fields' => $fields,
];

monolog()->log('something CRITICAL happend 😱', 'critical');

http://example.com/sitemap.xml
http://example.com/sitemap.json

(photoswipe: image.jpg
    width: 200
    height: 200
    quality: 70
    crop: true
)

robots.txt

<?php snippet('seo/meta') ?>

$queue = kqQueue('queuename');
$job   = kqJob([
    'foo' => 'foo',
    'bar' => 'bar'
]);

$queue->addJob($job);

return [
    'lukaskleinschmidt.resolve.cache' => true
];

<?= js('assets/js/main.js') ?>

<!-- will become -->
<script src="/assets/js/main.9ad649fd.js"></script>

$site->log('My message', 'error');

<?= $page->text()->toTree()->level(3) ?>

<div class="field">
    <?= label('Name', 'name') ?>
    <?= input('text', 'name') ?>
</div>

📁 snippets
├─ 📄 header.controller.php
└─ 📄 header.php

tp('apples', ['count' => 1]);
// 1 apple
tp('apples', ['count' => 3]);
// 3 apples
tp('place', ['position' => 1]);
// 1st
tp('cookies', ['start' => 3, 'end' => 4]);
// 3-4 cookies

// hook
'page.product.update:after' => function () {
    // your code goes here
}

$datelist = $site->recurr(
    '2022-09-10 20:00:00',
    '2022-09-11 02:00:00',
    'WEEKLY',
    ['WE', 'TH', 'FR'],
    '2022-10-11'
);

(arena: tim-duvendack/aesthetics-1483967740)

'maintenance' => true

return [
  'schnti.cachebuster.active' => true
];

// site/routes/my-awesome-route.php
use PresProg\RouteAttributes\Attributes\Get;

return #[Get('/hello')] function () {
    return '<h1>Hello world!</h1>';
};

$site->holidays('France', 2022);

<html>
  <head>
    <meta charset="utf-8">
    <?= $page->metaTags() ?>
  </head>
  ...

autopublish:
  label: Autopublish on
  type: date
  time: true
  default: now
autounpublish:
  label: Automatically unpublish on
  type: date
  time: true

foreach ($page->similar($options) as $p) {
  echo $p->title();
}

<?= $page->text()->chopper(20) ?>

assets/favicon/favicon.png

return [
  'thumbs' => [
    'driver' => 'vipsthumbnail'
  ]
];

(download: flyer.pdf text: our beautiful products)

thumbs/image.jpg
      ?width=640
      &height=640
      &crop=true

href="styles.db5796ea5bf2.css"

<form action="<?= $page->url() ?>" method="post">
    <!-- ... -->

    <?= csrf_field() ?>
    <?= turnstileField() ?>
    <input type="submit" value="Submit">
</form>
<?= turnstileScript() ?>

<?= __('Welcome to my site') ?>
<?= __('label.name') ?>
<?= __('Copyright {{year}}', ['year' => '2022']) ?>

$form = new Form([
    'name' => [
        'rules'   => ['required'],
        'message' => ['Name is required']
    ],
]);

(quote: Awesome quote author: A. Einstein)

return [
  'werbschaft.uploadExtended' => [
    'rename'            => true,
    'excludeCharacters' => ['_','__'],
    'tinyPng'           => true,
  ]
];

<?php snippet('fathom') ?>