Latest posts
Latest topics
Tutorial Un thème que l'on règle : « Aube » 2.0
Niveau intermédiaire · environ 1 heure · NeoFrag Reborn 1.2.50 ou plus récent
Ce tutoriel reprend le thème « Aube » du niveau débutant. À la fin :
- l'administrateur choisit ses couleurs — l'accent, le fond, le texte — sur une page « Personnaliser », avec un aperçu en direct sur une vraie page du site, et le site refuse une couleur illisible ;
- toute la palette se déduit de ces trois couleurs : surfaces, bordures, textes discrets, couleur posée sur l'accent ;
- le visiteur passe en mode sombre d'un clic, et le site s'en souvient.



Il te faut le thème de Mon premier thème (ou son archive, aube-1.0.0.zip), installé et activé sur un site
d'essai. L'archive de ce tutoriel, aube-2.0.0.zip, est jointe à ce sujet.
Étape 1 — La page « Personnaliser »
Un thème qui a un fichier controllers/admin.php reçoit, dans Thèmes & addons, une entrée Personnaliser dans
le menu de sa carte. Le site fait presque tout :
aube/controllers/admin.php
<?php
declare(strict_types=1);
namespace NF\Themes\Aube\Controllers;
use NF\NeoFrag\Loadables\Controller;
class Admin extends Controller
{
/** Les couleurs d'origine d'Aube : l'accent, le fond et le texte de sa palette claire. */
const COULEURS = ['theme_color' => '#c2410c', 'background_color' => '#f6f3ee', 'text_color' => '#2a2622'];
/** La page « Personnaliser » : trois couleurs, refusées si elles ne se lisent pas, et l'aperçu en direct. */
public function index()
{
return nf_reglage_couleurs($this, $this->__caller, self::COULEURS);
}
}
nf_reglage_couleurs() construit la page : trois sélecteurs de couleur, l'aperçu en direct sur une vraie page du
site, et la mesure des contrastes. À l'enregistrement, elle refuse une couleur de texte qui ne se lit pas sur le
fond (moins de 4,5 pour 1) ou un accent qui ne s'en détache pas (moins de 3 pour 1), avec un message qui dit pourquoi.
Les couleurs acceptées sont gardées dans les réglages du site, sous aube_theme_color, aube_background_color et
aube_text_color.
COULEURS donne les couleurs d'origine : la page les rappelle au-dessus des sélecteurs, et la feuille les prend tant que rien n'est réglé.
Étape 2 — Une feuille de style qui lit les réglages
Une feuille de thème peut être un gabarit PHP : le site l'exécute avant de l'envoyer. Aube y lit les trois couleurs, et en tire tout le reste :
aube/css/style.css
<?php
// La feuille d'Aube est un gabarit PHP : l'accent, le fond et le texte viennent de la page « Personnaliser » du thème,
// et toutes les autres teintes de la palette claire en sont tirées. Le mode sombre garde sa propre palette.
$accent = $this->config->aube_theme_color ?: '#c2410c';
$fond = $this->config->aube_background_color ?: '#f6f3ee';
$texte = $this->config->aube_text_color ?: '#2a2622';
// Ce qui est posé sur la page s'éclaircit : beaucoup sur un fond clair, à peine sur un fond sombre.
$eclat = couleur_luminance($fond) > 0.4 ? 70 : 6;
?>
/* La palette claire, celle qu'on règle : toutes les couleurs que les modules et les widgets emploient. */
:root {
--nf-bg: <?php echo $fond ?>;
--nf-bg-elevated: color-mix(in srgb, #ffffff <?php echo $eclat ?>%, <?php echo $fond ?>);
--nf-surface: color-mix(in srgb, #ffffff <?php echo $eclat ?>%, <?php echo $fond ?>);
--nf-surface-2: color-mix(in srgb, <?php echo $texte ?> 5%, <?php echo $fond ?>);
--nf-surface-3: color-mix(in srgb, <?php echo $texte ?> 10%, <?php echo $fond ?>);
--nf-hover: color-mix(in srgb, <?php echo $texte ?> 7%, <?php echo $fond ?>);
--nf-border: color-mix(in srgb, <?php echo $texte ?> 14%, <?php echo $fond ?>);
--nf-border-strong: color-mix(in srgb, <?php echo $texte ?> 28%, <?php echo $fond ?>);
--nf-text: <?php echo $texte ?>;
--nf-text-strong: color-mix(in srgb, <?php echo $texte ?> 75%, #000000);
--nf-text-soft: color-mix(in srgb, <?php echo $texte ?> 85%, <?php echo $fond ?>);
--nf-text-muted: color-mix(in srgb, <?php echo $texte ?> 75%, <?php echo $fond ?>);
--nf-muted: color-mix(in srgb, <?php echo $texte ?> 75%, <?php echo $fond ?>);
--nf-muted-2: color-mix(in srgb, <?php echo $texte ?> 68%, <?php echo $fond ?>);
--nf-accent: <?php echo $accent ?>;
--nf-accent-soft: color-mix(in srgb, <?php echo $accent ?> 12%, transparent);
--nf-accent-strong: color-mix(in srgb, <?php echo $accent ?> 80%, #000000);
--nf-accent-text: color-mix(in srgb, <?php echo $accent ?> 80%, #000000);
--nf-on-accent: <?php echo couleur_lisible_sur($accent) ?>;
--nf-success: #15803d;
--nf-info: #0369a1;
--nf-warning: #b45309;
--nf-danger: #b91c1c;
--nf-danger-soft: rgba(185, 28, 28, .1);
--nf-radius: 12px;
--nf-radius-sm: 8px;
/* Celles que le socle commun des thèmes demande en plus. */
--nf-radius-xs: 3px;
--nf-shadow-sm: 0 1px 2px rgba(42, 38, 34, .08);
--nf-shadow: 0 6px 18px -8px rgba(42, 38, 34, .2);
--nf-shadow-md: 0 12px 30px -12px rgba(42, 38, 34, .28);
--nf-success-soft: rgba(21, 128, 61, .1);
--nf-warning-soft: rgba(180, 83, 9, .1);
--nf-info-soft: rgba(3, 105, 161, .1);
--nf-link: var(--nf-accent-text);
--nf-link-hover: var(--nf-accent);
--nf-font-mono: ui-monospace, "Cascadia Mono", Consolas, monospace;
/* Les polices : celle du texte, et celle des titres. */
--nf-font: system-ui, "Segoe UI", Roboto, sans-serif;
--nf-font-display: "Iowan Old Style", Georgia, serif;
}
/* La palette sombre : la même liste, d'autres valeurs. Seule la palette claire se règle. */
[data-theme="dark"] {
--nf-bg: #1c1917;
--nf-bg-elevated: #26221f;
--nf-surface: #26221f;
--nf-surface-2: #2f2a26;
--nf-surface-3: #3a3430;
--nf-hover: #332e2a;
--nf-border: #3d3732;
--nf-border-strong: #57504a;
--nf-text: #e7e5e4;
--nf-text-strong: #fafaf9;
--nf-text-soft: #d6d3d1;
--nf-text-muted: #a8a29e;
--nf-muted: #a8a29e;
--nf-muted-2: #a19a95;
--nf-accent: #fb923c;
--nf-accent-soft: rgba(251, 146, 60, .14);
--nf-accent-strong: #fdba74;
--nf-accent-text: #fdba74;
--nf-on-accent: <?php echo couleur_lisible_sur('#fb923c') ?>;
--nf-success: #4ade80;
--nf-info: #38bdf8;
--nf-warning: #fbbf24;
--nf-danger: #f87171;
--nf-danger-soft: rgba(248, 113, 113, .16);
--nf-shadow-sm: 0 1px 2px rgba(0, 0, 0, .4);
--nf-shadow: 0 6px 18px -8px rgba(0, 0, 0, .6);
--nf-shadow-md: 0 12px 30px -12px rgba(0, 0, 0, .7);
--nf-success-soft: rgba(74, 222, 128, .12);
--nf-warning-soft: rgba(251, 191, 36, .12);
--nf-info-soft: rgba(56, 189, 248, .12);
}
body {
background: var(--nf-bg);
color: var(--nf-text);
font-family: var(--nf-font);
}
/* L'en-tête : le nom du site, le menu, le compte. */
.au-tete {
background: var(--nf-bg-elevated);
border-bottom: 1px solid var(--nf-border);
box-shadow: var(--nf-shadow-sm);
}
.au-tete-in {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 12px 24px;
padding-block: 14px;
}
.au-nom {
font-family: var(--nf-font-display);
font-size: 1.4rem;
font-weight: 700;
color: var(--nf-text-strong);
text-decoration: none;
}
.au-nom::before {
content: "";
display: inline-block;
width: .7em;
height: .7em;
margin-right: .45em;
border-radius: 50%;
background: var(--nf-accent);
}
.au-menu {
flex: 1 1 auto;
min-width: 0;
}
/* Le menu est un widget : on efface la grille qui l'entoure, et on aligne ses liens. */
.au-menu .row {
--bs-gutter-x: 0;
margin: 0;
}
.au-menu .row > * > .widget {
margin: 0;
}
.au-menu .nav {
gap: 4px;
flex-wrap: wrap;
}
.au-menu .nav-link {
padding: 6px 12px;
border-radius: var(--nf-radius-sm);
color: var(--nf-text-soft);
font-weight: 600;
}
.au-menu .nav-link:hover,
.au-menu .nav-link.active {
color: var(--nf-accent-strong);
background: var(--nf-accent-soft);
}
.au-compte {
display: flex;
align-items: center;
gap: 8px;
}
/* Le bouton clair/sombre : une icône ronde, qui montre la lune en clair et le soleil en sombre. */
.au-mode {
width: 34px;
height: 34px;
display: inline-flex;
align-items: center;
justify-content: center;
border: 1px solid var(--nf-border);
border-radius: 50%;
background: transparent;
color: var(--nf-text-soft);
}
.au-mode:hover {
color: var(--nf-accent-strong);
border-color: var(--nf-accent);
}
.au-mode .fa-sun,
[data-theme="dark"] .au-mode .fa-moon {
display: none;
}
[data-theme="dark"] .au-mode .fa-sun {
display: inline;
}
/* Le contenu. */
.au-page {
padding-block: 28px;
}
.au-zone + .au-zone {
margin-top: 24px;
}
/* Le pied de page. */
.au-pied {
border-top: 1px solid var(--nf-border);
padding-block: 24px;
color: var(--nf-text-muted);
font-size: .9rem;
}
.au-pied-outils {
display: flex;
flex-wrap: wrap;
gap: 8px;
}
Ce qui compte :
- Les trois couleurs, lues dans
$this->config, avec les couleurs d'origine si rien n'est réglé. color-mix()mélange deux couleurs en CSS :color-mix(in srgb, <texte> 14%, <fond>)donne une bordure qui est un peu de texte dans beaucoup de fond. Elle reste juste quelles que soient les couleurs choisies.couleur_lisible_sur($accent), une aide du site : le blanc ou le presque-noir, celui qui se lit le mieux sur l'accent. Un accent jaune reçoit un texte foncé, un accent bleu un texte blanc, sans que l'administrateur ait à y penser.$eclat: sur un fond clair, les cadres sont nettement plus clairs que la page ; sur un fond sombre, à peine.couleur_luminance()dit si le fond est clair.[data-theme="dark"]redéfinit toutes les couleurs pour le mode sombre. Seule la palette claire se règle : la sombre est fixée, pensée pour être lisible.- Le reste est celui de la 1.0, plus le bouton clair/sombre (
.au-mode) : il montre la lune en clair, le soleil en sombre.
Pendant que l'administrateur essaie des couleurs, l'aperçu redemande cette feuille avec les couleurs non enregistrées : c'est le même gabarit qui les reçoit. Il n'y a rien à écrire pour cela.
Étape 3 — Le mode sombre
Le mode doit être posé avant que la page s'affiche : sinon, un visiteur en mode sombre voit un éclair blanc à chaque page. Le squelette commence donc par un petit script :
aube/views/body.tpl.php
<script>
// Le mode du visiteur, posé avant que la page ne s'affiche : son choix s'il en a fait un, sinon celui de son système.
try {
var mode = localStorage.getItem('nf-aube-theme') || (matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
document.documentElement.setAttribute('data-theme', mode);
document.documentElement.setAttribute('data-bs-theme', mode);
} catch (e) {}
</script>
<header class="au-tete">
<div class="container au-tete-in">
<a class="au-nom" href="<?php echo url('') ?>"><?php echo nf_texte($this->config->nf_name) ?></a>
<?php if ($menu = $this->output->region('navigation')): ?>
<nav class="au-menu" aria-label="<?php echo $this->lang('Navigation') ?>"><?php echo $menu ?></nav>
<?php endif ?>
<div class="au-compte">
<button class="au-mode" type="button" data-libelle-sombre="<?php echo $this->lang('Mode sombre') ?>" data-libelle-clair="<?php echo $this->lang('Mode clair') ?>" aria-label="<?php echo $this->lang('Mode sombre') ?>">
<i class="fas fa-moon"></i><i class="fas fa-sun"></i>
</button>
<?php if ($this->user()): ?>
<a class="btn btn-outline-secondary btn-sm" href="<?php echo url('user') ?>"><i class="fas fa-user"></i> <?php echo nf_texte($this->user->username) ?></a>
<?php if ($this->access->effective_admin()): ?>
<a class="btn btn-primary btn-sm" href="<?php echo url('admin') ?>"><?php echo $this->lang('Administration') ?></a>
<?php endif ?>
<?php else: ?>
<a class="btn btn-primary btn-sm" href="<?php echo url('user/login') ?>"><?php echo $this->lang('Connexion') ?></a>
<?php endif ?>
</div>
</div>
</header>
<main class="container au-page">
<?php if ($zone = $this->output->region('before_content')): ?>
<section class="au-zone"><?php echo $zone ?></section>
<?php endif ?>
<?php if ($zone = $this->output->region('content')): ?>
<section class="au-zone"><?php echo $zone ?></section>
<?php endif ?>
</main>
<footer class="au-pied">
<div class="container">
<?php if ($zone = $this->output->region('footer')): ?>
<div class="au-zone"><?php echo $zone ?></div>
<?php endif ?>
<p class="au-pied-ligne">
<?php echo nf_texte($this->config->nf_name) ?>
· <?php echo $this->lang('Propulsé par') ?> <a href="https://neofrag-reborn.xyz">NeoFrag Reborn</a>
· <?php echo nf_liens_legaux() ?>
</p>
<div class="au-pied-outils">
<?php echo nf_selecteur_theme() ?>
<?php echo nf_selecteur_langue() ?>
</div>
</div>
</footer>
- Le script lit le choix du visiteur dans son navigateur (
localStorage, sousnf-aube-theme: chaque thème a sa propre clé), sinon la préférence de son système, et posedata-themesur la page.data-bs-themefait suivre les composants de Bootstrap. - Un
<script>écrit dans une vue reçoit tout seul le jeton qu'exige la politique de sécurité du site : rien à ajouter. - Le bouton porte ses deux étiquettes (
data-libelle-sombre,data-libelle-clair), traduites : le script choisit la bonne.
Le bouton lui-même vit dans js/theme.js, chargé par __init() :
aube/js/theme.js
/**
* Aube — le bouton clair/sombre. Le choix du visiteur est gardé dans son navigateur, sous la clé `nf-aube-theme` :
* chaque thème a la sienne. Le mode est posé dès le début de la page par le squelette (body.tpl.php) ; ce fichier ne
* fait que basculer.
*/
(function () {
'use strict';
var CLE = 'nf-aube-theme';
function poser(mode) {
document.documentElement.setAttribute('data-theme', mode);
document.documentElement.setAttribute('data-bs-theme', mode);
document.querySelectorAll('.au-mode').forEach(function (bouton) {
// L'étiquette dit ce que fait le bouton : passer à l'autre mode.
bouton.setAttribute('aria-label', mode === 'dark' ? bouton.dataset.libelleClair : bouton.dataset.libelleSombre);
bouton.setAttribute('title', bouton.getAttribute('aria-label'));
});
}
NF.ready(function () {
poser(document.documentElement.getAttribute('data-theme') === 'dark' ? 'dark' : 'light');
document.querySelectorAll('.au-mode').forEach(function (bouton) {
bouton.addEventListener('click', function () {
var mode = document.documentElement.getAttribute('data-theme') === 'dark' ? 'light' : 'dark';
poser(mode);
try {
localStorage.setItem(CLE, mode);
} catch (e) {
// Navigation privée, stockage refusé : le mode vaut pour la page, sans être retenu.
}
});
});
});
})();
NF.ready()attend que la page soit prête — c'est l'outil du site, à la place de jQuery, qui n'est plus chargé.localStoragepeut être refusé (navigation privée) : letrygarde le mode pour la page sans le retenir.
Et dans aube.php, une ligne de plus dans __init() — ->js('theme') — et la version 2.0.0 :
aube/aube.php
<?php
declare(strict_types=1);
/**
* Aube — le thème des tutoriels « Mon premier thème » (débutant) et « Un thème que l'on règle » (intermédiaire). LGPLv3.
*/
namespace NF\Themes\Aube;
use NF\NeoFrag\Addons\Theme;
class Aube extends Theme
{
protected function __info()
{
return [
'title' => 'Aube',
'description' => $this->lang('Un thème clair et chaleureux : un en-tête avec le menu, le contenu au centre, un pied de page sobre.'),
'link' => 'https://neofrag-reborn.xyz',
'author' => 'NeoFrag Reborn',
'license' => 'LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>',
'version' => '2.0.0',
'depends' => [
'neofrag' => '1.2.50'
],
'core' => FALSE,
'presets' => [],
'requires' => [],
'zones' => ['Navigation', 'Avant-contenu', 'Contenu', 'Pied de page'],
'regions' => [
'navigation' => 'Navigation',
'before_content' => 'Avant-contenu',
'content' => 'Contenu',
'footer' => 'Pied de page'
]
];
}
public function __init()
{
$this ->css('bootstrap.min')
->css('nf-bs5-bridge')
->css('icons/fontawesome.min')
->css('nf-socle-themes')
->css('style')
->css('nf-apres-theme')
->js('bootstrap.bundle.min')
->js('modal')
->js('notify')
->js('confirm')
->js('theme');
}
public function styles_row()
{
return $this->view('live_editor/row');
}
public function styles_widget()
{
return $this->view('live_editor/widget');
}
public function install($dispositions = [])
{
$dispositions = $this->array();
// Toutes les pages : le menu dans l'en-tête… Ses titres s'écrivent en français : c'est le widget Navigation
// qui les traduit, à l'affichage, dans la langue du visiteur.
$dispositions->set('*', 'Navigation', $this->array([
$this->row(
$this->col(
$this->widget($this->db->insert('nf_widgets', [
'widget' => 'navigation',
'type' => 'index',
'settings' => json_encode([
'links' => [
['title' => utf8_htmlentities('Accueil'), 'url' => ''],
['title' => utf8_htmlentities('Actualités'), 'url' => 'news'],
['title' => utf8_htmlentities('Forum'), 'url' => 'forum'],
['title' => utf8_htmlentities('Membres'), 'url' => 'members'],
['title' => utf8_htmlentities('Contact'), 'url' => 'contact']
]
])
]))
)
)
]));
// … et le contenu de la page, avec l'espace membre à côté.
$dispositions->set('*', 'Contenu', $this->array([
$this->row(
$this->col(
$this->widget($this->db->insert('nf_widgets', [
'widget' => 'module',
'type' => 'index'
]))
)->size('col-12 col-lg-8'),
$this->col(
$this->widget($this->db->insert('nf_widgets', [
'widget' => 'user',
'type' => 'index'
]))->style('panel-header')
)->size('col-12 col-lg-4')
)->style('row-default')
]));
return parent::install($dispositions);
}
}
Étape 4 — Les traductions
Deux textes de plus, « Mode sombre » et « Mode clair », dans les six fichiers de langs/. L'archive les porte.
Installer la mise à jour
- Compresse le dossier
aube, puis Thèmes & addons → Ajouter. Le site répond « Le thème Aube a été mis à jour ». Ta mise en page n'a pas bougé : une mise à jour ne rejoue jamaisinstall(). - Sur la carte d'Aube, ouvre le menu et choisis Personnaliser. Essaie des couleurs : l'aperçu suit. Un accent trop pâle est refusé à l'enregistrement, avec son contraste mesuré.
- Sur le site, le bouton rond de l'en-tête bascule entre clair et sombre.
Si ça ne marche pas
| Ce que tu vois | Ce que ça veut dire |
|---|---|
| Pas d'entrée Personnaliser sur la carte | controllers/admin.php manque, ou sa classe n'est pas NF\Themes\Aube\Controllers\Admin. |
| La page s'affiche sans couleurs après la mise à jour | Une erreur dans le PHP de style.css : le journal du site la note (Monitoring). |
| Le mode sombre clignote en blanc au chargement | Le script du début de body.tpl.php manque : sans lui, le mode n'est posé qu'à la fin du chargement. |
| Le bouton ne fait rien | ->js('theme') manque dans __init(), ou le fichier n'est pas dans js/. |
| « Cette couleur ne se détache pas assez du fond du thème » | C'est voulu : choisis-la plus foncée ou plus claire, ou change le fond. |
Pour aller plus loin
- Rends la palette sombre réglable à son tour : trois couleurs de plus, et un second appel à
couleur_lisible_sur(). - Le tutoriel expert termine Aube : un en-tête qui reste en haut quand on fait défiler, un menu replié sur téléphone, une police servie par le site, une migration de thème qui pose une nouvelle mise en page chez ceux qui ont déjà le thème, et sa vignette.

Forum activity
no visitor
Statistics
- 72 topics created
- 0 message posted
- 63 announcements
- 1 participant