Differences

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

--- plugin:addnewpage [2023-09-25 00:25] – Document usage of new @INPUT@ placeholder to create a namespace (PR #72) dregad
+++ plugin:addnewpage [2024-02-15 21:47] (current) – Aleksandr
@@ Line 7: / Line 7: @@
 type       : syntax
 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.
@@ Line 70: / Line 73: @@
+==== 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 104: / Line 134: @@
   - **Show root namespace** (''showroot'') — Whether to show the wiki's root namespace in the namespace selection list. 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** (''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 "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? ===