WvdS.DokuWiki.Flat Template

Template: flat
Version: 1.1.0 (WvdS Extensions)
Namespace: lib/tpl/flat/
Original: beemoon contact@beemoon.fr
Extensions: Wolfgang van der Stille zeljko.petrusic@outlook.de
License: GPL 2

The Flat Template is a minimalist, responsive DokuWiki template with WvdS extensions for multilingual support, language switcher, configurable sidebars, logo system with base64 rendering, and seamless integration with WvdS plugins.

• Multilingual Documentation - Automatic language switcher and detection
• Knowledge Bases - Clean navigation with accordion menus
• Project Documentation - Hierarchical sidebar structure
• Enterprise Wikis - Professional, customizable design
• Optimized Performance - Inline base64 images, cookie-based state management

Requirement: Wiki with German, English, and Slovenian.

conf/local.php:

$conf['tpl']['flat']['enableLangSwitcher'] = 1;
$conf['tpl']['flat']['languages'] = 'de,en,sl';
$conf['tpl']['flat']['langPosition'] = 0;
$conf['tpl']['flat']['defaultLanguage'] = 'de';

start.txt (for auto-redirect):

{{wvds:redirect target="{lang}:start"}}

Result:

• Language switcher shows DE/EN/SL options
• Auto-redirect via wvdscond plugin
• Language is detected from de:page, en:page, sl:stran
• Visitors are automatically redirected to matching language

Requirement: Main menu at top, accordion navigation at bottom.

File structure:

data/pages/
├── sidebar.txt          → Main menu
├── sidebar1.txt         → Empty file (placeholder)
├── de/
│   └── sidebar1.txt     → {{wvds:snippet>go_back}}
│                           {{wvds:acmenu dynamic="2"}}
├── en/
│   └── sidebar1.txt     → {{wvds:snippet>go_back}}
│                           {{wvds:acmenu dynamic="2"}}
└── en/crypto/
    └── sidebar1.txt     → {{wvds:snippet>go_back}}
                            {{wvds:acmenu dynamic="1"}}

sidebar.txt (Root):

~~NOCACHE~~
{{wvds:snippet>main_menu}}

en/sidebar1.txt:

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu dynamic="2"}}

Requirement: Footer text in different languages.

Configuration:

footerText = de:© 2025 Meine Firma - Alle Rechte vorbehalten|en:© 2025 My Company - All rights reserved|sl:© 2025 Moje podjetje - Vse pravice pridržane

Result:

• German pages: „© 2025 Meine Firma - Alle Rechte vorbehalten“
• English pages: „© 2025 My Company - All rights reserved“
• Slovenian pages: „© 2025 Moje podjetje - Vse pravice pridržane“

Requirement: Logo from wiki media with optimal display.

Admin Configuration:

showLogo = 1
logoSource = wiki
logoPath = wiki:logo.png
logoContainerSize = 300
logoFit = contain
logoPosition = center
logoMaxWidth = 300
logoQuality = 90

Result:

• Logo is rendered as base64 inline image (via wvdsimage)
• No additional HTTP request for the logo
• Image is scaled to max 300px and centered in 300x300px container
• object-fit: contain ensures the entire image is visible

Alternative: Logo from template directory:

showLogo = 1
logoSource = template
logoPath = logo.png        // located in lib/tpl/flat/images/logo.png

Alternative: External logo:

showLogo = 1
logoSource = url
logoPath = https://example.com/logo.png

1. Namespace Analysis
   └── Extracts language from position langPosition
   └── Example: en:crypto:openssl → "en"

2. Language Switch
   └── Replaces language segment in namespace
   └── en:crypto:openssl → de:crypto:openssl

3. Page Check
   └── Checks if target page exists
   └── If not: Redirect to language start page

1. Namespace-specific
   └── Searches for sidebar/sidebar1 in current namespace

2. Parent Namespace
   └── Searches upward in parent namespaces

3. Root Fallback
   └── Uses root sidebar if nothing found

1. Detect Browser Language
   └── Parse Accept-Language header

2. Language Available?
   ├── Yes: Redirect to language namespace
   └── No: Redirect to defaultLanguage

The template works seamlessly with WvdS plugins:

// In template files
$helper = plugin_load('helper', 'wvdsi18n');
$lang = $helper->detectLanguage();
$text = $helper->get('menu_home');

Usage:

• Localize footer texts
• Translate menu labels
• Parse configuration values

sidebar.txt:

{{wvds:snippet>main_menu}}

Usage:

• Reusable menu structures
• HTML components in sidebars
• Shared elements across namespaces

sidebar1.txt:

{{wvds:acmenu dynamic="2"}}

Usage:

• Accordion navigation in sidebars
• Dynamic namespace detection
• Automatic open/close behavior

Create conf/userstyle.css for customizations:

/* Language switcher customization */
.lang-switcher {
    position: fixed;
    top: 10px;
    right: 10px;
}
 
/* Sidebar width */
.sidebar {
    width: 280px;
}
 
/* Footer styling */
.footer {
    background: #333;
    color: #fff;
    padding: 20px;
}

• in all sidebars with dynamic content
• langPosition set correctly for namespace structure
• sidebar1.txt create in each language namespace
• wvdschunk use for reusable menu elements
• Fallback language always configure

• WvdS.DokuWiki.i18n Plugin - Internationalization (translations)
• WvdS.DokuWiki.Cond Plugin - Conditional content + Redirects
• WvdS.DokuWiki.Snippet Plugin - Reusable HTML components
• WvdS.DokuWiki.AcMenu Plugin - Accordion menu
• WvdS.DokuWiki.Image Plugin - Image processing with base64 output
• Original Flat Template

lib/tpl/flat/
├── main.php            → Main template
├── detail.php          → Media detail view
├── mediamanager.php    → Media manager
├── conf/
│   ├── default.php     → Default configuration
│   └── metadata.php    → Configuration metadata
├── lang/
│   ├── de/lang.php     → German translations
│   ├── en/lang.php     → English translations
│   └── sl/lang.php     → Slovenian translations
├── lang_helper.php     → Language & logo helper functions
├── css/
│   ├── style.css       → Template styles
│   └── logo.css        → Logo styles
├── js/
│   └── script.js       → Template scripts (incl. TOC cookie)
└── images/
    └── flags/          → Language flags