EsupTwitter

Skip to end of metadata
Go to start of metadata

Description rapide

EsupTwitter est une portlet Java JSR 168 intégrable dans un portail type EsupPortail.

Fonctionnalités

Elle permet d'afficher le Timeline Twitter (http://twitter.com) d'un utilisateur donné.
Cet utilisateur est défini dans les préférences de la portlet et peut ainsi être positionné lors de la publication de la portlet.
On peut aussi permettre à la personne authentifiée sur le portail de modifier sur une portlet cet utilisateur (mode EDIT de la portlet).
Enfin, et si l'administrateur a configuré EsupTwitter en ce sens, la personne authentifiée peut également s'authentifier sur Twitter avec son propre compte Twitter (si il en a un évidemment) afin de suivre son propre Timeline (authentification Twitter oAuth, cf paragraphe ci-dessous).

Activer la possibilité du Twitter oAuth

Si vous souhaitez permettre à vos utilisateurs de consulter leur timeline Twitter privé et donc d'utiliser Esup Portlet Twitter en mode connecté, vous devez enregistrer votre application sur Twitter.

Twitter propose un site dédié pour cela :http://dev.twitter.com/

Pour l'ENT de l'UNR Normandie, nous avons mis la description suivante :

"""Normandy University Portal aims to present students and personnals with access to web based services within and beyond the University."""

EsupPortletTwitter n'a pas besoin des autorisations d'écriture au niveau de Twitter puisqu'il ne permet que de consulter les timeline (le "Access Level" peut être mis à read-only).

De http://dev.twitter.com/ vous devez donc récupérer un "Consumer key" et un "Consumer secret" qu'il faut donner dans le fichier WEB-INF/context/portlet/twitterConfig.xml (ou src/main/webapp/WEB-INF/context/portlet/twitterConfig.xml si vous partez des sources de la portlet)

Sachez qu'à ce jour le OAuth Callback URL n'est pas utilisé par EsupPortletTwitter cependant ce paramètre (qui peut en fait être multi-valué) sert également à informer des domaines susceptibles d'héberger votre application, en effet un filtrage sur les hôtes est également mis en place par Twitter lors d'une authentification oAuth.

Rappelons que si vous laissez twitterConfig.xml donné par défaut, vous n'autoriserez pas l'authentification sur Twitter ... cela n'empêchera pas l'usage d'EsupPortletTwitter : la mise en place de la configuration oAuth n'est pas obligatoire dans EsupPortletTwitter.

Téléchargement

Une version 0.6 d'EsupTwitter est disponible au téléchargement sur sourcesup.

http://sourcesup.cru.fr/frs/?group_id=700

Technologies

Portlet JSR168, EsupTwitter a au départ été élaboré également pour expérimenter au mieux les techologies Spring v3 (RestTemplate, Spring-OXM, ...) notamment dans l'optique de réflexion autour d'EsupCommons v2 (qu'elle utilise depuis la version 0.5.0).

Le code et les fonctionnalités sont volontairement épurées.

EsupTwitter, bâti sur EsupCommons v2, est un projet construit avec Maven en s'inspirant des développements récents de portlets uPortal (FunctionalTestsPortlet et WeatherPortlet notamment).

En attaché à cette page de présentation EsupTwitter, des slides de la présentation du début de son développement, consultables ci-dessous directement :

You need flash player installed to preview ppt and pdf files

Get Adobe Flash player

Création du war depuis les sources.

Le code source est accessible directement depuis sourcesup :

http://sourcesup.cru.fr/scm/?group_id=700

Depuis le répertoire d'EsupTwitter un

vous package un EsupTwitter.war

Déploiement de la portlet (du war) dans un uPortal / EsupPortail

Depuis le répertoire source d'uPortal / EsupPortail :

devrait compiler et déployer la portlet EsupTwitter sur votre portail.

Pour les versions uPortal / Esup inférieures à 3.x.x, la commande étant plutôt :

Copies d'Écran

copies d'écran de EsupTwitter dans EsupPortail
Le Mode EDIT d'EsupTwitter
EsupTwitter dans EsupPortail (basé sur uPortal 3.2.0), le Timeline de la ville de rouen (config par défaut).
L'affichage d'un canal EsupTwitter depuis un smartphone via le thème mobile fourni par uPortal 3.2.0
Plusieurs EsupTwitter dans un même onglet EsupPortail
Le Mode EDIT d'EsupTwitter
Le Timeline EsupTwitter d'un utilisateur ayant donné son password dans le mode EDIT

Annexes

English page on jasig.org.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

2 Comments

comments.show.hide

  1. janv. 27, 2011

    Olivier LE BORGNE

    Modifications EsupTwitter pour travailler derrière un proxy :
    ===========================================

    1) Dans la classe TwitterController.java :

     1.a) Dans la déclaration des variables, ajouter les deux lignes suivantes (remplacer my.proxy.Host par l'adresse de votre proxy
    et 3128 par son numéro de port):

    public static final String PREF_TWITTER_PROXY_HOST = "my.proxy.Host";
    public static final Integer PREF_TWITTER_PROXY_PORT = 3128;

    1.b) Ajouter la ligne suivante dans la méthode setRestTemplate :

       client.getHostConfiguration().setProxy(PREF_TWITTER_PROXY_HOST, PREF_TWITTER_PROXY_PORT);

    2) Dans la classe OAuthRequestProxy.java, ajouter les deux lignes suivantes dans la méthode OAuthRequestProxy

       this.connection.setRequestProperty("http.proxyHost", TwitterController.PREF_TWITTER_PROXY_HOST);
       this.connection.setRequestProperty("http.proxyPort", TwitterController.PREF_TWITTER_PROXY_HOST);

    1. févr. 02, 2011

      Unr TESTLEMANS

      ! ATTENTION : Une erreur s'est glissée dans le commentaire ci-dessus, le point 2) est erroné , il ne faut pas en tenir compte