nodebb-plugin-onekite-calendar 1.0.0

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

@@ -0,0 +1,215 @@
+<!-- IMPORT admin/partials/settings/header.tpl -->
+
+<div class="row">
+  <div class="col-lg-9">
+    <h1>Calendar OneKite</h1>
+
+    <ul class="nav nav-tabs mt-3" role="tablist">
+      <li class="nav-item" role="presentation">
+        <button class="nav-link active" data-bs-toggle="tab" data-bs-target="#onekite-tab-settings" type="button" role="tab">Locations</button>
+      </li>
+      <li class="nav-item" role="presentation">
+        <button class="nav-link" data-bs-toggle="tab" data-bs-target="#onekite-tab-events" type="button" role="tab">Évènements</button>
+      </li>
+      <li class="nav-item" role="presentation">
+        <button class="nav-link" data-bs-toggle="tab" data-bs-target="#onekite-tab-pending" type="button" role="tab">Demandes en attente</button>
+      </li>
+      <li class="nav-item" role="presentation">
+        <button class="nav-link" data-bs-toggle="tab" data-bs-target="#onekite-tab-debug" type="button" role="tab">Debug HelloAsso</button>
+      </li>
+      <li class="nav-item" role="presentation">
+        <button class="nav-link" data-bs-toggle="tab" data-bs-target="#onekite-tab-accounting" type="button" role="tab">Comptabilisation</button>
+      </li>
+    </ul>
+
+    <form id="onekite-settings-form">
+    <div class="tab-content pt-3">
+      <div class="tab-pane fade show active" id="onekite-tab-settings" role="tabpanel">
+<h4>Groupes</h4>
+          <div class="mb-3">
+            <label class="form-label">Groupes autorisés à créer une demande (csv)</label>
+            <input class="form-control" name="creatorGroups" placeholder="ex: registered-users,membres">
+            <div class="form-text">Le groupe <code>onekite-ffvl-YYYY</code> est automatiquement ajouté au début. Tu peux ajouter d'autres groupes à la suite.</div>
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Groupes pouvant valider/supprimer (csv)</label>
+            <input class="form-control" name="validatorGroups" placeholder="ex: administrators,location-managers">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Groupes notifiés par email (csv)</label>
+            <input class="form-control" name="notifyGroups" placeholder="ex: administrators">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Durée de blocage en attente (minutes)</label>
+            <input class="form-control" name="pendingHoldMinutes" placeholder="5">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Délai rappel paiement (minutes)</label>
+            <input class="form-control" name="paymentHoldMinutes" placeholder="60">
+            <div class="form-text">Après validation (statut <code>paiement en attente</code>), un rappel est envoyé après ce délai. La réservation est ensuite expirée après <strong>2×</strong> ce délai.</div>
+          </div>
+
+          <hr class="my-4" />
+          <h4>Discord</h4>
+
+          <div class="mb-3">
+            <label class="form-label">Webhook URL</label>
+            <input class="form-control" name="discordWebhookUrl" placeholder="https://discord.com/api/webhooks/...">
+            <div class="form-text">Si vide, aucune notification Discord n'est envoyée.</div>
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Envoyer une notification à la demande</label>
+            <select class="form-select" name="discordNotifyOnRequest">
+              <option value="1">Oui</option>
+              <option value="0">Non</option>
+            </select>
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Envoyer une notification au paiement reçu</label>
+            <select class="form-select" name="discordNotifyOnPaid">
+              <option value="1">Oui</option>
+              <option value="0">Non</option>
+            </select>
+          </div>
+
+          <h4 class="mt-4">HelloAsso</h4>
+
+          <div class="mb-3">
+            <label class="form-label">Environnement</label>
+            <select class="form-select" name="helloassoEnv">
+              <option value="prod">Production</option>
+              <option value="sandbox">Sandbox</option>
+            </select>
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Client ID</label>
+            <input class="form-control" name="helloassoClientId">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Client Secret</label>
+            <input class="form-control" name="helloassoClientSecret" type="password">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">IPs autorisées pour le webhook HelloAsso (csv)</label>
+            <input class="form-control" name="helloassoWebhookAllowedIps" placeholder="51.138.206.200,4.233.135.234">
+            <div class="form-text">Liste des IPs autorisées à appeler le webhook. Laisse vide pour utiliser la liste par défaut.</div>
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Organization Slug</label>
+            <input class="form-control" name="helloassoOrganizationSlug">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Form Type</label>
+            <input class="form-control" name="helloassoFormType" placeholder="shop">
+          </div>
+
+          <div class="mb-3">
+            <label class="form-label">Form Slug</label>
+            <input class="form-control" name="helloassoFormSlug">
+          </div>
+        <hr class="my-4" />
+        <h4>Purge des locations</h4>
+        <div class="d-flex gap-2 align-items-center">
+          <input class="form-control" style="max-width: 160px;" id="onekite-purge-year" placeholder="YYYY">
+          <button type="button" class="btn btn-outline-danger" id="onekite-purge">Purger</button>
+        </div>
+        <div class="form-text mt-2">Supprime définitivement toutes les locations (réservations) dont la date de début est dans l'année sélectionnée.</div>
+      </div>
+
+      <div class="tab-pane fade" id="onekite-tab-events" role="tabpanel">
+        <h4>Évènements (autre couleur)</h4>
+        <div class="form-text mb-3">Permet de créer des évènements horaires (début/fin) avec adresse (Leaflet) et notes.</div>
+
+        <div class="mb-3">
+          <label class="form-label">Groupes autorisés à créer des évènements (csv)</label>
+          <input class="form-control" name="specialCreatorGroups" placeholder="ex: staff,instructors">
+        </div>
+
+        <div class="mb-3">
+          <label class="form-label">Groupes autorisés à supprimer des évènements (csv)</label>
+          <input class="form-control" name="specialDeleterGroups" placeholder="Si vide: même liste que la création">
+        </div>
+
+        <hr class="my-4" />
+        <h4>Purge des évènements</h4>
+        <div class="d-flex gap-2 align-items-center">
+          <input class="form-control" style="max-width: 160px;" id="onekite-se-purge-year" placeholder="YYYY">
+          <button type="button" class="btn btn-outline-danger" id="onekite-se-purge">Purger</button>
+        </div>
+        <div class="form-text mt-2">Supprime définitivement tous les évènements dont la date de début est dans l'année sélectionnée.</div>
+      </div>
+
+      <div class="tab-pane fade" id="onekite-tab-pending" role="tabpanel">
+        <h4>Demandes en attente</h4>
+        <div id="onekite-pending" class="list-group"></div>
+      </div>
+
+      <div class="tab-pane fade" id="onekite-tab-debug" role="tabpanel">
+        <p class="text-muted">Teste la récupération du token et la liste du matériel (catalogue).</p>
+        <button type="button" class="btn btn-secondary me-2" id="onekite-debug-run">Tester le chargement du matériel</button>
+        <pre id="onekite-debug-output" class="mt-3 p-3 border rounded onekite-debug-output" style="max-height: 360px; overflow: auto;"></pre>
+      </div>
+
+      <div class="tab-pane fade" id="onekite-tab-accounting" role="tabpanel">
+        <h4>Comptabilisation des locations (payées)</h4>
+        <div class="d-flex flex-wrap gap-2 align-items-end mb-3">
+          <div>
+            <label class="form-label">Du</label>
+            <input class="form-control" type="date" id="onekite-acc-from" />
+          </div>
+          <div>
+            <label class="form-label">Au</label>
+            <input class="form-control" type="date" id="onekite-acc-to" />
+          </div>
+          <div>
+            <button type="button" class="btn btn-primary" id="onekite-acc-refresh">Rafraîchir</button>
+            <button type="button" class="btn btn-outline-secondary" id="onekite-acc-export">Exporter CSV</button>
+            <button type="button" class="btn btn-outline-danger" id="onekite-acc-purge">Purger la compta</button>
+          </div>
+        </div>
+
+        <h5>Résumé par matériel</h5>
+        <div class="table-responsive">
+          <table class="table table-sm" id="onekite-acc-summary">
+            <thead>
+              <tr><th>Matériel</th><th>Nb locations</th><th>Total (€)</th></tr>
+            </thead>
+            <tbody></tbody>
+          </table>
+        </div>
+
+        <h5 class="mt-4">Détails</h5>
+        <div class="table-responsive">
+          <table class="table table-sm" id="onekite-acc-rows">
+            <thead>
+              <tr><th>Date</th><th>Utilisateur</th><th>Matériel</th><th>Total (€)</th><th>RID</th></tr>
+            </thead>
+            <tbody></tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+    </form>
+  </div>
+</div>
+
+<script>
+  require(['admin/plugins/calendar-onekite'], function (mod) {
+    if (mod && mod.init) {
+      mod.init();
+    }
+  });
+</script>
+
+<!-- IMPORT admin/partials/settings/footer.tpl -->

