Extension:Wikilog: Difference between revisions

Template:Wikilog Extension Navigation

MediaWiki extensions manual

Wikilog Release status: stable
Implementation	Parser function , Special page
Description	Adds blogging features to MediaWiki, through a special namespace, making it a wiki-blog hybrid, like a Bliki.
Author(s)	Juliano F. Ravasi (Julianotalk)
Latest version	1.2.0 (2011-12-11)
MediaWiki	1.18
Database changes	Yes
License	GNU General Public License 2.0
Download	Download v1.2.0 Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review Template:WikimediaDownload/svn README Release notes
Example	http://juliano.info/en/Blog:Memory_Leak
Parameters $wgTaggingEntity $wgWikilogStylePath $wgWikilogStyleVersion $wgWikilogExpensiveLimit $wgWikilogNumArticles $wgWikilogNumComments $wgWikilogExtSummaries $wgWikilogSignAndPublishDefault $wgWikilogMaxAuthors $wgWikilogEnableTags $wgWikilogMaxTags $wgWikilogEnableComments $wgWikilogMaxCommentSize $wgWikilogModerateAnonymous $wgWikilogFeedClasses $wgWikilogFeedSummary $wgWikilogFeedContent $wgWikilogFeedCategories $wgWikilogFeedRelated $wgWikilogNamespaces $wgWikilogCloneParser
Hooks used ArticleDeleteComplete ArticleEditUpdates ArticleFromTitle ArticleSave ArticleViewHeader BeforePageDisplay EditPage::attemptSave EditPage::showEditForm:fields EditPage::importFormData GetFullURL GetLocalURL InternalParseBeforeLinks LanguageGetSpecialPageAliases LanguageGetMagic LinkBegin LinksUpdate LoadExtensionSchemaUpdates ParserAfterTidy ParserBeforeStrip ParserClearState ParserFirstCallInit SkinTemplateTabAction SkinTemplateTabs SkinTemplateNavigation TitleMoveComplete UnknownAction
Translate the Wikilog extension if it is available at translatewiki.net

Wikilog enhances MediaWiki with some common blogging features, making it a wiki-blog hybrid. There are many names that are used to represent this concept: wikilog, wikiblog, bliki, etc. (refer to the Bliki article on Wikipedia).

Wiki pages are configured to act as blogs, which are called "wikilogs". Just like blogs, each wikilog contains a number of published articles, with the most recent ones displayed on the wikilog main page in reverse chronological order.

One or more custom namespaces are configured as Wikilog namespaces; pages created directly in these namespaces become wikilogs, while subpages to these pages become wikilog articles (blog posts) and are listed automatically on that wikilog's main page.

The extension provides the extra functionality for wikilogs and wikilog articles. Wikilog articles inherit all the usual wiki functionality, like wiki syntax, edit history, page categories, talk pages, etc. Among the features added by the extension are: automatic listing of articles, setting of article authors, handling of article comments, generation of syndication feeds (Atom and RSS) for individual wikilogs and for all wikilogs of the wiki, etc. For more information, see the full list of features.

The philosophy of Wikilog is not to just make a blog out of a wiki, but to combine both concepts. Unlike most blogs, wikilog articles can be collaboratively written and published by multiple users. Talk pages of wikilog articles provide a simpler interface for commenting than standard MediaWiki talk pages. It is similar to most blog software, with the addition of discussion threading.

• Project home @Google code
• Users mailing list

Requirements

In order to use Wikilog, the following components are required:

• MediaWiki 1.18 or higher.
• A MySQL database backend.

  Only MySQL databases are supported at the moment. PostgreSQL support is planned for a future release. Support for other database backends depend on people volunteering for maintaining them.

The following components are recommended:

• Extension:ParserFunctions

Installation

1. Download the extension and install it as ./extensions/Wikilog, relative to your MediaWiki installation directory. You may checkout the latest version from the Subversion repository in this directory, or uncompress one of the zip or tgz archives provided and rename/symlink the directory created.
• Note: The directory name must either have that name, or $wgWikilogStylePath must be set to the proper path in order for the extension to reference stylesheets and images from the extension directory.
2. Backup your database and local configuration, it is always a good idea.
3. Add the following lines to your LocalSettings.php (replace 100, with the first even-numbered namespace greater than or equal to 100 available in your wiki):

   require_once( 'extensions/Wikilog/Wikilog.php' );
   Wikilog::setupNamespace( 100, 'Blog', 'Blog_talk' );
   

4. Run the update.php script in order to create or update the tables used by the extension.
• Note: This script needs to be executed every time the extension (or MediaWiki) is upgraded.

User documentation

User documentation is included in the extension package in the documentation directory. The documentation is released under a Creative Commons license, and can be imported to the wiki, so that users may access it directly from the wiki. Currently the documentation is available only in English.

You must run the ./extensions/Wikilog/maintenance/wikilogImportDocumentation.php PHP script from a command-line shell in order to import the documentation to your wiki. Example:

$ cd /path/to/mediawiki
$ php extensions/Wikilog/maintenance/wikilogImportDocumentation.php

This will import the documentation pages and images to your wiki, and it can be accessed from [[Help:Wikilog]].

The documentation is maintained online; you are welcome to contribute!

Examples of use

Chinese

• CineWiki - Blog: The Mediawiki Technical Exchange

English

• Elena & Fabrice's Blogs
• halt and catch fire - Wikilog: Test
• I ask questions - Blog: Observations (since March 2009)
• pika - Blog: Recipes

German

• Blog: Bicycle Wiki

Quickstart

1. Create a Blog:My_blog_name page, with any introductory text for your blog
   (if you used another namespace above instead Blog: use that one)
2. On your blog front page you will see a new "wikilog" tab to start interacting with
3. There you can find the field: "Create new wikilog article" (see 1st picture below)
4. Create with that a post on your blog (see 2nd + 3rd picture)
   (don't forget to sign (--~~~~), otherwise it will not be published and stays as draft)

Note: It is strongly advised to refer to the detailed documentation too.

Images

• 
  Wikilog actions (with field: "Create new wikilog article")
• 
  how to create a blog posting
• 
  blog post created :-)