Help/UnfoldSubpagesPlugin

The UnfoldSubpages plugin is used to display all or some subpages of the current or a given page. This gives an overview for a Help:WikiBlogPlugin, Help:CalendarPlugin or similar subpages.

Warning: Don't use it with subpages with nonexistent sections! The section extractor is currently quite unstable.

Usage

<<UnfoldSubpages>>
<<UnfoldSubpages sortby=-mtime words=50 maxpages=5>>
<<UnfoldSubpages quiet=1 smalltitle=1>>
<<UnfoldSubpages sections=2 words=100>>
<<UnfoldSubpages lines=3>>
<<UnfoldSubpages pagename="PhpWikiAdministration"
                 section="Plugin Arguments" sectionhead=1>>

Arguments

All PageList arguments, plus the following ones:

Argument

Description

Default value

pagename

Any pagename or if empty the current page.

empty

quiet

Print no header.

false

sortby

Sort by + (ASC) or - (DESC) and one column.
Multiple columns like sortby="-hits,-mtime" not yet supported.
Supported columns: [+|-]pagename, [+|-]mtime, [+|-]hits.

pagename

maxpages

Maximum number of pages to include or all if not defined.

false

sections

Maximum number of sections per page to include or all if not defined.

false

section

Include this named section per page only if defined.

empty

sectionhead

When including a named section show the heading.

false

smalltitle

If set, hide transclusion-title, just have a small link at the start of the page.

false

words

Maximum number of words per page to include.

false

lines

Maximum number of lines per page to include.

false

bytes

Maximum number of bytes per page to include.

false

Deprecated Arguments

Argument

Description

pages

Deprecated. Renamed to maxpages.

sort

'asc' or 'desc'. Deprecated: use "+" or "-" before the column name with sortby.

Example

<<UnfoldSubpages pagename=Help maxpages=5 >>

Included from Help/ActionPage

The term ActionPage refers to a page containing a plugin invocation with the same or translated pluginname as the pagename. An action is together with the pagename argument the basic PhpWiki argument. It can both be GET or POST actions. Actions are untranslated, always English, pagenames can be localized. Basic (and old) actions are all lowercase, like edit, browse, remove, ... Newer actions in CamelCase are invoked via plugins on their specific action page.

We decoupled actions from plugins via action pages for the following reasons:

  1. Support translated action buttons and customizable action descriptions.
  2. Customize standard actions by tuning the plugin invocation arguments. Override or add plugin defaults.
  3. Split simple plugins into multiple actions, like RecentChanges/RecentEdits, MostPopular/LeastPopular, AllPages/AllPagesCreatedByMe/AllPagesLastEditedByMe/ AllPagesOwnedByMe which differ only in one argument.
  4. Simplify the syntax for actions on another actions using a PageList as result of an actionpage as input parameter for another action or format.
  • Those actions which have buttons or links in the theme or are referenced in the standard pgsrc pageset require their (possibly localized) actionpages, otherwise the actions will not work.
  • If the localized actionpage is not found the english version is used.
  • If no actionpage is found, it is recommended to do action=upgrade, which imports all missing and required action pages into the database.

So for a hypothetical new MyActionPage plugin MyActionPage will invoke the plugin and Help:MyActionPagePlugin should be the description page.

Existing Plugins

See PluginManager for a detailed list. Most plugins should have their own description page as subpage of Help/ with the name Plugin appended. PhpWikiDocumentation

Included from Help/AddCommentPlugin

The AddComment plugin lets users attach comments to the end of a page. Change the layout via the templates comment.tmpl and addcomment.tmpl, and the CSS classes wikicomment, wikicomment-header, wikicomment-body, wikicomment-footer.

Usage

<<AddComment order||=normal jshide||=0 mode||=show,add noheader||=0>>

Arguments

Argument

Description

Default value

jshide

Boolean. If true, the comments and/or textbox should be initially hidden and on click expanded.

false

order

List comments in chronological (order=normal) or reverse order (order=reverse).

normal

