-- cmsdAm 0.8 Frequently Asked Questions, a cura di Dino Ciuffetti, dam2k@users.sourceforge.net -- Q- Cos'e' cmsdAm? A- cmsdAm e' un semplice Framework per la gestione dei contenuti di un sito web. Il suo utilizzo rende molto piu' semplice la scrittura da zero di un sito web professionale senza dover per forza conoscere HTTP, i vari meccanismi di caching, funzionamento dei motori di ricerca, database, protocolli di rete, logging, ecc. In oltre e' molto semplice scrivere le proprie template, associarle a nomi di sezioni e lasciare che cmsdAm le incolli esattamente nel modo che vogliamo. Diciamo che si puo' associare la potenza del PHP alla semplicita' del copia e incolla avendo come risultato finale un sito web assolutamente professionale con il rispetto degli standard come HTTP, dei vari protocolli di rete, delle meta tag, ecc. Q- Chi ha scritto cmsdAm e con quale licenza e' distribuito? A- L'autore e' Dino Ciuffetti, sistemista Linux di Roma (Italia) che lavora per Pro-Netics S.r.l. CmsdAm e' distribuito sotto la licenza GNU GPL come i migliori software disponibili!! Q- Posso usare cmsdAm in ambienti commerciali? A- Certo che si!! Puoi usare Apache, Linux e tutto il resto in ambienti commerciali??!?!! Q- Devo conoscere PHP per usare cmsdAm? A- SI! Almeno una conoscenza di base e' richiesta per poter usare cmsdAm!! Comunque non e' difficile, e puoi trovare TUTTE le informazioni che vuoi al sito http://www.php.net/ Q- Che configurazione consigli per un ambiente di produzione? A- IBM xSeries 335/336, Linux Debian Sarge, Openldap, MySql, PHP4 e Apache 1.3.X. Tuttavia cmsdAm funziona perfettamente anche in altri environment. Se riuscite a farlo funzionare in altre configurazioni perfavore FATEMELO SAPERE!! Q- Che PHP,SO,moduli devo avere per far funzionare cmsdAm? A- Sinceramente non ho avuto modo di testare approfonditamente questo aspetto. Tuttavia potete darmi una mano voi segnalandomi su quale SO/webserver/PHP/moduli/db/ldap/ecc avete installato cmsdAm. Testato approfonditamente su sistemi Linux Debian Stable, Testing e Unstable con PHP4 e Apache 1 e 2. Q- Funziona su Windows? A- Mai provato. Provalo tu e facci sapere su cmsdam-devel@lists.sourceforge.net, grazie!! Q- Cos'e' una sezione e cos'e' un template file? A- Un template file e' un file PHP, HTML o TXT che viene mappato ad una o piu' sezioni di un sito WEB. Una sezione e' un pezzo di pagina con associato un nome ed alcune proprieta' che cmsdAm conosce ed usa per incollare nel punto preciso della pagina WEB le opportune template. L'utente decide tramite le API di cmsdAm (es. nel file "template/index.php") come e dove incollare i file template all'interno delle sezioni di una pagina WEB, anche molto complessa. Q- Le mie template possono essere in HTML puro senza nemmeno una riga di codice PHP? A- Certamente! L'importante e' scrivere PHP (utilizzando le API di cmsdAm) all'interno dello scheletro delle sezioni. Lo scheletro delle sezioni e' il file template/index.php che dice a cmsdAm quali sezioni incollare e in che modo. Dopodiche' le template possono anche essere puro testo! Q- Come faccio ad associare un template file ad una sezione? A- Le template devono risiedere nella directory template/lang/XX, dove XX sta per il tuo codice di linguaggio, ad esempio IT per l'italiano, EN per l'inglese, ecc... Un caso speciale sono le template che risiedono in "template/lang/default". Questa directory viene utilizzata per le template che vengono automaticamente incluse nel caso in cui il file per la lingua richiesta non esiste. Se ad esempio il browser ha come lingua di default il francese, e non esiste una directory template per il francese, cmsdAm includera' automaticamente i relativi template files che risiedono nella directory "template/lang/default". Puoi quindi associare il file di template al nome di sezione modificando il file etc/templates.php (il file di configurazione e' super commentato!!). Nota che questo sistema di associazione verra' modificato nelle future release di cmsdAm. Ad esempio potresti voler creare una sezione nominata "downloads" ed associarla al template file nominato "downloads.php". A questo punto alla chiamata del metodo $cms->sections->section_include("downloads"), ad esempio a cura del file "template/index.php", cmsdAm includera' il file template del linguaggio scelto. Se il file per la lingua richiesta dovesse non esistere, cmsdAm includera' automaticamente il file "downloads.php" nella directory "template/lang/default". E' possibile includere altre sezioni dall'interno di una sezione. Q- Posso configurare cmsdAm per controllare gli accessi sulle varie sezioni? A- Si. Da cmsdAm puoi decidere di includere determinate sezioni solo a determinati utenti o gruppi di utenti. Gli utenti e i gruppi possono essere definiti in un'alberatura LDAP custom o su Database. Guarda il file etc/templates.php per tale scopo. NOTA: per gli utenti e i gruppi al momento solo MySQL e LDAP sono supportati, PostgreSql arrivera' presto. Q- Che mi dici dei plugin? A- I plugin li puoi scrivere tu partendo dal plugin di esempio "_skel" nella directory "plugins" oppure utilizzare i plugins gia scritti. Q- Si possono creare siti complessi con cmsdAm? A- Certo! Dipende SOLO dalla tua bravura di programmatore PHP! Q- Qualcosa sul basso livello? A- Ripeto, tutto quello che puoi fare in PHP lo puoi fare in cmsdAm!! E' un CMS, non un sistema operativo! Q- E' molto veloce nel rendering delle pagine? A- Molto, molto, ma veramente molto veloce!!! Generalmente per gli scopi normali siamo nell'ordine di pochissimi millisecondi!! Provalo e fammi sapere che ne pensi!! Q- Scala bene? A- Leggi la documentazione del PHP su http://www.php.net/ Q- Linux e' bello? A- SI!!!!! Q- E Debian? A- SIIIII!!!!! Q- Devo configurare PHP in modi strani, particolari? A- In casi generici no, visto che le varie distribuzioni di Linux hanno i parametri gia correttamente configurati. cmsdAm funziona perfettamente con "register_globals = Off", e gli altri parametri di default. Fatemi sapere se avete qualsiasi problema con la vostra configurazione. Q- Devo configurare Apache in modi strani, particolari? A- In casi generici no, visto che le varie distribuzioni di Linux hanno i parametri gia correttamente configurati. cmsdAm funziona perfettamente dovunque funziona perfettamente PHP. Fatemi sapere se avete qualsiasi problema con la vostra configurazione. Q- Ci sono BUG conosciuti? A- Al momento non siamo a conoscenza di alcun BUG. Q- Vorrei dare una mano a scrivere/testare cmsdAm, o scrivere documentazione. A- SEI ASSOLUTAMENTE IL BENVENUTO!! Iscriviti alla mailinglist cmsdam-devel@lists.sourceforge.net e mandami una mail a dam2k@users.sourceforge.net. Questo progetto puo' essere anche il tuo!! Q- Vorrei donare qualche euro agli sviluppatori di cmsdAm. Come posso fare? A- Vai su http://sourceforge.net/donate/index.php?group_id=105808 e molte grazie!! I soldi verranno completamente utilizzati per lo sviluppo. P.S. ho deciso di donare il 10% delle donazioni a Sourceforge per il meraviglioso supporto hosting e sviluppo. Q- Vorrei dire qualcosa. Posso dire qualcosa? A- QUALSIASI commento, o qualsiasi altra considerazione, idea, o altro e' ben accetto!! Sentiti pure libero di scrivere a cmsdam-users@lists.sourceforge.net o nei forum o all'autore!! Q- Dove posso trovare maggiori informazioni, documentazione, o richiedere features? A- Usa questo preciso ordine: 1- Dai uno sguardo alla directory docs dei sorgenti di cmsdAm 2- Visita il sito web http://cmsdam.sourceforge.net/ 3- Iscriviti alla mailinglist cmsdam-users@lists.sourceforge.net e posta TUTTO quello che vuoi sapere 4- Dai una sbirciata ai sorgenti 5- Scrivimi una mail a dam2k@users.sourceforge.net per qualsiasi altra cosa non descritta nei posti appena citati Q- Dove sono le API di cmsdAm? A- Nella directory docs dei sorgenti di cmsdAm oppure sul sito web http://cmsdam.sourceforge.net. Q- Si possono creare sezioni dinamiche con funzioni di publishing? A- Sto scrivendo questo supporto (guarda la TODO list), al momento il publishing non e' supportato. Q- C'e' un'interfaccia di amministrazione? A- Al momento no, la sto scrivendo, ma questo comportera' in seguito l'uso obbligatorio del database, cosa che al momento e' solo accessoria e non obbligatoria. Q- Esistono css, temi o plugin gia fatti per realizzare in pochissimo tempo siti precostituiti? A- Veramente no. Non mi diverto abbastanza a creare temi e plugin per siti precostituiti! Ma se li vuoi scrivere tu mi fai veramente l'uomo piu' felice del mondo e li pubblico subito!! Q- Siamo pronti per DIV e CSS? A- Certo! Q- E invece character encoding e i18n? A- Si, gia scritto! Q- Esiste un supporto commerciale per cmsdAm? A- Al momento vorrei creare una community. Probabilmente a presto avrai a disposizione anche un supporto commerciale!