Creating Custom Themes for Xiuno BBS

Xiuno uses a flat-file template system. All theme files live inside view/. Customizing the look of your forum is straightforward.

---

Directory Layout

view/
  htm/
    index.htm          <- forum index page
    forum.htm          <- single forum (thread list)
    thread.htm         <- thread detail (posts)
    post.htm           <- reply / create form
    header.inc.htm     <- global page header
    footer.inc.htm     <- global page footer
  css/
    style.css
  js/
    main.js
  img/
    logo.png

---

Template Syntax

Templates are plain PHP with short echo tags:

<?= $conf['sitename'] ?>

<?php foreach($threadlist as $thread): ?>
  <div class="thread">
    <a href="<?= url('thread-'.$thread['tid']) ?>">
      <?= $thread['subject'] ?>
    </a>
  </div>
<?php endforeach; ?>

<?php include _include(APP_PATH.'view/htm/footer.inc.htm'); ?>

---

Creating a New Theme

cp -r view/ view_mytheme/

Then in conf/conf.php:

'view_url' => 'view_mytheme/',

---

Useful CSS Variables

:root {
  --color-primary : #4f46e5;
  --color-bg      : #ffffff;
  --color-bg-alt  : #f8f9fa;
  --color-text    : #212529;
  --color-border  : #dee2e6;
  --border-radius : 6px;
}

Override any of these in your custom style.css to retheme without touching HTML.

---

Sharing Your Theme

Pack it as:

mytheme-1.0.0.zip
  view/
  info.json
  preview.png

Upload it to the Downloads forum so others can use it!