Widget:ArticleSpawner/doc

{{#widget: ArticleSpawner}} creates a form or button that preloads wikitext from preload templates into the edit window of a new page, and populates the preload template with custom content. This extends (and potentially replaces) the functionality of the InputBox-driven Template:Tl template.

Usage

{{#widget: ArticleSpawner
| type      = 
| summary   = 
| title     = 
| showtitle = 

| param.A Key       = 
| param.Another Key = 
...

| hiddenparam = 
| hiddenparam =
...

| submit = 
}}

All fields are optional.

type (optional)

Hidden parameter that defines the preload templates to load into the edit window and content above it. Default is blank.

See Template:Tl for details on PathfinderWiki preload templates and content.

summary (optional)

Hidden parameter that sets the text to preload in the editing tool's summary field. Default is blank.

title (optional)

Name of the article to edit or create. Default is blank.

If you enter a title value and showtitle is not passed, this parameter's value fills the ArticleSpawner form's "Article Title" field.

If you enter a title value and showtitle is Template:Xt, the value is passed as a hidden parameter; there's no Article Title field, and clicking Submit creates the article using this value as the title.

showtitle (optional)

If Template:Xt, hides the Article Title field. Set to Template:Xt to create a standalone ArticleSpawner button.

param.(key name) (optional; can declare multiple times)

Creates a form field with the Template:Xt as the field's label and fills the field with the parameter's value. The value can be blank; if you don't pass a key name, it defaults to an integer.

All params are declared in the order you pass them, but before any hiddenparams regardless of the order they appear in the template—this is important as the preload template applies values in sequential order, so Template:Xt on the preload template is the first param declared in the widget, Template:Xt is the second, etc., and then the first hiddenparam declared in the widget follows in the preload template's numeric sequence.

hiddenparam (optional; can declare multiple times)

Passes a value as a preload parameter without creating a form field.

submit (optional)

Changes the text that appears on the submit button. Default is Template:Xt.

Example

No parameters

{{#widget: ArticleSpawner}}

{{#widget: ArticleSpawner}}

An ArticleSpawner widget with no parameters displays an Article Title field and Submit button; filling the field and clicking submit is equivalent to clicking a link for an article with the same title.

Basic parameters

{{#widget: ArticleSpawner
| title     = Squealy Nord
| submit    = Create an article
}}

{{#widget: ArticleSpawner | title = Squealy Nord | submit = Create an article }}

You can fill the Article Title field and Submit button with custom text. Note that the user can still edit the title.

Button with no fields

{{#widget: ArticleSpawner
| title     = Squealy Nord
| showtitle = no
| submit    = Create the "Squealy Nord" article now!
| summary   = Finally created the Squealy Nord article
}}

{{#widget: ArticleSpawner | title = Squealy Nord | showtitle = no | submit = Create the "Squealy Nord" article now! | summary = Finally created the Squealy Nord article }}

This button creates an article using Squealy Nord as the tile, and fills in the edit summary.

Preload template

{{#widget: ArticleSpawner
| type    = Biography
| summary = New real-world person article
| submit  = New biography
}}

{{#widget: ArticleSpawner | type = Biography | summary = New real-world person article | submit = New biography }}

When the user fills in a title and clicks the "New biography" button, it takes them to the article page, applies the Template:Tl preload template to the edit box, and displays the Template:Tl content above the edit box.

Parameterized preload template

{{#widget: ArticleSpawner
| type        = Biography
| summary     = New real-world freelancer article

| param.Name          = 
| param.Navbox target = freelance
| param.Role category = [[Category:Authors]]

| hiddenparam = [[Category:Freelance contributors]]
| hiddenparam = Freelancer

| submit = New biography
}}

{{#widget: ArticleSpawner | type = Biography | summary = New real-world freelancer article

| param.Name = | param.Navbox target = freelance | param.Role category =

| hiddenparam = | hiddenparam = Freelancer

| submit = Freelancer biography }}

For preload templates with preload parameters (Template:Xt, Template:Xt, Template:Xt, etc.), clicking the "Freelancer biography" button opens the article page, preloads the Template:Tl template and fills the preload parameters with the param and hiddenparam values in order (param.Name replaces Template:Xt, param.Navbox target replaces Template:Xt, param.Role category replaces Template:Xt, the first hiddenparam replaces Template:Xt, etc.), and displays the Template:Tl content above the edit box.

Note that if the hiddenparams were placed before the params, they would not be applied before the params. The widget processes all params in order first, then all hiddenparams in order.

TODO

• Handle labels more semantically.
• Allow for dropdown options.
• Provide field validation options.
• Relax param/hiddenparam ordering.