Volendo iniziare a scrivere qualcosa per joomla, ho deciso di partire dai moduli, emmmmm lato amministratore (back end), ma cercando in rete, non ho trovato nulla per il lato amministratore, ne un doc, ne un0 esempio commentato, mntre invece ho trovato molto per quello utilizzatore, quindi ho iniziato a spulciare tra i vari sorgenti di moduli per l' amministrazione ed ecco cosa son riuscito a capire/fare:

ogni modulo, sia esso lato utente o amministrazione e' un file zippato composto da due o piu' file,  i due file necessari affinche si possa scrivere un modulo sono :

mod_nome_modulo.php contente al suo interno il codice php da eseguire

mod_nome_modulo.xml contente al suo interno tutta una serie di informazioni necessarie all' installazione e alla corretta gestione del modulo

partiamo dall' alto e vediamo :

<?xml version="1.0" encoding="iso-8859-1"?>
 

indica che il file e' un file xml e che e' codificato con caratteri iso-8859 , difficilmente avremo motivo di variare questa riga

<mosinstall type="module"  client="administrator">
 

 indica che e' un file relativo ad un modulo e che serve per il lato amministrazione, seinvece vogliamo realizzare un modulo da usare nel lato utente, basta non implementare il parametro client!

    <name>modulo statistiche rss</name>
 

 indica il nome col quale verra' elencato il modulo nella lista moduli

    <author>davide ammirata</author>
    <creationDate>Maggio 2008</creationDate>
    <copyright>(C) 2008 davidea gnu gpl V3.</copyright>
    <license>http://www.gnu.org/licenses/gpl.html</license>
    <authorEmail> Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo. </authorEmail>
    <authorUrl>www.davidea.it</authorUrl>

 indica i classici, nome autore, data di creazione copyrighe e licenza, email dell' autore e sito dell' autore, tutte righe di commento .....

<version>1.0.0</version>
 

indica la versione del modulo, e' il classico numero progressivo da noi stabilito 

<description><![CDATA[
<h3>Questo modulo permette la visione delle statistiche sull' uso dei feed rss<br>
dopo aver apportato le modifiche al componente com_rss nelle statistiche viene visualizzato<br>
il numero di feed scaricati da ip univoci negli ultimi 2 giorni completi e nell' ultimo<br>
giorno completo dove per completo si intende dalle 00:00:01 alle 23:59:59<br><br></h3>
<h1> <red>se questo lavoro ti piace e/o vuoi modificarlo e migliorarlo puoi farlo, a patto che rilasci sempre i sorgenti , rendi il tuo lavoro disponibile agli altri, non sei l' unico a cui piace trovare pezzi di codice gia' scritto!!!!</red></h1>
]]></description>

e' la descrizione che verra' visualizzata durante l' installazione e la configurazione del modulo  

 <![CDATA[

]]> 

 fare attenzione a questi due pezzi di codice, sono quelli che ci consentono di inserire pezzi di codice html come i <br> <red> <h3> all' interno dellanostra descrizione, in loro assenza sara' possibile scrivere solo in plain text

 <files>
        <filename module="mod_rss_stat">mod_rss_stat.php</filename>
    </files>

 qui' devono essere elencati rigo per rigo, eventualmente ripetendo <filename ........ /filename> tutti i file che fanno parte del nostro modulo(escluso il file .xml) , eventualmente includendo anche il path delle sottodirectory

    <params>
    </params>    
 

 qui' vanno inseriti eventuali parametri nella forma

        <param name="widthtable" type="list" default="90" label="Width Table" description="The width (%) of statistics table">
            <option value="100">100%</option>
            <option value="95">95%</option>
            <option value="90">90%</option>
            <option value="85">85%</option>
            <option value="80">80%</option>
            <option value="75">75%</option>
            <option value="70">70%</option>
            <option value="65">65%</option>
            <option value="60">60%</option>
            <option value="55">55%</option>
            <option value="50">50%</option>
        </param>
 

 infine

</mosinstall>

 chiude il file

di seguito riporto il codice del file xml relativo al modulo _mod_rss_stat.xml che sto realizzando

<?xml version="1.0" encoding="iso-8859-1"?>
<mosinstall type="module"  client="administrator">
    <name>modulo statistiche rss</name>
    <author>davide ammirata</author>
    <creationDate>Maggio 2008</creationDate>
    <copyright>(C) 2008 davidea gnu gpl V3.</copyright>
    <license>http://www.gnu.org/licenses/gpl.html</license>
    <authorEmail> Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo. </authorEmail>
    <authorUrl>www.davidea.it</authorUrl>
    <version>1.0.0</version>
    <description><![CDATA[
<h3>Questo modulo permette la visione delle statistiche sull' uso dei feed rss<br>
dopo aver apportato le modifiche al componente com_rss nelle statistiche viene visualizzato<br>
il numero di feed scaricati da ip univoci negli ultimi 2 giorni completi e nell' ultimo<br>
    giorno completo dove per completo si intende dalle 00:00:01 alle 23:59:59<br><br></h3>
            <h1> <red>se questo lavoro ti piace e/o vuoi modificarlo e migliorarlo puoi farlo, a patto che rilasci sempre i sorgenti , rendi il tuo lavoro disponibile agli altri, non sei l' unico a cui piace trovare pezzi di codice gia' scritto!!!!</red></h1>
    ]]></description>
    <files>
        <filename module="mod_rss_stat">mod_rss_stat.php</filename>
    </files>
    <params>
    </params>    
</mosinstall>