Sebrac's CMS (Migas)
Release 1.0
October 2008 

created just for hobby and for free by Sebrac
www.sebrac.webcindario.com


# Author of this php script:   www.sebrac.webcindario.com
#                              info.compgos@gmail.com
# Release:                     1.0, 2008 October
# License:                     Gnu-Gpl
# 
# ******************************************************************************** 
# 
# W A R N I N G:   The author is not a php expert.
#                  so there could be here many errors and bugs. This cms is not
#                  100% safe from hackers attacks, the author did all his best in
#                  order to write good code, there is a double control to sanitize
#                  any user's input by browser, but may be he was not good enough,
#                  SO PLEASE REMEMBER: 
#                  Use this cms only for test and hobby purposes
#                  you can do any change to make it better!
# 
# NO WARRANTY: ARTICLES 11, 12 GNU-GPL LICENSE 
# 
# USE IT ONLY FOR TEST AND HOBBY PURPOSES

----------
what's new
----------
- Now the cms can generate a valid rss feed!
- correct some security bugs
- all the frontpage is contained in one file (index.php)!! so is more easy
  adapte an existent css template to your purposes or modify index.php iteself.
- administration area template indipendent by frontpage template.
- new layouts
- snap shots preview of links
- google custom search
- new captcha
- new online editor (xinha)
- alert dialog mootools based (Sexy Alert Box)

---------------
REQUERIMENTS
---------------
MYSql 4/5 database
Php 4/5
Optional: phpsendmail o Smtp mail

----------------
  INSTALLATION
----------------
1) Unzip the zip file on your local disk, you will get:

   - CMS: a directory that contains all the files of this cms);
   - index.php: a redirect file that points to "cms/index.php";
   - install.php: a redirect file that points to "cms/install.php"
   
2) Upload index.html and install.php on the main directory of your web site for example: www.yourdomain.com Then upload the whole CMS directory on your web site. Finally you should will have this tree:
   
   [.] www.yourdomain.com
    |
    |--[.]CMS
    |
    |--index.php
    |--install.php     
    
3) Run install.php, you get to know some data:
   mysql database: hostname (localhost only for local installations);
                   database name;
                   database login (username and password);
                   
   Website Administrator: Username and password that you choose to login yourself as administrator

   SMTP login: servername, login, port (usually 25)
  (note that Smtp is optional, you don't need it if php sendmail
   is activated or if you don't use the contact form).
                          
3) Run www.yourdomain.com/index.php this will redirect the browser to the real path
   of the cms that is www.yourdomain.com/cms/index.php
   That's all, login as Admin to manage the site.

IMPORTANT: delete these two files:
    www.yourdomain.com/install.php
    www.yourdomain.com/cms/install.php

May be this cms can shows notices and errors messages without importance
you can verify your php.ini settings to fix it:

;   - Show only errors
;
error_reporting = E_COMPILE_ERROR|E_RECOVERABLE_ERROR|E_ERROR|E_CORE_ERROR    

----------------------------------
 UPLOADING PHOTOS AND OTHER STUFF   
----------------------------------
File's name and its extensions should be both in lowercase mode: "yourfile.jpg"
  
To upload files, you can use the integrated file manager, or an external tool.
Anyway remember to set the right permissions as below:
                                    -rw-r--r--
this means that everyone can read the file but only the owner can write on it.
If you don't set the permissions you will not be able to insert the photo in your 
article or show it in the photo album.

------------------------
      DOWNLOADS
------------------------
The installation routine will ask to you for a shared files directory name. 
Then create it and put all you shared stuff in that directory.
-------------------------------
      Google Syntax Highlighter
-------------------------------
To write code in a post and render it:

add this lines before your code:

<textarea name="code" class="html" cols="60" rows="32" readonly-on>

write in your code:
 
  // your code here

close the tag:
</textarea>       

------------------------
      USERS
------------------------
You can:
- activate User self registration;
- restrict access to downloads area;
- allow post comments only to registered users.

------------------------
      TEMPLATES
------------------------
Changing the current theme is more easy: in the css section (Admin's Panel)
there is an options list with all the loaded templates, just choose the one you like.
To add new templates just copy it in a new folder in the "templates" directory, the css file
must to be named: "style.css".

                         
                      
   