Rilke CMS README file for Rilke CMS 0.95 beta
http://www.rilkecms.com / http://rilkecms.sourceforge.net
Jayesh Sheth (email: jayeshsh [at] ceruleansky.com )
September 03, 2003
Overview:
  1. Introduction
  2. What's New
  3. Technical Details
  4. Requirements
  5. Getting PHP, MySQL and Apache
  6. Call for Help
  7. Setup
  8. Credits
  9. License
I. Introduction:
Welcome to the eighth  public release of Rilke CMS! Rilke CMS is a content management system which enables people to update weblogs, intranet sites and other collaborative websites. It has been written with the goals of usability and simplicity. It is hoped that, once set up, it can be used to update a website by anyone who has used a word processor. For more information on its features, and to view a live demo, please visit http://www.rilkecms.com/demo/ . For the latest Rilke CMS news, please check out http://www.rilkecms.com/rilkecms/ .

II. What's New?
Rilke CMS 0.95 beta is a big feature release. It also fixes many long standing bugs.

Because of the large number of changes introduced in this version, it is being released as a "beta" version. After these changes have been extensively tested by a wide variety of users, a new non-beta will be released.

New Features in 0.95 beta include:
 This release also fixes many bugs, including the (remaining) bugs that occured  with register globals turned off in PHP.
The total number of major changes (including feature additions and bug fixes) is 20.

Please note that in this version many newly introduced screens have not been translated into German yet. When 0.95 final is released, these screens will also be available in German.

For a detailed list of changes, please review the Changelog .

Documentation Tips:
 A note on upgrading:


III. Technical Details:
Rilke CMS is written in PHP, and stores its data in a  MySQL database. It has a WYSIWYG publishing screen - thus its end users do not need to know HTML in order to use it. All information is entered in the form of entries, or posts. Visitors to a Rilke CMS powered site can comment on a post using the built in commenting system. The look and feel of the site can be changed with the click of a button, due to Rilke CMS' reliance on configurable CSS based themes. For more information on its features, and to view a live demo, please visit:
http://www.rilkecms.com/demo/

IV. Requirements:
In order to install Rilke CMS, it is recommended that you have a server with the following configuration:
 Operating System: Rilke CMS has been tested on Debian Linux and Windows XP. It should also work on other Linux flavors and hopefully on Mac OS X.

Rich Text Editing requires Mozilla 1.3+, Mozilla Firebird 0.61+ or Internet Explorer 5.5 +.

V. Getting PHP, MySQL and Apache:
Windows users can use the convenient package made available by Maguma, which bundles PHP, MySQL, Apache and PHPMyAdmin (MySQL administration tool) with their PHP editor in an easy-to-install package. If you use Linux, these might already be installed with your distribution. Please check the websites listed above for more information.

VI. Call for Help: If you fit any of the following profiles, the Rilke CMS project could use your help:
Please contact Jayesh at the email address specified above if you are interested in helping out!
Thanks!

VII. Setup:

Quick Setup Guide:
  1. Download Rilke CMS: https://sourceforge.net/project/showfiles.php?group_id=84255
  2. Unzip Rilke CMS zip file
  3. Create a MySQL database called "rilkecms".
  4. Create Preferences File [prefs.php] (using makeprefs.html)  
  5. Choose Username and Password
  6. Create Setup File (using makesetup.html)
  7. Upload contents of install_rilkecms directory to www.yourwebsite.com/rilkecms/
  8. Visit www.yourwebsite.com/rilkecms/setup/ and login using the Username and Password you chose when you created the setup file
  9. Watch as your MySQL tables are created and initialized (populated)
  10.  Log in to the Administration Screen: All done! Please Note: If you receive a PEAR-related fatal error, or a blank screen at this stage, please review the General Troubleshooting Guide.
  11. Well, almost done: If you have trouble uploading/attaching images on Linux, please chmod the uploads directory to 777.
  12. Optional: delete the setup folder after you are done. (It is password protected, but those files are not needed after Rilke CMS has been set up).
Detailed Setup Guide:

