feat: add Contao 5.7 pinboard bundle

README.md

@@ -0,0 +1,19 @@
+# Contao Pinboard Bundle
+
+Contao 5.7 Bundle für eine Pinwand mit frei angeordneten Pinnwandeinträgen.
+
+## Features
+
+- Backend-Entität `tl_pinnwand` unter **Inhalte**
+- Felder: Überschrift, Text (max. 3000), Link, Bild, dateAdded, dateModified, published, hervorgehoben
+- Frontend-Modul `pinnwand` (Twig)
+- Kork-Hintergrund + zufällige, überlappende Notizzettel
+- Drag-&-Drop als visueller Effekt (ohne Persistenz)
+- Hervorgehobene Einträge immer im Vordergrund
+
+## Installation (Bundle im Projekt einbinden)
+
+1. Bundle per Composer einbinden.
+2. Cache leeren.
+3. Datenbank aktualisieren.
+4. Assets installieren, damit CSS/JS unter `bundles/contaopinboard/` verfügbar sind.

composer.json

@@ -0,0 +1,18 @@
+{
+  "name": "eiswurm/contao-pinboard-bundle",
+  "description": "Pinboard bundle for Contao 5.7",
+  "type": "contao-bundle",
+  "license": "proprietary",
+  "require": {
+    "php": "^8.4",
+    "contao/core-bundle": "^5.7"
+  },
+  "autoload": {
+    "psr-4": {
+      "Eiswurm\\ContaoPinboardBundle\\": "src/"
+    }
+  },
+  "extra": {
+    "contao-manager-plugin": "Eiswurm\\ContaoPinboardBundle\\ContaoManager\\Plugin"
+  }
+}

contao/config/config.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+use Eiswurm\ContaoPinboardBundle\Model\PinboardModel;
+
+$GLOBALS['BE_MOD']['content']['pinnwand'] = [
+    'tables' => ['tl_pinnwand'],
+];
+
+$GLOBALS['TL_MODELS']['tl_pinnwand'] = PinboardModel::class;

contao/config/services.yaml

@@ -0,0 +1,22 @@
+services:
+  _defaults:
+    autowire: true
+    autoconfigure: true
+
+  Eiswurm\ContaoPinboardBundle\:
+    resource: '../../src/*'
+    exclude:
+      - '../../src/ContaoManager/'
+      - '../../src/ContaoPinboardBundle.php'
+
+  Eiswurm\ContaoPinboardBundle\Controller\FrontendModule\PinboardController:
+    tags:
+      -
+        name: contao.frontend_module
+        category: application
+        type: pinnwand
+        template: frontend_module/pinnwand
+
+  Eiswurm\ContaoPinboardBundle\EventListener\DataContainer\PinboardTimestampListener:
+    tags:
+      - { name: contao.callback, table: tl_pinnwand, target: config.onsubmit }

contao/dca/tl_pinnwand.php

