From 04af95e6f3ee462355c0d2a1ac8ccac9ef0ef432 Mon Sep 17 00:00:00 2001
From: vv221 <vv221@dotslashplay.it>
Date: Tue, 28 Apr 2020 13:26:30 +0200
Subject: [PATCH] A link to the current page can be shown

This is configurable through the administration panel.
Default is to not include a link to the current page.
---
 action.php           | 6 ++++--
 conf/default.php     | 1 +
 conf/metadata.php    | 1 +
 lang/en/lang.php     | 2 +-
 lang/en/settings.php | 1 +
 lang/fr/lang.php     | 2 +-
 lang/fr/settings.php | 1 +
 7 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/action.php b/action.php
index a97fc81..dccc97c 100644
--- a/action.php
+++ b/action.php
@@ -40,17 +40,19 @@ class action_plugin_childrenpages extends DokuWiki_Action_Plugin {
 		if ( $event->data['view'] !== 'page' ) {
 			return;
 		}
+		// Check if all links should be shown, or if the one to the current page shoud be excluded
+		$show_all_links = (bool) $this->getConf('show_link_to_current_page');
 		// If the current page is included in a reserved namespace, add a link back to main page
 		$children_types = $this->getConf('children_list');
 		$top_namespace = $this->getTopLevelNamespace();
 		$is_child_page = in_array($top_namespace, $children_types);
-		if ( $is_child_page ) {
+		if ( $show_all_links || $is_child_page ) {
 			$main_label = $this->getLang('btn_main');
 			$this->addMenuItem($event, '_main', $main_label, $top_namespace);
 		}
 		// Add menu items for each child page
 		foreach ( $children_types as $child_type ) {
-			if ( $child_type !== $top_namespace ) {
+			if ( $show_all_links || $child_type !== $top_namespace ) {
 				$child_label = $this->getLang("btn_$child_type");
 				$this->addMenuItem($event, $child_type, $child_label, $is_child_page);
 			}
diff --git a/conf/default.php b/conf/default.php
index 611cbb3..94c2d59 100644
--- a/conf/default.php
+++ b/conf/default.php
@@ -1,3 +1,4 @@
 <?php
 
 $conf['children_list'] = array('animation', 'gameplay', 'dev', 'talk');
+$conf['show_link_to_current_page'] = 0;
diff --git a/conf/metadata.php b/conf/metadata.php
index a3fd586..7d53330 100644
--- a/conf/metadata.php
+++ b/conf/metadata.php
@@ -1,3 +1,4 @@
 <?php
 
 $meta['children_list'] = [ 'array' ];
+$meta['show_link_to_current_page'] = [ 'onoff' ];
diff --git a/lang/en/lang.php b/lang/en/lang.php
index b737008..31295c8 100644
--- a/lang/en/lang.php
+++ b/lang/en/lang.php
@@ -1,6 +1,6 @@
 <?php
 
-$lang['btn_main'] = 'Back to main page';
+$lang['btn_main'] = 'Main article';
 
 $lang['btn_animation'] = 'Animation';
 $lang['btn_dev']       = 'Dev';
diff --git a/lang/en/settings.php b/lang/en/settings.php
index 5d44db9..d0e58f3 100644
--- a/lang/en/settings.php
+++ b/lang/en/settings.php
@@ -1,3 +1,4 @@
 <?php
 
 $lang['children_list'] = 'List of namespaces reserved for children pages';
+$lang['show_link_to_current_page'] = 'Include a link to the page currently shown';
diff --git a/lang/fr/lang.php b/lang/fr/lang.php
index 0d5c297..0cedd6b 100644
--- a/lang/fr/lang.php
+++ b/lang/fr/lang.php
@@ -1,6 +1,6 @@
 <?php
 
-$lang['btn_main'] = 'Retour à la page principale';
+$lang['btn_main'] = 'Article principal';
 
 $lang['btn_animation'] = 'Animation';
 $lang['btn_dev']       = 'Dev';
diff --git a/lang/fr/settings.php b/lang/fr/settings.php
index 29b5a9c..0ddd3a5 100644
--- a/lang/fr/settings.php
+++ b/lang/fr/settings.php
@@ -1,3 +1,4 @@
 <?php
 
 $lang['children_list'] = 'Liste des espaces de nom réservés aux pages enfants';
+$lang['show_link_to_current_page'] = 'Inclure un lien vers la page actuellement affichée';