pgsrc/PhpWikiAdministration

   1 Date: Mon, 7 Jun 2004 19:50:59 +0200
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.11pre)
   3 X-Rcs-Id: $Id: PhpWikiAdministration,v 1.34 2004-06-07 18:01:17 rurban Exp $
   4 Content-Type: application/x-phpwiki;
   5   pagename=PhpWikiAdministration;
   6   pgsrc_version="2 $Revision: 1.34 $";
   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           [/Chown]
  33
  34 ----
  35 !!! User Management
  36
  37 PhpWiki:EmailVerification is currently non-strict, leaving some possible holes, which can be administrated below.
  38
  39   This button will show a list of all users with registered emails and buttons to set the verification status manually.
  40
  41   <?plugin WikiAdminUtils
  42            action=email-verification
  43            label="Email Verification"
  44    ?>
  45
  46 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._
  47
  48   <?plugin WikiAdminUtils
  49            action=access-restrictions
  50            label="Access Restrictions"
  51    ?>
  52
  53 ----
  54 !!! Cleanup
  55
  56 A Wiki SandBox is very easy to clean. Here you can restore it to
  57 pristine condition by loading the default from pgsrc.
  58
  59   [Rake the SandBox|phpwiki:?action=loadfile&source=pgsrc/SandBox].
  60
  61 ----------
  62
  63 !!! Making Snapshots or Backups
  64
  65 !! ZIP files of database
  66
  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
  69 computer.
  70
  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.
  74
  75   (If the PhpWiki is configured to allow it, anyone can download a zip
  76   file.)
  77
  78 If your php has ''zlib'' support, the files in the archive will be
  79 compressed, otherwise they will just be stored.
  80
  81 !! Dump to directory
  82
  83 Here you can dump pages of your Wiki into a directory of your choice.
  84
  85   <?plugin WikiForm action=dumpserial?>
  86
  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
  89 to the directory!
  90
  91 -----------
  92 !!! Restoring
  93
  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
  99 want to load.
 100
 101 !! Upload File
 102
 103 Here you can upload ZIP archives, or individual files from your
 104 (client) machine.
 105
 106   <?plugin WikiForm action=upload?>
 107
 108 !! Load File
 109
 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.
 113
 114   <?plugin WikiForm action=loadfile?>
 115   <?plugin WikiForm action=loadfile buttontext="Load & Overwrite" overwrite=1?>
 116
 117 !! Upgrade
 118
 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_),
 123
 124 ;:[ Upgrade | phpwiki:HomePage?action=upgrade ]
 125
 126 -----------
 127
 128 !!! Format of the files
 129
 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
 136 page text.
 137
 138 !! Old Formats
 139
 140 __Serialized Files__
 141
 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.
 145
 146 __Plain Files__
 147
 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.
 151
 152 The upload and load functions will automatically recognize each of
 153 these three types of files, and handle them accordingly.
 154
 155 ----
 156
 157 !!! Dump pages as XHTML
 158
 159   <?plugin WikiForm action=dumphtml?>
 160
 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
 164 pages.
 165
 166   The XHTML file collection can also be downloaded as an
 167   __[XHTML ZIP Snapshot | phpwiki:?action=ziphtml]__.
 168
 169 ----
 170
 171 !!! Phpwiki Internals
 172
 173 These are here mostly for debugging purposes (at least, that's the
 174 hope.)
 175
 176 In normal use, you shouldn't need to use these, though, then again,
 177 they shouldn't really do any harm.
 178
 179 !! Purge Markup Cache
 180
 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.
 184
 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.)
 188
 189   <?plugin WikiAdminUtils
 190            action=purge-cache
 191            label="Purge Cache"
 192    ?>
 193
 194 !! Clean WikiDB of Illegal Filenames
 195
 196 Page names beginning with the subpage-separator, usually a slash
 197 (=/=), are not allowed. Sometimes though an errant plugin or something
 198 might create one....
 199
 200   This button will delete any pages with illegal page names.
 201
 202   <?plugin WikiAdminUtils
 203            action=purge-bad-pagenames
 204            label="Exorcise WikiDB"
 205    ?>
 206
 207 ----
 208 PhpWikiDocumentation