CompleteDocumentation
Complete documentation for the BlogApp

28 January 2025 - 14:54 | Version 1 |
Version: 6.1
Author: Michael Daum
Copyright: © 2005-2025 Michael Daum
License: GNU General Public License, version 2
Dependencies: ClassificationApp

Description

Documentation

Type Hierarchy

G BlogEntry Blog Entry ClassifiedControlledTopic ClassifiedControlledTopic ClassifiedControlledTopic->BlogEntry SeoTopic SeoTopic SeoTopic->BlogEntry CategorizedTopic CategorizedTopic Category Category CategorizedTopic->Category ClassifiedTopic ClassifiedTopic CategorizedTopic->ClassifiedTopic WikiTopic WikiTopic WikiTopic->CategorizedTopic ControlledTopic ControlledTopic WikiTopic->ControlledTopic TaggedTopic TaggedTopic WikiTopic->TaggedTopic ClassifiedTopic->ClassifiedControlledTopic ClassifiedTopic->SeoTopic WorkflowDefinition WorkflowDefinition ClassifiedTopic->WorkflowDefinition ControlledTopic->ClassifiedControlledTopic TaggedTopic->ClassifiedTopic

TopicType

Blog Entry

a posting published in a blog web
This is the central TopicType to store blog entries. See also

read more

TopicFunction

BlogEntryRenderIndexItem

Render a summary for a BlogEntries
This method is called by RenderCategory to display a summary for an object of type ClassifiedTopic.

Parameters
  • OBJECT
  • THEICON
  • TITLEEXTRA

read more

BlogEntryRenderRss

renders an item for a blog posting in an rss feed

Parameters
  • OBJECT
  • BLOGENTRY_FULLTEXT: boolean switch to display the full blog text in the feed; set to off will only display the teaser section (default is on)

read more

RenderArchives

display a list of months and the numbers of BlogEntries in it for the sidebar

Parameters
  • CAT: render archive links in this Category (optional)
  • THEWEB: web to read blog entries, default: BASEWEB

read more

RenderAuthorTools

tools visible to blog authors
Parameters
  • initialdate, where to start the calendar at, defaults to now

read more

RenderBlogEntries

Render a set of postings to leaf through
This TopicFunction displays a collection of BlogEntries within the given CATegory and/or TAG.

Parameters
  • SKIP: offset into the archive
  • LIMIT: number of postings to show at max
  • CAT: categories to extract (optional)
  • TAG: tagged entries to be extracted (optional)
  • STICKY: a pattern the Sticky field must match to list the posting see the "Sticky" definition in Blog Entry (optional)
  • NOSTICKY: same as STICKY but with inverse logic
  • FROM_TIME: lower boundary of timespan to display in epoch seconds
  • TO_TIME: uppwer boundary of timespan to display in epoch seconds
  • ONLYTEASER: switch "on" to just render the teaser section; defaults to rendering the full posting
  • THEWEB, defaults to BASEWEB

read more

RenderBlogEntryPagination

renders a navigation to link to the prev and next posting on the timeline

Parameters
  • CLASS: to be added to the container
  • THEWEB: web to search for blog entries, default BASEWEB

read more

RenderBlogEntryTitle

renders the heading section of a Blog Entry (deprecated)
Parameters
  • THETOPIC, defaults to BASEWEB.BASETOPIC
  • TITLE_EXTRA
  • SHOWREVINFO: boolean flag to switch on/off revinfo

read more

RenderCategories

display a list of categories in the sidebar
TODO

Parameters
  • CAT: top category whose subcategories are displayed, defaults to TOP

read more

RenderNumberOfComments

Parameters
  • THETOPIC to display the counts for
  • COMMENTSYSTEM

read more

RenderRecentBlogEntries

display a list of recent BlogEntries for the sidebar

Parameters
  • LIMIT: maximal number of BlogEntries to list
  • CAT: optionally render restrict list to this category
  • THEWEB: blog web, defaults to BASEWEB

read more

RenderRecentComments

