Date: Fri, 10 Sep 2010 13:46:13 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
X-Rcs-Id: $Id: Help%2FCreatePagePlugin 7682 2010-09-10 12:03:36Z vargenau $
Content-Type: application/x-phpwiki;
  pagename=Help%2FCreatePagePlugin;
  flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
  markup=2;
  charset=UTF-8
Content-Transfer-Encoding: binary

The **~CreatePage** [[Help:WikiPlugin|plugin]] allows to easily create new pages, optionally with default content.

This allows you to create a page geting the new pagename from a
forms-based interface, and optionally with the initial content from
some template.

Put a {{{<?plugin-form CreatePage ?>}}} at some page, browse this page,
enter the name of the page to create, then click the button.

== Usage ==

{{{
<?plugin-form CreatePage ?>
<?plugin-form CreatePage template=CategoryHomePage ?>
<?plugin-form CreatePage template=SomeTemplatePage vars="year=2004&name=None" ?>
}}}

== Arguments ==

{| class="bordered"
|-
! Argument
! Description
! Default value
|-
| **s**
| The pagename, which will passed to the plugin.
|
|-
| **initial_content**
| The new page will be pre-filled with this content.
|
|-
| **template**
| The new page will be pre-filled with the content of this page.
|
|-
| **vars**
| Variables to be expanded.
|
|-
| **overwrite**
| Whether to overwrite an existing page.
|
|}

== Variable Expansion ==

The content (either initial_content or template) might hold some variables, which will be
expanded on creation. Unassigned variables will stay as %%<var>%%, assigned variables without
matching %%<var>%% placeholder will be ignored, without any warning.

A variable in a template is denoted as ##%%var%%##, which will be expanded by the
value of ##var## given to the vars argument (in urlencoded php notation).

Some special variables are automatically assigned:
{| class="bordered"
|-
| %%ctime%%  || $~WikiTheme->formatDateTime(time())
|-
| %%author%% || $user->getId()
|}

This forms together with page templates and the [[Help:WikiFormRichPlugin]] and
optionally the [[Help:SqlResultPlugin]] a framework to create templated pages.

== Authors ==
* Dan Frankowski
* [[PhpWiki:ReiniUrban|Reini Urban]]

== Examples ==

{{{
<?plugin-form CreatePage s=MyHomePage ?>
}}}
<?plugin-form CreatePage s=MyHomePage ?>

== See Also ==
* [[PhpWiki:EasilyCreateNewPages]]
* [[Help:WikiFormRichPlugin]]
* [[Help:SqlResultPlugin]]

<noinclude>
----
[[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
</noinclude>
