proj-esup-twitter
Pages enfant
  • EsupTwitter

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

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

...

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 à l'utilisateur du la personne authentifiée sur le portail de modifier sur une portlet cet utilisateur (mode EDIT de la portlet), l'utilisateur s'identifie alors via Twitter oAuth.
Enfin 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.

Activer la possibilité du Twitter oAuth

...

(maintenant requis)

Vous devez enregistrer votre application sur Twitter pour qu'EsupTwitter fonctionne, ce même pour utiliser EsupTwitter pour suivre les timelines Twitter publiques d'un utilisateur : depuis le 11 Juin 2013, c'est une contrainte de l'API

Sachez enfin 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.

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/

...

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.

Sachez enfin Rappelons que si vous laissez twitterConfig.xml donné par défaut, vous n'autoriserez pas l'authentification sur Twitter ... et cela n'empêchera pas l'usage d'EsupPortletTwitter : la mise en place de la configuration oAuth n' est pas obligatoire dans EsupPortletTwitterEsupTwitter (depuis EsupTwitter 0.9, les versions inférieures ne fonctionnant plus depuis le 11 Juin 2013).

Téléchargement et code sources

Une version 0.5 14 d'EsupTwitter est disponible au téléchargement sur sourcesup, les sources sont gérées depuis Github.

httphttps://sourcesup.cru.fr/frs/?group_id=700github.com/Jasig/EsupTwitter/releases

Technologies

Portlet JSR168JSR286, 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).Pour une compatibilité avec portlet 1.0 / JSR168 (EsupPortail et uPortal ne supportant pas actuellement portlet 2.0 / JSR286) nous utilisons un "forward port" de Spring MVC Portlet 2.5 pour qu'il puisse tourner avec Spring v3 : http://jira.springframework.org/browse/SPR-7217 . En effet, à partir de Spring v3, spring-mvc-portlet ne supporte plus le portlet1.0 / JSR186 mais le portlet 2.0 / JSR286 exclusivement.

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

...

En attaché à cette page de présentation EsupTwitter, des slides de la présentation du début de son (très rapide) développement, consultable consultables ci-dessous directement :

Afficher fichier
dev_portlet_uportal.pdf
dev_portlet_uportal.pdf

Le code source est accessible directement depuis sourcesup :

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

Pour le compiler et le déployer vous devrez cependant avoir installé dans votre entrepôt maven le "forward port" de Spring MVC Portlet 2.5 donné ici  http://jira.springframework.org/browse/SPR-7217

Note : à partir de spring-portlet-mvc-jsr168-frontport.zip et pour que le mvn install du projet passe, vous pouvez supprimer la dépendance à org.springframework.test v2.5.6.SEC01 dans le pom.xml et supprimer tout le répertoire src/test

Ensuite depuis le répertoire d'EsupTwitter un

Bloc de code

mvn install

Puis un

Création du war depuis les sources.

Depuis le répertoire d'EsupTwitter un

Bloc de code
mvn package

vous package un EsupTwitter.war

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

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

Bloc de code
Bloc de code

ant deployPortletApp -DportletApp=/opt/canaux/EsupTwitter/target/EsupTwitteresup-twitter.war

depuis 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 :

Bloc de code

ant portlet.deploy -DportletApp=/opt/canaux/EsupTwitter/target/EsupTwitter.war

Copies d'Écran

Galerie
columns3
titlecopies d'écran de EsupTwitter dans EsupPortail

Annexes

English page on jasig.org.