source: trunk/web/punbb/plugins/AMP_Exemple.php

Last change on this file was 6, checked in by dj3c1t, 13 years ago

mise a jour du trunk

File size: 5.2 KB
Line 
1<?php
2/***********************************************************************
3
4  Copyright (C) 2002-2005  Rickard Andersson (rickard@punbb.org)
5
6  This file is part of PunBB.
7
8  PunBB is free software; you can redistribute it and/or modify it
9  under the terms of the GNU General Public License as published
10  by the Free Software Foundation; either version 2 of the License,
11  or (at your option) any later version.
12
13  PunBB is distributed in the hope that it will be useful, but
14  WITHOUT ANY WARRANTY; without even the implied warranty of
15  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  GNU General Public License for more details.
17
18  You should have received a copy of the GNU General Public License
19  along with this program; if not, write to the Free Software
20  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21  MA  02111-1307  USA
22
23************************************************************************/
24
25##
26##
27##  Voici quelques notes intérrêssantes pour les aspirants auteurs de plugin :
28##
29##  1. Si vous voulez afficher un message par l’intermédiaire de la fonction
30##     message(), vous devez le faire avant d’appeler generate_admin_menu($plugin).
31##
32##  2. Les plugins sont chargés par admin_loader.php et ne doivent pas être terminés
33##     (par exemple en appelant exit()). AprÚs que le script du plugin ait fini, le
34##     script du chargeur affiche le pied de page, ainsi inutil de vous souciez de cela.
35##     Cependant veuillez noter que terminer un plugin en appelant message() ou
36##     redirect() est trÚs bien.
37##
38##  3. L’attribut action de toute balise <forme> et l’URL cible pour la fonction
39##     redirect() doit être placé à la valeur de $_SERVER[’REQUEST_URI’]. Cette
40##     URL peut cependant être étendue pour inclure des variables supplémentaires
41##     (comme l’ajout de &foo=bar dans le plugin exemple).
42##
43##  4. Si votre plugin est pour les administrateurs seulement, le nom de fichier
44##     doit avoir le préfixe AP_. S’il est pour les administrateurs et les modérateurs,
45##     utilisez le préfixe AMP_. Le plugin exemple a le préfixe AMP_ et est donc
46##     disponible dans le menu de navigation aux administrateurs et aux modérateurs.
47##
48##  5. Utilisez _ au lieu des espaces dans le nom de fichier.
49##
50##  6. Tant que les scripts de plugin sont inclus depuis le scripts admin_loader.php
51##     de PunBB, vous avez accÚs toutes les fonctions et variables globales de PunBB
52##     (par exemple $db, $pun_config, $pun_user etc.).
53##
54##  7. Faites de votre mieux pour garder l’aspect et l’ergonomie de votre interface
55##     utilisateur de plugins semblable au reste des scripts d’administration.
56##     N’hésitez pas à emprunter le marquage et le code aux scripts d’admin pour
57##     l’employer dans vos plugins.
58##
59##  8. Les plugins doivent êtres délivrés sous la licence d’utilisation GNU/GPL ou
60##     une licence compatible. Recopiez le préambule GPL (situé en haut des scripts
61##     de PunBB) dans votre script de plugin et changez l e copyright pour qu’il
62##     corresponde à l’auteur du plugin (c’est à dire vous).
63##
64##
65
66
67// Make sure no one attempts to run this script "directly"
68if (!defined('PUN'))
69        exit;
70
71// Tell admin_loader.php that this is indeed a plugin and that it is loaded
72define('PUN_PLUGIN_LOADED', 1);
73
74//
75// The rest is up to you!
76//
77
78// If the "Show text" button was clicked
79if (isset($_POST['show_text']))
80{
81        // Make sure something something was entered
82        if (trim($_POST['text_to_show']) == '')
83                message('You didn\'t enter anything!');
84
85        // Display the admin navigation menu
86        generate_admin_menu($plugin);
87
88?>
89        <div class="block">
90                <h2><span>Plugin exemple</span></h2>
91                <div class="box">
92                        <div class="inbox">
93                                <p>Vous avez dit "<?php echo pun_htmlspecialchars($_POST['text_to_show']) ?>". Bon boulot.</p>
94                                <p><a href="javascript: history.go(-1)">Retour</a></p>
95                        </div>
96                </div>
97        </div>
98<?php
99
100}
101else    // If not, we show the "Show text" form
102{
103        // Display the admin navigation menu
104        generate_admin_menu($plugin);
105
106?>
107        <div id="exampleplugin" class="blockform">
108                <h2><span>Plugin exemple</span></h2>
109                <div class="box">
110                        <div class="inbox">
111                                <p>Ce plugin ne fait rien de bien utile. D'où le nom &quot;Exemple&quot;.</p>
112                                <p>Ce serait un bon endroit pour parler au sujet de votre plugin. Décrivez ce qu'il fait et comment il devrait être utilisé. Soyez bref, mais instructif.</p>
113                        </div>
114                </div>
115
116                <h2 class="block2"><span>Un formulaire d'exemple</span></h2>
117                <div class="box">
118                        <form id="example" method="post" action="<?php echo $_SERVER['REQUEST_URI'] ?>&amp;foo=bar">
119                                <div class="inform">
120                                        <fieldset>
121                                                <legend>Saisissez un bout de texte et cliquez "Afficher"&#160;!</legend>
122                                                <div class="infldset">
123                                                <table class="aligntop" cellspacing="0">
124                                                        <tr>
125                                                                <th scope="row">Texte à afficher<div><input type="submit" name="show_text" value=" Afficher le texte " tabindex="2" /></div></th>
126                                                                <td>
127                                                                        <input type="text" name="text_to_show" size="25" tabindex="1" />
128                                                                        <span>Le texte que vous voulez afficher.</span>
129                                                                </td>
130                                                        </tr>
131                                                </table>
132                                                </div>
133                                        </fieldset>
134                                </div>
135                        </form>
136                </div>
137        </div>
138<?php
139
140}
141
142// Note that the script just ends here. The footer will be included by admin_loader.php.
Note: See TracBrowser for help on using the repository browser.