Antoine Guiral : apprenti du web 2.0

Partage d’expériences sur le web

Articles reli´s: «:api»

[tuto mashup] Google maps sur votre site : c’est possible! (version statique)

Posté par Guiral antoine le janvier 24, 2008

Le tutoriel est présent sur mon nouveau blog (lien direct vers le tutoriel). Désolé pour la gène occasionnée…

Je vous en parlais il y a quelque jour, le voila! Un petit tutoriel pour faire un mashup avec google maps sur votre site. J’ai réalisé un site début janvier pour l’école : www.le-passe-livre.com qui utilise google maps.

  • Vue d’ensemble du tutoriel

Nous allons utiliser une classe php (une fois de plus :-) ) qui va nous permettre d’utiliser très simplement l’API de google. Comme presque toutes les API vous devez obtenir une clé pour pouvoir utiliser le service. Puis nous construirons notre google map en placant nos marqueurs sur la carte. Enfin nous l’afficherons.

  • Télécharger la classe et activer l’API

Vous pouvez télécharger la classe ici. Créez un dossier “classe” à la racine de votre site et décompressez l’archive à l’interieur. Vous devez maintenant obtenir la clé qui va vous permettre d’utiliser l’API de google maps. Pour pouvoir tester votre site en local indiquez http://127.0.0.1/ pour l’url de votre site.

  • Création de la carte google

Je pense que le code est assez bien commenté. On créé une instance de notre carte, puis on fait le lien avec la clé google et on définit les caractéristique de notre carte (taile,type de carte,etc etc).

Afin d’optimiser le référencement de mon nouveau blog, je suis contraint de tronquer se billet…La suite du tutoriel est présent sur mon nouveau blog (lien direct vers le tutoriel). Désolé pour la gène occasionnée…

Publié dans tutoriel, web 2.0 | Taggé: , , , , , , , , , , | 14 Commentaires »

[tuto mashup] Galerie photo animée via Flickr : animer votre galerie (2/2)

Posté par Guiral antoine le janvier 22, 2008

Ce tutoriel est disponible dans son intégralité sur mon nouveau blog : lien direct

La suite du tutoriel sur les mashup avec flickr est là! Sachez que ce tutoriel est applicable avec toutes vos photos, qu’elles proviennent de flickr ou non.

Pour ceux qui ne veulent pas ou n’ont pas le temps ou l’envie de lire la première partie voici ma page de test pour la galerie avec flickr (des fois il y a un bug, faites f5 le temps que je corrige ce problème…).

  • Le javascript : jquery

Nous allons d’abord télécharger notre framework préféré >>JQuery<< et le plugin >>Interface<< qui nous intéresse.

Choisissez bien!

Je vous conseil de mettre vos deux librairie dans un dossier que vous nommerez scripts et qui contiendra tous vos scripts javascript et vos librairies. Maintenant que votre espace de travaille est préparé reprenons le fil du tutoriel précédent :

Ce tutoriel est disponible dans son intégralité sur mon nouveau blog : lien direct

Publié dans tutoriel, web 2.0 | Taggé: , , , , , , , , , | 6 Commentaires »

[tuto mashup] Galerie photo animée via Flickr : récupérer les photos (1/2)

Posté par Guiral antoine le janvier 19, 2008

Ça y est! Il est là, il est tout nouveau tout beau! Le tutoriel pour faire une galerie photo animée avec JQuery et qui utilise flickr pour héberger vos photos. Un bon petit mashup quoi! Pour voir ce que ça donne un peit test ici… Allé gogogogogo!

  • Flickr

Bon, on veux héberger nos photos chez flickr. Donc…il vous faut un compte flickr (si ce n’est déjà fait!). Allé hop hop hop on s’inscrit. Si vous avez un compte yahoo! cela devrait être ok. L’ inscription ça c’est fait. Un petit mail de validation plus tard vous voila connecter sur votre compte flickr.
Pour la suite sur flickr je vous ai préparé un tutoriel vidéo. Je vous conseille de le suivre en entier, surtout pour la fin!

  • Le php

Alors là on rentre dans le vif du sujet. Nous allons utiliser une classe php. Des notions de POO serait un plus mais si vous n’y connaissez rien en POO pas de problème vous pouvez continuer. Pour commencer vous devez >>télécharger la classe basée sur l’API de flickr<<. C’est elle qui va nous permettre d’afficher nos photos. Créez vous un dossier dans lequel vous décompressez l’archive. Créez y aussi un nouveau fichier php, par exemple : test-flickr.php.

Activer la librairie curl : Il faut à présent vérifier que votre serveur local soit configuré correctement. Ouvrez votre php.ini et trouvez le bloc qui contient toutes les extensions de php. Il faut ensuite décommenter (enlever le “;” au début de la ligne) la ligne suivante : extension=php_curl.dll. C’est presque fini. Allez dans votre dossier “php” dans easyPhp ou dans WAMP et copier les fichiers libeay32.dll et ssleay32.dll dans votre dossier windows/system32 ou windows/system suivant votre version de windows.

