Differences

This shows you the differences between two versions of the page.

--- plugin:addnewpage [2023-05-07 16:20] – Updated history with information found in the README dregad
+++ plugin:addnewpage [2024-02-15 21:47] (current) – Aleksandr
@@ Line 6: / Line 6: @@
 email      : dregad@mantisbt.org
 type       : syntax
-lastupdate : 2015-11-02
+lastupdate : 2023-05-10
-compatible : Jack Jackrum+, Igor, Hogfather, Greebo, Frusterick Manners, Elenor of Tsort, Detritus, Hrun, Ponder Stibbons, Adora Belle, Angua, Rincewind
+compatible : Rincewind, Angua, Adora Belle, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum, Kaos
 depends    :
 conflicts  :
 similar    : new_page_dialog, npd, catlist
 tags       : button, form, create
-screenshot_img: :plugin:addnewpage_ns_nothidden.png
 downloadurl: https://github.com/dregad/dokuwiki-plugin-addnewpage/zipball/master
 bugtracker : https://github.com/dregad/dokuwiki-plugin-addnewpage/issues
 sourcerepo : https://github.com/dregad/dokuwiki-plugin-addnewpage
+donationurl: https://github.com/sponsors/dregad
+screenshot_img: :plugin:addnewpage_ns_nothidden.png
 ----
@@ Line 26: / Line 29: @@
 This plugin allows you to add new-page forms to wiki pages, so that users can simply enter the title of a new page and go straight to the editing form (rather than first creating a link to the page, or typing the URL directly).
-The target namespace for the new page can either be selected from a drop-down list in the new-page form, or specified in the form [[#syntax|syntax]]. Only namespaces to which the user is permitted to write are shown.
+The target namespace for the new page can either be selected from a drop-down list in the new-page form, or specified in the form [[#syntax]]. Only namespaces to which the user is permitted to write are shown.
+The plugin can pair with the [[plugin:newpagetemplate|newpagetemplate Plugin]] to start with a predefined template instead of an empty page.
 The form submit button is disabled if there is no text in the title field.
@@ Line 58: / Line 63: @@
 This is configured in the main wiki configuration manager.
 If ''@PAGE@'' (or ''@NS@'') is given, the current page ID (or its namespace) will be used (e.g. for use in [[:namespace templates]]; see below).
+==== Creating a namespace ====
+It is possible to use the ''@INPUT@'' placeholder to reference the user's input in the namespace specification. For example,
+  {{NEWPAGE>foo:@INPUT@:start}}
+will create a new namespace within the //foo// namespace.
+==== Date/time-based naming ====
+The plugin supports usage of [[https://www.php.net/manual/en/function.strftime.php|strftime placeholders]] in the namespace config. This allows adding date elements to the namespace specification
+  {{NEWPAGE>project:notes:@INPUT@_%Y-%m-%d}}
+  {{NEWPAGE>reports:%Y:week_%W}}
+When used together with the [[#configuration_and_settings|autopage]] option to hide the input field, a daily page can be created with a single button click:
+  {{NEWPAGE>journal:%Y-%m-%d?autopage}}
+==== Configuration overrides ====
+It is possible to override the plugin's [[#configuration_and_settings|configuration]] for a single usage of the syntax, by specifying a ''?'' followed by the config's name with an optional ''no'' prefix to negate it. Values for non-boolean configs can be provided with ''='', separated by '';''. Multiple overrides can be given, separated by '','' or ''&''.
+General syntax:
+  ?[no]<option_1>[=value_1[;value_2]...][,[no]<option_2>]...
+Examples:
+  * overwrite the default hide setting <code>
+{{NEWPAGE>namespace?nohide}}
+</code>
+  * custom namespace exclusion and hide root <code>
+{{NEWPAGE>namespace?exclude=project;reports&noshowroot}}
+</code>
 ==== New-page templates ====
-This plugin is also compatible with the [[:plugin:newpagetemplate|New Page Template]] plugin (note that this is a separate feature to the [[#namespace templates]] described below). To specify a template to be used with the new page, use one of the following syntaxes:
+This plugin is also compatible with the [[:plugin:newpagetemplate|newpagetemplate plugin]] (note that this is a separate feature to the [[#namespace templates]] described below). To specify a template to be used with the new page, use one of the following syntaxes:
 | ''%%{{NEWPAGE#newtpl}}%%'' | Use the ''newtpl'' template |
@@ Line 89: / Line 131: @@
 You can configure the plugin in the Config Manager of DokuWiki. There are four settings:
-  - **Excluded namespaces** — A semicolon-separated list of namespaces that should be excluded from the namespace selection list. Default: ''wiki;playground''.
+  - **Excluded namespaces** (''exclude'') — A semicolon-separated list of namespaces that should be excluded from the namespace selection list. Default: ''wiki;playground''.
-  - **Show root namespace** — Whether to show the wiki's root namespace in the namespace selection list. Default: true.
+  - **Show root namespace** (''showroot'') — Whether to show the wiki's root namespace in the namespace selection list. Default: true.
-  - **Hide namespace selection** — Hide the namespace selection list. Only applies if a namespace is given (see [[#syntax|above]]). Default: true.
+  - **Hide namespace selection** (''hide'') — Hide the namespace selection list. Only applies if a namespace is given (see [[#syntax|above]]). Default: true.
-  - **Hide "access denied" message** — Do not show the "You are not allowed to add pages" message when the user doesn't have permission to create pages. Default: false (i.e. do show the message)..
+  - **Hide "access denied" message** (''hideACL'') — Do not show the "You are not allowed to add pages" message when the user doesn't have permission to create pages. Default: false (i.e. do show the message).
+  - **Hide the input box** (''autopage'') — The preconfigured namespace is treated as a full page ID. Use with [[#date_time-based_naming|date placeholders]]). Default: false.
 =====FAQ=====
+=== Why is a privileged user not allowed to add pages? ===
+Logged in as administrator, why do I get a //You are not allowed to add pages// error message ?
+> This is a [[https://github.com/dregad/dokuwiki-plugin-addnewpage/issues/38|known problem]], caused by caching. As a workaround, add ''%%~~NOCACHE~~%%'' to the page that contains the form.
 === Addnewpage form on the admin page? ===