Blog Plugin

blog plugin by Gina Häußge, Michael Klier
Use DokuWiki as blogging tool. (previous authors: Esther Brunner)

Last updated on 2008-04-20. Provides Syntax, Helper, Action.
Compatible with DokuWiki 2006-11-06, rc2008-03-31.

Requires feed, include, pagelist.
Similar to bliki, content.

Tagged with blog, blogging, news.

Download plugin-blog.tgz (up to Dokuwiki 2007-06-26b)
plugin-blog.tgz (Dokuwiki rc2008-03-31 and above)
BundleHub Configure your own DokuWiki blogsuite install package, consisting of all mandatory plugins plus any optional features you want to include:
BlogSuite BundleHub

Description

The Blog Plugin makes blogs in your wiki easily possible. The blog component shows the latest entries (pages) from a namespace in reverse chronological order. In this new version, the creation date is the sort key – no longer the date of the last non-minor modification as in previous versions. The archive component lists all entries that were written (created) in the given month.

This plugin is the successor of the blog and archive components of the old Blog Plugin. It's therefore incompatible with it.

If you use this plugin for blogging you might want to join Planet DokuWiki.

Configuration

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
dateprefix A date prefix that automatically gets added to pages created with the new entry form. You can use the options from the strftime php function, namespace separators work as well ie. %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

Components

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] include flags delimited by &, see flags optional

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 flags optional

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

Demo

You can try this plugin here.

Bugs

Please report bugs at the Bug tracker.

Further Resources

wantedpages.php bug fix

If you get

ornellas@pound:~/ornellas.apanela.com/dokuwiki$ php bin/wantedpages.php

Fatal error: Call to undefined function  auth_quickaclcheck() in /home/.karamazov/ornellas/ornellas.apanela.com/dokuwiki/lib/plugins/blog/helper.php on line 84
ornellas@pound:~/ornellas.apanela.com/dokuwiki$

Edit lib/plugins/blog/helper.php and after if (!defined('DOKU_INC')) die(); add the line:

require_once(DOKU_INC.'inc/auth.php');

This should solve the issue.

Discussion

  • Does this plugin still require other plugins? (include, pagelist). I think the answer is yes. Yes, confirmed.
  • After I upgraded dokuwiki version all of the blog dates are set to today. Can this be fixed?
    • Try to upgrade the dependent plugins as well (notably include and pagelist). Does this help?
  • I read on tag page, that plugin:blog contains its functionality, but I do not see any instructions how to use tags here. The way as it is described on the tag page it does not work for me.
  • This is not the fact, I removed the line from the blog tag plugin page. You have to install the tag plugin to be able to use it.
  • Is there any way to make links in the tittle of every post (something similar to “Read more”)?.
  • Are scheduled entries possible? I would like to have something like “Publish this entry in 3 days”. Is there a way to have this function with the blog plugin?
  • The Demo link is currently broken FIXME 110508

a category component?

I don't where to post this, since it's just like a whole new feature. It still depend on the plugins like the blog plugin suite, so I post it here.

I would like to name it “category”, the feature is showing the pages like the blog plugin(using plugin:include), but not base on namespace. It base on something like tag(or using the plugin:tag also).

So the syntax is like below(and maybe using the same flags as plugin:include), which shows the pages tag music.;-)

{{category>music}}
 
plugin/blog.txt · Last modified: 2008/05/15 19:14 by reder
 
Imprint Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
WikiForumIRCBugsTranslate