I plug-in di Joomla! possono essere utilizzati per automatizzare operazioni sui contenuti (ad esempio per aggiungere il sistema di voto agli articoli…altro non è che l’aggiunta di codice html a quello dell’articolo).

Spesso si rivelano estremamente utili per effettuare azioni correttive sull’intero contenuto (compreso l’header della pagina); motivo per cui, sfruttando i metodi di JFactory, possiamo creare un plugin che all’evento di preparazione del contenuto, effettui dei controlli su title e description ed eviti valori di default (che non piacciono tanto agli spider dei motori di ricerca).
Per leggere le informazioni meta ho utilizzato un metodo alternativo a quello della pillola per evitare title e description duplicati, un metodo più generale e attuabile quando non si ha un riferimento al contenuto mediante $this (cosa possibile, invece, all’interno di un file di template)

In una prossima pillola vedremo nel dettaglio le tipologie di plug-in e gli eventi cui associarne l’esecuzione, per ora ci basti aver presente che il plug-in che andiamo a realizzare:

• agisce sul content
• viene invocato all’evento onPrepareContent

Come realizziamo il plug-in:

Creiamo  innanzitutto un file xml che descriva il plug-in: automatismo.xml

<?xml version="1.0" encoding="utf-8"?>
<install version="1.5" type="plugin" group="content">
<name>AUTOMATISMO</name>
<author>Antonio Picone</author>
<creationDate>May 2009</creationDate>
<copyright>Copyright (C) 2008 - 2009 Open Source Matters. All rights reserved.</copyright>
<license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license>
<authorEmail>info@antoniopicone.it</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>1.5</version>
<description>Add the auto-populated header for SEO</description>
<files>
<filename plugin="automatismo">automatismo.php</filename>
</files>
<params/>
</install>

Successivamente, il file del plug-in (commentato riga per riga): automatismo.php

<?php

// evitiamo l'accesso direto a questo file
defined( '_JEXEC' ) or die( 'Restricted access' );

// registriamo l'esecuzione della funzione all'evento onPreapareContent
$mainframe->registerEvent( 'onPrepareContent', 'plgContentAutomatismo' );

function plgContentAutomatismo( &$row, &$params, $page=0 )

{

// Creo un nuovo riferimento all'oggetto JConfig per prelevare i parametri di configurazione

$CONFIG =& new JConfig();

// Creo un rif all'oggetto che descrive il documento

$document = &JFactory::getDocument();

// JFactory fornisce metodi get per preleavare Title e Description, usiamoli

$title = $document->getTitle();

$description = $document->getDescription();

// Se il title di questa pagina è quello di default, lo riscrivo nella forma: sezione > categoria > titolo

if ($CONFIG->sitename == $title) $title = $row->section . ' > ' . $row->category . ' > ' . $row->title;

// Se la description è quella di default, la sosticuisco con i primi 140 caratteri del contenuto dell'articolo

if ($CONFIG->MetaDesc == $description) $description = substr($row->text, 0 ,140);

// Sfrutto i metodi set di JFactory per riscrivere Title e Description

$document->setDescription($description);

$document->setTitle($title);

}

Per installare il plug-in, basterà copiare i due files nella directory /plugins/content/ e attivarlo dal back-end.

That’s all folks ]]> http://www.pilloledijoomla.it/livello-avanzato/realizziamo-un-plug-in-seo-per-joomla.html/feed 2 http://www.pilloledijoomla.it/livello-avanzato/joomla-e-la-tassonomia-dei-contenuti.html http://www.pilloledijoomla.it/livello-avanzato/joomla-e-la-tassonomia-dei-contenuti.html#comments Mon, 06 Apr 2009 11:20:56 +0000 admin http://192.168.10.38/pillole/joomla/?p=211 Una volta appresa la gestione degli articoli di Joomla!, avrete notato che la tassonomia di questi ultimi è limitata a 2 livelli: sezione e categoria.

Ciò vuol dire che, per come è strutturato Joomla! 1.5, organizzare contenuti a livelli di profondità ulteriore risulta impossibile (a meno di ricorrere ad hack).

