UPDATE Febbraio 2011: Questa guida non e’ piu’ valida dopo la release della versione 2.0rc1, fate riferimento alla guida originale sul sito del componente.
http://ptwix.toforge.com/index.php?p=install
Ptwix è un componente da me creato per visualizzare la timeline del tuo account twitter direttamente sul tuo sito.
E’ scritto in PHP ed usa AJAX per effettuare un update asincrono quando viene richiesto.
Usa anche un sistema di cache XML per evitare che si superino le 100 richieste in un ora, limite imposto da twitter per evitare il sovraccarico dei server.
Ne potete vedere una demo qui http://ptwix.toforge.com?p=demo
Scrivo questa guida all’installazione in italiano qui sul mio blog in quanto il sito ufficiale ho deciso di lasciarlo solo in lingua inglese.
Bando alle ciance e partiamo!!!
Scaricate l’archivio che preferite all’indirizzo http://ptwix.toforge.com?p=download e posizionate la cartella ptwix ovunque volete sul vostro server.
Poniamo l’attenzione sulla cartella cache all’interno del package ptwix, questa è la cartella di default per contenere i file di cache, e naturalmente deve avere i permessi di scrittura.
Non dovete per forza usare questa cartella ma una qualsiasi sul vostro server e in qualsiasi posizione.
Ora aprite il file ptwix_reader.php che si trova nella cartella as e modificate le seguenti righe
$username="yourtwitterusername";
$password="yourtwitterpassword";
$url_path="http://www.mysite.com/ptwix/";
$cache_folder="/var/www/examplesite/ptwix/cache/";
I primi due parametri sono le credenziali di autenticazione del vostro account twitter, l’url path e la path url assoluta che punta alla cartella di installazione di ptwix e infine cache_folder rappresenta la posizione della cartella in cui saranno scritti i file di cache che, come vi dicevo prima, dovranno avere i permessi di scrittura.
Fatto questo possiamo andare ad inserire ptwix nella pagina che desideriamo con i seguenti passi
Includiamo il file ptwix.php della cartella core
<? include "ptwix/core/PtwiX.php" ?>
Creiamo una nuova istanza dell’ogetto passandogli nell’ordine i seguenti parametri
Instance Name: Il mome dell’istanza dell’ogetto, a vostro piacere.
Username: L’username del tuo account twitter
Password: La password del tuo account twitter
Url path: La path url della cartella di installazione di ptwix (http://www.mysite.com/ptwix/)
Cache folder path: La path assoluta della cartella di cache
Timeline type: (Optional) La timeline da visualizzare (user timeline o friends timeline). Default friends timeline
Theme: (Optional) Il nome del tema da utilizzare, default gray-blue
Dopo di che bisogna inserire il foglio di stile relativo al tema, potete farlo manualmente oppure utilizzando il metodo printCss_Ref.
Ora resta da stampare il box di ptwix ovunque vogliamo utilizzando il metodo printBox.
Per chiarirvi le idee ecco un bell’esempio completo
<? include "core/PtwiX.php";
$PtwiX=new PtwiX('second','user','pass','http://www.mysite.com/ptwix/','/var/www/ptwix/cache/',PtwiX::$FRIENDS_TIMELINE,'silver-red');
?>
<html>
<head>
<? $PtwiX->printCssRef(); ?>
</head›
<body›
<? $PtwiX->printBox(); ?>
</body>
</html>
Per completezza vi ricordo l’esistenza del metodo setDimension(larghezza,altezza) che chiamato sull’oggetto vi permette di impostare la dimensione a vostro piacimento.
Inoltre per chi ha un dominio in hosting e gli risulta impossibile installare curl e il relativo modulo PHP esiste anche un metodo disableCurl(boolean) che permette di disabilitare l’uso di curl, ma in questo caso potrete visualizzare solo la timeline del vostro utente e non quella dei vostri amici.
Se avete particolari domande o problemi commentate pure e non dimenticate di seguire me e ptwix su twitter. 
Pingback: Ptwix, script para mostrar tu timeline de Twitter de manera elegante | Punto Geek