DokuWiki

It's better when it's simple

User Tools

Site Tools

Trace:
plugin:bliki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
plugin:bliki [2011-10-31 15:26] – [Plugin Source] 79.207.143.227plugin:bliki [2023-12-21 17:08] (current) – [Thanks] Aleksandr
Line 6: Line 6:
 email      : beau@dentedreality.com.au email      : beau@dentedreality.com.au
 type       : syntax type       : syntax
-lastupdate : 2005-10-16 +lastupdate : 2011-10-31 
-compatible : +compatible : 2011-05-25 "Rincewind", "Angua"
 depends    :  depends    : 
 conflicts  :  conflicts  : 
-similar    : blog +similar    : blog, blogtng, log 
-tags       : blog, news +tags       : blog, news, twitter
-----+
  
 +downloadurl: https://trello.com/1/cards/5af70a06baeeb1371277812c/attachments/5af70a219cbf8182bedfb170/download/bliki.zip
 +bugtracker :
 +sourcerepo :
 +donationurl:
  
-by [[beau@dentedreality.com.au|Beau Lebens]] and [[anthony.caetano@sanlam.co.za|Anthony Caetano]]+screenshot_img: 
 +---- 
 + 
 +By [[beau@dentedreality.com.au|Beau Lebens]] and [[anthony.caetano@sanlam.co.za|Anthony Caetano]].
  
 ===== Description ===== ===== Description =====
 +
 Bliki allows you to create a simple blog on any page of your wiki by adding a single tag (''%%~~BLIKI~~%%'') to your page. It uses date-based namespaces to store your entries, and automatically handles paging of posts, a 'new post' link, date headers and post footers. Bliki allows you to create a simple blog on any page of your wiki by adding a single tag (''%%~~BLIKI~~%%'') to your page. It uses date-based namespaces to store your entries, and automatically handles paging of posts, a 'new post' link, date headers and post footers.
  
 ===== Version/Requirements ===== ===== Version/Requirements =====
 +
 Latest version released 2005-10-16 and developed/tested using the 2005-07-13 version of DokuWiki. Latest version released 2005-10-16 and developed/tested using the 2005-07-13 version of DokuWiki.
 +
 +**Update**: thanks to [[user>Taggic]], bliki now works with Rincewind and Angua.
  
 ==== Previous Versions ==== ==== Previous Versions ====
 +
   * First release: deep storage only.   * First release: deep storage only.
  
Line 29: Line 40:
  
 ==== Plugin Source ==== ==== Plugin Source ====
 +
 Create a directory called ''bliki'' inside your ''lib/plugins/'' directory, and then copy the following source into ''syntax.php'' in that directory (''lib/plugins/bliki/syntax.php''). Obviously make sure the file is readable by your webserver. Create a directory called ''bliki'' inside your ''lib/plugins/'' directory, and then copy the following source into ''syntax.php'' in that directory (''lib/plugins/bliki/syntax.php''). Obviously make sure the file is readable by your webserver.
 +
 +----
 +
 +2011-10-31 [[user>Taggic]] -> tested following on 2011-05-25a “Rincewind”
 +
  
 <file php syntax.php> <file php syntax.php>
Line 457: Line 474:
  
 ==== Conf Changes ==== ==== Conf Changes ====
-You'll need to add the following configuration directives as well, preferably to ''conf/default.php'';+You'll need to add the following configuration directives as well, preferably to ''conf/local.php'';
  
 ^ Please note the new ''structure'' and ''offset'' options! ^ ^ Please note the new ''structure'' and ''offset'' options! ^
  
-<file php default.php>+<file php local.php>
 <?php <?php
