cmsdAm is a powerful, simple, scalable, quick, secure, GPL released, PHP4 written from scratch Content Management System Framework. It is specially designed for people having some basic PHP knowledge. You can create powerful professional sites in a while using cmsdAm, and you don't have to rewrite each time php code for handle each section, users, search engine, etc. cmsdAm do all the work for you! You just have to configure it, and write HTML or PHP code for your sections. You don't have to care about mails, HTTP headers, HTML strange tags, META tags, HTTP cache mechanisms, etc, just write HTML or PHP code for your sections. Enjoy!!! Dino Ciuffetti - dam2k@users.sourceforge.net * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the Free * Software Foundation; version 2 of the License. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * for more details. * * You should have received a copy of the GNU General Public License along * with this program (COPYING); if not, go to http://www.fsf.org/ or write * to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. cmsdAm - General Documentation ** Basic description ** To make cmsdAm working you have to know some basic about php programming, not because it's difficult to use, but because it's designed for scalability, velocity, security, and that's make cmsdAm usable by php programmers. Please pay attention on what I have to say, I spent time for writing docs, and I spent time to write cmsdAm, the time is money after all!! Please note that I just started to write doc for cmsdAm few months ago, so if you want to ask me something, please subscribe yourself to one of the cmsdAm lists you can find in cmsdam.sourceforge.net. Well, we can begin to bring up the site with cmsdAm. Don't you want to bring up a site with cmsdAm? Yes it is, so give up! Cmsdam is a free, simple, secure, speedy, scalable, (portable?!), GPL released, PHP4 content management system framework with a set of api functions specially designed for PHP4 basic experienced people that want to bring up dynamic sites in a few time. Yes it is, but how can I bring up my site with cmsdAm? All you have to do is to write PHP/HTML template files, write the PHP skeleton and configure cmsdAm. Please read all this doc before make me questions. If you think you have to ask me something usefull, please don't exitate to drop me a note at dam2k@users.sourceforge.net, or post to the mailinglist cmsdam-users@lists.sourceforge.net!! ** Download cmsdAm ** You can download cmsdAm from sourceforge site, please check the site cmsdam.sourceforge.net for details. But if you are reading this file, may be you have already downloaded cmsdAm two minutes ago, or not? ;-) ** Install cmsdAm ** After download you may want to install it, so "cd" to a directory of your choice, ex /opt. I recommend to put cmsdAm files to a directory outside your Web Server DocumentRoot for security reasons. If you want to put cmsdAm files into the DocumentRoot directory, you should configure your webserver to not allow external view of cmsdAm internal files/templates. You can do that using the example file etc/apache.include. Now check this: - If you downloaded the .tar.bz2 do the following: $ tar -jxvf cmsdam-0.X.tar.bz2 - If you downloaded the .tar.gz do the following instead: $ tar -zxvf cmsdam-0.X.tar.gz ** Configure apache ** You can find configuration files into the cmsdAm "etc" directory. Here you will find a file called "apache.include". This file contains apache directives you may have to use to make cmsdAm working as a website and ensure file security with apache and cmsdAm. All you have to do at this time is to modify this file to your needs and include it into your apache "httpd.conf" file. This way we are sure that apache doesn't make visible things it shouldn't be, even if cmsdAm design should make it hard! If at this point your answer is: "I'm not using apache web server!!" then my answer will be: "Well, go to download it immediatly, httpd is THE web server!!" NOTE: cmsdAm works with PHP4, so if you know what you are doying it may works where PHP can work, not only on apache web server!!! Please let me know the platform you are using (PHP, SO, etc), so I can write a list of well known working environments. Has been reported that cmsdAm also works on Windowz... :-) THE POWER OF PHP!!!!! After that you have to: - chgrp -R www-data cmsdam/logs - chmod -R 775 (or 770, or 570, or 575) cmsdam/logs - Modify "/your_cmsdam_directory/etc/config.php" to adapt cmsdAm to your needs; - Modify "/your_cmsdam_directory/template/index.php". This is the main template file. Here you can call other defined sections. Please go to read the cmsdAm API, FAQ, DEMO, ecc... - Create "/your_cmsdam_directory/template/lang/yourlang/your_sections.php" so that cmsdAm can link your template files into the code. Remember to create the DB entries too. IMPORTANT NOTE: You don't have to create a file named your_sections.php!! You have to write some php files for your sections and create the DB entries accordingly!! - cat cmsdam.ddl | mysql -u mysqluid -p -h localhost mysqlpass - setup your ldap tree and schema (NOT needed if you don't want to use it) - Configure your sections details That's ok, you have just finished to install cmsdAm!! Easy, but if you enconter ANY problem, don't esitate to subscribe yourself to cmsdam-people@lists.sourceforge.net, or to cmsdam-devel@lists.sourceforge.net. If it runs for you, please let me know your apache, php and OS version! It's young software after all!! ** Modify template/index.php ** If you want to change the cmsdAm default layout (and that's guaranted!!!) you have to modify something. First of all you have to adapt files in etc directory, if you didn't already (watch up!), then you have to modify the default template, a file called template/index.php. This file is the main site layout (skeleton) where all the sections are linked. Here you can use cmsdAm API to call templates, read or write to DB, handle users an groups, make a search with the search engine, split ad array with paginator, use cmsdAm plugins, and so on... That's GPL, development software so use it only if you know what you are doing. I can't take the charge of some system damage, data loss, ecc... even if it's quite impossible!! Just said: use it at your own risk. If you want more details do the following things in this order: 1- Read the FAQ to cmsdam.sourceforge.net 2- Read documentation files in "docs" directory; 3- Check the site cmsdam.sourceforge.net; 4- Use the forum at sourceforge, cmsdAm project; 5- Use the mailinglists cmsdam-people@lists.sourceforge.net - cmsdam-devel@lists.sourceforge.net; 6- Read the code :-) ; 7- Write me a mail. IMPORTANT NOTES!!! * If you have some PHP basic and you want to help me writing cmsdAm, please write me a mail. * I need testers / feedback too!!! * Should be great to create a little community with cmsdAm! Please give me help for this!! ----------------------------------------------------------------------------- I am happy to know that you are using cmsdAm. Thank you for using it!! I hope you enjoy!! ## WARNING ## ## Read carefully COPYING file for license informations of this software!! ## WARNING ## cmsdAm author: dAm2K - Dino Ciuffetti - dam2k@users.sourceforge.net