Create a Theme

With PaperPost you can create your own themes and switch between them. This tutorial will show you how you setup a theme to make one yourself.

To make a theme you need an understanding of HTML and CSS.
If you don't know HTML or CSS, you will not be able to make your own theme.

The main folder you will be working in is:
/assets/theme_folder/
All your files and folders will be located and stored in this directory.

There are also some key files you must have:

/assets/theme_folder/theme.php
/assets/theme_folder/info.txt
/assets/theme_folder/css/basic.css
/assets/theme_folder/images/icons/

theme.php stores all the layout data, edit this and you can change the layout
info.txt has all the theme data, like the name, author, folder, width, etc
/css/basic.css is where you change the style, colour, images, etc
/images/icons/ is where all the icons for PaperPost are located. It's best just to copy and paste that folder for now

To change the theme, edit the /mod/config.php file. Where it says "$constant_theme_folder", and change it to the folder name you have chosen

Setting Up Your Theme

Try copying a the folder "Default" from the /assets/ folder, and call it what you would like to call your theme.
After that, edit the info.txt file found in there. It should say:

$constant_theme_name = "PaperPost"; //Name of Theme
$constant_theme_version = "1.0"; //Version of Theme
$constant_theme_width_other = "785"; //Size of other things(tables, etc)
$constant_theme_width_nice = "800"; //Site width
$constant_theme_width_type = "px"; //site width type(px, em, %)
$constant_theme_author = "PaperPost"; //author
$constant_theme_author_link = "www.paperpost.pap3rback.com"; //Author's website

Edit all these variables to what you want.

Change $constant_theme_name to what ever you want.
Changing $constant_theme_version does little at this stage, but it's best just to put it in

This is a crucial part:
Edit $constant_theme_width_nice to what width you want your theme to be. Do not include the units
If you want your site to have a width of 95%, it would be $constant_theme_width_nice = "95";

Change the the width type variable like this, if you want 95%: $constant_theme_width_type = "%";

Now open up /mod/config.php. Edit the line where it says $constant_theme_folder edit the string to your own folder name

Your site now should be running on that theme directory.

Making Your Theme

Now you know how to change the layout and where everything is stored, if you know html and css, you should be able to take off from here.

There are just some parts you need to add to make it work in PaperPost, These are shown from the default template and are just PHP includes to certain aspects of the site.