nodebb-plugin-calendar-onekite 2.1.2 → 10.0.11

package/package.json

@@ -1,23 +1,10 @@
 {
   "name": "nodebb-plugin-calendar-onekite",
-  "version": "2.1.2",
-  "description": "Calendar + equipment booking + admin approval + HelloAsso payments for NodeBB v4 (no-jQuery UI)",
+  "version": "10.0.11",
+  "description": "NodeBB calendar booking plugin using FullCalendar and HelloAsso checkout intents",
   "main": "library.js",
   "license": "MIT",
-  "keywords": [
-    "nodebb",
-    "plugin",
-    "calendar",
-    "booking",
-    "helloasso",
-    "fullcalendar"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {},
-  "scripts": {
-    "lint": "echo \"(optional) add eslint if you want\"",
-    "test": "echo \"no tests\""
+  "dependencies": {
+    "axios": "^1.7.7"
   }
 }

package/plugin.json

@@ -1,17 +1,9 @@
 {
   "id": "nodebb-plugin-calendar-onekite",
-  "name": "Calendar Onekite",
-  "description": "Calendrier + réservation matériel + validation admin + paiement HelloAsso pour NodeBB v4 (no-jQuery UI)",
-  "url": "",
-  "version": "2.1.2",
+  "name": "Calendar OneKite",
+  "description": "FullCalendar-based equipment booking workflow with HelloAsso checkout + admin approval.",
+  "url": "https://www.onekite.com/calendar",
   "library": "./library.js",
-  "staticDirs": {
-    "static": "static"
-  },
-  "acpScripts": [
-    "static/js/admin.bundle.js",
-    "static/js/admin-planning.bundle.js"
-  ],
   "hooks": [
     {
       "hook": "static:app.load",
@@ -22,13 +14,25 @@
       "method": "addAdminNavigation"
     },
     {
-      "hook": "filter:widgets.getWidgets",
-      "method": "defineWidgets"
-    },
-    {
-      "hook": "filter:widget.render:calendarUpcoming",
-      "method": "renderUpcomingWidget"
+      "hook": "filter:router.page",
+      "method": "addPageRoute"
     }
   ],
-  "templates": "templates"
+  "templates": "templates",
+  "staticDirs": {
+    "public": "./public"
+  },
+  "acpScripts": [
+    "public/js/admin/calendar-onekite-admin.js"
+  ],
+  "scripts": [
+    "public/js/calendar-onekite.js"
+  ],
+  "styles": [
+    "public/css/calendar-onekite.css"
+  ],
+  "languages": [
+    "language"
+  ],
+  "defaultLang": "en-GB"
 }

package/public/css/calendar-onekite.css

@@ -0,0 +1,14 @@
+.calendar-onekite-page {
+  padding: 0.5rem 0;
+}
+
+.calendar-onekite-header {
+  margin-top: 0.25rem;
+}
+
+#onekite-calendar {
+  background: var(--bs-body-bg);
+  border: 1px solid var(--bs-border-color);
+  border-radius: 0.75rem;
+  padding: 0.5rem;
+}

package/public/js/admin/calendar-onekite-admin.js

@@ -0,0 +1,81 @@
+/* global $, app, socket */
+
+(function () {
+  function setStatus(html, type) {
+    const el = $('#calendar-onekite-admin-status');
+    el.html(`<div class="alert alert-${type || 'info'}">${html}</div>`);
+  }
+
+  async function loadSettings() {
+    const settings = await $.getJSON('/api/admin/plugins/calendar-onekite');
+    // Populate
+    $('#calendar-onekite-settings [name="enabled"]').prop('checked', settings.enabled === 'on' || settings.enabled === true);
+    $('#calendar-onekite-settings [name="requesterGroups"]').val(settings.requesterGroups || '');
+    $('#calendar-onekite-settings [name="approverGroups"]').val(settings.approverGroups || '');
+    $('#calendar-onekite-settings [name="holdMinutes"]').val(settings.holdMinutes || 60);
+    $('#calendar-onekite-settings [name="notifyEmails"]').val(settings.notifyEmails || '');
+
+    $('#calendar-onekite-settings [name="helloassoEnv"]').val(settings.helloassoEnv || 'sandbox');
+    $('#calendar-onekite-settings [name="helloassoClientId"]').val(settings.helloassoClientId || '');
+    $('#calendar-onekite-settings [name="helloassoClientSecret"]').val(settings.helloassoClientSecret || '');
+    $('#calendar-onekite-settings [name="helloassoOrganizationSlug"]').val(settings.helloassoOrganizationSlug || '');
+    $('#calendar-onekite-settings [name="helloassoFormType"]').val(settings.helloassoFormType || 'event');
+    $('#calendar-onekite-settings [name="helloassoFormSlug"]').val(settings.helloassoFormSlug || '');
+    $('#calendar-onekite-settings [name="helloassoBackUrl"]').val(settings.helloassoBackUrl || '');
+    $('#calendar-onekite-settings [name="helloassoErrorUrl"]').val(settings.helloassoErrorUrl || '');
+    $('#calendar-onekite-settings [name="helloassoReturnUrl"]').val(settings.helloassoReturnUrl || '');
+    $('#calendar-onekite-settings [name="itemsCacheMinutes"]').val(settings.itemsCacheMinutes || 360);
+  }
+
+  async function saveSettings(e) {
+    e.preventDefault();
+    const data = {};
+    $('#calendar-onekite-settings').serializeArray().forEach(({ name, value }) => {
+      data[name] = value;
+    });
+    data.enabled = $('#calendar-onekite-settings [name="enabled"]').prop('checked') ? 'on' : '';
+    await $.ajax({
+      url: '/api/admin/plugins/calendar-onekite',
+      method: 'POST',
+      data,
+    });
+    setStatus('Sauvegardé ✅', 'success');
+  }
+
+  async function testItems() {
+    try {
+      const res = await $.getJSON('/api/calendar-onekite/items');
+      const items = res.items || [];
+      setStatus(`Items récupérés: <strong>${items.length}</strong>`, 'info');
+    } catch (e) {
+      setStatus(`Erreur items: ${e.responseJSON && e.responseJSON.error ? e.responseJSON.error : e.statusText}`, 'danger');
+    }
+  }
+
+  async function purgeYear() {
+    const year = parseInt($('#calendar-onekite-purge-year').val(), 10);
+    if (!year) {
+      return setStatus('Année invalide', 'warning');
+    }
+    if (!confirm(`Purger toutes les réservations dont le début est en ${year} ?`)) return;
+
+    try {
+      const res = await $.ajax({
+        url: '/api/admin/plugins/calendar-onekite/purge',
+        method: 'POST',
+        data: { year },
+      });
+      setStatus(`Purge terminée. Supprimés: <strong>${res.deleted}</strong>`, 'success');
+    } catch (e) {
+      setStatus(`Erreur purge: ${e.responseJSON && e.responseJSON.error ? e.responseJSON.error : e.statusText}`, 'danger');
+    }
+  }
+
+  $(window).on('action:admin.plugins.calendar-onekite', async function () {
+    await loadSettings();
+
+    $('#calendar-onekite-settings').off('submit').on('submit', saveSettings);
+    $('#calendar-onekite-test-items').off('click').on('click', testItems);
+    $('#calendar-onekite-purge').off('click').on('click', purgeYear);
+  });
+})();

package/public/js/calendar-onekite.js

@@ -0,0 +1,186 @@
+/* global $, app */
+(function () {
+  async function fetchItems() {
+    const res = await $.getJSON('/api/calendar-onekite/items');
+    return res.items || [];
+  }
+
+  async function createReservation(payload) {
+    const res = await $.ajax({
+      url: '/api/calendar-onekite/reservations',
+      method: 'POST',
+      data: payload,
+    });
+    return res.reservation;
+  }
+
+  async function approveReservation(id) {
+    const res = await $.ajax({
+      url: `/api/calendar-onekite/reservations/${encodeURIComponent(id)}/approve`,
+      method: 'POST',
+    });
+    return res.reservation;
+  }
+
+  async function rejectReservation(id) {
+    const res = await $.ajax({
+      url: `/api/calendar-onekite/reservations/${encodeURIComponent(id)}/reject`,
+      method: 'POST',
+    });
+    return res.reservation;
+  }
+
+  function loadFullCalendar() {
+    return new Promise((resolve, reject) => {
+      if (window.FullCalendar) return resolve();
+      const css = document.createElement('link');
+      css.rel = 'stylesheet';
+      css.href = 'https://cdn.jsdelivr.net/npm/fullcalendar@6.1.15/index.global.min.css';
+      document.head.appendChild(css);
+
+      const script = document.createElement('script');
+      script.src = 'https://cdn.jsdelivr.net/npm/fullcalendar@6.1.15/index.global.min.js';
+      script.onload = resolve;
+      script.onerror = reject;
+      document.head.appendChild(script);
+    });
+  }
+
+  async function initCalendar() {
+    await loadFullCalendar();
+
+    const uid = parseInt(app.user && app.user.uid, 10) || 0;
+    if (!uid) $('#onekite-login-hint').show();
+
+    let items = [];
+    try {
+      items = await fetchItems();
+    } catch (e) {
+      console.warn('Unable to fetch items', e);
+    }
+
+    function promptForItem() {
+      if (!items.length) {
+        const itemName = prompt('Nom du matériel ?');
+        if (!itemName) return null;
+        return { id: itemName, name: itemName, priceCents: 0 };
+      }
+      const choices = items
+        .map((it, idx) => {
+          const id = it.id ?? it.itemId ?? it.itemID ?? idx;
+          const name = it.name ?? it.label ?? it.itemName ?? `Item ${id}`;
+          const price = it.price ?? it.amount ?? it.unitPrice ?? it.totalAmount ?? it.publicAmount ?? 0;
+          return { id: String(id), name: String(name), priceCents: Number(price) || 0 };
+        });
+
+      const menu = choices.map((c, i) => `${i + 1}) ${c.name}${c.priceCents ? ` — ${(c.priceCents / 100).toFixed(2)}€` : ''}`).join('\n');
+      const input = prompt(`Choisis un matériel:\n${menu}\n\nEntre le numéro:`);
+      const n = parseInt(input, 10);
+      if (!n || n < 1 || n > choices.length) return null;
+      return choices[n - 1];
+    }
+
+    const calendarEl = document.getElementById('onekite-calendar');
+    const calendar = new FullCalendar.Calendar(calendarEl, {
+      initialView: 'dayGridMonth',
+      selectable: true,
+      editable: false,
+      height: 'auto',
+      headerToolbar: {
+        left: 'prev,next today',
+        center: 'title',
+        right: 'dayGridMonth,timeGridWeek,timeGridDay',
+      },
+      events: async (info, success, failure) => {
+        try {
+          const res = await $.getJSON('/api/calendar-onekite/events', {
+            start: info.startStr,
+            end: info.endStr,
+          });
+          success(res.events || []);
+        } catch (e) {
+          failure(e);
+        }
+      },
+      select: async (selectionInfo) => {
+        try {
+          if (!uid) {
+            app.alertError('Connecte-toi pour réserver.');
+            calendar.unselect();
+            return;
+          }
+          const item = promptForItem();
+          if (!item) {
+            calendar.unselect();
+            return;
+          }
+          const payload = {
+            itemId: item.id,
+            itemName: item.name,
+            start: selectionInfo.startStr,
+            end: selectionInfo.endStr,
+            priceCents: item.priceCents || 0,
+          };
+          await createReservation(payload);
+          app.alertSuccess('Demande envoyée (en attente de validation).');
+          calendar.refetchEvents();
+        } catch (e) {
+          const err = (e.responseJSON && e.responseJSON.error) ? e.responseJSON.error : e.statusText;
+          if (err === 'overlap') {
+            app.alertError('Ce matériel est déjà réservé sur cette période.');
+          } else if (err === 'not-allowed') {
+            app.alertError('Vous n’êtes pas autorisé à créer une demande.');
+          } else {
+            app.alertError(`Erreur: ${err}`);
+          }
+        } finally {
+          calendar.unselect();
+        }
+      },
+      eventClick: async (clickInfo) => {
+        const ev = clickInfo.event;
+        const p = ev.extendedProps || {};
+        // Approve/reject only if pending, and user has rights (server will enforce)
+        if (p.status !== 'pending') return;
+
+        if (!uid) return;
+
+        const action = prompt('Réservation en attente. Tape "a" pour valider, "r" pour refuser, autre pour annuler.');
+        if (action === 'a') {
+          try {
+            const updated = await approveReservation(ev.id);
+            app.alertSuccess('Validée ✅. Un email avec lien de paiement a été envoyé.');
+            calendar.refetchEvents();
+            if (updated && updated.paymentUrl) {
+              // optionally open link
+              const open = confirm('Ouvrir le lien de paiement ?');
+              if (open) window.open(updated.paymentUrl, '_blank');
+            }
+          } catch (e) {
+            const err = (e.responseJSON && e.responseJSON.error) ? e.responseJSON.error : e.statusText;
+            app.alertError(`Erreur validation: ${err}`);
+          }
+        } else if (action === 'r') {
+          try {
+            await rejectReservation(ev.id);
+            app.alertSuccess('Refusée ❌');
+            calendar.refetchEvents();
+          } catch (e) {
+            const err = (e.responseJSON && e.responseJSON.error) ? e.responseJSON.error : e.statusText;
+            app.alertError(`Erreur refus: ${err}`);
+          }
+        }
+      },
+    });
+
+    calendar.render();
+
+    $('#onekite-refresh').on('click', () => calendar.refetchEvents());
+  }
+
+  $(window).on('action:ajaxify.end', function (ev, data) {
+    if (data && data.url && data.url.startsWith('calendar')) {
+      initCalendar();
+    }
+  });
+})();

package/templates/admin/plugins/calendar-onekite.tpl

@@ -1,78 +1,117 @@
-<div id="calendar-onekite-admin">
-  <h2>Calendar Onekite – Administration</h2>
+<div class="acp-page-container">
+  <h1 class="mb-4">Calendar OneKite</h1>
 
-  <h3>Réservations en attente</h3>
-  <div id="pending-reservations"></div>
+  <div class="alert alert-warning">
+    Les groupes sont à renseigner par <strong>noms de groupes</strong> séparés par des virgules (ex: <code>administrators, booking-approvers</code>).
+  </div>
 
-  <hr>
+  <form id="calendar-onekite-settings">
+    <div class="mb-3">
+      <label class="form-label">Activer le plugin</label>
+      <div class="form-check">
+        <input class="form-check-input" type="checkbox" id="enabled" name="enabled">
+        <label class="form-check-label" for="enabled">Enabled</label>
+      </div>
+    </div>
 
-  <h3>Paramètres du plugin</h3>
+    <div class="row g-3">
+      <div class="col-md-6">
+        <label class="form-label">Groupes autorisés à créer une demande (requesterGroups)</label>
+        <input class="form-control" type="text" name="requesterGroups" placeholder="members, ..." />
+      </div>
+      <div class="col-md-6">
+        <label class="form-label">Groupes qui valident/refusent (approverGroups)</label>
+        <input class="form-control" type="text" name="approverGroups" placeholder="administrators, ..." />
+      </div>
+    </div>
 
-  <div class="form-group">
-    <label>Groupes autorisés à créer / modifier des événements</label>
-    <input id="calendar-onekite-groups" class="form-control" value="{settings.allowedGroups}">
-    <small>Ex : administrators, moderators</small>
-  </div>
+    <div class="row g-3 mt-1">
+      <div class="col-md-6">
+        <label class="form-label">Durée de blocage d'une demande en attente (minutes)</label>
+        <input class="form-control" type="number" name="holdMinutes" min="1" value="60" />
+      </div>
+      <div class="col-md-6">
+        <label class="form-label">Emails supplémentaires à notifier (optionnel)</label>
+        <input class="form-control" type="text" name="notifyEmails" placeholder="[email protected], [email protected]" />
+      </div>
+    </div>
 
-  <div class="form-group">
-    <label>Groupes autorisés à réserver</label>
-    <input id="calendar-onekite-book-groups" class="form-control" value="{settings.allowedBookingGroups}">
-    <small>Ex : registered-users, membres, vip</small>
-  </div>
+    <hr class="my-4"/>
 
-  <div class="form-group">
-    <label>Nombre d’événements dans le widget</label>
-    <input id="calendar-onekite-widget-limit" type="number" class="form-control" value="{settings.limit}">
-  </div>
+    <h3 class="h5">HelloAsso</h3>
+    <div class="row g-3">
+      <div class="col-md-4">
+        <label class="form-label">Environnement</label>
+        <select class="form-select" name="helloassoEnv">
+          <option value="sandbox">sandbox</option>
+          <option value="prod">prod</option>
+        </select>
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">Client ID</label>
+        <input class="form-control" type="text" name="helloassoClientId" />
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">Client Secret</label>
+        <input class="form-control" type="password" name="helloassoClientSecret" />
+      </div>
+    </div>
 
-  <hr>
-  <h3>Lieux & Inventaire (global)</h3>
-  <p class="text-muted">
-    Les stocks sont globaux et séparés par lieu. Format JSON.
-  </p>
+    <div class="row g-3 mt-1">
+      <div class="col-md-4">
+        <label class="form-label">organizationSlug</label>
+        <input class="form-control" type="text" name="helloassoOrganizationSlug" />
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">formType</label>
+        <input class="form-control" type="text" name="helloassoFormType" placeholder="event, membership, donation..." />
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">formSlug</label>
+        <input class="form-control" type="text" name="helloassoFormSlug" />
+      </div>
+    </div>
 
-  <div class="form-group">
-    <label>Lieux (locations)</label>
-    <textarea id="calendar-onekite-locations" class="form-control" rows="4">{settings.locationsJson}</textarea>
-    <small>Ex: [{"id":"arnaud","name":"Chez Arnaud"},{"id":"siege","name":"Siège Onekite"}]</small>
-  </div>
+    <div class="row g-3 mt-1">
+      <div class="col-md-4">
+        <label class="form-label">backUrl (HTTPS)</label>
+        <input class="form-control" type="text" name="helloassoBackUrl" />
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">errorUrl (HTTPS)</label>
+        <input class="form-control" type="text" name="helloassoErrorUrl" />
+      </div>
+      <div class="col-md-4">
+        <label class="form-label">returnUrl (HTTPS)</label>
+        <input class="form-control" type="text" name="helloassoReturnUrl" />
+      </div>
+    </div>
 
-  <div class="form-group">
-    <label>Inventaire (inventory)</label>
-    <textarea id="calendar-onekite-inventory" class="form-control" rows="6">{settings.inventoryJson}</textarea>
-    <small>Ex: [{"id":"wing","name":"Aile Wing","price":5,"stockByLocation":{"arnaud":1,"siege":0}}]</small>
-  </div>
+    <div class="row g-3 mt-1">
+      <div class="col-md-4">
+        <label class="form-label">Cache items HelloAsso (minutes)</label>
+        <input class="form-control" type="number" name="itemsCacheMinutes" min="1" value="360" />
+      </div>
+    </div>
 
-  <hr>
-  <h3>HelloAsso</h3>
-  <div class="form-group">
-    <label>API base</label>
-    <input id="calendar-onekite-helloasso-apibase" class="form-control" value="{settings.helloassoApiBase}">
-    <small>Ex: https://api.helloasso.com</small>
-  </div>
-  <div class="form-group">
-    <label>Organization slug</label>
-    <input id="calendar-onekite-helloasso-org" class="form-control" value="{settings.helloassoOrganizationSlug}">
-  </div>
-  <div class="form-group">
-    <label>Form slug (Checkout)</label>
-    <input id="calendar-onekite-helloasso-form" class="form-control" value="{settings.helloassoFormSlug}">
-  </div>
-  <div class="form-group">
-    <label>Client ID</label>
-    <input id="calendar-onekite-helloasso-clientid" class="form-control" value="{settings.helloassoClientId}">
-  </div>
-  <div class="form-group">
-    <label>Client Secret</label>
-    <input id="calendar-onekite-helloasso-secret" class="form-control" value="{settings.helloassoClientSecret}">
-  </div>
-  <div class="form-group">
-    <label>Return URL</label>
-    <input id="calendar-onekite-helloasso-return" class="form-control" value="{settings.helloassoReturnUrl}">
-  </div>
+    <div class="mt-4 d-flex gap-2">
+      <button class="btn btn-primary" type="submit">Sauvegarder</button>
+      <button class="btn btn-outline-secondary" type="button" id="calendar-onekite-test-items">Tester la récupération des items</button>
+    </div>
+  </form>
 
-  <button id="calendar-onekite-save" class="btn btn-primary">Enregistrer</button>
-</div>
+  <hr class="my-4"/>
 
+  <h3 class="h5">Purge calendrier</h3>
+  <div class="row g-2 align-items-end">
+    <div class="col-md-3">
+      <label class="form-label">Année</label>
+      <input class="form-control" type="number" id="calendar-onekite-purge-year" min="1970" max="3000" placeholder="2025" />
+    </div>
+    <div class="col-md-3">
+      <button class="btn btn-danger" type="button" id="calendar-onekite-purge">Purger</button>
+    </div>
+  </div>
 
-<script src="/plugins/nodebb-plugin-calendar-onekite/static/js/admin.bundle.js"></script>
+  <div class="mt-3" id="calendar-onekite-admin-status"></div>
+</div>

package/templates/calendar-onekite/calendar.tpl

@@ -0,0 +1,18 @@
+<div class="calendar-onekite-page">
+  <div class="calendar-onekite-header d-flex align-items-center justify-content-between flex-wrap gap-2">
+    <h1 class="h3 mb-0">Calendrier</h1>
+    <div class="calendar-onekite-actions d-flex gap-2 align-items-center">
+      <button class="btn btn-sm btn-outline-secondary" id="onekite-refresh">Rafraîchir</button>
+    </div>
+  </div>
+
+  <div class="alert alert-info mt-3" id="onekite-login-hint" style="display:none;">
+    Vous devez être connecté pour faire une demande de réservation.
+  </div>
+
+  <div class="mt-3" id="onekite-calendar"></div>
+
+  <div class="mt-3 small text-muted">
+    <span>⏳ = en attente de validation</span> · <span>✅ = validée</span> · <span>❌ = refusée</span>
+  </div>
+</div>

package/.drone.yml

@@ -1,62 +0,0 @@
-kind: pipeline
-type: docker
-name: deploy-nodebb-plugin
-
-trigger:
-  branch:
-    - master
-  event:
-    - push
-
-steps:
-  - name: sanity-check
-    image: node:20-alpine
-    commands:
-      - node -v
-      - test -f plugin.json
-      - test -f library.js
-      - test -d static
-      - test -d templates
-
-  - name: deploy-files
-    image: appleboy/drone-scp
-    settings:
-      host:
-        from_secret: SSH_HOST
-      username:
-        from_secret: SSH_USER
-      port:
-        from_secret: SSH_PORT
-      key:
-        from_secret: SSH_KEY
-      source:
-        - ./
-      target:
-        from_secret: PLUGIN_TARGET_DIR
-      strip_components: 0
-      overwrite: true
-
-  - name: install-and-build
-    image: appleboy/drone-ssh
-    environment:
-      PLUGIN_TARGET_DIR:
-        from_secret: PLUGIN_TARGET_DIR
-    settings:
-      host:
-        from_secret: SSH_HOST
-      username:
-        from_secret: SSH_USER
-      port:
-        from_secret: SSH_PORT
-      key:
-        from_secret: SSH_KEY
-      script:
-        - 'echo "Plugin: $PLUGIN_TARGET_DIR"'
-        - 'test -d "$PLUGIN_TARGET_DIR"'
-
-        - 'cd "$PLUGIN_TARGET_DIR"'
-        - 'if [ -f package.json ]; then npm ci --omit=dev; else echo "No package.json, skipping npm ci"; fi'
-
-        #- 'cd "$NODEBB_PATH"'
-        #- './nodebb build'
-        #- './nodebb restart || true'

package/README.md

@@ -1,28 +0,0 @@
-# nodebb-plugin-calendar-onekite (no-jQuery)
-
-## Features
-- FullCalendar frontend (Month/Week/Day/List) with drag&drop + resize (editable for authorized groups)
-- Event CRUD, booking (multi-day), admin validation workflow, HelloAsso payment intent + webhook
-- Admin pages (ACP) without jQuery; robust under ajaxify via MutationObserver
-- Widget: calendarUpcoming
-
-## Important: FullCalendar assets
-This package loads FullCalendar from jsDelivr CDN in templates/calendar.tpl.
-If you need offline / no-CDN, tell me and I will vendor the files under static/vendor/fullcalendar.
-
-## Install
-- Copy into your NodeBB plugins folder
-- Activate plugin in ACP
-- Rebuild: ./nodebb build
-
-## Routes
-- Pages: /calendar, /calendar/my-reservations
-- Admin: /admin/plugins/calendar-onekite, /admin/calendar/planning
-- API: available under /api/... and /api/v3/... (NodeBB v4 client helper uses /api/v3)
-
-
-## v2.1 inventory model
-- Global locations/inventory in ACP (locationsJson/inventoryJson)
-- Events select allowed inventory item IDs (bookingItemIds)
-- Availability is global per (itemId, locationId) across all events
-- Admin planning is graphical (FullCalendar) with filters