Place au code :

La première ligne va concerner l’inclusion de notre classe :

<?php

require(‘flickr.php’);

Ensuite pour pouvoir utiliser l’API nous devons obtenir une deux clés (gratuites). C’est le cas pour la quasi-totalité des API. La première clé s’obtient en remplissant ce formulaire :

La première clé!

La seconde clé suivez le lien indiquez par la flèche rouge. Elle se situe sous la première clé et s’appelle clé de “secret partagé“. Nous pouvons maintenant nous connecter à flickr via l’API.

// Paramètres API :

$apiKey = ‘010e84b635468**********8d7a0f322′;
$apiSecret = ‘989******aa1418e’;

La variable $apiKey correspond à la première clé. Pas la peine de traduire pour la seconde ;-) .

Vous vous souvenez des id que vous avez notés au début? Re-sortez les!

// Id du User :

$userId = ‘227*****@N07′;

//Id de l’album :

$albumId = ‘72157*********064′;

Nous y voilà. Nous allons instancier notre classe Flickr. C’est à dire que nous allons créer un objet à partir de notre classe. Voila comment ça se passe :

// Nouvelle instance de Flickr :

$flickr = new Flickr( $apiKey , $apiSecret );

Notre nouvel objet : $flickr. C’est lui qui gère la connexion avec l’API. On va créer une instance de notre album maintenant. Même combat sauf que la classe change de nom :

// Nouvelle instance de Album :

$album = new Album( $flickr , $albumId , $userId );

Enfin! Nous avons notre album. On comprend rapidement les arguments que l’on transmet lors de l’instance : notre objet $flickr pour se conecter, notre identifiant d’album $albumId et notre identifiant utilisateur $userId. On a donc ce qu’il nous faut pour accéder à nos photos : Notre objet $album.

Pour ce tutoriel j’utilise la méthode getPhotos(). C’est celle qui nous donne le plus de données utilisables. Pour le moment nous allons nous contenter d’afficher les miniatures de nos photos.

// Affiche les “thumbs” de toutes les photos de l’album :

foreach( $album->getPhotos() as $photo ) {
echo $photo['imgThumbs'] ;
}

?>

Le foreach permet d’assigner à la variable $photo chaque “ligne” ou “tuple” (pour reprendre un langage plus orienté base de données) renvoyés par la methode getPhotos(). Si vous voulez avoir le détail de ce que renvoi getPhotos() pour faire mumuz et modifier le script à votre guise, remplacez la ligne du echo par :

var_dump($photo);

Un petit test dans firefox votre navigateur favori et normalement vous devriez avoir toutes vos miniatures!

Un grand merci à scriptsphp pour cette classe et la doc fournie. D’ailleurs n’hésitez pas à aller faire un tour sur leur site pour voir toutes les méthodes qui existent.

 

La prochaine étape du tutoriel portera sur l’aspect animation de la gallerie histoire d’avoir un truc présentable!

Si vous avez fait des essais postez vos url’s en commentaire. Pareil si vous avez des bugs, problèmes remarques, etc etc n’hésitez surtout pas!! A très bientôt pour la suite!

 

EDIT : la suite est ici!

Publié dans projet, tutoriel, web 2.0 | Taggé: , , , , , , , , , , | 2 Commentaires »

Vous avez dit mashup?

Posté par Guiral antoine le janvier 18, 2008

Avant de nous lancer dans le prochain tutoriel, il me semble important de savoir ce qu’est un “mashup” ou “mash-up“. C’est un concept important pour le web 2.0. Rien de bien compliqué mais autant savoir de quoi on parle!

  • Quoi?

Un mashup c’est le fait de réutiliser le contenu d’un site ou service existant dans votre site web. Les services web propose d’utiliser leurs contenus au travers d’API. En guise d’exemple, le prochain tutoriel utilisera l’API de flickr. Vous réaliserez donc un mashup en codant la galerie photos que je vous propose de faire.

  • Qui?

Il existe beaucoup de services proposant une API pour accéder à leurs contenus. Les plus célèbres sont : Google, Yahoo!, Amazon, YouTube, Dailymotion, Flickr, eBay, etc…

  • Pourquoi?

Le fait de proposer une API est un avantage pour les deux partis. D’un coté les services qui les proposent bénéficient d’une publicité “virale” puisque ce sont les créateurs de site qui vont publier et faire connaitre leurs produits (gratuitement en plus :-p). De l’autre coté le créateur de site web a à sa portée des outils puissants, complets et variés qui vont lui permettre de faire des sites tous plus extraordinaire les uns que les autres!

La seule limite qu’il vous reste c’est votre créativité! C’est souvent le plus dur… avoir de bonnes idées!

A très vite!

Publié dans découverte, web 2.0 | Taggé: , , , , , , , , | 1 commentaire »