Clovis Gauzy
Éclairagiste et photographie : reportage, mariage, concert, theatre, et autre evenement a Agen, en Aquitaine et partout en France et ailleurs

Construction de l'URL

Pour pouvoir définir quels seront les photos reçus, vous devez construire une adresse à questionner. Cette adresse se constitue des éléments suivants :

• le [site] de l'auteur
• le [lieu], nom de la salle de spectacle, en toutes lettres et en remplacant les espaces par _
• la [date], aux formats AAAA, AAAAMM ou AAAAMMJJ

Grace à ces éléments, nous allons construire l'adresse de cette manière : http://[site]/API/[lieu]/[date]

Exemples

http://www.clovis-gauzy.fr/API/Le_Florida retournera toutes les photos réalisés au Florida

http://www.clovis-gauzy.fr/API/Le_Florida/2009 retournera toutes les photos réalisés au Florida en 2009

http://www.clovis-gauzy.fr/API/Le_Florida/200912 retournera toutes les photos réalisés au Florida en décembre 2009

http://www.clovis-gauzy.fr/API/Le_Florida/20091216 retournera toutes les photos réalisés au Florida le 16 décembre 2009

http://www.clovis-gauzy.fr/API/Le_Florida/random retournera une photo au hasard réalisée au Florida

http://www.clovis-gauzy.fr/API/Le_Florida/2009/random retournera une photo au hasard réalisée au Florida en 2009

http://www.clovis-gauzy.fr/API/Le_Florida/200912/random retournera une photo au hasard réalisée au Florida en décembre 2009

http://www.clovis-gauzy.fr/API/Le_Florida/20091216/random retournera une photo au hasard réalisée au Florida le 16 décembre 2009

Informations de retour

La réponse est retourné sous la forme d'un tableau PHP mis en série (il suffit d'un unserialize() pour lui redonner sa vrai nature)

Il aura deux formes différente selon que vous ayez demandé une image aléatoire ou des galeries

Réponse pour les galeries

• [x] (numéro d'incrémentation)
  • [titre] => de la galerie
  • [date] => au format timestamp
  • [lieu] =>
  • [photos]
    • [x] => référence de la photo
    • …
  • [categorie] =>
  • [short] => URL courte de la galerie sur le site de l'auteur
• …

Réponse pour la photo aléatoire

• [titre] =>
• [ref] =>
• [date] => au format timestamp
• [lieu] =>
• [short] => URL courte de la photo sur le site de l'auteur

Les modules prêt à porter

Pour le moment, nous ne proposons que des solutions pour des sites supportant le PHP et permettant l'utilisaton de cURL ou files_get_contents()

PHP

Code à rajouter entre les bannières et de chaque page…
<style type="text/css"> .ExternalPhotoGalerie { border:1px solid #777;margin:1em;padding: 0.5em; } .ExternalPhotoGalerie > h3 { margin-top:0; } .ExternalPhotoGalerie > div, .ExternalPhotoRandom > div { float:left;width:150px;height:150px;padding:3px;margin:2px 4px 0 0;text-align:center;display:table;vertical-align:middle; } .ExternalPhotoGalerie > div > div, .ExternalPhotoRandom > div > div { display:table-cell;vertical-align:middle; } .ExternalPhotoGalerie > .copyright, .ExternalPhotoRandom > .copyright { clear:left;font-size:0.8em;font-style:italic;margin-bottom:0; } .ExternalPhotoGalerie > .copyright { text-align:right; } </style>
…ou directement dans le fichier CSS de votre thème (n'hésitez par à adapter)
.ExternalPhotoGalerie { border:1px solid #777;margin:1em;padding: 0.5em; } .ExternalPhotoGalerie > h3 { margin-top:0; } .ExternalPhotoGalerie > div, .ExternalPhotoRandom > div { float:left;width:150px;height:150px;padding:3px;margin:2px 4px 0 0;text-align:center;display:table;vertical-align:middle; } .ExternalPhotoGalerie > div > div, .ExternalPhotoRandom > div > div { display:table-cell;vertical-align:middle; } .ExternalPhotoGalerie > .copyright, .ExternalPhotoRandom > .copyright { clear:left;font-size:0.8em;font-style:italic;margin-bottom:0; } .ExternalPhotoGalerie > .copyright { text-align:right; }

Code à rajouter sur chaque page qui va exploiter l'API. Il est fortement conseillé de mettre ce code dans un fichier à part et de l'appeler ensuite avec un require_once() ou de l'intégré dans un fichier qui sera appelé pour chaque page.
function getExternalPhoto($url) { setlocale(LC_ALL,'fr_FR.UTF-8','fr_FR'); if (substr($url,-6) == 'random') $rand = true; // Si la première méthode ne marche pas, essayer de dé-commenter le bloc ci-dessous (en enlevant les /* et */)… /* $ch = curl_init(); $timeout = 10; // set to zero for no timeout curl_setopt ($ch, CURLOPT_URL,$url); curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout); $file_contents = curl_exec($ch); curl_close($ch); */ // … et commentez celle-ci $rts = file_get_contents($url); if ($rts != "N;") { $rts = unserialize($rts); // affichage de la photo if ($rand) { $ret = "<div class=\"ExternalPhotoRandom\"> <h4><a href=\"".$rts['url']."\" title=\"".$rts['titre']."\">".$rts['titre']."</a></h4> <p>".$rts['lieu']." - ".strftime('%A %d %B %Y',$rts['date'])."</p> <div><div><a href=\"".$rts['url']."\" title=\"".$rts['titre']."\"><img src=\"http://www.clovis-gauzy.fr/photos/tiny".$rts['ref'].".jpg\" alt=\"".$rts['titre']."\" /></a></div></div> <p class=\"copyright\">Photo : <a href=\"http://www.clovis-gauzy.fr\" title=\"Clovis Gauzy Photographie\">Clovis Gauzy</a></p> </div>"; } // affichage des albums else foreach ($rts as $galerie) { $ret .= "<div class=\"ExternalPhotoGalerie\"> <h3><a href=\"".$galerie['url']."\" title=\"".$galerie['titre']."\">".$galerie['titre']."</a></h3> <p>".$galerie['lieu']." - ".strftime('%A %d %B %Y',$galerie['date'])."</p>"; foreach ($galerie['photos'] as $do) $ret .= "<div><div><a href=\"http://www.clovis-gauzy.fr/photo/$do-.html\" title=\"".$galerie['titre']."\"><img src=\"http://www.clovis-gauzy.fr/photos/tiny$do.jpg\" /></a></div></div>"; $ret .= "<p class=\"copyright\">Photographies : <a href=\"http://www.clovis-gauzy.fr\" title=\"Clovis Gauzy Photographie\">Clovis Gauzy</a></p> </div>"; } return $ret; } }

Il suffit maintenant d'insérer cette commande avec l'URL que l'on aura construit plus haut (ici la galerie du 16 décembre 2009 au Florida)
<?=getExternalPhoto('http://www.clovis-gauzy.fr/API/Le_Florida/20091216'); ?>

Si vous avez des propositions pour améliorer / optimiser ce code, n'hésitez pas à m'en faire part ! ^^