Differences

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

--- plugin:blogtng [2014-07-19 01:03] – [How to enable TOC] Klap-in
+++ plugin:blogtng [2023-09-01 16:14] (current) – Klap-in
@@ Line 3: / Line 3: @@
 ---- plugin ----
 description: A next generation blog plugin for DokuWiki
-author     : Gina Häußge, Michael Klier, Andreas Gohr
+author     : Dokufreaks (previous authors: Gina Häußge, Michael Klier, Andreas Gohr)
 email      : freaks@dokuwiki.org
 type       : syntax, action, helper
-lastupdate : 2014-04-27
+lastupdate : 2023-02-16
-compatible : 2013-05-10 "Weatherwax", 2010-11-07 "Anteater", 2011-05-25 "Rincewind", "Angua", 2012-10-13 "Adora Belle"
+compatible : Hrun, Ponder Stibbons, Binky, Weatherwax, Anteater, Rincewind, Angua, Adora Belle
 depends    : sqlite
 conflicts  :
 similar    : blog, discussion, tag
 tags       : blog, discussion, tags, sqlite, !discontinued
-securitywarning: Listings don't respect acls, pages that belong to a blog are displayed even if the current users can't access them
+securitywarning:
 downloadurl: https://github.com/dokufreaks/plugin-blogtng/zipball/master
@@ Line 27: / Line 27: @@
 ===== Download and Installation =====
-Use the url of the download button above in the Plugin Manager. Or alternatively, click this button to download a compressed  file.  Unpack the file in ''dokuwiki/lib/plugins'' and rename the resulting directory to give ''dokuwiki/lib/plugins/blogtng''.
+Search and install the plugin using the [[plugin:extension|Extension Manager]].
+Alternatively, refer to [[:Plugins]] on how to install plugins manually in ''dokuwiki/lib/plugins/blogtng''.
 ==== Dependencies ====
 The next dependencies are required:
-  - SQLite-Extension for PHP5. On Debian systems install with: <code bash>aptitude install php5-sqlite</code>
+  - SQLite PHP Extension. On Debian systems install with e.g. <code bash>aptitude install php7-sqlite</code>
   - The helper plugin [[Sqlite]]
@@ Line 59: / Line 61: @@
 Next you can use some ''<blog *>'' syntax that can be configured to show lists, tag clouds, comments and more.
 For example, you can add a list with condensed blog entries to a normal wiki page, that displays last created blog entries but only shows their abstract using the ''small'' template. To improve navigation in this overview navigation is added too.
 <code>
@@ Line 74: / Line 77: @@
   limit  6
 </blog>
