In general the use of LokiCMS is very easy. If you still need help on general use of LokiCMS or info on more complex features you should check out this documentation. It is still work in progress and valid for version 0.3.4.
After you download LokiCMS you first have to extract all the files in the archive. Upload all the files to your website and point your web browser to the install.php file. The installer will check if it can write all the files that LokiCMS needs to. If this is not so you will not be able to use LokiCMS before you change permissions on those files. You will probably have to do that by using CHMOD. Take a look at site for instructions on how to do this in several ftp clients: Change File Permissions (chmod) with FTP. Reload the installer to see if you have correctly changed the permissions. If everything is good continue with accepting the license and setting up your password. Your site will then be prepared for you, if the install you was successful the installer will give you a link to your new LokiCMS site! I recommend that you delete the install.php file after you are done with the installation.
It is pretty straightforward to administrate LokiCMS. After logging in you can edit some general setting like the title of your site. You can also change some more advanced settings, hold your mouse over the options to get a description. To manage the content on your site go to the pages page. On this page all pages that you have created are listed. In this overview you can change the rank of the pages, this will determine in what location the pages are shown in the menu. Active pages are displayed in the menu and inactive ones are not, even tough the they are called inactive inactive pages are visible to your visitors. The default can be changed by clicking on No in the row of the page you want to be the default one. If you want to delete a page in has to be inactive.
On this page you can also create new pages by giving them a name and selecting the module that they should use. The module determines the kind of content it is. For instance a normal page or a link.
Not finished yet
LokiCMS is designed to be modular, in LokiCMS a module is the part that processes the page into the html that is added to the theme. So when a certain page is requested it is looked for in the pages dir and the accompanying module is loaded to process the data that is in that particular page file. I recommend you read about modifying LokiCMS.
A module consists of two files, firstly module.php which is simply a description of the module (you should leave away the explanation):
<?
// technical
$modulename = "Normal"; (- the name of the module)
$modulecode = "lcd"; (- the file extension)
// info
$moduleversion = "0.3.0"; (- the version of the module)
$modulefullname = "Lokicode module"; (- full description of the module)
$moduleauthor = "Ynte de Wolff" (- the author of the module)
?>
The second file contains the actual module and is called functions.php:
<?
function module($something) {
(this module will be called when a page has to be displayed, you can do whatever you want
with the input here and then return it so it can be used to display the page)
return $return;
};
function moduleedit($page) {
(this module is called when you want to edit a page in the admin, you can put the edit interface here)
};
function modulesave($page) {
(this module is also called when you are going to edit a page, you can check for instance if a
$_POST has been filled with data and save the page)
};
function modulenew($page) {
(this module is called when you want to create a new file and you have selected this module for
it, you can perhaps prepare the new page here)
};
?>
I hope this simple explanation is enough to get you started, I hope to improve it someday.
LokiCMS has been made to integrate into most themes with only a little bit of work (modern xhtml themes). I will now explain how to do this yourself.
Themes are placed into a folder and then into the themes folder. The name of the folder is also the name of the theme. The main file is index.php so you should rename your index file to that. Also very important is that you should take into account that all the resources are relative to the main LokiCMS location and not to the location of the theme so for instance:
<link href="themes/name/default.css" rel="stylesheet" type="text/css" />
and not
<link href="default.css" rel="stylesheet" type="text/css" />
The same for images etc...
To integrate the output you can use several tags:
%title% - the title of the page
%header% - the header text above the page
%tagline% - the smaller/second header text
%menu% - this is a list of the menu items and it is outputted like this:
<ul>
<li><a href="index.php?page=Index.lcd">Index</a></li>
<li><a href="index.php?page=Features.lcd">Features</a></li>
<li id="active"><a href="index.php?page=Documentation.lcd">Documentation</a></li>
<li><a href="index.php?page=Themes.lcd">Themes</a></li>
</ul>
(the id="active" tells you that that item is the one the user is looking to)
%pagecontent% - this the content of the page in xhtml
%footer% - the text of the footer
With these codes you should be able to integrate your theme in a simple way into LokiCMS, you are not required to use them all. I hope to improve on this system one day.