1 Date: Mon, 6 Dec 2004 21:23:59 +0200
2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.11pre)
3 X-Rcs-Id: $Id: PhpWikiAdministration,v 1.36 2004-12-06 20:23:36 rurban Exp $
4 Content-Type: application/x-phpwiki;
5 pagename=PhpWikiAdministration;
6 pgsrc_version="2 $Revision: 1.36 $";
10 Content-Transfer-Encoding: binary
12 _*Note:*_ _Most of the actions on this page require administrative
13 privileges. They will not work unless you have set an admin username and
14 password in the PhpWiki config file._
16 <?plugin CreateToc jshide||=1 with_toclink||=1 ?>
21 First select pages and then define the action:
23 <?plugin-form WikiAdminSelect s="*" ?>
25 or call the available ~WikiAdmin actions directly:
37 PhpWiki:EmailVerification is currently non-strict, leaving some possible holes, which can be administrated below.
39 This button will show a list of all users with registered emails and buttons to set the verification status manually.
41 <?plugin WikiAdminUtils
42 action=email-verification
43 label="Email Verification"
46 To prevent from robots eating all possible ressources in a short time, blocking from certain IPs or not-well-behaving user agents can be defined below. See PhpWiki:HowToBlockRobots and MeatBall:SurgeProtector. _Note: Not yet enabled._
48 <?plugin WikiAdminUtils
49 action=access-restrictions
50 label="Access Restrictions"
56 A Wiki SandBox is very easy to clean. Here you can restore it to
57 pristine condition by loading the default from pgsrc.
59 [Rake the SandBox|phpwiki:?action=loadfile&source=pgsrc/SandBox].
63 !!! Making Snapshots or Backups
65 !! ZIP files of database
67 These links lead to zip files, generated on the fly, which contain all
68 the pages in your Wiki. The zip file will be downloaded to your local
71 This *[ZIP Snapshot | phpwiki:?action=zip]* contains only the
72 latest versions of each page, while this *[ZIP Dump |
73 phpwiki:?action=zip&include=all]* contains all archived versions.
75 (If the PhpWiki is configured to allow it, anyone can download a zip
78 If your php has _zlib_ support, the files in the archive will be
79 compressed, otherwise they will just be stored.
83 Here you can dump pages of your Wiki into a directory of your choice.
85 <?plugin WikiForm action=dumpserial?>
87 The most recent version of each page will written out to the
88 directory, one page per file. Your server must have write permissions
94 If you have dumped a set of pages from PhpWiki, you can reload them
95 here. Note that pages in your database will be overwritten; thus, if
96 you dumped your HomePage when you load it from this form it will
97 overwrite the one in your database now. If you want to be selective
98 just delete the pages from the directory (or zip file) which you don't
103 Here you can upload ZIP archives, or individual files from your
106 <?plugin WikiForm action=upload?>
110 Here you can load ZIP archives, individual files or entire
111 directories. The file or directory must be local to the http
112 server. You can also use this form to load from an http: or ftp: URL.
114 <?plugin WikiForm action=loadfile?>
115 <?plugin WikiForm action=loadfile buttontext="Load & Overwrite" overwrite=1?>
119 Do some verification checks and upgrade changes automatically, after having installed a
120 new phpwiki engine update:
121 * Upgrade new or changed page revisions from pgsrc,
122 * Upgrade the database schema (mysql _page.id auto_increment_, ADD _session.sess_ip_),
124 ;:[ Upgrade | phpwiki:HomePage?action=upgrade ]
128 !!! Format of the files
130 Currently the pages are stored, one per file, as MIME (RFC:2045)
131 e-mail (RFC:822) messages. The content-type ''application/x-phpwiki''
132 is used, and page meta-data is encoded in the content-type
133 parameters. (If the file contains several versions of a page, it will
134 have type ''multipart/mixed'', and contain several sub-parts, each
135 with type ''application/x-phpwiki''.) The message body contains the
142 The dump to directory command used to dump the pages as PHP
143 ''serialized()'' strings. For humans, this made the files very hard
144 to read, and nearly impossible to edit.
148 Before that the page text was just dumped to a file--this means that
149 all page meta-data was lost. Note that when loading ''plain files'',
150 the page name is deduced from the file name.
152 The upload and load functions will automatically recognize each of
153 these three types of files, and handle them accordingly.
157 !!! Dump pages as XHTML
159 <?plugin WikiForm action=dumphtml?>
161 This will generate a directory of static pages suitable for
162 distribution on disk where no web server is available. The various
163 links for page editing functions and navigation are removed from the
166 The XHTML file collection can also be downloaded as an
167 *[XHTML ZIP Snapshot | phpwiki:?action=ziphtml]*.
171 !!! Phpwiki Internals
173 These are here mostly for debugging purposes (at least, that is the
176 In normal use, you should not need to use these, though, then again,
177 they should not really do any harm.
179 !! Purge Markup Cache
181 (If your wiki is so configured,) the transformed (almost-HTML) content
182 of the most recent version of each page is cached. This speeds up page
183 rendering since parsing of the wiki-text takes a fair amount of juice.
185 Hitting this button will delete all cached transformed
186 content. (Each pages content will be transformed and re-cached next
187 time someone views it.)
189 <?plugin WikiAdminUtils
194 !! Clean WikiDB of Illegal Filenames
196 Page names beginning with the subpage-separator, usually a slash
197 (=/=), are not allowed. Sometimes though an errant plugin or something
200 This button will delete any pages with illegal page names, without possibility to restore.
202 <?plugin WikiAdminUtils
203 action=purge-bad-pagenames
204 label="Purge bad pagenames"
207 !! Clean WikiDB of empty and unreferenced pages
209 *Warning!* This button will delete every empty and unreferenced page, without any possibility to restore them again.
210 This will disable the possibility to revert or get back any deleted page.
212 <?plugin WikiAdminUtils
213 action=purge-empty-pages
214 label="Purge all empty unreferenced pages"