display a list of recent comments in the current web
This function is used to render a section in a sidebar listing the recent comments last month limitted to a max of 10 by default. To fetch the list of most recent comments there are two implementations below: one using DBQUERY and METACOMMENT and the other using SOLRSEARCH. The latter is used automatically when SolrPlugin is installed.

Parameters
  • THEWEB: web to search for comments, defaults to %BASEWEB%
  • LIMIT: max number of comments to show
  • CAT: retrieve recent comments on BlogEntries in that category
  • MONTHS: age of comments to display by number of months, defaults to 1

read more

RenderRecentNews

This function renders a list of recent BlogEntries in the given web. Only published postings will be rendered as well as those not tagged "blogonly". Each posting's teaser will be extracted.

See also:

Parameters
  • SKIP: number of items to skip, default 0
  • LIMIT: number of items to show, default 4
  • THEWEB: web holding blog entries, default Blog
  • CAT: categories to extract (optional)
  • TAG: tagged entries to be extracted (optional)
  • SHOWREVINFO: on/off, default on
  • STICKY

read more

RenderSideBar

sidebar for the blog app
TODO

Parameters
  • SIDEBAR: kind of sidebar to display

read more

RenderSimilarBlogEntries

display a list of related BlogEntries
This needs Foswiki:Extensions/SolrPlugin

Parameters
  • NONE

read more

Installation

Manifest

# Name Type
1 BlogCalendarViewTemplate TopicView, ApplicationTopic, WikiTopic
  a topic view for a blog calendar
2 BlogEntry TopicType, DataForm, DocuTopic, ApplicationTopic, WikiTopic
  a posting published in a blog web
3 BlogEntryEditTemplate TopicView, ApplicationTopic, WikiTopic
  Editor for BlogEntries
4 BlogEntryRenderIndexItem TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  Render a summary for a BlogEntries
5 BlogEntryRenderRss TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  renders an item for a blog posting in an rss feed
6 BlogEntryViewTemplate TopicView, ApplicationTopic, WikiTopic
  TopicView for BlogEntries
7 BlogSearchViewTemplate TopicView, ApplicationTopic, WikiTopic
  Solr search for blogs
8 Category TopicType, DataForm, DocuTopic, ApplicationTopic, WikiTopic
  Blog category
9 CategoryViewTemplate TopicView, ApplicationTopic, WikiTopic
  special category view for blogs
10 FrontPageViewTemplate TopicView, ApplicationTopic, WikiTopic
   
11 PatternSkinBlogEntryViewTemplate TopicView, ApplicationTopic, WikiTopic
  TopicView for BlogEntries (PatternSkin variation)
12 PatternSkinCategoryViewTemplate TopicView, ApplicationTopic, WikiTopic
  TopicView for categories (PatternSkin variation)
13 PatternSkinCompatibilityTemplate TopicView, ApplicationTopic, WikiTopic
  some basic mappings into PatternSkin
14 PatternSkinFrontPageViewTemplate TopicView, ApplicationTopic, WikiTopic
   
15 RenderArchives TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  display a list of months and the numbers of BlogEntries in it for the sidebar
16 RenderAuthorTools TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  tools visible to blog authors
17 RenderBlogEntries TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  Render a set of postings to leaf through
18 RenderBlogEntryPagination TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  renders a navigation to link to the prev and next posting on the timeline
19 RenderBlogEntryTitle TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  renders the heading section of a BlogEntry (deprecated)
20 RenderCategories TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  display a list of categories in the sidebar
21 RenderNumberOfComments TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
   
22 RenderRecentBlogEntries TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  display a list of recent BlogEntries for the sidebar
23 RenderRecentComments TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  display a list of recent comments in the current web
24 RenderRecentNews TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
   
25 RenderSideBar TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  sidebar for the blog app
26 RenderSimilarBlogEntries TopicFunction, DocuTopic, ApplicationTopic, WikiTopic
  display a list of related BlogEntries
27 WebHome ApplicationTopic, WikiTopic
   
28 WebPreferences WebTool, ApplicationTopic, WikiTopic
   
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding arbeitsgruppe.ch? Send feedback