Extension:Wikilog
| Overview • Features • Configuration • FAQ • Special pages |
The Wikilog extension 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.
Wikilog was originally developed by Juliano F. Ravasi. Current development is done in a separate repository on GitHub by User:VitaliyFilippov:
Contents
Requirements[edit]
In order to use Wikilog, the following components are required:
- MediaWiki 1.19 or higher.
- A MySQL or PostgreSQL database backend.
The following components are recommended:
Installation[edit]
- Download the extension and install it as
./extensions/Wikilog, relative to your MediaWiki installation directory. You may download the tarball from GitHub or clone using Git.- Warning: Use the github download to get the most current version. The other download link points to old versions.
- Note: The directory name must either have that name, or
$wgWikilogStylePathmust be set to the proper path in order for the extension to reference stylesheets and images from the extension directory.
- Backup your database and local configuration, it is always a good idea.
- 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::setupBlogNamespace( 100 );
- 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.
Bugs[edit]
Now Wikilog stopped to work for me with MediaWiki 1.28.0. Here is the error message:
2017/01/02 17:33:51 [error] 3546#0: *7104 FastCGI sent in stderr: "PHP message: PHP Fatal error: Call to undefined method SkinVector::link() in /var/www/withoutvowels/web/w/extensions/Wikilog/WikilogItemPager.php on line 192" while reading response header from upstream, client: 31.210.180.196, server: withoutvowels.org, request: "GET /wiki/Blog:Main HTTP/1.1", upstream: "fastcgi://unix:/var/run/php5-fpm-withoutvowels.sock:", host: "withoutvowels.org", referrer: "https://withoutvowels.org/wiki/Project:Donate"
Note that I have Vector and only Vector skin installed.
User documentation[edit]
WARNING: User documentation is slightly outdated, it was written for the original Juliano's version. Send pull requests on github if you want to make it actual :)
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[edit]
Older version (Juliano's):
- Elena & Fabrice's Blogs
- halt and catch fire - Wikilog: Test
- I ask questions - Blog: Observations (since March 2009)
- pika - Blog: Recipes
Quickstart[edit]
- 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) - On your blog front page you will see a new "wikilog" tab to start interacting with
- There you can find the field: "Create new wikilog article" (see 1st picture below)
- 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[edit]
- GPL licensed extensions
- Stable extensions
- Parser function extensions
- Special page extensions
- Extensions in Wikimedia version control
- Extensions which add rights
- ArticleDeleteComplete extensions
- ArticleEditUpdates extensions
- ArticleFromTitle extensions
- ArticleSave extensions
- ArticleViewHeader extensions
- BeforePageDisplay extensions
- EditPage::attemptSave extensions
- EditPage::showEditForm:fields extensions
- EditPage::importFormData extensions
- GetFullURL extensions
- GetLocalURL extensions
- InternalParseBeforeLinks extensions
- LanguageGetSpecialPageAliases extensions
- LanguageGetMagic extensions
- LinkBegin extensions
- LinksUpdate extensions
- LoadExtensionSchemaUpdates extensions
- ParserAfterTidy extensions
- ParserBeforeStrip extensions
- ParserClearState extensions
- ParserFirstCallInit extensions
- SkinTemplateTabAction extensions
- SkinTemplateTabs extensions
- SkinTemplateNavigation extensions
- TitleMoveComplete extensions
- UnknownAction extensions
- All extensions
- Feed generator extensions
