AldoContent CMS Files

AldoContent 0.9 README

Copyright (c) 2007 Miguel Angel DA VILA <miguelangeldavila at argotvisual dot net>
Licensed under GPLv2 (or any later version, see COPYING)

Introduction
================================

   AldoContent is a modern Online Based Content Management System written in PHP
   by Miguel Angel Da Vila in Mexico City. Its design is focused on usability 
   to be as user friendly and versatile as possible.

   AldoContent meets the features required by a real CMS: Templates based layout,
   easily editable content (WysiWyg), scalable feature sets via plugins, Document
   management and of course, Web standards commitment.
   
Installation and requirements
================================

Please read the aldocms/docs/INSTALL file to know about system requirements and 
follow the instructions on it in order to install the program.   

Copyright
=================================

This software is copyrighted (2007) by Miguel Angel Da Vila and is protected by 
the GNU Public License Version 2 (GPL). In short, this means:
	--you'll have the source code available
	--you may run this program on as many machines as you want/have
	--you may copy and distribute it as much as you want, as long as you don't
	  violate the copyright, distribute it as a commercial product (and keep all
	  files together!)
	--you may edit this code to fit your needs/wishes (please, let me know about
      improvements)
	--you may use this code for your own applications but they have to be 
	  released under GPL then as well.
      
For licensing details, please read the file named COPYING.

If you release this program e.g. in a bundle of software on CD/DVD, publish
an article about this program etc, let the author know about this. Not that
you need an explicit permission (as long as you stick to the above terms,
especially the GPL) you are even encouraged to do so.


About credits
========================

As a courtesy to me and my effort, I respectfully request you to retain the link
to AldoContent in the footer of your website pages, in this way you will 
contribute to invite more users to use with AldoContent and, in the spirit of 
Open Source, to involve more people to participate making improvements, 
discovering bugs or security issues in your own benefit.


Features
========================

This is a brief of the main features:

*  Uses HTML templates containing the webpage's layout. It is possible to have 
   many templates as you wish and use them to have different designs according
   the site section.

   The dinamically generated content is positioned in the templates via special
   tags.

*  Multilingual content and interface. The interface internationalization is
   based on GNU gettext, an NLS (Native Language Support) API from GNU.

   Te content internationalization is possible by writing and storing content
   for many languages as you have installed for the interface in the locale
   folder of your site.

*  With LiveIMG manages a sets of images which are positioned in the templates
   using a special tag to create random or static image banners.

*  Uses FCKeditor to bring Rich Text Formating capabilities to edit content.

*  AldoContent has its own FCKeditor plugin to create hyperlinks to the dynamic
   pages created with it.

*  It's equiped with a file manager to upload and manage files in the server.

*  Has the capability to create premium content for registered members.

*  Authors can decide if content is published or unpublished in order to hide
   it from public while is approved. This feature can also be used to
   maintain pages out of the visitors visible menu wich are usseful to store
   forms or content with its own hyperlinks to get it.

*  The content is organized in tree levels: a first level consisting in sections
   grouping a second level with the navigation menus from which the user comes
   to content. And a third level based on articles which can be a large text
   separated in small pages or chapters.

*  SEO friendly URLs cappable.

NOTES:
========================

Enable Firefox paste functionality

    1. Close all Firefox windows/tabs.

    2. Create a text file named user.js in your PROFILE folder (see below).
       On Windows use notepad (make sure you can see file extensions first so
       you don't create a file named user.js.txt).

       On Windows XP your PROFILE folder is usually here:
       C:\Documents and Settings\[UserName]\Application Data\Mozilla\Firefox\
       Profiles\Default.Oj

       and similar for Windows 2000.

       Do NOT use the Firefox/Mozilla program under C:\Program Files\Mozilla\

       On Linux/Unix your PROFILE folder is on:

       /home/[username]/.mozilla/firefox/[someletters].[profile]/

    3. Add the following lines to the user.js file (replace 'yourdomain' with
       your real domain where AldoContent is used for):

       user_pref("capability.policy.policynames", "allowclipboard");
       user_pref("capability.policy.allowclipboard.sites" , "http://www.yourdomain.com");
       user_pref("capability.policy.allowclipboard.Clipboard.cutcopy", "allAccess");
       user_pref("capability.policy.allowclipboard.Clipboard.paste", "allAccess");

    5. On Windows save the file, close notepad and restart your computer.

       On Unix-Like systems you don't have to restart as usual ;-).

    Now you should be able to cut-and-paste in FCK editor.

    If you doesn't like to configure your system, use [Ctrl]+[v], that will work
    as a last resort.

SEO frienddly URLs

    In order to activate the SEO friendly URLs your server needs to have active
    mod_rewrite (it minds that this cappability is intended for servers runnig
    Apache httpd server) and in case your site runs in a hosting provider shared
    server the ISP must allow change configuration through local .htaccess
    file on your base directory.

    If your installation meets all pre-requisites the .htaccess must have
    following lines on it:

    RewriteEngine On

    RewriteCond %{REQUEST_FILENAME} !-f [NC]
    RewriteRule ^((.+)/)(.+)\.html$ index.php?section=$2&pag_name=$3 [QSA]

    If your hosting service or the server where AldoContent runs is a virtual
    server probably you should have to make a workaround, to make it work.


About AldoContent name on
===========================

   The name was inspired by a great hairy friend, a french poodle. He is always
   ready, is fast, funny and small. AldoContent meets some of those values.

   Also comes as 'Aldo Do Content' recursive acronym.

Athor's website
===========================
   http://www.argotvisual.net


Known issues
============================

+ Unmarking and stoping using a language in the configuration screen does not 
  eliminates the entries in the database.
+ When adding a language, the menu entries are not created automatically for 
  the new language, each of them must be opened in a previous existing language
  and saved with the data corresponding to the language added. 


Bugs
============================
   If you discover some bug please report it through our website contact form.

TODO
============================
*  An autobackup system.
*  A versioning system.
*  Workflow.
*  Assign permissions to each role