pgsrc/PhpWikiAdministration

   1 Date: Sat, 24 Jan 2009 19:18:24 +0100
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=PhpWikiAdministration;
   6   flags=PAGE_LOCKED;
   7   markup=2;
   8   charset=iso-8859-1
   9 Content-Transfer-Encoding: binary
  10
  11 _*Note:*_  _Most of the actions on this page require administrative privileges._
  12
  13 <?plugin CreateToc jshide||=0 with_toclink||=1 position=right with_counter=1 ?>
  14
  15 == Page Explorer
  16
  17 First select pages and then define the action:
  18
  19 <?plugin-form WikiAdminSelect s="*" ?>
  20
  21 or call the available ~WikiAdmin actions directly:
  22
  23 [/Remove] |
  24   [/Rename] |
  25     [/Replace] |
  26       [/SetAcl] |
  27         [/Chown]
  28
  29 == User Management
  30
  31 === Reset a users password
  32
  33 <?plugin-form PasswordReset textinput=user method=post ?>
  34
  35 === Email Verification
  36
  37 This is currently non-strict, leaving some possible holes in not being able to
  38 connect to certain mail hosts, which can be overridden below. See [PhpWiki:EmailVerification].
  39
  40 This button will show a list of all users with registered emails and buttons to set the verification status manually.
  41
  42 <?plugin WikiAdminUtils
  43          action=email-verification
  44          label="Email Verification"
  45 ?>
  46
  47 === Access Restrictions (disabled)
  48
  49 To prevent from robots eating all possible ressources in a short time, blocking from certain IPs
  50 or not-well-behaving user agents can be defined below. See [PhpWiki:HowToBlockRobots] and
  51 [MeatBall:SurgeProtector]. _Note: Not yet enabled._
  52
  53 <?plugin WikiAdminUtils
  54          action=access-restrictions
  55          label="Access Restrictions"
  56 ?>
  57
  58 == Cleanup
  59
  60 A Wiki SandBox is very easy to clean. Here you can restore it to
  61 pristine condition by loading the default from pgsrc.
  62
  63 [Rake the SandBox|phpwiki:?action=loadfile&source=pgsrc/SandBox].
  64
  65 == Making Snapshots or Backups
  66
  67 === ZIP files of database
  68
  69 These links lead to zip files, generated on the fly, which contain all
  70 the pages in your Wiki. The zip file will be downloaded to your local
  71 computer.
  72
  73 This *[ZIP Snapshot | phpwiki:?action=zip]* contains only the
  74 latest versions of each page, while this *[ZIP Dump | phpwiki:?action=zip&include=all]* contains all archived versions.
  75
  76 (If the [PhpWiki|PhpWiki:PhpWiki] is configured to allow it, anyone can download a zip file.)
  77
  78 If your php has _zlib_ support, the files in the archive will be 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 directory, one page per file. Your server must have write permissions to the directory!
  87
  88 == Restoring
  89
  90 If you have dumped a set of pages from [PhpWiki|PhpWiki:PhpWiki], you can reload them
  91 here. Note that pages in your database will be overwritten; thus, if
  92 you dumped your HomePage when you load it from this form it will
  93 overwrite the one in your database now. If you want to be selective
  94 just delete the pages from the directory (or zip file) which you don't
  95 want to load.
  96
  97 === Upload File
  98
  99 Here you can upload ZIP archives, or individual files from your
 100 (client) machine.
 101
 102 <?plugin WikiForm action=upload?>
 103
 104 === Load File
 105
 106 Here you can load ZIP archives, individual files or entire
 107 directories. The file or directory must be local to the http
 108 server. You can also use this form to load from an http: or ftp: URL.
 109
 110 <?plugin WikiForm action=loadfile?>
 111 <?plugin WikiForm action=loadfile buttontext="Load & Overwrite" overwrite=1?>
 112
 113 === Upgrade
 114
 115 Do some verification checks and upgrade changes automatically, after having installed a
 116 new phpwiki engine update:
 117 * Upgrade new or changed page revisions from pgsrc,
 118 * Upgrade the database schema (mysql _page.id auto_increment_, ADD _session.sess_ip_),
 119
 120 [ Upgrade | phpwiki:HomePage?action=upgrade ]
 121
 122 == Format of the files
 123
 124 === Current Format
 125
 126 Currently the pages are stored, one per file, as MIME (RFC:2045)
 127 e-mail (RFC:822) messages. The content-type _application/x-phpwiki_
 128 is used, and page meta-data is encoded in the content-type
 129 parameters. (If the file contains several versions of a page, it will
 130 have type _multipart/mixed_, and contain several sub-parts, each
 131 with type _application/x-phpwiki_.)  The message body contains the
 132 page text.
 133
 134 === Old Formats
 135
 136 ==== Serialized Files
 137
 138 The dump to directory command used to dump the pages as PHP
 139 _serialized()_ strings. For humans, this made the files very hard
 140 to read, and nearly impossible to edit.
 141
 142 ==== Plain Files
 143
 144 Before that the page text was just dumped to a file--this means that
 145 all page meta-data was lost. Note that when loading _plain files_,
 146 the page name is deduced from the file name.
 147
 148 The upload and load functions will automatically recognize each of
 149 these three types of files, and handle them accordingly.
 150
 151 == Dump pages as XHTML
 152
 153 <?plugin WikiForm action=dumphtml?>
 154
 155 This will generate a directory of static pages suitable for
 156 distribution on disk where no web server is available. The various
 157 links for page editing functions and navigation are removed from the
 158 pages.
 159
 160 The XHTML file collection can also be downloaded as an *[XHTML ZIP Snapshot | phpwiki:?action=ziphtml]*.
 161
 162 ----
 163 [CategoryActionPage]