From 48e11686f97d4124afa9e86ffe7c491579a2e827 Mon Sep 17 00:00:00 2001
From: Pascal Corpet <pascal.corpet@m4x.org>
Date: Mon, 24 Mar 2008 00:29:41 +0100
Subject: [PATCH] more explanations for forums banishment administration

---
 modules/forums.php         |  9 ++++-----
 templates/forums/admin.tpl | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+), 5 deletions(-)
 create mode 100644 templates/forums/admin.tpl

diff --git a/modules/forums.php b/modules/forums.php
index 700f076..f02a9dc 100644
--- a/modules/forums.php
+++ b/modules/forums.php
@@ -150,14 +150,13 @@ class ForumsModule extends PLModule
         $page->assign('xorg_title','Polytechnique.org - Administration - Bannissements des forums');
         $page->assign('title', 'Gestion des mises au ban');
         $table_editor = new PLTableEditor('admin/forums','forums.innd','id_innd');
-        $table_editor->describe('ipmin','min plage IP',true);
-        $table_editor->describe('ipmax','max plage IP',true);
-        $table_editor->describe('uid','id utilisateur',true);
-        $table_editor->describe('write_perm','masque des forums autorisés en lecture',true);
-        $table_editor->describe('read_perm','masque des forums autorisés en écriture',true);
+        $table_editor->add_sort_field('priority', true, true);
+        $table_editor->describe('read_perm','lecture',true);
+        $table_editor->describe('write_perm','écriture',true);
         $table_editor->describe('priority','priorité',true);
         $table_editor->describe('comment','commentaire',true);
         $table_editor->apply($page, $action, $id);
+        $page->changeTpl('forums/admin.tpl');
     }
 
     static function run_banana(&$page, $params = null)
diff --git a/templates/forums/admin.tpl b/templates/forums/admin.tpl
new file mode 100644
index 0000000..0cac7fb
--- /dev/null
+++ b/templates/forums/admin.tpl
@@ -0,0 +1,44 @@
+{**************************************************************************}
+{*                                                                        *}
+{*  Copyright (C) 2003-2008 Polytechnique.org                             *}
+{*  http://opensource.polytechnique.org/                                  *}
+{*                                                                        *}
+{*  This program is free software; you can redistribute it and/or modify  *}
+{*  it under the terms of the GNU General Public License as published by  *}
+{*  the Free Software Foundation; either version 2 of the License, or     *}
+{*  (at your option) any later version.                                   *}
+{*                                                                        *}
+{*  This program is distributed in the hope that it will be useful,       *}
+{*  but WITHOUT ANY WARRANTY; without even the implied warranty of        *}
+{*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *}
+{*  GNU General Public License for more details.                          *}
+{*                                                                        *}
+{*  You should have received a copy of the GNU General Public License     *}
+{*  along with this program; if not, write to the Free Software           *}
+{*  Foundation, Inc.,                                                     *}
+{*  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA               *}
+{*                                                                        *}
+{**************************************************************************}
+
+Le tableau suivant permet de gérer la mise au ban (le bannissement) de certains utilisateurs aux forums.
+
+Chaque ligne permet de gérer les accès limités à :
+<ul>
+<li>une plage d'adresses IP donnée (entre ipmin et ipmax),</li>
+<li>à tout le monde (uid=0) ou seulement à un utilisateur donné,</li>
+<li>en restreignant l'accès en lecture à un ensemble de forums décrits par un masque,</li>
+<li>en restreingant l'accès en écriture à un ensemble de forums décrits par un masque.</li>
+</ul>
+
+<p>
+Dans les masques le <strong>*</strong> remplace n'importe quel texte et le <strong>!</strong> bloque l'accès au lieu de l'autoriser. Par exemple : <code>xorg.*,!xorg.prive.*</code> autorise tous les forums xorg sauf ceux qui s'appellent xorg.prive.qqchose.
+</p>
+
+<p>
+Les différentes règles sont appliquées par ordre de priorité décroissante.
+</p>
+
+{include file="core/table-editor.tpl"}
+
+{* vim:set et sw=2 sts=2 sws=2 enc=utf-8: *}
+
-- 
2.1.4