@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+$GLOBALS['TL_DCA']['tl_pinnwand'] = [
+    'config' => [
+        'dataContainer' => Contao\DC_Table::class,
+        'enableVersioning' => true,
+        'sql' => [
+            'keys' => [
+                'id' => 'primary',
+                'published' => 'index',
+                'hervorgehoben' => 'index',
+            ],
+        ],
+    ],
+    'list' => [
+        'sorting' => [
+            'mode' => 1,
+            'fields' => ['hervorgehoben DESC', 'dateAdded DESC'],
+            'flag' => 6,
+            'panelLayout' => 'filter;sort,search,limit',
+        ],
+        'label' => [
+            'fields' => ['ueberschrift', 'dateAdded'],
+            'format' => '%s <span style="color:#999;padding-left:3px">[%s]</span>',
+        ],
+        'global_operations' => [
+            'all' => [
+                'href' => 'act=select',
+                'class' => 'header_edit_all',
+                'attributes' => 'onclick="Backend.getScrollOffset()" accesskey="e"',
+            ],
+        ],
+        'operations' => [
+            'edit' => [
+                'href' => 'act=edit',
+                'icon' => 'edit.svg',
+            ],
+            'copy' => [
+                'href' => 'act=copy',
+                'icon' => 'copy.svg',
+            ],
+            'delete' => [
+                'href' => 'act=delete',
+                'icon' => 'delete.svg',
+                'attributes' => 'onclick="if(!confirm(\'' . ($GLOBALS['TL_LANG']['MSC']['deleteConfirm'] ?? 'Möchten Sie den Eintrag wirklich löschen?') . '\'))return false;Backend.getScrollOffset()"',
+            ],
+            'show' => [
+                'href' => 'act=show',
+                'icon' => 'show.svg',
+            ],
+        ],
+    ],
+    'palettes' => [
+        'default' => '{title_legend},ueberschrift,text,link,bild;{meta_legend},dateAdded,dateModified;{publish_legend},published,hervorgehoben',
+    ],
+    'fields' => [
+        'id' => [
+            'sql' => 'int(10) unsigned NOT NULL auto_increment',
+        ],
+        'tstamp' => [
+            'sql' => 'int(10) unsigned NOT NULL default 0',
+        ],
+        'ueberschrift' => [
+            'exclude' => true,
+            'search' => true,
+            'sorting' => true,
+            'inputType' => 'text',
+            'eval' => ['mandatory' => true, 'maxlength' => 255, 'tl_class' => 'w50'],
+            'sql' => "varchar(255) NOT NULL default ''",
+        ],
+        'text' => [
+            'exclude' => true,
+            'search' => true,
+            'inputType' => 'textarea',
+            'eval' => ['mandatory' => true, 'maxlength' => 3000, 'rte' => 'tinyMCE', 'allowHtml' => true, 'tl_class' => 'clr'],
+            'sql' => 'text NULL',
+        ],
+        'link' => [
+            'exclude' => true,
+            'search' => true,
+            'inputType' => 'text',
+            'eval' => ['rgxp' => 'url', 'decodeEntities' => true, 'maxlength' => 2048, 'dcaPicker' => true, 'tl_class' => 'w50'],
+            'sql' => "varchar(2048) NOT NULL default ''",
+        ],
+        'bild' => [
+            'exclude' => true,
+            'inputType' => 'fileTree',
+            'eval' => ['filesOnly' => true, 'fieldType' => 'radio', 'extensions' => Contao\Config::get('validImageTypes'), 'mandatory' => false, 'tl_class' => 'w50 clr'],
+            'sql' => 'binary(16) NULL',
+        ],
+        'dateAdded' => [
+            'sorting' => true,
+            'flag' => 6,
+            'inputType' => 'text',
+            'eval' => ['rgxp' => 'datim', 'datepicker' => true, 'mandatory' => true, 'tl_class' => 'w50 wizard'],
+            'sql' => 'int(10) unsigned NOT NULL default 0',
+        ],
+        'dateModified' => [
+            'sorting' => true,
+            'flag' => 6,
+            'inputType' => 'text',
+            'eval' => ['rgxp' => 'datim', 'readonly' => true, 'disabled' => true, 'tl_class' => 'w50'],
+            'sql' => 'int(10) unsigned NOT NULL default 0',
+        ],
+        'published' => [
+            'exclude' => true,
+            'filter' => true,
+            'toggle' => true,
+            'inputType' => 'checkbox',
+            'eval' => ['doNotCopy' => true, 'tl_class' => 'w50 m12'],
+            'sql' => "char(1) NOT NULL default ''",
+        ],
+        'hervorgehoben' => [
+            'exclude' => true,
+            'filter' => true,
+            'toggle' => true,
+            'inputType' => 'checkbox',
+            'eval' => ['tl_class' => 'w50 m12'],
+            'sql' => "char(1) NOT NULL default ''",
+        ],
+    ],
+];

contao/languages/de/modules.php

@@ -0,0 +1,6 @@
+<?php
+
+declare(strict_types=1);
+
+$GLOBALS['TL_LANG']['MOD']['pinnwand'] = ['Pinwand', 'Pinnwandeinträge verwalten'];
+$GLOBALS['TL_LANG']['FMD']['pinnwand'] = ['Pinwand', 'Zeigt veröffentlichte Pinnwandeinträge als frei angeordnete Notizzettel an'];

