====== FKN-Blog ======


Rund um das FKN-Land.


====== Gallery-Test ======
{{gallery>:fkn-blog ?100x100&crop&lightbox}}

====== Blog-Test ======

{{tag>fkn-blog blog demo}}


{{blog>[FKN-Blog]}}


{{archive>[FKN-Blog]}}




=== Blog ===

  {{blog>[namespace]?[number]&[flags]}}

^ [namespace] | namespace for the blog; subspaces will be searched as well; ''*'' is the whole wiki, ''.'' is the same namespace as the page lies in  | optional; default is the blog namespace set in the configuration |
^ [number] | number of entries to show per page | optional; default is 5 |
^ [flags] | flags are delimited by ''&'' | |
^     ::: | all [[include#configuration_and_flags|Include plugin flags]] are supported | optional |
^     ::: | Form placement: ''topform''/''bottomform''/''noform'' | optional, default is ''topform'' |
^     ::: | Custom new-entry form title: ''newentrytitle=Custom title'' | optional, can also be set as a [[#configuration_and_settings|configuration option]] |

This includes a specified number of most recent blog entries from the given namespace into the current page. Below the entries a link to the page (permalink), the author, the creation date and the number of comments are shown. Link, author, date and comments info can be hidden. At the end of the blog a link to older entries lets you navigate in the history of the blog. At the very end, if you have enough rights to create new pages, a form for new blog entries is displayed.


=== Archive ===

  {{archive>[namespace]?[month]&[flags]}}

^ [namespace] | the namespace for which you want an archive list; ''*'' is the whole wiki, ''.'' is the same namespace as the page lies in | optional; default is the namespace specified in the configuration |
^ [month] | the month for the archive list in YYYY-MM format; ''*'' for all pages | required |
^ [flags] | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optional |

Shows a table with all pages of the given namespace that were created in the specified month.

  {{autoarchive>[namespace]}}

Creates an automatic archive.

===== Configuration and Settings =====
The blog plugin can be configured using the DokuWiki configuration manager available in the admin menu.

^ ''namespace'' | The default namespace which is used if no namespace was given in the syntax |
^ ''formposition'' | You can choose to display the new entry form either above or below the blog entries |
^ ''newentrytitle'' | Set a custom title for all new entry forms.  This can also be set on individual blog forms. |
^ ''dateprefix'' | A date prefix that automatically gets added to pages created with the new entry form. You can use the options from the [[phpnet>strftime]] PHP function; namespace separators work as well, e.g. ''%Y:%m%d'' |
^ ''sortkey'' | Defines how the blog entries are sorted. Available options are creation date, modification date, page name, page ID and page title (first headline) |
^ ''sortorder'' | Sort the blog entries ascending/descending |
^ ''showhistogram'' | Display a histogram in normal archive mode (not for autoarchive) |

===== Changes =====

  * **2013-10-20**: Translation updates, fix cache handling for empty blog listings
  * **2013-03-27**: Better cache handling for the archive syntax
    * the syntax that lists everything till now correctly updates the cache now whenever a page is changed or a comment or linkback is added.
    * the cache is not used anymore when it contains an archive listing with a page that the current user can't access. The excluded pages won't be included again automatically unless the cache expires for other reasons, the ''%%~~NOCACHE~~%%'' macro can be used if this is needed.





~~LINKBACK~~
~~DISCUSSION~~