1. Download Rilke CMS from https://sourceforge.net/project/showfiles.php?group_id=84255
2.  Unzip the Rilke CMS zip file which you downloaded. If  you use Windows, I recommend any of the following unzip programs: 7-Zip (free), WinRAR (shareware), and WinZip (shareware). If you Linux, I trust you know which unzip program to use! The files contained with the directory install_rilkecms are the ones you will need.
3. Create a new Database for Rilke CMS. This can most often be accomplished using PHPMyAdmin. If you are unsure, ask your web hosting provider if this is available. If you have used Maguma's Installation Package  on Windows, you can launch PHPMyAdmin from within the Maguma PHP Editor.  For more information on creating databases, visit MySQL's documentation or the PHPMyAdmin page.
4. Create Preferences File: So that Rilke CMS knows which database to access, what your weblog is called, and so on, it requires access to a preferences file, called prefs.php. You can generate this file offline, by visiting the makeprefs.html (located in the install_rilkecms/setup directory). You should generate the preference file save its contents to install_rilkecms/prefs.php as prefs.php. Important: Add the following line to the end of the generated prefs.php configuration file (if this line is not already present) : require_once("lang.php");
5. Choose Username and Password: This step is important - in order to administrate Rilke CMS, you will need (at least) one username and password. When you visit makesetup.html (located in the install_rilkecms/setup directory), you will be prompted to enter a username and password. It is recommend you choose an easy to use username, and use the difficult to guess, randomly generated password. Save this information to a file so that you will not forget it. 
6. Create Setup File:
Press the Create Setup button and save the contents of the generated file as setup.php to the install_rilkecms/setup directory.
7. Upload the contents of the install_rilkecms directory to a directory called rilkecms on your webhost. If you created the rilkecms directory under the root folder of www.yourwebsite.com, then Rilke CMS would be available at www.yourwebsite.com/rilkecms/ . In order to upload these files, you will need an FTP program. If you use Windows, I recommend FileZilla (freely available).
8. Begin Setup : Visit www.yourwebsite.com/rilkecms/setup/ and login using the Username and Password you chose when you created the setup file. If all goes well, you should see notifications of tables being created. If you get an error,  please review the following steps:
9. Check for Successful Setup Message: If all goes well, you will be notified that Rilke CMS has been set up successfully. You will be prompted to log in.

10. Log in to the Main Administration Screen, and try to add a post. If it works, Rilke CMS is set up. Congratulations! Please Note: If you receive a PEAR-related fatal error, or a blank screen at this stage, please review the General Troubleshooting Guide.

11. Well, almost done: If you have trouble uploading/attaching images on Linux, please chmod the uploads directory to 777.

12. Optional: delete the setup folder after you are done. (It is password protected, but those files are not needed after Rilke CMS has been set up).

VIII. Credits:

Main development of Rilke CMS: Jayesh Sheth, Cerulean Sky Creations, LLC.

Rilke CMS was originally based on Rodin: http://rodin.lot23.com
You may still notice similarities to Rodin, but most of the code has been rewritten

Some templates were based ideas from designs found at oswd.org

Some PEAR libraries have been used (DB, Authentication, HTML_Crypt), available from http://pear.php.net

Some background graphics from http://www.k10k.net were used for the templates.

The commenting system was based on a guestbook class by nevarsa.com, and available at:
http://px.sklar.com/code.html?id=589&fmt=pl

The upload class was written by David Fox and Dave Tufts,and is available at: [url missing]

The HTMLarea WYSIWYG editor was written by interactivetools.com and is available at:
http://www.interactivetools.com/iforum/Open_Source_C3/htmlArea_v3.0_-_Alpha_Release_F14/htmlArea_3:_Alpha_release_P7101/

The JavaScript MD5 and random password code (for the setup wizard) uses code from:
http://pajhome.org.uk/crypt/md5/
http://webdeveloper.earthweb.com/repository/webdev/content/software/1999/08/16/JS_18893/script18893.html

IX. License:

Rilke CMS and its associated templates are licensed under the Creative Commons Attribution-ShareAlike License. The two main terms of this license are:

Attribution. The licensor permits others to copy, distribute, display, and perform the work. In return, licensees must give the original author credit.

This means that you can make a copy of and use this software; however, you must list Cerulean Sky Creations, LLC / rilkecms.com as the original author in any re-distribution of this software. In a re-distribution, you must also reproduce the credits section above, or the entire readme file which contains this information.

A link back to rilkecms.com and use of the "powered by Rilke CMS logo" on sites using Rilke CMS would be greatly appreciated.
    
Share Alike. The licensor permits others to distribute derivative works only under a license identical to the one that governs the licensor's work.

You can distribute derivative works of Rilke CMS, but only under this same license.

You can obtain a summary and copy of this license on the web at http://creativecommons.org/licenses/by-sa/1.0/legalcode or in the copy of the license that came with this distribution of Rilke CMS.