package/templates/calendar-onekite.tpl

@@ -0,0 +1,51 @@
+<div class="container">
+  <div class="row">
+    <div class="col-12">
+      <h1>Calendrier</h1>
+      <div id="onekite-calendar" style="margin-top: 1rem;"></div>
+    </div>
+  </div>
+</div>
+
+<!--
+  FullCalendar
+  - Use CDN "latest" so NodeBB v4 stays simple to maintain.
+  - Use main.min.css (the global bundle does not ship index.global.min.css).
+-->
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fullcalendar@latest/main.min.css" />
+<script src="https://cdn.jsdelivr.net/npm/fullcalendar@latest/index.global.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@fullcalendar/core@latest/locales-all.global.min.js"></script>
+
+<!--
+  No inline require() here.
+  The plugin's forum script auto-initialises on the calendar page via ajaxify.
+-->
+
+
+<style>
+  /* Make the custom "Évènement" button distinct from view buttons */
+  .fc .fc-newSpecial-button {
+    background: #8e44ad;
+    border-color: #8e44ad;
+    color: #fff;
+  }
+  .fc .fc-newSpecial-button:hover {
+    filter: brightness(0.95);
+  }
+
+  /* Mobile tweaks for FullCalendar */
+  @media (max-width: 576px) {
+    #onekite-calendar { margin-top: .5rem !important; }
+    .fc .fc-toolbar { flex-wrap: wrap; gap: .25rem; }
+    .fc .fc-toolbar-title { font-size: 1.05rem; line-height: 1.2; }
+    .fc .fc-button { padding: .25rem .45rem; font-size: .75rem; }
+    .fc .fc-button .fc-icon { font-size: .9em; }
+    .fc .fc-daygrid-day-number { font-size: .75rem; padding: 2px; }
+    .fc .fc-col-header-cell-cushion { font-size: .75rem; padding: 4px 0; }
+    .fc .fc-event-title { font-size: .72rem; }
+    /* Avoid horizontal scroll */
+    .fc { overflow-x: hidden; }
+    .fc .fc-scrollgrid, .fc .fc-scrollgrid table { width: 100% !important; }
+  }
+</style>
+