contao/languages/de/tl_pinnwand.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+$GLOBALS['TL_LANG']['tl_pinnwand']['ueberschrift'] = ['Überschrift', 'Die Überschrift des Pinnwandeintrags.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['text'] = ['Text', 'Inhalt des Pinnwandeintrags (maximal 3000 Zeichen).'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['link'] = ['Link', 'Optionaler Link zum Eintrag.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['bild'] = ['Bild', 'Optionales Bild für den Pinnwandeintrag.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['dateAdded'] = ['Erstellt am', 'Datum/Uhrzeit der Erstellung.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['dateModified'] = ['Geändert am', 'Datum/Uhrzeit der letzten Änderung.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['published'] = ['Veröffentlicht', 'Nur veröffentlichte Einträge erscheinen im Frontend.'];
+$GLOBALS['TL_LANG']['tl_pinnwand']['hervorgehoben'] = ['Hervorgehoben', 'Hervorgehobene Einträge liegen im Frontend immer oben.'];
+
+$GLOBALS['TL_LANG']['tl_pinnwand']['title_legend'] = 'Inhalt';
+$GLOBALS['TL_LANG']['tl_pinnwand']['meta_legend'] = 'Metadaten';
+$GLOBALS['TL_LANG']['tl_pinnwand']['publish_legend'] = 'Veröffentlichung';

src/ContaoManager/Plugin.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Eiswurm\ContaoPinboardBundle\ContaoManager;
+
+use Contao\ManagerPlugin\Bundle\BundlePluginInterface;
+use Contao\ManagerPlugin\Bundle\Config\BundleConfig;
+use Contao\ManagerPlugin\Bundle\Parser\ParserInterface;
+use Contao\CoreBundle\ContaoCoreBundle;
+use Eiswurm\ContaoPinboardBundle\ContaoPinboardBundle;
+
+final class Plugin implements BundlePluginInterface
+{
+    public function getBundles(ParserInterface $parser): array
+    {
+        return [
+            BundleConfig::create(ContaoPinboardBundle::class)
+                ->setLoadAfter([ContaoCoreBundle::class]),
+        ];
+    }
+}

src/ContaoPinboardBundle.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Eiswurm\ContaoPinboardBundle;
+
+use Symfony\Component\HttpKernel\Bundle\Bundle;
+
+final class ContaoPinboardBundle extends Bundle
+{
+}

src/Controller/FrontendModule/PinboardController.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Eiswurm\ContaoPinboardBundle\Controller\FrontendModule;
+
+use Contao\CoreBundle\Controller\FrontendModule\AbstractFrontendModuleController;
+use Contao\FilesModel;
+use Contao\ModuleModel;
+use Contao\Template;
+use Eiswurm\ContaoPinboardBundle\Model\PinboardModel;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class PinboardController extends AbstractFrontendModuleController
+{
+    protected function getResponse(Template $template, ModuleModel $model, Request $request): Response
+    {
+        $collection = PinboardModel::findBy(
+            ['published = ?'],
+            ['1'],
+            ['order' => 'hervorgehoben DESC, dateAdded DESC, id DESC']
+        );
+
+        $notes = [];
+
+        if (null !== $collection) {
+            foreach ($collection as $entry) {
+                $imagePath = null;
+
+                if ($entry->bild) {
+                    $fileModel = FilesModel::findByUuid($entry->bild);
+                    $imagePath = $fileModel?->path;
+                }
+
+                $notes[] = [
+                    'id' => (int) $entry->id,
+                    'headline' => (string) $entry->ueberschrift,
+                    'text' => (string) $entry->text,
+                    'link' => (string) $entry->link,
+                    'dateAdded' => (int) $entry->dateAdded,
+                    'dateModified' => (int) $entry->dateModified,
+                    'imagePath' => $imagePath,
+                    'highlighted' => '1' === $entry->hervorgehoben,
+                ];
+            }
+        }
+
+        return $this->render('@Contao/frontend_module/pinnwand.html.twig', [
+            'entries' => $notes,
+            'module' => $model,
+        ]);
+    }
+}

src/EventListener/DataContainer/PinboardTimestampListener.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Eiswurm\ContaoPinboardBundle\EventListener\DataContainer;
+
+use Contao\DataContainer;
+use Contao\Database;
+
+final class PinboardTimestampListener
+{
+    public function __invoke(DataContainer $dataContainer): void
+    {
+        if (null === $dataContainer->id) {
+            return;
+        }
+
+        $timestamp = time();
+
+        $record = Database::getInstance()
+            ->prepare('SELECT dateAdded FROM tl_pinnwand WHERE id = ?')
+            ->limit(1)
+            ->execute($dataContainer->id);
+
+        if (!$record->numRows) {
+            return;
+        }
+
+        $dateAdded = (int) $record->dateAdded;
+
+        Database::getInstance()
+            ->prepare('UPDATE tl_pinnwand SET dateAdded = ?, dateModified = ?, tstamp = ? WHERE id = ?')
+            ->execute($dateAdded > 0 ? $dateAdded : $timestamp, $timestamp, $timestamp, $dataContainer->id);
+    }
+}

src/Model/PinboardModel.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Eiswurm\ContaoPinboardBundle\Model;
+
+use Contao\Model;
+
+final class PinboardModel extends Model
+{
+    protected static string $strTable = 'tl_pinnwand';
+}

src/Resources/public/css/pinboard.css

@@ -0,0 +1,110 @@
+.pinboard {
+  width: 100%;
+  max-width: 1400px;
+  margin: 0 auto;
+  padding: 1.5rem;
+}
+
+.pinboard__surface {
+  position: relative;
+  min-height: 42rem;
+  border-radius: 1.2rem;
+  overflow: hidden;
+  background:
+    radial-gradient(circle at 20% 10%, rgba(255, 255, 255, 0.25), transparent 42%),
+    radial-gradient(circle at 80% 90%, rgba(50, 30, 10, 0.2), transparent 36%),
+    repeating-linear-gradient(35deg, rgba(75, 40, 15, 0.18), rgba(75, 40, 15, 0.18) 3px, rgba(93, 52, 23, 0.12) 3px, rgba(93, 52, 23, 0.12) 9px),
+    linear-gradient(145deg, #b77944 0%, #a66a38 45%, #8d552a 100%);
+  box-shadow: inset 0 0 0 1px rgba(65, 33, 12, 0.25), inset 0 0 18px rgba(45, 22, 8, 0.35);
+}
+
+.pin-note {
+  position: absolute;
+  width: clamp(220px, 28vw, 340px);
+  min-height: 190px;
+  padding: 1rem 1rem 1.25rem;
+  border-radius: 0.3rem;
+  background: linear-gradient(160deg, #fff8a8 0%, #f5eb85 100%);
+  color: #2a241c;
+  box-shadow: 0 10px 22px rgba(20, 10, 5, 0.34);
+  cursor: grab;
+  user-select: none;
+  touch-action: none;
+  transition: box-shadow 160ms ease, transform 160ms ease;
+}
+
+.pin-note::before {
+  content: '';
+  position: absolute;
+  top: -9px;
+  left: 50%;
+  width: 18px;
+  height: 18px;
+  transform: translateX(-50%);
+  border-radius: 50%;
+  background: radial-gradient(circle at 35% 35%, #f2f2f2, #979797 68%, #707070 100%);
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.35);
+}
+
+.pin-note.is-highlighted {
+  background: linear-gradient(160deg, #ffd99b 0%, #f7c46f 100%);
+}
+
+.pin-note.is-dragging {
+  cursor: grabbing;
+  box-shadow: 0 18px 34px rgba(20, 10, 5, 0.46);
+}
+
+.pin-note__image-wrap {
+  margin: 0 0 0.7rem;
+}
+
+.pin-note__image {
+  display: block;
+  width: 100%;
+  height: auto;
+  border-radius: 0.25rem;
+}
+
+.pin-note__headline {
+  margin: 0 0 0.5rem;
+  font-size: 1.1rem;
+  line-height: 1.25;
+}
+
+.pin-note__text {
+  font-size: 0.96rem;
+  line-height: 1.45;
+  max-height: 14rem;
+  overflow: hidden;
+}
+
+.pin-note__link-wrap {
+  margin: 0.8rem 0 0;
+}
+
+.pin-note__link {
+  color: inherit;
+  font-weight: 600;
+}
+
+.pinboard__empty {
+  margin: 0;
+  padding: 1.5rem;
+  color: #fff;
+  font-weight: 600;
+}
+
+@media (max-width: 768px) {
+  .pinboard {
+    padding: 0.8rem;
+  }
+
+  .pinboard__surface {
+    min-height: 36rem;
+  }
+
+  .pin-note {
+    width: min(84vw, 290px);
+  }
+}

src/Resources/public/js/pinboard.js

@@ -0,0 +1,121 @@
+(() => {
+  const board = document.querySelector('[data-pinboard-surface]');
+
+  if (!board) {
+    return;
+  }
+
+  const notes = Array.from(board.querySelectorAll('[data-pin-note]'));
+
+  if (!notes.length) {
+    return;
+  }
+
+  let zCounter = 200;
+
+  const randomBetween = (min, max) => Math.random() * (max - min) + min;
+
+  const placeNotes = () => {
+    const boardRect = board.getBoundingClientRect();
+    const maxXBase = Math.max(24, boardRect.width - 300);
+    const maxYBase = Math.max(24, boardRect.height - 220);
+
+    notes.forEach((note, index) => {
+      const maxX = Math.max(16, maxXBase - note.offsetWidth * 0.2);
+      const maxY = Math.max(16, maxYBase - note.offsetHeight * 0.2);
+
+      const x = randomBetween(12, maxX);
+      const y = randomBetween(12, maxY);
+      const rotation = randomBetween(-7, 7);
+      const highlighted = note.dataset.highlighted === '1';
+      const level = highlighted ? 1000 + index : 100 + index;
+
+      note.dataset.baseRotation = String(rotation);
+      note.dataset.x = String(x);
+      note.dataset.y = String(y);
+      note.style.zIndex = String(level);
+      note.style.transform = `translate(${x}px, ${y}px) rotate(${rotation}deg)`;
+    });
+  };
+
+  const clampToBoard = (note, x, y) => {
+    const boardRect = board.getBoundingClientRect();
+    const noteRect = note.getBoundingClientRect();
+    const maxX = Math.max(0, boardRect.width - noteRect.width);
+    const maxY = Math.max(0, boardRect.height - noteRect.height);
+
+    return {
+      x: Math.min(Math.max(0, x), maxX),
+      y: Math.min(Math.max(0, y), maxY),
+    };
+  };
+
+  const enableDrag = (note) => {
+    let dragging = false;
+    let pointerId = null;
+    let offsetX = 0;
+    let offsetY = 0;
+
+    note.addEventListener('pointerdown', (event) => {
+      dragging = true;
+      pointerId = event.pointerId;
+      note.setPointerCapture(pointerId);
+      note.classList.add('is-dragging');
+      note.style.zIndex = String(++zCounter + 2000);
+
+      const startX = Number.parseFloat(note.dataset.x ?? '0');
+      const startY = Number.parseFloat(note.dataset.y ?? '0');
+      offsetX = event.clientX - startX;
+      offsetY = event.clientY - startY;
+    });
+
+    note.addEventListener('pointermove', (event) => {
+      if (!dragging || event.pointerId !== pointerId) {
+        return;
+      }
+
+      const baseRotation = Number.parseFloat(note.dataset.baseRotation ?? '0');
+      const nextX = event.clientX - offsetX;
+      const nextY = event.clientY - offsetY;
+      const clamped = clampToBoard(note, nextX, nextY);
+
+      note.dataset.x = String(clamped.x);
+      note.dataset.y = String(clamped.y);
+      note.style.transform = `translate(${clamped.x}px, ${clamped.y}px) rotate(${baseRotation}deg)`;
+    });
+
+    const releaseDrag = (event) => {
+      if (!dragging || event.pointerId !== pointerId) {
+        return;
+      }
+
+      dragging = false;
+      note.classList.remove('is-dragging');
+      note.releasePointerCapture(pointerId);
+      pointerId = null;
+    };
+
+    note.addEventListener('pointerup', releaseDrag);
+    note.addEventListener('pointercancel', releaseDrag);
+  };
+
+  const adjustBoardHeight = () => {
+    let requiredHeight = 620;
+
+    notes.forEach((note) => {
+      const y = Number.parseFloat(note.dataset.y ?? '0');
+      requiredHeight = Math.max(requiredHeight, y + note.offsetHeight + 36);
+    });
+
+    board.style.minHeight = `${Math.ceil(requiredHeight)}px`;
+  };
+
+  placeNotes();
+  notes.forEach(enableDrag);
+  adjustBoardHeight();
+
+  window.addEventListener('resize', () => {
+    placeNotes();
+    adjustBoardHeight();
+  });
+})();

templates/frontend_module/pinnwand.html.twig

@@ -0,0 +1,38 @@
+{% extends '@Contao/frontend_module/_base.html.twig' %}
+
+{% block content %}
+  <link rel="stylesheet" href="{{ asset('bundles/contaopinboard/css/pinboard.css') }}">
+
+  <section class="pinboard" data-pinboard>
+    <div class="pinboard__surface" data-pinboard-surface>
+      {% for entry in entries %}
+        <article
+          class="pin-note{% if entry.highlighted %} is-highlighted{% endif %}"
+          data-pin-note
+          data-highlighted="{{ entry.highlighted ? '1' : '0' }}"
+          data-seed="{{ entry.id }}"
+          aria-label="{{ entry.headline }}"
+        >
+          {% if entry.imagePath %}
+            <figure class="pin-note__image-wrap">
+              <img src="{{ asset(entry.imagePath) }}" alt="" class="pin-note__image">
+            </figure>
+          {% endif %}
+
+          <h3 class="pin-note__headline">{{ entry.headline }}</h3>
+          <div class="pin-note__text">{{ entry.text|raw }}</div>
+
+          {% if entry.link %}
+            <p class="pin-note__link-wrap">
+              <a href="{{ entry.link }}" class="pin-note__link" target="_blank" rel="noopener">Mehr erfahren</a>
+            </p>
+          {% endif %}
+        </article>
+      {% else %}
+        <p class="pinboard__empty">Keine veröffentlichten Pinnwandeinträge vorhanden.</p>
+      {% endfor %}
+    </div>
+  </section>
+
+  <script src="{{ asset('bundles/contaopinboard/js/pinboard.js') }}" defer></script>
+{% endblock %}