pgsrc/PhpWikiAdministration

   1 Date: Wed, 26 Nov 2003 18:34:06 +0100
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.7pre)
   3 X-Rcs-Id: $Id: PhpWikiAdministration,v 1.31 2004-05-09 00:57:32 rurban Exp $
   4 Content-Type: application/x-phpwiki;
   5   pagename=PhpWikiAdministration;
   6   pgsrc_version="2 $Revision: 1.31 $";
   7   flags=PAGE_LOCKED;
   8   markup=2;
   9   charset=iso-8859-1
  10 Content-Transfer-Encoding: binary
  11
  12 _*Note:*_ _Most of the actions on this page require administrative
  13 privileges. They won't work unless you have set an admin username and
  14 password in the PhpWiki config file._
  15
  16 <?plugin CreateToc jshide||=1 with_toclink||=1 ?>
  17
  18 ----
  19 !!! Page Explorer
  20
  21 First select pages and then define the action:
  22
  23 <?plugin-form WikiAdminSelect s="*" ?>
  24
  25 or call the available ~WikiAdmin actions directly:
  26
  27 [/Remove] |
  28   [/Rename] |
  29     [/Replace] |
  30       [/SetAcl] |
  31         [/Chmod]
  32
  33 ----
  34 !!! User Management
  35
  36 PhpWiki:EmailVerification is currently non-strict, leaving some possible holes, which can be administrated below.
  37
  38   This button will show a list of all users with registered emails and buttons to set the verification status manually.
  39
  40   <?plugin WikiAdminUtils
  41            action=email-verification
  42            label="Email Verification"
  43    ?>
  44
  45 To prevent from robots eating all possible ressources in a short time, blocking from certain IP's or not-well-behaving user agents can be defined below. See PhpWiki:HowToBlockRobots and MeatBall:SurgeProtector. _Note: Not yet enabled._
  46
  47   <?plugin WikiAdminUtils
  48            action=access-restrictions
  49            label="Access Restrictions"
  50    ?>
  51
  52 ----
  53 !!! Cleanup
  54
  55 A Wiki SandBox is very easy to clean. Here you can restore it to
  56 pristine condition by loading the default from pgsrc.
  57
  58   [Rake the SandBox|phpwiki:?action=loadfile&source=pgsrc/SandBox].
  59
  60 ----------
  61
  62 !!! Making Snapshots or Backups
  63
  64 !! ZIP files of database
  65
  66 These links lead to zip files, generated on the fly, which contain all
  67 the pages in your Wiki. The zip file will be downloaded to your local
  68 computer.
  69
  70   This __[ZIP Snapshot | phpwiki:?action=zip]__ contains only the
  71   latest versions of each page, while this __[ZIP Dump |
  72   phpwiki:?action=zip&include=all]__ contains all archived versions.
  73
  74   (If the PhpWiki is configured to allow it, anyone can download a zip
  75   file.)
  76
  77 If your php has ''zlib'' support, the files in the archive will be
  78 compressed, otherwise they will just be stored.
  79
  80 !! Dump to directory
  81
  82 Here you can dump pages of your Wiki into a directory of your choice.
  83
  84   <?plugin WikiForm action=dumpserial?>
  85
  86 The most recent version of each page will written out to the
  87 directory, one page per file. Your server must have write permissions
  88 to the directory!
  89
  90 -----------
  91 !!! Restoring
  92
  93 If you have dumped a set of pages from PhpWiki, you can reload them
  94 here. Note that pages in your database will be overwritten; thus, if
  95 you dumped your HomePage when you load it from this form it will
  96 overwrite the one in your database now. If you want to be selective
  97 just delete the pages from the directory (or zip file) which you don't
  98 want to load.
  99
 100 !! Upload File
 101
 102 Here you can upload ZIP archives, or individual files from your
 103 (client) machine.
 104
 105   <?plugin WikiForm action=upload?>
 106
 107 !! Load File
 108
 109 Here you can load ZIP archives, individual files or entire
 110 directories. The file or directory must be local to the http
 111 server. You can also use this form to load from an http: or ftp: URL.
 112
 113   <?plugin WikiForm action=loadfile?>
 114
 115 !! Upgrade
 116
 117 Do some verification checks and upgrade changes automatically, after having installed a
 118 new phpwiki engine update:
 119 * Upgrade new or changed page revisions from pgsrc,
 120 * Upgrade the database schema (mysql _page.id auto_increment_, ADD _session.sess_ip_),
 121
 122 ;:[ Upgrade | phpwiki:HomePage?action=upgrade ]
 123
 124 -----------
 125
 126 !!! Format of the files
 127
 128 Currently the pages are stored, one per file, as MIME (RFC:2045)
 129 e-mail (RFC:822) messages. The content-type ''application/x-phpwiki''
 130 is used, and page meta-data is encoded in the content-type
 131 parameters. (If the file contains several versions of a page, it will
 132 have type ''multipart/mixed'', and contain several sub-parts, each
 133 with type ''application/x-phpwiki''.)  The message body contains the
 134 page text.
 135
 136 !! Old Formats
 137
 138 __Serialized Files__
 139
 140   The dump to directory command used to dump the pages as PHP
 141   ''serialized()'' strings. For humans, this made the files very hard
 142   to read, and nearly impossible to edit.
 143
 144 __Plain Files__
 145
 146   Before that the page text was just dumped to a file--this means that
 147   all page meta-data was lost. Note that when loading ''plain files'',
 148   the page name is deduced from the file name.
 149
 150 The upload and load functions will automatically recognize each of
 151 these three types of files, and handle them accordingly.
 152
 153 ----
 154
 155 !!! Dump pages as XHTML
 156
 157   <?plugin WikiForm action=dumphtml?>
 158
 159 This will generate a directory of static pages suitable for
 160 distribution on disk where no web server is available. The various
 161 links for page editing functions and navigation are removed from the
 162 pages.
 163
 164   The XHTML file collection can also be downloaded as an
 165   __[XHTML ZIP Snapshot | phpwiki:?action=ziphtml]__.
 166
 167 ----
 168
 169 !!! Phpwiki Internals
 170
 171 These are here mostly for debugging purposes (at least, that's the
 172 hope.)
 173
 174 In normal use, you shouldn't need to use these, though, then again,
 175 they shouldn't really do any harm.
 176
 177 !! Purge Markup Cache
 178
 179 (If your wiki is so configured,) the transformed (almost-HTML) content
 180 of the most recent version of each page is cached. This speeds up page
 181 rendering since parsing of the wiki-text takes a fair amount of juice.
 182
 183   Hitting this button will delete all cached transformed
 184   content. (Each pages content will be transformed and re-cached next
 185   time someone views it.)
 186
 187   <?plugin WikiAdminUtils
 188            action=purge-cache
 189            label="Purge Cache"
 190    ?>
 191
 192 !! Clean WikiDB of Illegal Filenames
 193
 194 Page names beginning with the subpage-separator, usually a slash
 195 (=/=), are not allowed. Sometimes though an errant plugin or something
 196 might create one....
 197
 198   This button will delete any pages with illegal page names.
 199
 200   <?plugin WikiAdminUtils
 201            action=purge-bad-pagenames
 202            label="Exorcise WikiDB"
 203    ?>
 204
 205 ----
 206 PhpWikiDocumentation