Date: Sun,  8 Mar 2009 10:12:36 +0000
Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
X-Rcs-Id: $Id$
Content-Type: application/x-phpwiki;
  pagename=Help%2FCreatePagePlugin;
  flags=PAGE_LOCKED;
  markup=2;
  charset=iso-8859-1
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

*s*: |
  The pagename, which will passed to the plugin. Default: ""
*initial_content*:  |
  The new page will be pre-filled with this content. Default: ""
*template*:  |
  The new page will be pre-filled with the content of this page. Default: ""
*vars*: |
  variables to be expanded. Default: ""
*overwrite*: |
  Whether to overwrite an existing page. Default: "" 

== 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 <tt>%%var%%</tt>, which will be expanded by the 
value of <tt>var</tt> given to the vars argument (in urlencoded php notation).

Some special variables are automatically assigned:

%%ctime%% | 
  $~WikiTheme->formatDateTime(time())
%%author%% | 
  $user->getId()

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

== Authors

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

== Examples

<?plugin-form CreatePage s=MyHomePage ?>

== See also
* PhpWiki:EasilyCreateNewPages
* PhpWiki:WikiFormRichPlugin
* PhpWiki:SqlResultPlugin

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