Ad esempio, immaginiamo di dover realizzare un magazine che abbia una sezione sport cui appartengono le categorie calcio e, chessò, tennis: se volessi specializzare gli articoli di calcio, dividendoli in due sottocategorie: serie A e serie B, per come è strutturato Joomla! 1.5, sarebbe impossibile.
Questo limite, allo stato attuale, è particolarmente pesante dato che altri CMS (Drupal e WordPress in primis) gestiscono livelli di profondità pseudo-illimitati.

La buona notizia è che Joomla! 1.6 estenderà i livelli di tassonomia eliminando il limite a 2 (sezione->categoria), non solo: anche ora, nel caso sia davvero necessario organizzare contenuti in sottocategorie, potremmo, ad esempio sfruttare i parametri aggiuntivi messi a disposizione dal core di Joomla! 1.5 e aggirare il problema.


$user =& JFactory::getUser();


Facendo un print_r($user) si ottengono, infatti, le coppie variabile-valore di campi quali:

• ID dell’utente
• nome visualizzato
• username
• tipologia utente
• date di registrazione ed ultimo accesso
• parametri aggiuntivi

Questi parametri vengono salvati nella colonna attribs della tabella jos_content come elenco di variabili=valore

Può risultare utile agiungere dei parametri ad un contenuto (ad esempio un link ad un video pertinente al contenuto) di modo da arricchire le informazioni di quest’ultimo.

Per fare ciò possiamo sfruttare lo stesso principio utilizzato per i parametri aggiuntivi preesistenti nella, memorizzati nella colonna attribs, ai quali andranno aggiunti i nostri parametri aggiuntivi.

L’obiettivo, pertanto, è di memorizzare queste informazioni nel database ma anche poter gestire questi parametri allo stesso modo in cui Joomla! gestisce gli attuali parametri.

Vediamo, pertanto, quali modifiche apportare al componente com_content per aggiungere il supporto ai nostri parametri:

1. Modifichiamo il file /administrator/components/com_content/models/article.xml aggiungendo in fondo all’attuale elenco dei parametri, 3 parametri custom: param1, parma2, param3 appartenenti al gruppo myparams

<params group="myparams">
<param name="param1" type="text" size="25" default="" label="Parametro 1" description="testo descrittivo parametro 1" />
<param name="param2" type="textarea" rows="5" cols="30" default="" label="Parametro 2" description="testo descrittivo parametro 2" />
<param name="param3" type="list" default="" label="Parametro 3" description="testo descrittivo parametro 3">
<option value="0">Zero</option>
<option value="1">Uno</option>
</param>
</params>

In questo modo abbiamo aggiunto alla definizione del XML ulteriori parametri da visualizzare nella view per la modifica dell’articolo.

2.  Modifichiamo il file di template del modulo di back-end per il componente com_content (/administrator/components/com_content/admin.content.html.php
), alla funzione submitbutton(pressbutton), inserendo prima di echo $pane->endPane(); le seguenti righe:

$title = JText::_( 'Parametri MyParams' );
echo $pane->startPanel( $title, "myparams-page" );
echo $form->render('params', 'myparams');
echo $pane->endPanel();

Così facendo verrà effettuato il render del gruppo di parametri appena creato e, alla modifica dei valori di tali parametri, Joomla! memorizzerà anche i valori per tali parametri.

3. Infine, per richiamare dal front-end i valori dei parametri inseriti a corredo dell’articolo, inseriamo nel template utilizzato, magari nella pagina default.php di una view del com_content, quanto segue:

$params = &JComponentHelper::getParams( 'com_content' );
echo $params->get( 'param2' );

Anche se piuttosto semplice, questo componente può essere adattato, ad esempio, ad inviare messaggi adeguatamente formattati ad un web service di un CRM, aggiungendo così al proprio sito istituzionale un potente sistema di lead incoming che spesso manca in organizzazioni aziendali meio-piccole.

Il componente in questione non ha un back-end in quanto diamo per scontato che le email verranno inviate dall’inidirizzo email inserito in fase di installazione del CMS (o modificabile dalle impostazioni di Joomla!) ad un indirizzo info@miodominio.it

Il componente che andiamo a creare si chiamerà com_contatti e sarà strutturato in questo modo:

- controller contenente due task: compila ed invia per effettuare le operazioni di input dei dati ed invio della mail
- 2 view per le azioni dei task di compilazione ed invio del form

NB: Di seguito, notate i parametri passati dal form: ce ne sono due nascosti che indicano quale option (=componente) e quale task richiamare.

