Initial commit

Author: medienbaecker

.editorconfig

@@ -0,0 +1,20 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.php]
+indent_size = 4
+
+[*.md,*.txt]
+trim_trailing_whitespace = false
+insert_final_newline = false
+
+[composer.json]
+indent_size = 4

.gitignore

@@ -0,0 +1,8 @@
+# OS files
+.DS_Store
+
+# npm modules
+/node_modules
+
+# Composer files
+/vendor

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <Year> <Your Name>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,41 @@
+# Kirby Playground
+
+## 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?)`
+-   Site method `playgroundLinks()` that scans the playground snippets directory and creates a navigation list
+-   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
+
+## Configuration
+
+You can enable authentication to restrict access to logged-in Panel users:
+
+```php
+// site/config/config.php
+return [
+  'medienbaecker.playground.auth' => true
+];
+```
+
+## Directory Structure
+
+```
+site/
+├── snippets/
+│   └── playground/
+│       └── your-component.php
+└── assets/
+    └── css/
+        └── playground/
+            ├── playground.css
+            └── your-component.css
+```

composer.json

@@ -0,0 +1,16 @@
+{
+    "name": "medienbaecker/playground",
+    "description": "Kirby Playground",
+    "license": "MIT",
+    "type": "kirby-plugin",
+    "version": "1.0.0",
+    "authors": [
+        {
+            "name": "Thomas Günther",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "getkirby/composer-installer": "^1.1"
+    }
+}

index.php

@@ -0,0 +1,54 @@
+<?php
+
+use Kirby\Cms\App as Kirby;
+use Kirby\Cms\Page;
+use Kirby\Filesystem\Dir;
+
+Kirby::plugin('medienbaecker/playground', [
+  'options' => [
+    'auth' => false
+  ],
+
+  'siteMethods' => [
+    'playgroundLinks' => function () {
+      $files = Dir::files(kirby()->root('snippets') . '/playground');
+      $links = array_map(function ($file) {
+        $name = pathinfo($file, PATHINFO_FILENAME);
+        $title = ucwords(str_replace('-', ' ', $name));
+        return "<li><a href='" . url("playground/{$name}") . "'>{$title}</a></li>";
+      }, $files);
+
+      return '<ul class="playground-nav">' . implode('', $links) . '</ul>';
+    }
+  ],
+
+  'templates' => [
+    'playground' => __DIR__ . '/templates/playground.php'
+  ],
+
+  'snippets' => [
+    'playground/not-found' => __DIR__ . '/snippets/not-found.php'
+  ],
+
+  'routes' => [
+    [
+      'pattern' => 'playground/(:any?)',
+      'action'  => function ($component = null) {
+        if (kirby()->option('medienbaecker.playground.auth') && !kirby()->user()) {
+          $this->next();
+        }
+
+        $page = new Page([
+          'slug'     => $component ?? 'playground',
+          'template' => 'playground',
+          'content'  => [
+            'title' => $component ? "Playground: {$component}" : 'Playground',
+            'component' => $component
+          ]
+        ]);
+
+        return site()->visit($page);
+      }
+    ]
+  ]
+]);

snippets/not-found.php

@@ -0,0 +1,5 @@
+<div class="wrap playground-list">
+  <div class="inner rich-text">
+    <?= site()->playgroundLinks() ?>
+  </div>
+</div>

templates/playground.php

@@ -0,0 +1,15 @@
+<?php snippet('head') ?>
+
+<?= css([
+  'assets/css/playground/playground.css',
+  "assets/css/playground/{$page->component()}.css"
+]) ?>
+
+<?php
+snippet([
+  "playground/{$page->component()}",
+  'playground/not-found'
+])
+?>
+
+<?php snippet('bottom') ?>