locale/it/pgsrc/Aiuto%2FMagicPhpWikiURLs

   1 Date: Tue,  4 Jan 2011 11:58:08 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Aiuto%2FMagicPhpWikiURLs;
   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