mode

List of “add” and/or “show”.

add,show

noheader

Boolean. If true, the “Comments” header should be omitted.

false

pagename

Attach to which page?

current pagename

Known Problems

  • jshide does not work yet. Not very well tested.

Examples

Comments

Included from Help/AddingPages

To add a new page to the wiki, all you have to do is come up with a meaningful title and put it between [[double brackets]].

Then you can go ahead and click the question mark at the end of your new hyperlink, and the Wiki will give you a window for making the new page.

The page name can contain any character, except:

  • angle brackets (<>),
  • square brackets ([]),
  • curly brackets ({}),
  • double quotes ("),
  • pipe (|),
  • and hash sign (#) that is used for anchors.

If you wish to add documents with complex markup to the wiki, you might be better off providing a URL to it than trying to add the text of the document here, like so:

[[http://phpwiki.sourceforge.net/|PhpWiki project homepage]]

PhpWiki project homepage

The Wiki does not support most HTML tags, only the simplest. See TextFormattingRules. <tags>They will just render like text.</tags> Wiki is meant to be as simple as possible to encourage use.

Note that there is a feature that your system administrator can enable to allow embedded HTML, but there are security risks involved.

Included from Help/Adobe Flash

You can easily insert Adobe Flash (.swf) files in the wiki.

Uploading Flash files

First, Flash files need to be uploaded in the wiki. For that purpose, you will use the UpLoad plugin.

Syntax

You give access to the uploaded Flash files with the following syntax.

{{myflash.swf}}

or

[[Upload:myflash.swf]]

will inline the image.

Options

Using the Upload: syntax, options are allowed to change the appearance:

[[Upload:myflash.png size=40x25 align=center]]

Separate options by spaces. The allowed options are the following:

  • size: width "x" height or num + "%"
  • align: string
  • border: number
  • hspace: number
  • vspace: number

Examples

Wikicreole syntax

{{ora.swf}}

Plugin Template failed. Page “Help/Adobe Flash/themes/Sidebar/ora.swf” does not exist.

Upload syntax

[[Upload:ora.swf]]
[[Upload:ora.swf size=50x50]]

URL syntax

[[http://www.qasia.com/games/mahjong.swf]]

http://www.qasia.com/games/mahjong.swf

See Also

Included from Help/Advice for Mediawiki users

If you contribute to Wikipedia or to other wikis that use the Mediawiki software, you will notice some differences in the wiki syntax of Mediawiki and the wiki syntax of Phpwiki.

Syntax differences

Here are some differences between Mediawiki and Phpwiki:

  • Italics are // (but you can also use '' like in Wikipedia)
  • Bold is ** (you cannot use ''' like in Wikipedia)
  • Line break is \\ in Wikicreole, <br /> in Mediawiki
  • There is no automatic capitalisation of first character of page name. Pages [[foo]] and [[Foo]] are different.
  • A space in a page name in not equivalent to an underscore. Pages [[foo bar]] and [[foo_bar]] are different. We recommend to use a space in the page names.
  • Many things that are built-in in Mediawiki use plugins in Phpwiki (table of contents, redirections, back links, etc.).
  • Redirections are less sophisticated in Phpwiki (e.g. backlinks do not show redirected pages)

Tables

You can use the Mediawiki table syntax.

Included from Help/AllPagesPlugin

The AllPages plugin lists all pages in this wiki.

Usage

<<AllPages arguments>>

Arguments

All PageList arguments, plus the following ones:

Argument

Description

Default value

noheader

Boolean. If true, header should be omitted.

false

include_empty

Boolean. If true, pages that are referenced but not yet created are included in the list.

false

info

Allows multiple columns: info=mtime,hits,summary,version,author,locked,minor or all

none

userpages

Boolean. If true, display only pages created by users (not the ones created at initialisation of the wiki).

false

Example

<<AllPages limit=20 cols=3>>

All pages in this wiki (861 total):

|<<   << - 1 / 44 - Next >>   >>|

Author

See Also

See Also