uniwiki

...discover TWiki details, and how to start your own site.

BlogUp: a twiki based weblog setup

Note: The BlogUp application is part of the BlogPlugin.

Introduction

BlogUp is a TWikiApplication addon package that turns TWiki into a weblog tool. In combination with the NatSkin it offers the look & feel of well known blogging tools like MovableType or WordPress but embedded into a full-fledged wiki.

The main features are:

  • single- or multi-author blogging
  • one-click easy publishing and correction of postings and comments
  • extensible tagging system
  • tagged news aggregation
  • semi-automatic computation of "related" postings
  • threaded comment system
  • full content syndication
  • flexible archiving and retrieval
  • tag statistics
  • completely form-based TWikiApplication using the TWikiWorkbench approach

Screenshots

BlogPluginSnap11.jpg BlogPluginSnap8.jpg BlogPluginSnap6.jpg BlogPluginSnap12.jpg
Implementation level showing one TopicFunction . Implementation level showing list of TopicTypes . BlogAuthors tools in sidebar . Customized WebSearch showing headlines and teasers .
BlogPluginSnap9.jpg BlogPluginSnap15.jpg BlogPluginSnap7.jpg BlogPluginSnap14.jpg
Monthly BlogArchive and statistics . Editing a posting . Implementation level showing list of TopicFunctions . Editing a BlogLink .
BlogPluginSnap4.jpg BlogPluginSnap2.jpg BlogPluginSnap13.jpg BlogPluginSnap5.jpg
BlogEntry, sidebar links to related entries . FrontPage (MovableType style) . Editing a BlogEntry . NewsReader based on HeadlinesPlugin .
BlogPluginSnap1.jpg BlogPluginSnap3.jpg BlogPluginSnap10.jpg  
FrontPage (Wordpress style) . BlogSideBar on FrontPage showing the Archive, Categories and Blogroll . Administrative level showing list of SubjectCategories .  

Getting started

To create a blog use the BlogFactory. Note, however, that only members of the TWikiAdminGroup are allowed to create a new blog. After entering the mandatory information you will get a new web that is a copy of the _BlogPlugin template web.

User Manual

TODO The BlogUp TWikiApplication is made up of tree levels that are of use depending on the role of the visitor.
  1. application level: that's the view a normal visitor gets on the site
  2. blog author level: grant access to tools needed to post a blog entry or add new SubjectCategories?
  3. administrative level: grant access to TopicFunctions that render the site

Roles are assigned using TWikiGroups, i.e. the BlogAuthorGroup? and the BlogAdminGroup. Each blog is contained in one web; one blog can be a multi-author or single-author blog. A multi-author blog will display authorship per posting, not so a single-author blog.

Exploring the blog

TODO

Publishing a new blog entry

TODO

Adding a new SubjectCategory?

TODO

Aggregating news

TODO

Commenting

TODO

Implementation

The BlogUp is implemented using the TWikiWorkbench approach consisting (at least) of a set of TopicTypes, TopicFunctions, TWikiForms and TopicTemplates that are used to implement the application.

TopicTypes

Each topic is typed using TWikiForms, that is TWikiForms define TopicTypes. A TopicType form has a token and a free-form TopicDescription? that describes the purpose of an instance of that type.

In general a TopicType is made up of three parts:

  1. the TopicType topic named XXX
  2. the TWikiForm topic named XXXForm
  3. the TopicTemplate topic named XXXTemplate

The XXX TopicType topic lists an overview of all topics of the given type and a form to create a new one.

Name Description
TopicForm TopicType of a tagged TWikiTopic
TopicForm TopicType to create blog entries
TopicForm TopicType of a normal TWiki topic
TopicForm TopicType and TWikiFormAttribute that describes BlogEntry categories
TopicForm TopicType that links to another news or blog site.
TopicForm TopicType for user comments
TopicForm TopicType used in BlogEntryForm to collect all BlogEntries of one author
TopicForm TopicType of topics to be called by a (parameterized) INCLUDE or DBCALL
TopicForm TopicType of all possible TopicTypes in the _BlogPlugin web
TopicForm TopicType for topics on the administrative level
TopicForm TopicType for an attribute description of a TWikiForm
TopicForm TopicType used to create topics of the associated type
TopicForm TopicType of pages that display a (sub)set of BlogEntries
TopicForm TopicType of TWiki.TWikiForms
TopicForm TopicType of topics that implement a TMPL template to view topics

TopicFunctions

TopicFunctions are the basic building blocks that are used to render the application. TopicFunctions are divided into sections that are extracted using parametrized INCLUDEs. (Note, that the BlogPlugin does not use INCLUDE or SEARCH but DBCALL and DBQUERY provided by the DBCachePlugin.) Thereby TopicFunctions are "called" as functions in a library are called to be executed. Every TopicFunction is named RenderXXX where XXX describes the output generated by it. A TopicFunction is also documenting itself and its parameters.