-</code> Please refer to [[#syntax]] section for explanation of the configuration details and the overview of other syntax possible.
+</code>
+Another example is using a tagcloud. Firstly, you can add a tagcloud like:
+<code>
+<blog tagcloud>
+  target   page:tag
+</blog>
+</code>
+Then in the target page, ie "page:tag", add the following to show blog lists in one tag.
+<code>
+<blog list>
+  tpl      small
+</blog>
+</code>
+Now the tag cloud is shown, and when you click one tag, you will be redirected to the page listing all entries tagged with it.
+Please refer to [[#syntax]] section for explanation of the configuration details and the overview of other syntax possible.
 In the admin panel you reach via "Manage Blogs (BlogTNG)" an interface which shows you the last comments and blog entries with some shortcuts to modify them. Via the search bar you search for entries, comments and tags.
 The BlogTNG let you create a rss feed for your blog too. Please refer to the section [[#Customized RSS feed for the blog]].
+For nice blog about starting with BlogTNG plugin see: [[http://blog.andreas-haerter.com/2011/05/15/how-to-create-a-dokuwiki-blog-blogtng-plugin|How to create a DokuWiki based blog]]  by [[user>Andreas|Andreas]].
@@ Line 526: / Line 549: @@
 > ===Little (temporary) initiative===
 > At the moment a development effort has result in an update of the plugin. The plugin has now a dependency on the helper plugin to obtain decent maintained sqlite2 //and// sqlite3 support. Many other little improvements are included too.
-> Please report issues in the issue tracker --- [[user>Klap-in|Klap-in]] //2013/09/10 01:53//
+> Please report issues in the issue tracker --- [[user>Klap-in|Klap-in]] //2013/09/10//
 ==== How to create a new blog in the same site? ====
@@ Line 551: / Line 574: @@
 E. g. the following pages are using the BlogTNG-Plugin:
+  * [[http://adam.nz/blog/]] (English) (Jan-2016)
   * [[http://harpanet.com]] (English) (Jun-2013)
   * [[http://www.andrwe.org]] (English)
@@ Line 558: / Line 582: @@
   * [[http://www.rocking-minds.org]] (English)
   * [[http://blog.slucas.fr]] (French, English)
-  * [[http://chrisge.org]] (German, English)
   * [[http://www.heiko-barth.de/blog/]] (German)
   * [[http://htrd.su/]] (Russian)
   * [[http://blog.flower-platform.com]] (English)
   * [[http://www.joebenimble.com/]] (English)
+  * [[http://ingegnerialibera.altervista.org/blog/doku.php]] (Italian)
+===== Bug and feature requests =====
-===== Examples =====
+Please report all your issues at the [[https://github.com/dokufreaks/plugin-blogtng/issues|GitHub issuetracker]].
-Awesome work! But i'm stunned by the complexity of options and stuff, so could you please provide some examples to learn from? --- og
-> Maybe this helps: [[http://blog.andreas-haerter.com/2011/05/15/how-to-create-a-dokuwiki-blog-blogtng-plugin|How to create a DokuWiki based blog (BlogTNG plugin)]]  --- [[user>Andreas|Andreas]] //2011/05/15 06:00//
-> Please see the recent added [[#Usage]] section too.  --- [[user>Klap-in|Klap-in]] //2013/09/10 12:43//
-==== Tagcloud ====
-How to show tags is not clear in the above documentation. To show tag cloud, for exaample, you first need to add the following sytax
-<code>
-<blog tagcloud>
-  target   page:tag
-</blog>
-</code>
-Then in the target page, ie "page:tag", add the following to show blog lists in one tag.
-<code>
-<blog list>
-  tpl      small
-</blog>
-</code>
-Now the tag cloud is shown, and when you click one tag, you will be redirected to the page listing all entries taged with it.
 ===== Discussion =====
@@ Line 640: / Line 636: @@
 > I forked the plugin and added the ability to globally disable/close/enable comments, see https://github.com/lainme/plugin-blogtng if you are interested. --- [[user>lainme|lainme]] //2013/02/01 08:16//
-=== Broke my Wiki ===
-Using monobook installing this broke my entire Wiki - it no longer works with a server error.
-> What's the error message? I tried the monobook template and everything works fine.  --- [[user>lainme|lainme]] //2013/02/01 08:16//
 ==== How to disable TOC? ====
@@ Line 679: / Line 668: @@
         if ($this->entry['commentstatus'] == 'closed' || $this->entry['commentstatus'] == 'disabled') return;
         if(!$this->commenthelper) {
-            $this->commenthelper =& plugin_load('helper', 'blogtng_comments');
+            $this->commenthelper = plugin_load('helper', 'blogtng_comments');
         }
         $this->commenthelper->tpl_form($this->entry['page'], $this->entry['pid']);
@@ Line 700: / Line 689: @@
 >> Did you see the question [[plugin:blogtng#How to disable toc]]? That will shine some light.
 >>  --- [[user>Klap-in|Klap-in]] //2014-07-19//
+>>> Sorry if my question wasn't clear...  I use the [[https://www.dokuwiki.org/template:mnml-blog | mnml-blog template]] with the ''blogtng'' plugin.  My problem is that none of the TOC's show.  I'm glad they don't show in the blog pages, but I would like to see them in regular pages, but I don't.  When I look at websites that use the same template, they don't seem to have that problem.  I looked at [[plugin:blogtng#How to disable toc]] but it doesn't help me. --- Patrick //2014/08/02//
+>>>> Finally figured it out.  I needed to flip ''<?php tpl_content( false )?>'' to ''<?php tpl_content( true )?>''  in ''lib/tpl/mnml-blog/main.php''.  --- Patrick //2015/04/11//
+==== Cannot save with selected Blog ====
-==== How to put a comment on non blog page? ====
+>:?: Since Release 2014-05-05a "Ponder Stibbons" the article can not be saved to selected Blog
+> THNX,--- Peter //2014/08/20//
->:?: How to put a comment on non blog page? Release Last
+==== Tag link ====
-> Thanks,--- Briga //2014/07/18//
+> If I click on a tag the result page does not show all the articles with the stated tag. example: https://www.monjo.com/index?btng[post][tags]=film
->
->> Using a different plugin, because your question is not in the scope of this plugin. See [[plugin:Discussion]] Plugin
->> --- [[user>Klap-in|Klap-in]] //2014-07-19//