PostERG/xamxam
1
0
Fork 0
mirror of https://codeberg.org/PostERG/xamxam.git synced 2026-05-06 19:19:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

add form help blocks: DB table, admin editor, live rendering in partage form

Browse Source
This commit is contained in:
Pontoporeia
2026-04-29 21:08:09 +02:00
parent 0437ec8d15
commit 670a38f30d
7 changed files with 136 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
app/public/partage/index.php
View File

@@ -210,6 +210,10 @@ function renderShareLinkForm(string $slug, array $link): void
$shareOldFn = fn(string $key, string $default = '') => old($formData, $key, $default);
// No autofocus in the share form — identity function.
$shareWithAutofocusFn = fn(string $field, array $attrs = []) => $attrs;
// Load all form help blocks in one query.
$helpBlocks = Database::getInstance()->getAllFormHelpBlocks();
$helpFn = fn(string $key) => $helpBlocks[$key]['content'] ?? '';
?>
<!DOCTYPE html>
<html lang="fr">
@@ -243,9 +247,7 @@ function renderShareLinkForm(string $slug, array $link): void
<div class="flash-success" role="alert"><?= htmlspecialchars($flashSuccess) ?></div>
<?php endif; ?>
<!-- TODO: Add an introductory block here explaining the purpose of this form
to students: what xamxam is, what happens after submission, who can see
their work, and the general timeline before publication. -->
<?php $helpContent = $helpFn('partage_intro'); include APP_ROOT . '/templates/partials/form/form-help-block.php'; ?>
<p class="required-note"><span class="asterisk">*</span> Champs obligatoires</p>
<form action="/partage/<?= urlencode($slug) ?>/submit" method="post" enctype="multipart/form-data" class="admin-form">
@@ -253,13 +255,15 @@ function renderShareLinkForm(string $slug, array $link): void
<!-- ═══════════════════ Informations du TFE ═══════════════════ -->
<?php
// TODO: Add a student-facing explanation block for each fieldset below,
// describing what information is expected and why it is collected.
$oldFn = $shareOldFn;
$withAutofocusFn = $shareWithAutofocusFn;
// TODO: Add a contextual note for the synopsis field explaining the
// expected length, tone, and whether it will be publicly visible.
$synopsisExtra = '';
// Inject fieldset intro note and synopsis-specific note via the partial's hook.
ob_start();
$helpContent = $helpFn('fieldset_synopsis');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
$synopsisExtra = ob_get_clean();
$helpContent = $helpFn('fieldset_tfe_info');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
include APP_ROOT . '/templates/partials/form/fieldset-tfe-info.php';
?>
@@ -279,9 +283,8 @@ function renderShareLinkForm(string $slug, array $link): void
];
}
}
// TODO: Add a note explaining the jury composition to students:
// who counts as external, what role each member plays, and
// whether this information will be publicly visible.
$helpContent = $helpFn('fieldset_jury');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
require APP_ROOT . '/templates/partials/form/jury-fieldset.php';
?>
@@ -289,17 +292,15 @@ function renderShareLinkForm(string $slug, array $link): void
<?php
$oldFn = $shareOldFn;
$withAutofocusFn = $shareWithAutofocusFn;
// TODO: Add a note for the academic context fieldset clarifying what
// orientation/AP/finality values correspond to, and where students
// can look them up if unsure.
$helpContent = $helpFn('fieldset_academic');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
include APP_ROOT . '/templates/partials/form/fieldset-academic.php';
?>
<!-- ═══════════════════ Fichiers ═══════════════════ -->
<?php
// TODO: Add a note before the files fieldset explaining accepted formats,
// max sizes, what a cover image should look like, and that files
// will only be accessible according to the chosen access level.
$helpContent = $helpFn('fieldset_files');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
include APP_ROOT . '/templates/partials/form/fieldset-files.php';
?>
@@ -309,10 +310,8 @@ function renderShareLinkForm(string $slug, array $link): void
$withAutofocusFn = $shareWithAutofocusFn;
$showDescription = false;
$defaultAccessTypeId = 2;
// TODO: Add an explanation of each access level (Libre / Interne / Interdit)
// close to the "Visibilité / Accès" select so students understand
// the implications before choosing. Cross-reference the licence
// fieldset below.
$helpContent = $helpFn('fieldset_access');
include APP_ROOT . '/templates/partials/form/form-help-block.php';
include APP_ROOT . '/templates/partials/form/fieldset-metadata.php';
?>
@@ -322,8 +321,7 @@ function renderShareLinkForm(string $slug, array $link): void
<!-- ═══════════════════ E-mail de confirmation ═══════════ -->
<fieldset>
<legend>E-mail de confirmation</legend>
<!-- TODO: Add a sentence explaining that the confirmation email is only
used to send the submission recap and will not be shared publicly. -->
<?php $helpContent = $helpFn('fieldset_email'); include APP_ROOT . '/templates/partials/form/form-help-block.php'; ?>
<?php
$name = 'confirmation_email';
$label = 'Adresse e-mail * :';