package/templates/emails/calendar-onekite_approved.tpl

@@ -0,0 +1,40 @@
+<p>Bonjour {username},</p>
+<p>Votre réservation a été validée.</p>
+
+<!-- IF validatedBy -->
+<p><strong>Validée par :</strong> <a href="{validatedByUrl}">{validatedBy}</a></p>
+<!-- ENDIF validatedBy -->
+
+<p><strong>Matériel</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>
+
+<!-- IF pickupTime -->
+<p><strong>Heure de récupération :</strong> {pickupTime}</p>
+<!-- ENDIF pickupTime -->
+
+<!-- IF pickupAddress -->
+<p><strong>Adresse de récupération :</strong><br>{pickupAddress}</p>
+<!-- ENDIF pickupAddress -->
+
+<!-- IF mapUrl -->
+<p style="font-size: 12px; color: #666;">Voir sur la carte : <a href="{mapUrl}">OpenStreetMap</a></p>
+<!-- ENDIF mapUrl -->
+
+<!-- IF notes -->
+<p><strong>Notes :</strong><br>{notes}</p>
+<!-- ENDIF notes -->
+
+<!-- IF paymentUrl -->
+<p>
+  <a href="{paymentUrl}" style="display:inline-block;padding:12px 18px;border-radius:6px;text-decoration:none;border:1px solid #333;">
+    Payer maintenant
+  </a>
+</p>
+<p style="font-size: 12px; color: #666;">Si le bouton ne fonctionne pas, utilisez ce lien : <a href="{paymentUrl}">{paymentUrl}</a></p>
+<!-- ENDIF paymentUrl -->

package/templates/emails/calendar-onekite_expired.tpl

@@ -0,0 +1,11 @@
+<p>Bonjour {username},</p>
+<p>Votre demande de location de matériel a expiré (paiement non reçu à temps).</p>
+
+<p><strong>Matériel</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>

package/templates/emails/calendar-onekite_paid.tpl

@@ -0,0 +1,15 @@
+<p>Bonjour {username},</p>
+<p>Nous avons bien reçu votre paiement.</p>
+
+<p><strong>Matériel</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>
+
+<!-- IF paymentReceiptUrl -->
+<p><strong>Reçu :</strong> <a href="{paymentReceiptUrl}">{paymentReceiptUrl}</a></p>
+<!-- ENDIF paymentReceiptUrl -->

package/templates/emails/calendar-onekite_pending.tpl

@@ -0,0 +1,15 @@
+<p>Bonjour {username},</p>
+<p>Nouvelle demande de location de matériel.</p>
+
+<p><strong>Demandeur :</strong> {requester}</p>
+
+<p><strong>Matériel</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>
+
+<p><strong>Total estimé :</strong> {total} €</p>

package/templates/emails/calendar-onekite_refused.tpl

@@ -0,0 +1,15 @@
+<p>Bonjour {username},</p>
+<p>Votre demande de location de matériel a été refusée.</p>
+
+<p><strong>Matériel réservé</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>
+
+<!-- IF refusedReason -->
+<p><strong>Raison du refus</strong><br>{refusedReason}</p>
+<!-- ENDIF refusedReason -->

package/templates/emails/calendar-onekite_reminder.tpl

@@ -0,0 +1,20 @@
+<p>Bonjour {username},</p>
+<p>Rappel concernant votre location de matériel.</p>
+
+<p><strong>Matériel</strong></p>
+<ul>
+<!-- BEGIN itemNames -->
+  <li>{itemNames}</li>
+<!-- END itemNames -->
+</ul>
+
+<p>{dateRange}</p>
+
+<!-- IF paymentUrl -->
+<p>
+  <a href="{paymentUrl}" style="display:inline-block;padding:12px 18px;border-radius:6px;text-decoration:none;border:1px solid #333;">
+    Payer maintenant
+  </a>
+</p>
+<p style="font-size: 12px; color: #666;">Si le bouton ne fonctionne pas, utilisez ce lien : <a href="{paymentUrl}">{paymentUrl}</a></p>
+<!-- ENDIF paymentUrl -->