#rokfor-web

A simple reference implementation of a Rokfor CMS web application. It uses jade templates or a custom php template engine to produce the html output.

#Installation

• Prerequisites: A running rokfor installation. Check it out here: Rokfor-cms
• Clone the repository in the document root
• Make sure to include the configuration file (rf_config-v2.inc in index.php)

#How-To

##Parameters

The Rokfor Structure is based on the idea of a book. A book is a top level project which can be multiplied in Issues. Each book consists of chapters. In each chapter, there can elements. A element is a collection of data structures.

$this->_checkBook($_GET['book']);
$this->_checkIssue($_GET['issue']);
$this->_checkChapter($_GET['chapter']);		
$this->_checkElement($_GET['element']);	

If these parameters are omitted, the first available will be set as default. You can send these parameters when creating a menufunction, or pretty print them with an .htaccess file. Here is an example of rewriting the first two parameters to chapter and element. You probably want to pass book and issue as well if you have a bigger project.

RewriteCond %{ENV:REDIRECT_STATUS} 	=200           [OR]
RewriteCond %{REQUEST_URI} 		    ^.*/assets/.*$ [OR]
RewriteCond %{REQUEST_URI} 		    ^.*/other_directory_to_exclude/.*$

RewriteRule .* - [S=2]	            # Number of Rules to skip if the conditions above match. 
                                    # Here we skip two rules.
									
RewriteRule ^(.*)/(.*)$             /index.php?chapter=$1&element=$2 [L]
RewriteRule ^(.*)$                  /index.php?chapter=$1 [L]

##Templates

Templates reside in the templates folder. They are html, and you're totally free in designing whatever you want. You can include subtemplates, do fancy javascript or css. If Rokfor cannot find a specific template, default.phtml will be used to render the content. If you need to, you can store different templates per book, issue, chapter or element. Templates are always names like the corresponding book, issue, chapter or element. The choice is stacked:

For example:

• templates/chapter/Intro.phtml will always be used for elements within the chapter Intro.
• templates/element/Demo.phtml will be used for the element named Demo, overruling Intro.phtml.
• The hierarchy is: element -> chapter -> issue -> book -> default

The hierarchy is set in the constructor of controller.class.inc:

/**
* Create output depending on the template
*/
	
if (file_exists(template_path.'/element/'.$_GET['element'].'.phtml')) {
	$this->content('/elements/'.$_GET['element'].'.phtml');						
}
else if (file_exists(template_path.'/chapter/'.$_GET['chapter'].'.phtml')) {
	$this->content('/chapters/'.$_GET['chapter'].'.phtml');						
}
else if (file_exists(template_path.'/issue/'.$_GET['issue'].'.phtml')) {
	$this->content('/issue/'.$_GET['issue'].'.phtml');						
}		
else if (file_exists(template_path.'/book/'.$_GET['book'].'.phtml')) {
	$this->content('/issue/'.$_GET['book'].'.phtml');						
}				
else {
	$this->content('default.phtml');			
}

###Data Access Functions

The little magic is here: Whenever you write a snippet like this, make sure, that the function $dump_content in this example also exists in the view.class.inc file. In the end, make sure, that your template function returns its result as a string. The string will be inserted in the template to make it complete.

<?=$dump_content?>

You can include a template within a template:

<?include('sys/header.phtml')?>

Like this, you can set the same footer for every page in one template.

###Data Structures

When you design a function for a template, there are two main data structures holding the necessary data.

$this->tree
$this->data

$this->tree holds the available books, the issues, the chapters and the elements of the current chapter. You can easily create a menu with it. $this->data holds the content of the loaded element. You can create a page with it.

If you need to know which book, issue, chapter or element is currently active, it's all stored in these structures. You can use these to highlight the selected section in the menu, for example.

$this->book
$this->issue
$this->chapter
$this->element

###Loading other than current data

If you need other data than the current, for example in your footer, you can overload the active element data with an own id:

$localdata = $this->_loadData($_element);	// Load the content of element with id $_element
$text = $localdata['Textfield'];			// $text holds now the content of the loaded data
$current = $this->data['Textfield'];		// $current holds the content of the default data

###Javascript

If you need Java Script Code which should be executed, there's the helper function

$this->addDomready($_code) 

The code will be added to a onReady Function at the end of the page. It's wrapped in a mootools-flavoured domready function, but you can change the code in the controller.class.inc file at ease:

	function dump($echo = true) 
	{
		...
			<script type="text/javascript" charset="utf-8">
			window.addEvent(\'domready\', function() {
				'.join("\n",$this->domready).'
				});
			</script>
			');
		...

If you prefer jquery, you can change the code to:

	function dump($echo = true) 
	{
		...
			<script type="text/javascript" charset="utf-8">
			$( document ).ready(function() {
				'.join("\n",$this->domready).'
				});
			</script>
			');
		...

###Example Function

Here's an example for a textfield:

function texfield() 
{
	$html = $this->data['Textfield'];				// Get the text value of the field "Textfield"
	return ('<p class="content">'.$html.'</p>');	// Wrap it in a tag and return it.
}