Location: PHPKode > projects > Rilke CMS > rilkecms_095b_release/readme.txt
<http://rilkecms.sourceforge.net> 	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 <#i>
   2. What's New <#ii>
   3. Technical Details <#iii>
   4. Requirements <#iv>
   5. Getting PHP, MySQL and Apache <#v>
   6. Call for Help <#vi>
   7. Setup <#vii>
   8. Credits <#viii>
   9. License <#ix>

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/
<http://www.rilkecms.com/demo/> . For the latest Rilke CMS news, please
check out http://www.rilkecms.com/rilkecms
<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:

    * A redesigned default theme
    * A built in permissions / user-level system (writer, editor,
      administrator)
    * A complete user interface for adminstering users (only available
      to administrators)
    * Customizable Links (via a styled drop down menu)
    * Customizable Blogroll + Integrated Mini RSS Feed Aggregator
    * A customizable contact info block

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
<changelog.html>  <http://www.rilkecms.com/rilkecms/?id=65>.

Documentation Tips:

    * A new document on translating Rilke CMS's User Interface has been
      published at SourceForge
      <https://sourceforge.net/docman/display_doc.php?docid=18431&group_id=84255>
    * A draft of a tutorial on making or customizing themes for Rilke
      CMS
      <https://sourceforge.net/docman/display_doc.php?docid=18039&group_id=84255>
      has been published. Feel free to customize Rilke CMS'
      look-and-feel to your heart's content - my only request is that
      you leave the new "powered by Rilke CMS" logo at the bottom intact.

A note on upgrading:

    * If you are upgrading from previous versions, please follow the
      following steps:

      1)Use PHPMyAdmin to export the contents of the archives (posts)
      and bbbook(comments) tables to comma separated (CSV) files

      2)Install Rilke CMS 0.95 beta to a new folder on your webhost,
      choosing the same username and password you did before.  Please
      note that the user specified at the time you install Rilke CMS
      will be an administrator. You can add more users from the "More
      ..." option in the administration screen.

      3)Use PHPMyAdmin to import the contents of your old archives and
      bbbook tables into the newly created 0.95 tables.

    * Please make sure that the value of $titleurl in prefs.php contains
      a slash at the end, i.e.: http://www.yahoo.com/ If not, then you
      might get an error in the Administration Screen when you try to
      switch edit modes, or try to attach an image.

<https://sourceforge.net/docman/display_doc.php?docid=18045&group_id=84255>
------------------------------------------------------------------------

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:

    * Apache Web Server <http://www.apache.org/> - ver. 1.3 (or higher)
    * PHP <http://www.php.net> - ver 4.2.3 - 4.3.2
    * MySQL Database <http://www.mysql.com> - ver 3.23 (or higher)

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
<http://maguma.com/en/lightdownload.html>, 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:

    * Programmer :  PHP / MySQL / JavaScript
    * Designer:  HTML / CSS
    * Graphic Designer: Adobe Photoshop / Gimp / Flash
    * Documenter: Technical Writing Skills (and familiarity with content
      management systems)
    * Translator: Knowledge of a language other than English

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
      <install_rilkecms/setup/makeprefs.html>)  
   5. Choose Username and Password
   6. Create Setup File (using makesetup.html
      <install_rilkecms/setup/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
      <https://sourceforge.net/docman/display_doc.php?docid=17911&group_id=84255>.
  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
<http://www.7-zip.org/> (free), WinRAR <http://rarsoft.com/>
(shareware), and WinZip <http://winzip.com/> (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  <http://maguma.com/en/lightdownload.html>on Windows, you can
launch PHPMyAdmin from within the Maguma PHP Editor.  For more
information on creating databases, visit MySQL's documentation
<http://www.mysql.com/doc/en/CREATE_DATABASE.html> or the PHPMyAdmin
<http://www.phpmyadmin.net/> 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 <install_rilkecms/setup/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
<install_rilkecms/setup/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 <http://filezilla.sourceforge.net> (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:

    * Check prefs.php to make sure that you entered all MySQL connection
      information correctly
    * Double check that you created a database for Rilke CMS, and that
      its name is correctly entered in prefs.php
    * Make sure that (in your PHP settings) that register globals and
      magic quotes are turned on. Also check the include path settings
      <http://www.zend.com/manual/configuration.directives.php#ini.include-path>to
      make sure that relative includes are allowed
    * Make sure that your session path is writable and points to a valid
      directory (many Windows users have this problem and have to make a
      change in php.ini for this to work)
    * If you get a PEAR error, it is probably because your include path
      points to non-existent PEAR libraries. You can fix this by
      changing the include_path directive to point to the adminpear/Auth
      directory. More information on this is in the General
      Troubleshooting Guide (Point 7)
      <https://sourceforge.net/docman/display_doc.php?docid=17911&group_id=84255#seven>.
    * Consult the online documentation for Rilke CMS
      <http://sourceforge.net/docman/?group_id=84255> which contains
      various troubleshooting guides
    * If you need to create the database tables manually, you may
      consult the database schema files in the db_schema folder

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
<https://sourceforge.net/docman/display_doc.php?docid=17911&group_id=84255>.

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
<http://www.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 <sharealikelicense.html> that came with this distribution
of Rilke CMS.




Return current item: Rilke CMS