Il componente sarà pertanto composto dai file:

/com_contatti/contatti.xml contenente la definizione dei file e i dati del componente
/com_contatti/contatti.php che istanzia il controller e definisce l’azione di default
/com_contatti/controller.php contenete le azioni relative ai due task che intendiamo sviluppare
/com_contatti/views/index.html
/com_contatti/views/compila/view.html.php contenente la definizione di una classe che eredita JView e richiama il metodo parent::display()
/com_contatti/views/compila/tmpl/index.html
/com_contatti/views/compila/tmpl/default.php contenete il codice del form e la relativa azione cui passare il controllo
/com_contatti/views/invia/view.html.php contenente la definizione di una classe che eredita JView e richiama il metodo parent::display()
/com_contatti/views/invia/tmpl/index.html
/com_contatti/views/invia/tmpl/default.php contenete il codice di invio della mail con i dati prelevati dal form

Diamo un’occhiata al codice dei file:

contatti.xml

<?xml version="1.0" encoding="utf-8"?>
<install type="component" version="1.5.0">
<name>Contatti</name>
<description>Componenti per invio di un form di contatti</description>

<files>
<filename>controller.php</filename>
<filename>contatti.php</filename>
<filename>index.html</filename>
<filename>views/index.html</filename>
<filename>views/contatti/index.html</filename>
<filename>views/contatti/view.html.php</filename>
<filename>views/contatti/tmpl/default.php</filename>
<filename>views/contatti/tmpl/index.html</filename>
</files>

</install>

Ricordiamo che i file index.html non contengono altro che: <html><body bgcolor="#FFFFFF"></body></html>

dopodiché creiamo contatti.php:

<?php

// Evito accesso diretto al file
defined( '_JEXEC' ) or die( 'Restricted access' );

// Requiedo il controller base
require_once( JPATH_COMPONENT.DS.'controller.php' );

// Rechiedo all'occorrenza il controller specifico
if($controller = JRequest::getWord('controller')) {
$path = JPATH_COMPONENT.DS.'controllers'.DS.$controller.'.php';
if (file_exists($path)) {
require_once $path;
} else {
$controller = '';
}
}

// Creo un'istanza del controller
$classname    = 'ContattiController'.$controller;
$controller   = new $classname( );

// notifichiamo che il task di default non è "view" (convenzione in Joomla!) bensì "compila-form"

// Eseguo il task richiesto
$controller->execute(JRequest::getCmd('task'));

Il file controller.php, invece, conterrà il codice dei due task:

<?php

// Check to ensure this file is included in Joomla!
defined('_JEXEC') or die( 'Restricted access' );

jimport('joomla.application.component.controller');

class ContattiController extends JController
{

function compila()
{
$session =& JFactory::getSession();
JRequest::setVar( 'view', 'compila' );
$this->display();
}

function invia()
{
global $mainframe;

}
}

Infine, i file contenenti le classi che ereditano JView:

/com_contatti/views/compila/view.html.php

<?php

defined('_JEXEC') or die( 'Restricted access' );

jimport('joomla.application.component.view');

class ContattiViewCompila extends JView
{
function display($tpl = null)
{

parent::display($tpl);
}

}


/com_contatti/views/invia/view.html.php

<?php

defined('_JEXEC') or die( 'Restricted access' );

jimport('joomla.application.component.view');

class ContattiViewInvia extends JView
{
function display($tpl = null)
{

parent::display($tpl);
}

}

E infine, i file delle view: il primo con il form:

/com_contatti/views/compila/tmpl/default.php

<?php // no direct access
defined('_JEXEC') or die('Restricted access'); ?>

<form action="<?php echo JURI::base() ?>index.php" name="contattiForm" method="post">

<input type="hidden" name="layout" value="<?php echo $this->getLayout();?>" />
<input type="hidden" name="option" value="com_contatti" />
<input type="hidden" name="task" value="invia" />
<input type="hidden" name="link" value="<?php echo $data->link; ?>" />
<?php echo JHTML::_( 'form.token' ); ?>
</form>

e il file di invio che verrà presentato solo in caso di esito positivo dell’invio:

<?php
defined('_JEXEC') or die('Restricted access'); ?>
<div style="padding: 10px;">
<div class="componentheading">
<?php echo 'Grazie per averci contattato!' ?>
</div>
</div>