Falt4 RC1 Usermanual

First Steps..................................................................................................................2
Login to Falt4...........................................................................................................2
Structure of the Falt4 Administration..........................................................................2
Articles.......................................................................................................................4
Create a new article..................................................................................................4
The Article Listing.....................................................................................................7
Navigation.................................................................................................................8
Linking possibilities....................................................................................................8
Categories................................................................................................................10
Create a category....................................................................................................10
Templates................................................................................................................11
Construction of Templates.......................................................................................11
Exampletemplates...................................................................................................12
Stylesheets (CSS) and Templates.............................................................................14
How to create Templates.........................................................................................14
Domains...................................................................................................................16
User..........................................................................................................................17
The 4 different usertypes.........................................................................................17
How to add a new user............................................................................................18
Site Properties (defaults)..........................................................................................20
The Media Database................................................................................................23
Why a Media Database ?.........................................................................................23
Manage Folders.......................................................................................................24
From the Harddisk to the Internet............................................................................25
First Steps

Login to Falt4

The Falt4 Administration is located at „http://www.your-domain.com/admin/“.

Falt4 requires a valid username/password combination to login. Additionally you can

choose the desired domain which you want to edit.

Structure of the Falt4 Administration

The Falt4 administration is divided into three main areas.

Red area: Main navigation for accessing the different sections of the administration
Blue area: Holds the actions of the active section
Yellow area: Working area of the selected action
Articles

Create a new article

To create a new article follow these steps:

Step 1: Click on „Article“ in the main navigation

Step 2: Choose the action „Create Article“

Step 3: Insert the desired title and choose the appropriate category

Step 4: Click „next“

The article gets created as soon as you click on „next“. As a next step you are now able to
edit the content of your newly created article or change some of its properties.
Action 1:
To edit the content you have to choose one out of three sections of the article. Normally
you want to edit the „main section“.

Action 2:
In the article properties you can change the title or choose a different articletemplate for
example. If you change properties you have to save (Action 3) the article before leaving
the page.

Action 3:
Save the article if you do not want to edit now.

After a click on one of these three sections (Introduction, Main article, Closing part) the
editor opens (by default this is the WYSIWYG editor, otherwise choose an other editor on
the right of Introduction).
Action 1:
If you got the required warranties, you can select „Auto publishing“ and optionally set a
date for publication.

Action 2:
This the editor window, all the content related work is done here. You can create the
content with your desired formating. Additionally you have access to all your documents
over the mediadatabase. With a right-click on an element like tables or images you can
edit various properties.

Action 3:
it is recommended that you click on „Buffer data“ when you're working on articles to
prevent data loss.

After successful creation and saving of the article it is saved in the system. To use an
article on your website it also needs to be published. To publish an article you have to go
to the „Listview“ of the articles or choose „automatic publishing“ in the editor.
The Article Listing

Action 1:
For more clearness you have the possibility to filter the listing with various criteria.

Action 2:
All articles get listed here with additional information such as date of creation and autor.
You can sort the list by category, title and date.

Action 3:
Every article has different functions depending on the permission of your user. You can set
permissions, delete, publish or edit the article.
Navigation

Linking possibilities

The Articlelink
The Articlelink is a direct link to an article. The active articletemplate gets loaded.

The Categorylink
When using categorylinks, a defined amount of articles of the chosen category gets
loaded. The active weblogtemplate is being used. This way you have the opportunity to
show only a title and an introduction followed by a read-more link to show the full article.

