Extension:AutoCreatePage

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
AutoCreatePage
Release status: beta
Implementation Parser function
Description Provides a parser function to create additional pages automatically when a page is saved
Author(s)
Latest version 0.6 (2016-10-13)
MediaWiki 1.21+
PHP 5.3+
Database changes No
License GNU General Public License 2.0 or later
Download
README
  • $egAutoCreatePageMaxRecursion
  • $egAutoCreatePageIgnoreEmptyTitle
  • $egAutoCreatePageNamespaces
Translate the AutoCreatePage extension if it is available at translatewiki.net
Check usage and version matrix.

The AutoCreatePage extension provides a parser function called "createpageifnotex" that creates a page of a given title if no such page exists yet. The function takes the page title and the wikitext that is used to create the page as its only parameters. This can be used by templates that want to create some content on separate pages, which is especially useful when creating pages with Page Forms or when using Semantic MediaWiki to create query pages (which may be too big to fit on the same page).

Usage[edit]

Documentation is found on the GitHub page of the extension. The general syntax for using the parser function is:

{{#createpageifnotex:Name of the page to create|Initial content of the page if created}}

All newly created pages will be attributed to the user who edited the page where the parser function was used. It is possible to use templates and parser functions as part of the initial content by surrounding them with <nowiki> tags. However, newly created pages can never create additional pages (this is a feature; otherwise one could accidentally create large numbers of pages, where each new page creates another one).

Installation[edit]

  • Download, extract and place the file(s) in a directory called AutoCreatePage in your extensions/ folder.

Configuration[edit]

The extension supports three configuration variables, that can be set in the "LocalSettings.php" file.

$egAutoCreatePageMaxRecursion
The maximum recursion depth to which calls of createpageifnotex are executed on created pages. Default: 1.
$egAutoCreatePageIgnoreEmptyTitle
If invocations of createpageifnotex should be silently ignored. Default: false (will put an error message on the wiki page).
$egAutoCreatePageNamespaces
The list of namespaces in which calls of createpageifnotex are executed. If your call originates from a page not in one of these namespaces, it gets ignored. Defaults to $wgContentNamespaces. An example for an alternative setting:
$egAutoCreatePageNamespaces = [
    NS_MAIN,
    NS_USER,
    NS_TEMPLATE,
    NS_CUSTOM
];

Version history[edit]

  • Version 0.6 (2016-10-13): New config variable $egAutoCreatePageNamespaces
  • Version 0.5 (2016-05-13): New config variables $egAutoCreatePageMaxRecursion and $egAutoCreatePageIgnoreEmptyTitle
  • Version 0.4 (2014-09-23): Initial release, based on previous code by Daniel Herzig (from AIFB Portal extension version 0.3).

See also[edit]