locale/it/pgsrc/MagicPhpWikiURLs

   1 Date: Fri, 10 Sep 2010 13:48:47 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=MagicPhpWikiURLs;
   6   flags=PAGE_LOCKED;
   7   charset=utf-8
   8 Content-Transfer-Encoding: binary
   9
  10 == About phpwiki: URLs
  11
  12 A special type of URL is available for making links to perform
  13 administrative and other special functions in PhpWiki.  Here is a
  14 brief description of how they work.
  15
  16 The basic syntax of a phpwiki: URL is
  17   __phpwiki:__''pagename''__?__''query-args''
  18
  19 If ''pagename'' is omitted it defaults to the current page.
  20
  21 ''Query-args'' should be a set of parameters in standard
  22 HTTP GET format.
  23
  24 The "action=''x''" parameter should almost always be given.  It can be one of
  25 __browse__, __info__, __diff__, __search__, __edit__,
  26 __zip__, __dumpserial__, __loadserial__,
  27 __remove__, __lock__, __unlock__,
  28 __login__, __logout__, __setprefs__ or __save__.
  29 The default action is __browse__.
  30
  31 Some of the actions accept other parameters.
  32
  33 ;__info__: Accepts __showpagesource__.
  34 ;__search__: Accepts __searchterm__, and __searchtype__.
  35 ;__edit__: Accepts __version__.
  36 ;__remove__: Accepts __verify__.
  37 ;__save__: Accepts __editversion__, __minor_edit__, and  __content__.
  38 ;__setprefs__: Accepts __edit_area_width__, __edit_area_height__.
  39
  40
  41 === Writing Magic Links in Wiki Pages
  42
  43 A magic link looks like:
  44
  45   __[[__ ''text'' __|__ ''phpwiki-url'' __]__
  46
  47 The "''text'' __|__" is optional but usually recommended.
  48 If given it will provide the label for the link.
  49
  50 The ''phpwiki-url'' is a __phpwiki:__ URL as described above.
  51
  52 ==== Some examples
  53
  54   [[ Edit the !SandBox | phpwiki:!SandBox?action=edit ]
  55 will generate a link which will take you directly to editing the SandBox, like so:
  56 [ Edit the SandBox | phpwiki:SandBox?action=edit ].
  57
  58 Other possibilites:
  59 * [ Diff the SandBox | phpwiki:SandBox?action=diff ],
  60 * [ Lock the HomePage | phpwiki:HomePage?action=lock ],
  61 * [ Get a Full Zip Dump | phpwiki:?action=zip&include=all ],
  62 * [ Page titles containing 'wiki' | phpwiki:TitleSearch?s=wiki ],
  63
  64 === Writing Magic Forms in Wiki Pages
  65
  66 ''__Note__: Magic forms are on their way out, I think.  They are being superceded by <''''?plugin-form>s.''
  67
  68 If one of the ''query-args'' has a value like
  69   ''arg''__=__''opt-width''__(__''opt-dflt-val''__)__
  70 the link will be rendered as a form, rather than as an anchor.
  71
  72 ''Opt-width'', if given specifies the size of the input area, while
  73 ''opt-dflt-val'' specifies the default value for the input.
  74 If ''text'' is given in the link, then a submit-button with that
  75 label will be included in the form, otherwise the submit button
  76 will be omitted.
  77
  78 Examples:
  79
  80   [[ Full Search | phpwiki:FullTextSearch?s=() ]
  81 gives
  82 [ Full Search | phpwiki:FullTextSearch?s=() ]
  83
  84 While
  85   [[ phpwiki:TitleSearch?s=12() ]
  86 yields
  87 [ phpwiki:TitleSearch?s=12() ]
  88
  89 Other examples:
  90 [ Browse Page | phpwiki:?action=browse&pagename=() ]
  91 ----
  92 PhpWikiDocumentation