Últimas publicaciones
Tutorial Un module et sa base de données : « Astuces » 2.0
Niveau intermédiaire · environ 1 h 30 · NeoFrag Reborn 1.2.50 ou plus récent
Au niveau débutant, les astuces étaient écrites dans le code : pour en ajouter une, il fallait modifier un fichier et renvoyer l'archive. Ce tutoriel les fait passer dans la base de données, et donne au module une page d'administration pour les écrire, les modifier, les cacher ou les supprimer. Il apporte aussi un widget, « Astuce du jour », livré dans la même archive.




Il te faut le module de Mon premier module (ou son archive, astuces-1.0.0.zip), installé sur un site d'essai :
on va le mettre à jour, et ses quatre astuces passeront dans la base. L'archive de ce tutoriel,
astuces-2.0.0.zip, est jointe à ce sujet.
Ce qui change dans le dossier
astuces-2.0.0/ le dossier de l'archive : deux addons côte à côte
├── modules/
│ └── astuces/
│ ├── astuces.php la version 2.0.0, et ses adresses d'administration
│ ├── install/
│ │ ├── install.sql la table des astuces
│ │ ├── uninstall.sql son effacement, à la désinstallation
│ │ └── migrations/
│ │ └── 2026_10_15_astuces_du_code.up.sql les astuces de la 1.0, versées dans la table
│ ├── controllers/
│ │ ├── checker.php les pages publiques lisent la table
│ │ ├── index.php
│ │ ├── admin_checker.php nouveau : vérifie les adresses de l'administration
│ │ └── admin.php nouveau : la liste et le formulaire
│ └── views/, css/, langs/, images/
└── widgets/
└── astuces/ le widget « Astuce du jour »
Quand une archive porte plusieurs addons, chacun va dans le dossier de son type : modules/, widgets/,
themes/. L'installeur installe les modules d'abord, puis les widgets : le widget trouve ainsi son module déjà en
place.
Étape 1 — La table
Un module crée ses tables dans install/install.sql :
astuces/install/install.sql
-- La table du module Astuces. Ce fichier est joué à l'installation, et de nouveau à chaque mise à jour :
-- « IF NOT EXISTS » ne crée que ce qui manque, et ne touche jamais à une table déjà là.
CREATE TABLE IF NOT EXISTS `nf_astuces` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`title` varchar(150) NOT NULL,
`content` text NOT NULL,
`published` tinyint(1) NOT NULL DEFAULT 1,
`sort_order` int(11) NOT NULL DEFAULT 0,
`created_at` timestamp NOT NULL DEFAULT current_timestamp(),
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
id: le numéro de l'astuce, attribué par la base.title,content: son titre et son texte.published: 1 si elle est publiée, 0 si c'est un brouillon que les visiteurs ne voient pas.sort_order: l'ordre dans la liste, réglé dans l'administration.created_at: la date d'écriture, posée par la base.
Ce fichier est joué à l'installation et à chaque mise à jour. CREATE TABLE IF NOT EXISTS ne crée que ce qui
manque : une table déjà là, avec ses astuces, n'est jamais touchée.
Le fichier inverse, install/uninstall.sql, est joué quand on désinstalle le module :
astuces/install/uninstall.sql
-- Désinstaller le module efface ses astuces.
DROP TABLE IF EXISTS `nf_astuces`;
Étape 2 — Reprendre les astuces de la 1.0 : une migration
Les quatre astuces du débutant vivaient dans le code. Pour que les sites qui ont la 1.0 les retrouvent dans la base, le module apporte une migration :
astuces/install/migrations/2026_10_15_astuces_du_code.up.sql
-- Les quatre astuces que la version 1.0 écrivait dans son code passent dans la table. Cette migration ne joue
-- qu'à la MISE À JOUR depuis la 1.0 : une installation neuve la marque comme faite sans la jouer, et commence vide.
INSERT INTO `nf_astuces` (`title`, `content`, `sort_order`) VALUES
('Complète ton profil', 'Un avatar et quelques mots sur toi : les autres membres savent à qui ils parlent.', 1),
('Suis les sujets qui t''intéressent', 'Suivre un sujet du forum te prévient de chaque nouvelle réponse.', 2),
('Change la langue du site', 'Le sélecteur du pied de page affiche le site dans ta langue, pour toi seul.', 3),
('Choisis ce que ton profil montre', 'Dans ton espace membre, tu décides de ce que les autres voient de toi, comme ton âge ou ta présence en ligne.', 4);
- Son nom commence par une date (
AAAA_MM_JJ_) : les migrations d'un module se jouent dans cet ordre. - Elle ne se joue qu'une fois, et seulement à une mise à jour : le site retient celles qu'il a jouées. Sur une installation neuve de la 2.0, elle est marquée comme faite sans être jouée — la table y commence vide, et c'est voulu : ces quatre astuces n'appartiennent qu'aux sites qui avaient la 1.0.
- En SQL, une apostrophe dans un texte s'écrit deux fois :
t''intéressent.
La règle : une nouvelle table va dans install.sql ; une évolution d'une table ou de données déjà livrées
va dans une migration.
Étape 3 — Les adresses de l'administration
astuces/astuces.php
<?php
declare(strict_types=1);
/**
* Astuces — le module des tutoriels « Mon premier module » (débutant) et « Un module et sa base de données »
* (intermédiaire). LGPLv3.
*/
namespace NF\Modules\Astuces;
use NF\NeoFrag\Addons\Module;
class Astuces extends Module
{
protected function __info()
{
return [
'title' => $this->lang('Astuces'),
'description' => $this->lang('Quelques astuces pour bien démarrer sur le site, chacune sur sa page.'),
'icon' => 'fas fa-lightbulb',
'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' => [],
'admin' => TRUE,
'routes' => [
'' => 'index',
'{id}/{url_title}' => '_astuce',
'admin' => 'index',
'admin/ajouter' => '_ajouter',
'admin/{id}/{url_title}' => '_modifier',
'admin/supprimer/{id}/{url_title}' => '_supprimer'
]
];
}
}
'admin' => TRUE donne au module une entrée dans l'administration, à l'adresse /admin/astuces. Les routes qui
commencent par admin sont servies par controllers/admin.php, après controllers/admin_checker.php ; les autres
par index.php, après checker.php, comme au débutant. Le cœur réserve ces pages aux administrateurs.
La méthode astuces() du débutant a disparu : la liste vient maintenant de la table.
Étape 4 — Les pages publiques lisent la table
astuces/controllers/checker.php
<?php
declare(strict_types=1);
namespace NF\Modules\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controllers\Module_Checker;
class Checker extends Module_Checker
{
public function index()
{
return [$this->_publiees()];
}
public function _astuce($id, $url_title)
{
$publiees = $this->_publiees();
foreach ($publiees as $rang => $astuce)
{
if ((int) $astuce['id'] === (int) $id)
{
// Une adresse dont le titre n'est pas le bon mène à la bonne adresse.
nf_bon_titre((string) $url_title, (string) $astuce['title'], 'astuces/'.(int) $id);
return [$astuce, $rang + 1, count($publiees)];
}
}
// Introuvable, ou pas encore publiée : le site répond « page introuvable ».
}
/** Les astuces publiées, dans l'ordre choisi dans l'administration. */
private function _publiees(): array
{
return $this->db->select('id', 'title', 'content')
->from('nf_astuces')
->where('published', 1)
->order_by('sort_order ASC, id ASC')
->get();
}
}
$this->db->select(…)->from('nf_astuces')->where('published', 1)->order_by(…)->get(): une requête écrite avec le constructeur de requêtes du site.get()rend une liste de lignes ;row()en rend une seule.- Une astuce non publiée n'est pas dans la liste : son adresse répond « page introuvable », même pour qui la devine.
- Le checker calcule aussi la place de l'astuce parmi les publiées, pour « Astuce 3 sur 5 ».
astuces/controllers/index.php
<?php
declare(strict_types=1);
namespace NF\Modules\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controllers\Module as Controller_Module;
class Index extends Controller_Module
{
public function index($astuces)
{
$this ->title($this->lang('Astuces'))
->icon('fas fa-lightbulb')
->breadcrumb();
return $this->css('astuces')
->panel()
->heading()
->body($this->view('index', [
'astuces' => $astuces
]));
}
public function _astuce($astuce, $numero, $total)
{
// Le titre vient de la base : il n'a pas de traduction, on le dit au site pour qu'il n'en cherche pas.
$titre = $this->no_translate($astuce['title']);
$this ->title($titre)
->icon('fas fa-lightbulb')
->breadcrumb($this->lang('Astuces'), url('astuces'))
->breadcrumb();
return $this->css('astuces')
->panel()
->heading($titre, 'fas fa-lightbulb')
->body($this->view('astuce', [
'astuce' => $astuce,
'numero' => $numero,
'total' => $total
]));
}
}
$this->no_translate(…) : le titre vient de la base, il n'a pas de traduction. Sans ce mot, le site le chercherait
dans les fichiers de langue, et noterait au journal une traduction manquante à chaque visite dans une autre langue.
Les vues changent peu : une liste vide a son message, et le texte de l'astuce garde ses retours à la ligne
(nl2br()).
astuces/views/index.tpl.php
<?php if (!$astuces): ?>
<p class="astuces-vide"><?php echo $this->lang('Aucune astuce pour le moment.') ?></p>
<?php else: ?>
<ol class="astuces">
<?php foreach ($astuces as $astuce): ?>
<li>
<a href="<?php echo url('astuces/'.$astuce['id'].'/'.url_title($astuce['title'])) ?>"><?php echo nf_texte($astuce['title']) ?></a>
</li>
<?php endforeach ?>
</ol>
<?php endif ?>
astuces/views/astuce.tpl.php
<p class="astuces-numero"><?php echo $this->lang('Astuce %d sur %d', $numero, $total) ?></p>
<p class="astuces-texte"><?php echo nl2br(nf_texte($astuce['content'])) ?></p>
<a class="btn btn-outline-secondary btn-sm" href="<?php echo url('astuces') ?>">
<i class="fas fa-arrow-left"></i> <?php echo $this->lang('Toutes les astuces') ?>
</a>
Étape 5 — L'administration
L'admin_checker vérifie les adresses de l'administration, comme le checker le fait pour les pages publiques :
astuces/controllers/admin_checker.php
<?php
declare(strict_types=1);
namespace NF\Modules\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controllers\Module_Checker;
class Admin_Checker extends Module_Checker
{
public function index()
{
return [$this->db ->select('id', 'title', 'published')
->from('nf_astuces')
->order_by('sort_order ASC, id ASC')
->get()];
}
public function _ajouter()
{
// Rien à charger, mais un tableau VIDE vaudrait « rien » : le site répondrait « page introuvable ».
return [NULL];
}
public function _modifier($id, $url_title)
{
return $this->_astuce($id);
}
public function _supprimer($id, $url_title)
{
return $this->_astuce($id);
}
/** L'astuce demandée, ou rien : « page introuvable ». */
private function _astuce($id): ?array
{
$astuce = $this->db->from('nf_astuces')->where('id', (int) $id)->row();
return $astuce ? [$astuce] : NULL;
}
}
Pour « Nouvelle astuce », il n'y a rien à charger. Mais un checker qui rend un tableau vide dit « rien trouvé »,
et le site répondrait « page introuvable » : il rend donc [NULL].
Le contrôleur de l'administration :
astuces/controllers/admin.php
<?php
declare(strict_types=1);
namespace NF\Modules\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controllers\Module as Controller_Module;
class Admin extends Controller_Module
{
/** La liste : une ligne par astuce, son état, et ses deux boutons. */
public function index($astuces)
{
$this->title($this->lang('Astuces'))->icon('fas fa-lightbulb');
if (!$astuces)
{
$corps = $this->admin_empty('fas fa-lightbulb', $this->lang('Aucune astuce.'), $this->lang('Écris la première : elle paraîtra sur la page des astuces.'));
}
else
{
$corps = '<table class="table table-hover mb-0"><thead><tr>'
.'<th>'.$this->lang('Titre').'</th><th>'.$this->lang('État').'</th><th></th>'
.'</tr></thead><tbody>';
foreach ($astuces as $astuce)
{
$adresse = $astuce['id'].'/'.url_title($astuce['title']);
$etat = $astuce['published']
? '<span class="badge text-bg-success">'.$this->lang('Publiée').'</span>'
: '<span class="badge text-bg-secondary">'.$this->lang('Brouillon').'</span>';
$corps .= '<tr>'
.'<td>'.nf_texte($astuce['title']).'</td>'
.'<td>'.$etat.'</td>'
.'<td class="text-end text-nowrap">'
.'<a class="btn btn-sm btn-outline-secondary" href="'.url('admin/astuces/'.$adresse).'" title="'.$this->lang('Modifier').'"><i class="fas fa-pen"></i></a> '
.'<a class="btn btn-sm btn-outline-danger" href="'.$this->csrf_url('admin/astuces/supprimer/'.$adresse).'" data-confirm="'.nf_texte($this->lang('Supprimer cette astuce ?')).'" title="'.$this->lang('Supprimer').'"><i class="far fa-trash-alt"></i></a>'
.'</td></tr>';
}
$corps .= '</tbody></table>';
}
return $this->admin_card(
'fas fa-lightbulb',
$this->lang('Astuces'),
$corps,
$this->lang('%d astuce|%d astuces', count($astuces), count($astuces)),
$this->admin_create('admin/astuces/ajouter', $this->lang('Nouvelle astuce'))
);
}
public function _ajouter()
{
return $this->_formulaire(NULL);
}
public function _modifier($astuce)
{
return $this->_formulaire($astuce);
}
public function _supprimer($astuce)
{
// Un lien qui efface porte un jeton : un lien piégé, cliqué par un administrateur, ne fait rien.
$this->check_csrf('admin/astuces');
$this->db->where('id', $astuce['id'])->delete('nf_astuces');
notify($this->lang('Astuce supprimée.'));
redirect('admin/astuces');
}
/** Le même formulaire écrit une astuce neuve ou modifie une astuce existante. */
protected function _formulaire(?array $astuce)
{
$nouvelle = $astuce === NULL;
$titre = $nouvelle ? $this->lang('Nouvelle astuce') : $this->lang('Modifier l\'astuce');
$this->title($titre)->icon('fas fa-lightbulb')->breadcrumb();
$this->form()
->add_rules([
'title' => ['label' => $this->lang('Titre'), 'type' => 'text', 'value' => $nouvelle ? '' : $astuce['title'], 'rules' => 'required'],
'content' => ['label' => $this->lang('Texte'), 'type' => 'textarea', 'value' => $nouvelle ? '' : $astuce['content'], 'rules' => 'required'],
'sort_order' => ['label' => $this->lang('Ordre'), 'type' => 'text', 'value' => $nouvelle ? '0' : $astuce['sort_order']],
'published' => ['label' => $this->lang('Publication'), 'type' => 'checkbox', 'value' => ['1'], 'values' => ['1' => $this->lang('Astuce publiée')], 'checked' => ['1' => $nouvelle || !empty($astuce['published'])]]
])
->add_submit($nouvelle ? $this->lang('Ajouter') : $this->lang('Enregistrer'), $nouvelle ? 'fas fa-plus' : 'fas fa-check');
if ($this->form()->is_valid($post))
{
$donnees = [
'title' => $post['title'],
'content' => $post['content'],
'sort_order' => (int) $post['sort_order'],
'published' => in_array('1', (array) ($post['published'] ?? []), TRUE) ? 1 : 0
];
if ($nouvelle)
{
$this->db->insert('nf_astuces', $donnees);
}
else
{
$this->db->where('id', $astuce['id'])->update('nf_astuces', $donnees);
}
notify($nouvelle ? $this->lang('Astuce ajoutée.') : $this->lang('Astuce enregistrée.'));
redirect('admin/astuces');
}
return $this->admin_card($nouvelle ? 'fas fa-plus' : 'fas fa-pen', $titre, $this->form()->display());
}
}
La liste suit la charte de l'administration du site :
- une carte (
admin_card()) avec son titre, son compte (« 6 astuces ») et le bouton qui crée (admin_create()) ; - un état vide (
admin_empty()) qui dit quoi faire quand il n'y a rien ; - dans chaque ligne, des boutons à icône seule : modifier en contour gris, supprimer en contour rouge ;
- des pastilles d'état :
text-bg-successpour une astuce publiée,text-bg-secondarypour un brouillon.
Supprimer passe par un lien. Un lien qui efface doit porter un jeton : sans lui, une page piégée, ouverte par
un administrateur connecté, pourrait effacer à sa place. csrf_url() ajoute le jeton au lien, check_csrf() le
vérifie avant d'effacer. data-confirm fait demander une confirmation par le site avant de suivre le lien.
Le formulaire est le même pour une astuce neuve et pour une astuce à modifier :
form()->add_rules([…])décrit les champs : leur étiquette, leur type (text,textarea,checkbox…), leur valeur de départ, et'rules' => 'required'pour un champ obligatoire ;is_valid($post)est vrai quand le formulaire a été envoyé et que ses règles sont respectées ;$postreçoit alors les valeurs ;- on écrit dans la table (
insert()ouupdate()), on annonce le résultat (notify()), et on retourne à la liste (redirect()).
Le formulaire porte lui-même son jeton : rien à ajouter de ce côté.
Étape 6 — Le widget « Astuce du jour »
Le widget vit dans widgets/astuces/, dans la même archive. Sa carte d'identité :
widgets/astuces/astuces.php
<?php
declare(strict_types=1);
/**
* Astuce du jour — le widget du module Astuces, tutoriel « Un module et sa base de données » (intermédiaire). LGPLv3.
*/
namespace NF\Widgets\Astuces;
use NF\NeoFrag\Addons\Widget;
class Astuces extends Widget
{
protected function __info()
{
return [
'title' => $this->lang('Astuce du jour'),
'description' => $this->lang('Une astuce du module Astuces, qui change chaque jour, ou les dernières écrites.'),
'icon' => 'fas fa-lightbulb',
'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' => [],
// Il lit la table du module : sans le module, il ne s'affiche pas, et « Ajouter » refuse de l'installer seul.
'requires' => ['astuces'],
'types' => [
'index' => $this->lang('L\'astuce du jour'),
'dernieres' => $this->lang('Les dernières astuces')
]
];
}
}
…avec 'requires' => ['astuces']. Ce widget lit la table du module : sans le module, cette table n'existe pas,
et la page tomberait. Le déclarer dans requires fait que, sans le module (ou s'il est désactivé), le widget ne
s'affiche pas, que l'éditeur en direct ne le propose pas, et que « Ajouter » refuse de l'installer seul.
Son contrôleur a deux types :
widgets/astuces/controllers/index.php
<?php
declare(strict_types=1);
namespace NF\Widgets\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controllers\Widget as Controller_Widget;
class Index extends Controller_Widget
{
/** L'astuce du jour : un tirage dont la graine est la date, donc la même astuce toute la journée. */
public function index($settings = [])
{
$astuce = $this->db ->select('id', 'title', 'content')
->from('nf_astuces')
->where('published', 1)
->order_by('RAND('.(int) date('Ymd').')')
->row();
$this->css('astuces');
return $this->panel()
->heading()
->body($this->view('index', [
'astuce' => $astuce ?: NULL
]));
}
/** Les dernières astuces écrites, autant que le réglage le demande. */
public function dernieres($settings = [])
{
$astuces = $this->db ->select('id', 'title')
->from('nf_astuces')
->where('published', 1)
->order_by('created_at DESC, id DESC')
->limit((int) ($settings['nombre'] ?? 3))
->get();
$this->css('astuces');
return $this->panel()
->heading($this->lang('Les dernières astuces'), 'fas fa-lightbulb')
->body($this->view('dernieres', [
'astuces' => $astuces
]));
}
}
RAND(20261015) : un tirage au hasard dont la graine est la date du jour. La même graine donne le même tirage :
l'astuce reste la même toute la journée, et change le lendemain.
Le type « Les dernières astuces » a un réglage, le nombre à montrer ; le checker le garde entre 1 et 10, quoi qu'on envoie :
widgets/astuces/controllers/checker.php
<?php
declare(strict_types=1);
namespace NF\Widgets\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controller;
class Checker extends Controller
{
public function index($settings = [])
{
// L'astuce du jour n'a rien à régler.
return [];
}
public function dernieres($settings = [])
{
$settings = (array) $settings + ['nombre' => 3];
// Entre 1 et 10, quoi qu'on envoie.
return [
'nombre' => min(10, max(1, (int) $settings['nombre']))
];
}
}
widgets/astuces/controllers/admin.php
<?php
declare(strict_types=1);
namespace NF\Widgets\Astuces\Controllers;
use NF\NeoFrag\Loadables\Controller;
class Admin extends Controller
{
/** Seul le type « Les dernières astuces » a un réglage : combien en montrer. */
public function dernieres($settings = [])
{
$settings = (array) $settings + ['nombre' => 3];
return $this->view('admin', [
'nombre' => (int) $settings['nombre']
]);
}
}
Installer la mise à jour
- Prépare un dossier qui contient les deux dossiers
modulesetwidgets(tels qu'ils sont dans l'archive). - Sélectionne
modulesetwidgetsensemble, puis clic droit → Compresser. L'archive doit avoir ces deux dossiers à sa racine : si tu compresses le dossier qui les contient, l'installeur ne trouvera pas tes addons. - Thèmes & addons → Ajouter. Le site répond « Le module Astuces a été mis à jour » et « Le widget Astuce du jour a été installé ».
- Ouvre
/astuces: les quatre astuces sont là, versées par la migration. Ouvre Administration → Astuces pour en écrire d'autres.
Si ça ne marche pas
| Le site répond | Ce que ça veut dire |
|---|---|
| « Le composant ne peut pas être installé, veuillez vérifier son contenu » | L'archive n'a pas modules/ et widgets/ à sa racine : recompresse les deux dossiers eux-mêmes. |
| « Astuce du jour a besoin de : astuces. Installe-les d'abord. » | L'archive porte le widget sans le module, et le module n'est pas installé. |
/admin/astuces/ajouter répond « page introuvable » |
_ajouter() de l'admin_checker rend un tableau vide : il doit rendre [NULL]. |
| Les astuces de la 1.0 n'apparaissent pas | C'est une installation neuve, pas une mise à jour : la migration n'est jouée que sur un site qui avait la 1.0. |
| « Action non autorisée (jeton de sécurité invalide). » en supprimant | Le lien a été construit sans csrf_url(). |
Pour aller plus loin
- Des catégories d'astuces : une deuxième table dans
install.sql, une colonnecategory_idajoutée ànf_astucespar une migration (c'est une évolution d'une table déjà livrée), et un champselectdans le formulaire. - Des permissions : le guide Créer un module, dans la documentation du site, montre comment en déclarer.
Le tutoriel expert reprend « Astuces » une dernière fois : les astuces deviennent traduisibles (une table par langue, remplie par une migration), le module s'inscrit dans la recherche et le plan du site, et chaque astuce reçoit des réactions.

Actividad del foro
ningún visitante
Estadísticas
- 72 temas creados
- 0 mensaje publicado
- 63 anuncios
- 1 participante