README

Usage

1. Create your tests as snippets in /site/snippets/playground/
2. Access your tests at /playground/[component-name]

For example, if you have a snippet named buttons.php, it will be available at /playground/buttons.

Features

• Custom route handling for /playground/(:any?) that can optionally be restricted to logged-in users
• Components are rendered through virtual pages, without requiring actual page files
• Loads CSS files from assets/css/playground/[component-name].css and a global playground.css
• Built-in fallback to a component list when accessing non-existent components
• Placeholder helpers for lorem ipsum text and images

Placeholder Content

Generate placeholder content directly in your playground snippets (or anywhere else) by using the Playground class:

use Medienbaecker\Playground;

Text

Playground::text([
    // word count (default: 20)
    'words' => 50,
    'words' => [30, 60],

    // wrap in <p> tags (default: false)
    'paragraphs' => false,
    'paragraphs' => true,
    'paragraphs' => 3,
    'paragraphs' => [2, 5],

    // insert random <a> tags (default: false)
    'links' => false,
    'links' => true,
    'links' => 2,
    'links' => [1, 3],

    // insert random <strong> tags (default: false)
    'bold' => false,
    'bold' => true,
    'bold' => 1,
    'bold' => [1, 2],

    // insert random <em> tags (default: false)
    'italic' => false,
    'italic' => true,
    'italic' => 1,
    'italic' => [1, 3],

    // start with (default: 'Lorem ipsum ')
    'prefix' => 'Lorem ipsum ',
    'prefix' => false,

    // end with (default: '.')
    'suffix' => '.',
    'suffix' => false,
])

For names, titles, or other non-sentence content, set prefix and suffix to false (or null or ''):

Playground::text(['words' => 5, 'prefix' => false, 'suffix' => false])

This way you will get random words, not starting with Lorem ipsum and not ending with a period.

Images

Returns virtual Kirby File objects with full thumb support:

Playground::image('landscape')->thumb('card')
Playground::image('square')->crop(200, 200)
Playground::images(6) // returns a Files collection

Variants: landscape, portrait, square

Configuration

You can enable authentication to restrict access to logged-in Panel users:

// site/config/config.php
return [
  'medienbaecker.playground.auth' => true
];

Directory Structure

assets/
├── css/
│   └── playground/
│       ├── playground.css
│       └── your-component.css
site/
├── snippets/
│   └── playground/
│       └── your-component.php