The Modulelink
A modulelink links a module only. If you want to show a module additionally to an article,
you have to choose an articlelink and an article with an included module(by default
including modules works with 'replacement tags' that start with # (example
#module(guestbook)).

The external link

With external links you have the possibility to link other websites directly in you
navigation. You can also link to files on your server outside of the CMS.

Step 1: To get to the navigation administration click on “navigation”

Step 2: To create a new navigationlink click on “add navigation point”.

Step 3: Enter the desired linkname (If you work with multiple languages you can
translate the linkname here). Additionally you can choose an image and an
alternative template.

Step 4: Choose the desired linking type and the target.

Step 5: Save. Now you get asked at which position you want your new link to show up.
Categories

Categories are a good way to preserve clarity in the system. You can use different
functions to show articles which are grouped in categories to present them on the
website. As an example you can create a newssite with ease. Just create the category
you wish, save all your articles in this category and link to it trough the navigation with the
weblog type linking option. Additionally there are extranet categories which are protected
against unauthorized access.
You cannot nest categories.

Create a category

Step 1: You can access the category management over the main navigation by clicking
on categories.

Step 2: Click on add category in the subnavigation.

Step 3: Choose the desired category type.

Templates

Construction of Templates

In Falt4 basically two types of templates exist. This are sitetemplates which will be used to
define the positions of the different elements like the navigation and the content and on
the other hand contenttemplates which are used for presenting the content.

A sitetemplate contains at least a position for the content (#engine) and for the
navigation (example: #group1, the number of the group is depending on how much
different navigation you used in the navigation management). Additionally a sitetemplate
can contain other positions for modules like the search or the survey.

Allowed positions (replacementtags) are:

● #group1: This will include the chosen navigation, as can be seen in the
navigationadministration.
● #engine: This will include the active contenttemplate
● #position_top: for positioning modules
● #position_left1 [1-9]: for positioning modules
● #position_right1 [1-9]: for positioning modules
● #position_center: for positioning modules

Contenttemplates are split into three types, which are:

● Articletemplates
● Weblogtemplates
● Moduletemplates

Article and Weblogtemplates can contain the following positions:

● #title this will show the title of the article
● #content1 introduction of the article
● #content2 main content of the article
● #content3 ending content of the article
● #read_more A link to the full article if you do not show all of #content[1-3]
● #module(modulename) this is for including modules in articles eg.:
#module(guestbook)
● #print a link for opening only the content in a new window with the appropriate
template
● #autor the loginname of the autor
 ● #date creationdate of the article
● #name_full the full name of the autor as defined in the account
● #all a link for showing all articles out of the selected category
● #topicpic an optional image for the selected category

A moduletemplate only needs two positions because if you want to build a custom page
with an included module you should use the #module tag in a contenttemplate.
● #module this is where the module gets included.
● #mod_name the actual name of themodule (eg.: guestbook).

You should be aware that site template must begin after the <body> tag and
ends just before </body>.

Exampletemplates

A sitetemplate

<div id='container'>
<div id='left'>
<div id='nav'>#group1</div>
<div id='survey'>#position_left1</div>
</div>
<div id='content'>#engine</div>
</div>

#group1 #engine

#position_left1

An articletemplate (included at the #engine position)

<table>
<tr><td><strong>#title</strong></td><td>written by: #autor at #date</td></tr>
<tr><td colspan=2>#content1</td></tr>
<tr><td colspan=2>#content2</td></tr>
<tr><td colspan=2>#content3</td></tr>
</table>

#title Written by #autor

at #date
#content1
#content2
#content3

A weblogtemplate (included at the #engine position)

<table>
<tr><td><strong>#title</strong></td><td>written at #date</td></tr>
<tr><td colspan=2>#content1</td></tr>
<tr><td colspan=2>#read_more</td></tr>
</table>

#title Written at #date

#content1
#read_more

A moduletemplate (included at the #engine position)

<table>
<tr><td><h1>#mod_name</h1></td></tr>
<tr><td>#module</td></tr>
</table>

#mod_name
#module
Stylesheets (CSS) and Templates

Normally every template has its stylesheet. It is possible to add more than one stylesheet
to a template, that gives you the possibility to have some styledefinitions not template
specific. As an example you can format a title tag (<h1>,<h2> for all templates.

A stylesheet contains only the definitions.

h1,h2 {
font-size: 22px;
font-color: grey;
}
#nav {
background-color: #ff6600;
border: 1px black dashed;
}

How to create Templates

You can create templates either locally and upload them or use the integrated editor to
create your code or insert your code.

Step 1: You can reach the template management over the mainnavigation by clicking
on Administration.
Step 2: Click on add template to create a new template. To manage the existing
templates click on manage templates.
Step 3: Enter a descriptive title for your new template.
Step 4: Choose the type of your new template (as described above).
Step 5: Choose if the new template should be the new standard template.

Now you have to choose whether you want to upload the template or use the integrated
editor to create your code.

Step 6: browse your local disk and choose the template you want to open.
(Step 7): here you could switch to the editor instead.
Step 8: With a click on save the template gets uploaded.
Domains

With Falt4 it is possible to manage multiple domains with only one instance of the system.

To get Falt4 running with multiple domains you have to setup your hosting like this.

Install Falt4 in the directory you want.

Example: /home/andi/htdocs/falt4

Configure apache (or the webserver of your choice) so that all the domains you want to
manage with falt4 point to the directory you chosen before.
Example: www.falt4.ch -> /home/andi/htdocs/falt4
www.mypersonalwebsite.org -> /home/andi/htdocs/falt4

Now you have to add all domains in the Falt4

administration. You find the domain management
under Administration -> Domains.

You need at least a domain name and a username

with password. This will be the administrator for the
new domain.

Now Falt4 identifies from which the visitors are

coming and serves the right page.

To manage these domains you have to choose the desired domain name in the login box.
This way every domain has its own administration area. This way every domain is
separated from each other.

This gives great opportunities like the possibility to build a webservice with Falt4 hosting
or you could create a blogger like service in just minutes.
User

The 4 different usertypes

There are four different usertypes, but only three of them are for the administration area.
● Administrator
● Publisher
● Autor
the fourth type is the extranetuser.

Every type has its own specialties to allow you to create the workflow you need.

The Administrator:

The administrator is the usertype which is not supposed to work on the content. The
administrator is the user which edits the structure and look & feel of the site. He creates
new user, has the possibility to change colors, fonts, width and so on. He is able to view
the site statistics and plan and create new campaigns to improve the site. Practically all
administrative tasks fall in his field of responsibility.

This usertype can not have any special authorizations. He is able to access all functions of
the whole system.

The Publisher:

The publisher is the default user in the system. You have the possibility to set permissions
for publishers for every function in the system. So he can be as restricted as a autor or an
administrator. As an example you can give him permission to create and publish articles.
This way you can use the publisher as a controlling instance. You can even give different
publishers permission for different categories so can split the workflow even more. Instead
of publishing he also has the option so send the article back with a message attached.
Then the autor has to edit the article again and send it for publishing again.

The Author:

Authors are the usertype with the lowest amount of possibilities. It is only possible to
allow access on the article and mediadatabase functions. Additionally he can be restricted
on certain categories to write in. Authors are by default the users who write articles and
correct it when something changes.
But if you realize smaller projects it is often useful to only work with the publisher
usertype because the workflow is simpler and shorter.

The Extranetuser:

The extranetuser does not have access to the administration area. Instead he can log in
on the website and access the so called extranet or just some additional secure content.
How to add a new user

Step 1: You can find the

user management under
administration.

Step 2: Click on add user

to create a new user.

Step 3: Choose the desired usertype to create a new

user with this type(You will find this icons as
replacement for different user related
functions). In this example we choose the
publisher.

Step 4: A new user requires as least a username and a secure password (recommended
password uses characters and numbers). If you like you can enter various other
user related information like the email address or the URL of his own website.
Additionally you can configure how the administration area behaves when this
user logs in. Like setting the default editor or how lists get sorted by default.

Step 5: If you already have a user with the same permissions set as you want the new
user to have, you can copy this users permission here.

Step 6: With a click on save the user is being created.

Site Properties (defaults)

To get to the site properties you have to click on administration (step 1) and then defaults
(step 2).

Under administration you can find various other functions of Falt4.

● Manage Tempaltes
● Manage Domains
● Manage Users
● Manage Modules
● Manage Parser replacements
● Blocking System
● Updates
Section 1: General Settings
Page title is the title of your Webseite <title>Pagetitle</title>
Copyright is the content of the copyright metatag
Metadesciption is the content of the description metatag
List signs are the default list icons (li) from the mediadatabase

Section 2: Navigation Settings

Navigation picture properties defines how a picture in the
navigation is beeing displayed. It can be shown before or behind the
link, replace the link or as linkbackground.

Section 3: Default font and link settings

Font family,font colour,link color,link:hover color,links
underline, font size
Background color is the background color of the body of your
webseite

Section 4: Front options

You can translate all words and sentences which are produced by the
system itself here. Like read the full article which is used when
building newspages.

Section 5: Backend options

Here you can define the default behaviour of the administration area.
For example which editor should be selected by default or how
certain lists get sorted.

Section 6: Security and Workflow settings

mod_rewrite lets you autmoatically create search engine friendly
urls

Section 7: Startpage behaviour

Define which page or category should be loaded as your front or
startpage.
The Media Database

Why a Media Database ?

The Media Database is like the article management a central container for different media
files. Media files are all kind of files like images, pdf, ppt and so on. Most of the time the
Media Database is only used for images and documents.
Normally you need the Media Database every time you want to add other content than
text in your website. As an example in articles, pictures in your navigation or if you want
to share some other kind of downloads.

In the Media Database you have the possibility to create folders. This works just like in
windows. Folders can be nested in each other for a maximum of clarity
You can do more than just manage your
files with the Media Database. You have
different functions like automatically render
a copyright image on all your files or create
thumbnails on the fly when uploading.
If you want to manage and upload files
directly, you get to the Media Database by
clicking on „Media Database“ in the top
navigation.
To use media files in your website you can
click the Media Database icon (image left: example article editor) where possible. The
Media Database then gets opened in a pop-up.
Manage Folders

Folders in the Media Database are

comparable to folders on your local
filesystem. Folders are designed to
group an amount of mediafiles to
get a clean structure in your Media
Database. A Folder can contain
unlimited subfolders. As a good
example look at the treeview
(Action 1).

The opened folder is the currently active. All red folders are extranet-folders and are only
accessible by logged in users that have the authority to view them.

All needed operations for managing Folders inside the Media

Database can be reached trough the link „Folders“. There you
can:
● Create new folders
● edit existing
● delete unneeded
● or download as a backup

This functions are based on the currently opened folder. When a new folder gets created,
it will get a subfolder of the currently active (opened). This is the default behavior for all
operations. As an example you can rename the opened folder by clicking „Folder“->“edit
folder“.
From the Harddisk to the Internet

Step by Step. How to bring an image from your harddisk to your website trough an article.

Step 1: Go to the article listing

Step 2: click on the edit icon on the right side of the desired article.

Step 3: Open the desired Section of the article with the visual editor.

Step 4: Click where you want the image to be inserted.

Step 5: Click on the Media Database icon

(you will see this icon everywhere where
you can insert media files).

A pop-up opens up (so be sure they are

allowed for your own website) including
the Media Database.
Step 6: Open the folder where you want to save the image.
Step 7: Open the menu „folders“ and choose „new file“.

Step 8: Enter an informative title(it gets used as alt tag of the image).
Step 9: Click on browse to choose the file on your local filesystem.
Step 10: It is possible to automatically create thumbnails. Check the checkbox and
insert the desired width or height if you want the thumbnail to be
proportionally resized.
Step 11: With a click on save the file gets uploaded. You get redirected to the folder
preview of the active folder.
 Step 12: Locate the newly uploaded file
in the folder preview and click on it.

Now you get to the image properties

and the options how to insert the
picture in the article.

Step 13: You have three options how to insert the picture in your article.

● Insert as thumbnail: the

thumbnail with a link to
the original picture get
added.
● Insert as picture: only
the original picture gets
added.
● Insert as link: A link to
the file gets added to
your article.

Step 14: click on the insert button and the image will be added to currently selected
location in the article.

Congratulations!