-$conf['bliki']['structure'] = 'flat'; // Structure to use when storing posts; [flat | deep] +// * 2011-10-31  modified by Taggic to get is work with current dokuwiki (Rincewind) 
-$conf['bliki']['offset'] = 0; // Number of hours to offset new post times from your server (eg -3 if you post from a timezone 3 hours behind your server) +$conf['plugin']['bliki']['structure'] = 'flat'; // Structure to use when storing posts; [flat | deep] 
-$conf['bliki']['numposts'] = 15; // Number of posts to show on each page of a blog +$conf['plugin']['bliki']['offset'] = 0; // Number of hours to offset new post times from your server (eg -3 if you post from a timezone 3 hours behind your server) 
-$conf['bliki']['dateheader'] = '===== l, F j ====='; // Format for date header/separator (passed to date(), escape special flags!) +$conf['plugin']['bliki']['numposts'] = 15; // Number of posts to show on each page of a blog 
-$conf['bliki']['datefooter'] = 'n/j/Y g:ia'; // Format for the footer datestamp (includes hours/minutes) (passed to date(), escape special flags!) +$conf['plugin']['bliki']['dateheader'] = '===== l, F j ====='; // Format for date header/separator (passed to date(), escape special flags!) 
-$conf['bliki']['footer'] = '<sub>Posted @ {timestamp} -- [[{permalink}|Permalink]] -- [[{edit}|Edit]]</sub>'; // use {timestamp}, {permalink} and {edit} to link to special variables. +$conf['plugin']['bliki']['datefooter'] = 'n/j/Y g:ia'; // Format for the footer datestamp (includes hours/minutes) (passed to date(), escape special flags!) 
-$conf['bliki']['newlabel'] = '&raquo; New Post'; // Label for the new post button/link +$conf['plugin']['bliki']['footer'] = ' \\\\ <sub>Posted @ {timestamp} -- [[{permalink}|Permalink]] -- [[{edit}|Edit]]</sub> \\\\ \\\\ '; // use {timestamp}, {permalink} and {edit} to link to special variables. 
-$conf['bliki']['olderlabel'] = 'Older Posts &raquo;'; // Link to older posts +$conf['plugin']['bliki']['newlabel'] = '&raquo; New Post'; // Label for the new post button/link 
-$conf['bliki']['newerlabel'] = '&laquo; Newer Posts'; // Link to newer posts+$conf['plugin']['bliki']['olderlabel'] = 'Older Posts &raquo;'; // Link to older posts 
 +$conf['plugin']['bliki']['newerlabel'] = '&laquo; Newer Posts'; // Link to newer posts
 </file> </file>
  
Line 512: Line 530:
  
 ===== Usage ===== ===== Usage =====
 +
 To create a blog using bliki, you just create a new page, set up the basic template (surrounding the actual blog) and put in the ''%%~~BLIKI~~%%'' tag. When you load that page, you'll see any available blog posts and the option to create a new one. Your actual page might look like this; To create a blog using bliki, you just create a new page, set up the basic template (surrounding the actual blog) and put in the ''%%~~BLIKI~~%%'' tag. When you load that page, you'll see any available blog posts and the option to create a new one. Your actual page might look like this;
  
Line 542: Line 561:
  
 ===== Notes ===== ===== Notes =====
 +
   * Currently will not function properly if ''$conf['userewrite']'' is set to 2 and ''$conf['useslash']'' is set to 0 (zero).   * Currently will not function properly if ''$conf['userewrite']'' is set to 2 and ''$conf['useslash']'' is set to 0 (zero).
   * Creating a new post and editing an existing one is slightly less intuitive than it could be because DokuWiki takes you to that individual entry when you're done, rather than the blog page   * Creating a new post and editing an existing one is slightly less intuitive than it could be because DokuWiki takes you to that individual entry when you're done, rather than the blog page
Line 547: Line 567:
  
 ===== To Do ===== ===== To Do =====
 +
   * Take ACLs into account for new post links   * Take ACLs into account for new post links
   * Use caching?   * Use caching?
  
 ===== Thanks ===== ===== Thanks =====
-  * Andreas Gohr and everyone else who is actively developing DokuWiki - it's the best wiki engine out there!+ 
 +  * Andreas Gohr and everyone else who is actively developing DokuWiki -- it's the best wiki engine out there!
   * Esther Brunner for the [[plugin:include|Include plugin]], which got me started on this one.   * Esther Brunner for the [[plugin:include|Include plugin]], which got me started on this one.
-  * Rael Dornfest for the [[http://www.blosxom.com/|blosxom blogging engine]], which was the inspiration for this project.+  * Rael Dornfest for the [[wp>Blosxom|blosxom blogging engine]], which was the inspiration for this project.
   * Anthony Caetano for adding flat storage support to the plugin   * Anthony Caetano for adding flat storage support to the plugin
  
 ===== Discussion ===== ===== Discussion =====
 +
 Comments? Comments?
  
Line 610: Line 633:
    $conf['bliki']['namespace'] = "some_namespace"  // ie "comments", "comments:2006", "bliki" or whatever you want    $conf['bliki']['namespace'] = "some_namespace"  // ie "comments", "comments:2006", "bliki" or whatever you want
  
-2. Replace function render() with this: +2. Replace function ''render()'' with this: 
-<code>+<code php>
     function render($mode, &$renderer, $data) {     function render($mode, &$renderer, $data) {
     global $ID, $conf;     global $ID, $conf;
Line 716: Line 739:
    - how will I be able to use categories?    - how will I be able to use categories?
    - is there a simple way to modify the appearance of the entries? I'd like to have a title, instead of the Date over the entry and another color in the background of an entry and it's header...    - is there a simple way to modify the appearance of the entries? I'd like to have a title, instead of the Date over the entry and another color in the background of an entry and it's header...
 +
 +------
 +  - What ever happend to including a link in these pages to a site where the plugin is in use, as an example?  --- [[user>tonybaldwin|tony baldwin]] //2014-08-17 20:59//
plugin/bliki.1320071201.txt.gz · Last modified: 2011-10-31 15:26 by 79.207.143.227
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

Global DokuWiki Links