pgsrc/PhpWikiAdministration

   1 Date: Tue, 31 Aug 2010 11:36:04 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC-20100415)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=PhpWikiAdministration;
   6   flags=PAGE_LOCKED;
   7   markup=2;
   8   charset=UTF-8
   9 Content-Transfer-Encoding: binary
  10
  11 **//Note://** //Most of the actions on this page require administrative privileges.//
  12
  13 <<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 | [[/Chown]] | [[/Markup]] | [[/Purge]] | [[/Remove]] | [[/Rename]] | [[/SearchReplace]] | [[/SetAcl]] | [[/SetAclSimple]]
  24
  25 == Global Access Rights ==
  26
  27 These action pages will allow you to set the default access rights for wiki pages.
  28 Pages without individual access rights will use these default access rights.
  29 * [[SetGlobalAccessRightsSimple]]
  30 * [[SetGlobalAccessRights]]
  31
  32 == User Management ==
  33
  34 === Reset a users password ===
  35
  36 <?plugin-form PasswordReset textinput=user method=post ?>
  37
  38 === Email Verification ===
  39
  40 This is currently non-strict, leaving some possible holes in not being able to
  41 connect to certain mail hosts, which can be overridden below. See [[PhpWiki:EmailVerification]].
  42
  43 This button will show a list of all users with registered emails and buttons to set the verification status manually.
  44
  45 <<WikiAdminUtils action=email-verification label="Email Verification">>
  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 <<WikiAdminUtils action=access-restrictions label="Access Restrictions">>
  54
  55 == Cleanup ==
  56
  57 A Wiki SandBox is very easy to clean. Here you can restore it to
  58 pristine condition by loading the default from pgsrc.
  59
  60 **[[phpwiki:?action=loadfile&overwrite=1&source=pgsrc/SandBox|Rake the SandBox]]**
  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 **[[phpwiki:?action=zip|ZIP Snapshot]]** contains only the
  71 latest versions of each page, while this **[[phpwiki:?action=zip&include=all|ZIP Dump]]** contains all archived versions.
  72
  73 (If the ~PhpWiki is configured to allow it, anyone can download a zip file.)
  74
  75 If your php has //zlib// support, the files in the archive will be compressed, otherwise they will just be stored.
  76
  77 === Dump to directory ===
  78
  79 Here you can dump pages of your Wiki into a directory of your choice.
  80
  81 <<WikiForm action=dumpserial>>
  82
  83 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!
  84
  85 == Restoring ==
  86
  87 If you have dumped a set of pages from ~PhpWiki, you can reload them
  88 here. Note that pages in your database will be overwritten; thus, if
  89 you dumped your HomePage when you load it from this form it will
  90 overwrite the one in your database now. If you want to be selective
  91 just delete the pages from the directory (or zip file) which you don't
  92 want to load.
  93
  94 === Upload File ===
  95
  96 Here you can upload ZIP archives, or individual files from your
  97 (client) machine.
  98
  99 <<WikiForm action=upload>>
 100
 101 === Load File ===
 102
 103 Here you can load ZIP archives, individual files or entire
 104 directories. The file or directory must be local to the http
 105 server. You can also use this form to load from an http: or ftp: URL.
 106
 107 <<WikiForm action=loadfile>>
 108 <<WikiForm action=loadfile buttontext="Load & Overwrite" overwrite=1>>
 109
 110 === Upgrade ===
 111
 112 Do some verification checks and upgrade changes automatically, after having installed a
 113 new phpwiki engine update:
 114 * Upgrade new or changed page revisions from pgsrc,
 115 * Upgrade the database schema (mysql //page.id auto_increment//, ADD //session.sess_ip//),
 116
 117 You can force overwrite or not:
 118 * **[[phpwiki:HomePage?action=upgrade|Upgrade]]**
 119 * **[[phpwiki:HomePage?action=upgrade&overwrite=1|Upgrade & Overwrite]]**
 120
 121 == Format of the files ==
 122
 123 === Current Format ===
 124
 125 Currently the pages are stored, one per file, as MIME (RFC:2045)
 126 e-mail (RFC:822) messages. The content-type //application/x-phpwiki//
 127 is used, and page meta-data is encoded in the content-type
 128 parameters. (If the file contains several versions of a page, it will
 129 have type //multipart/mixed//, and contain several sub-parts, each
 130 with type //application/x-phpwiki//.)  The message body contains the
 131 page text.
 132
 133 === Old Formats ===
 134
 135 ==== Serialized Files ====
 136
 137 The dump to directory command used to dump the pages as PHP
 138 //serialized()// strings. For humans, this made the files very hard
 139 to read, and nearly impossible to edit.
 140
 141 ==== Plain Files ====
 142
 143 Before that the page text was just dumped to a file--this means that
 144 all page meta-data was lost. Note that when loading //plain files//,
 145 the page name is deduced from the file name.
 146
 147 The upload and load functions will automatically recognize each of
 148 these three types of files, and handle them accordingly.
 149
 150 == Dump pages as XHTML ==
 151
 152 <<WikiForm action=dumphtml>>
 153
 154 This will generate a directory of static pages suitable for
 155 distribution on disk where no web server is available. The various
 156 links for page editing functions and navigation are removed from the
 157 pages.
 158
 159 The XHTML file collection can also be downloaded as an **[[phpwiki:?action=ziphtml|XHTML ZIP Snapshot]]**.
 160
 161 ----
 162 [[CategoryActionPage]]