Name Description
TopicForm Render a single BlogEntry
TopicForm Renders the BlogArchive in TAG mode
TopicForm Renders a list of TWikiForms that use a given TWikiFormAttribute
TopicForm Render a topic summary for a search hit
TopicForm Renders a set of BlogEntry teasers in a SubjectCategory
TopicForm Render the list of SubjectCategories in the sidebar
TopicForm Render a list of all months that have postings.
TopicForm Render an RSS feed
TopicForm Render a tools sidebar section displayed when using PatternbSkin
TopicForm Render a list of tracks you currently listen to
TopicForm Render a list of related BlogEntries for the BlogEntry sidebar
TopicForm Render the PAGETITLE for items in this application
TopicForm Render list of TopicTypes
TopicForm Render google adsense banner
TopicForm Render a teaser for a BlogEntry
TopicForm Render list of backlings to the BlogImages
TopicForm Render a set of postings to leaf through
TopicForm Render the search result in the BlogArchive
TopicForm Render a list of topics that use a given TopicFunction
TopicForm Render the list of recent comments in the WebSideBar
TopicForm Compute the next comment nr given a current BlogEntry or BlogComment
TopicForm Render all BlogEntries of a BlogAuthor as teaser.
TopicForm Replacement for TWiki's default WebChanges
TopicForm Renders all comments of a BlogEntry
TopicForm Render the header of a BlogPage
TopicForm Render a BlogEntry for a FrontPage
TopicForm Render a set of links to alternative formats for the current html page
TopicForm Render all BlogComments recursively
TopicForm Render a set of teasers
TopicForm Renders a BlogLink
TopicForm Display section of affiiations in the sidebar
TopicForm Renders the BlogArchive in CHRON mode
TopicForm Render a single BlogComment
TopicForm Renders the BlogArchive
TopicForm Render a form to post a BlogComment
TopicForm Render a technorati include
TopicForm Renders a list of BlogPages put into the sidebar
TopicForm Render the sidebar navigation
TopicForm Render list of all BlogLinks of a given SubjectCategory
TopicForm Renders the BlogArchive in CAT mode
TopicForm Render the list of BlogAuthors in the sidebar
TopicForm Render the list of recent postings in the WebSideBar
TopicForm Implements a formatted metadatasearch
TopicForm Render the visitors for the sidebar
TopicForm Render rss an feed
TopicForm Renders the BlogArchive in CAT mode
TopicForm Render a double linked list to previous and next documents
TopicForm TopicFunction to display your blog's license.
TopicForm Render the list of BlogLinks in the sidebar
TopicForm Render a navigation to previous/next blog entries on the FrontPage

TWikiForms

TODO

Name Description
TopicForm TWikiForm for SubjectCategories
TopicForm TWikiForm for BlogEntries
TopicForm TWikiForm attached to general TWikiTopics
TopicForm TWikiForm for BlogPages
TopicForm TWikiForm for BlogLinks
TopicForm TWikiForm for BlogAuthors
TopicForm TWikiForm for BlogComments

TopicTemplates

TODO

Name Description
TopicForm Template to create a TopicTemplate
TopicForm Template for BlogComments
TopicForm Template to create an BlogLink
TopicForm Template to create TopicViews
TopicForm Template to create TopicTypes
TopicForm Template to create an AdminTool
TopicForm Generic template for topics in the _BlogPlugin web
TopicForm Template to create SubjectCategories
TopicForm Template to create TopicFunctions
TopicForm Template to create TWikiForm topics
TopicForm Template to create BlogPages
TopicForm Template to create TWikiFormAttributes
TopicForm Template to create BlogAuthors
TopicForm Template to create BlogEntries

Customization

TODO

See also: BlogPlugin, BlogUp template web

Application Info

Author: TWiki:Main/MichaelDaum
Copyright ©: 2006, Michael Daum
License: GPL (GNU General Public License)
Version: v0.47
Dependencies: BlogPlugin
Change History: (see also the change history of the BlogPlugin)
24 Jan 2006: Initial version
Demo: http://jojowiki.dyndns.org
Home: TWiki:Plugins/BlogUp
Feedback: TWiki:Plugins/BlogPlugin
Appraisal: TWiki:Plugins/BlogPluginAppraisal

-- TWiki:Main/MichaelDaum - 08 Feb 2006

Navigation

MySideBar

Create your personalized sidebar.
r1 - 31 Aug 2006 - 08:09:45 - TWikiGuest
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.BlogUp
Syndicate this site RSSATOM