justVisual Content Management System

Client requirements (to administer):
Windows OS, IE 5.5+, Firefox 1.0+, Mozilla 1.3+ and Netscape 7+.

Server requirements:
PHP > 4.1, Linux or Windows

Components used:

FCKEditor (customized)

Features:

no database needed
works even at safe mode enabled hosts
WYSIWYG-based menu and content editing
comfortably operated file upload (powered by FCKEditor)
a build-in contact page - you don't need to publish your email address
the choice between either a pre-made template or your own design
the design template can be changed dynamically
support for multiple languages
show/hide page sections
site visitors and visited pages report ^(*)
backup of the entire site as a static archive
well-named pages, no querystrings - ideal for search engines

^* - default off; MySQL database for visitor logging needed

If you have safe mode enabled on your server, download the second archive (in this case, you should set the ftp access data in ftp_config.php), otherwise select the first download.

Change log:

Version 1.2 - added the possibility of transferring the site to a different folder to make the URL short and easy to remember
Version 1.1 - bugs in navigation edit functions fixed

Installation

Unzip the archive, configure the system and copy it to a folder on your server.

Set write permissions to this folders on the server :

/justVisual/sites/
/UserFiles/File/
/UserFiles/Image/
/UserFiles/Flash/
/UserFiles/Media/

Configuration

1. In the both of files

/justVisual/FCKeditor/editor/filemanager/browser/default/connectors/php/config.php
/justVisual/FCKeditor/editor/filemanager/upload/php/config.php

set the appropriate Config["UserFilesPath"]
It means the document root based path to the folder UserFiles.

2. /justVisual/system/login0.php

- configure here the mail text for the forgotten password.

3. /justVisual/sites/site/pages/content/contact_content.php

- configure here the subject and sender of mails sent via contact form.

4. In case of safe mode enabled on the host:

- configure the file /justVisual/system/ftp_config.php

Set the host name, ftp username, ftp password and the parameter $diff.
What means $diff:
this is the difference between two strings: the document root directory of your host and the ftp root directory.
The ftp root directory is the root directory what you see if you log in to the ftp server.

Example 1:

document root: /home/username/www/
ftp root: /www/
- the $diff is "/home/username"

Example 2:

document root: /home/htdocs/www/
ftp root: /
- the $diff is "/home/htdocs/www"

The rule is:
$diff + ftp root = document root

Creating of new sites

Open in the browser the file /index.php and follow the instructions. Please don't use special characters for the site name.

The URL of the new site is /justVisual/sites/YourSite/index.php
Open the new site in the browser, log in and create the navigation and the content.

For shorter URL use forwarding or frame construction like this:
		<FRAMESET ROWS="100%," Border="0" FrameBorder="0">
  			<FRAME SRC="index.php"  NoResize Scrolling="auto">
		</FRAMESET>
- or see the next paragraph

Transfer a site to another folder

By default every new site you create appears in the directory /justVisual/sites/
In this case, the URL of the new site is http://..../justVisual/sites/yourSiteName
If you want to have a short URL (eg., http://yourSiteName), make it like that:

create the new site (let it be called "yourSiteName")
cut the directory justVisual/sites/yourSiteName and paste it to the directory of your choice
open the file rootconfig_example.php in yourSiteName folder and edit it according to your justVisual install directory settings.
This file will link the displaced site folder to the original justVisual folder.
rename the file rootconfig_example.php to rootconfig.php
ensure that all the write permissions in the folders yourSiteName/pages, yourSiteName/pages_content and yourSiteName/common are enabled
if you create the new site entry manually (without using the site adding interface under /index.php - eg., per copy-paste-rename), don't forget to create the appropriate subfolders in folders UserFiles/File, UserFiles/Image, UserFiles/Flash, UserFiles/Media and set the write permissions.
Otherwise, you would not be able to add images and other media files to the content pages.
From my expirience, the FCKeditor seems to have problems if I used it at another local hard drive as C. To avoid it I recommend to install the justVisual only at the C local drive.

Adding of new templates

The template (style) directory is /justVisual/style
Don't forget to add the new entry in the /justVisual/style/js too.

How it works

The main template file is buildpage.php in the justVisual/system folder.
All the functions you can find in utilities.php.
The user control panel is userPanel.php.

The menu, footer and header files are located in yourSiteName/common folder.
The files and folders which are not published yet begins with "____"

TODO

The main TODO is the style editor. At the moment, it is not really useful.

Notes

Please don't change anything in the folder /justVisual/sites/site. This is the source for new sites.
In order to printVersion and getArchive works, at least one PHP setting must exist: either allow_url_fopen is true or curl library installed.
The visitors overview is currently disabled. In order to enable it, the MySQL database is required. Run the /justVisual/system/Log_RSS/install.php to install the Log_RSS component.
This script creates 2 tables in the database and writes the user data into the file parameters.php (additional info: http://www.fh54.de/Log_RSS )
After this, uncomment the commented table row in the /justVisual/system/userPanel.php and the last string in the /justVisual/system/buildpage.php
Set the option $useFopenURL in the /justVisual/system/Log_RSS/RSS2HTML/rss2html.php

justVisual CMS version 1.2

Lightweight WYSIWYG databaseless Content Management System