Flickr er uten tvil den største og beste fotografisiden på internett. Det er mange widgets, merker og plugins som lar deg vise de nyeste Flickr-bildene dine på nettstedet ditt, men vi tar det et skritt videre ved å tappe rett inn i Flickr og integrere fotostrømmen din på nettstedet ditt, og gir deg et fotogalleri som Det er en bris å oppdatere.

Vi lager dette fotogalleriet ved hjelp av Flickr API og phpFlickr. Hvis bokstavene "A, P & I" er nok til å treffe frykt i hjertet ditt, ikke bekymre deg, vi tar det sakte og gir full kodeeksempler som du kan kopiere.

Flickr har også nylig lansert The App Garden, som er et showcase av verktøy, leker og nettsteder som bruker Flickr API for å tilby noe nyttig eller morsomt. Når du får tak i å bruke API, kan du la fantasien fremkalle en ny måte å bruke den på, og sende inn appen din.

For denne opplæringen antar jeg at du allerede har en Flickr-konto, og tilgang til en server som kjører PHP og PEAR.

Oversikten

• Få en Flickr API-nøkkel
• Last ned phpFlickr-filene
• Bygg en galleriside for å vise våre miniatyrbilder (med paginering)
• Lag en fotoside for å vise bildene våre (med forrige og neste navigasjon)

Trinn 1 - Få en Flickr API-nøkkel

Din API-nøkkel er din egen unike serie med tall og bokstaver som gir deg tilgang til Flickrs tjenester. Gå hit: http://www.flickr.com/services/apps/create/apply/

Her må du bestemme om du skal bruke Flickr for kommersielle eller ikke-kommersielle formål. Flickr gir gode forklaringer på hva du bør velge, sjansen er at du trenger en ikke-kommersiell API-nøkkel, som er det jeg velger for denne demoen.

Følg trinnene og fyll ut alle dine detaljer.

Du bør da bli presentert med din unike nøkkel som vil vises som en serie av tilfeldige tall og bokstaver som dette:

Du ser også et nummer som heter "Secret;" ignorere det for nå. For denne øvelsen trenger vi bare nøkkelen; noter det som vi trenger det snart.

Hvis du bruker API-en til å bygge et kult verktøy eller et nettsted senere, kan det være lurt å sende inn og fungere som du bygger i Flickr App Garden. Du kan klikke på "Rediger appdetaljer" for å fylle ut infoen.

Vær særlig oppmerksom på tipsene og rådene som er gitt i API-vilkårene og retningslinjene for fellesskapet, hvis du misbruker det, mister du det.

Nå videre til spennende ting ...

Trinn 2 - Last ned phpFlickr 

phpFlickr er et prosjekt av Dan Coulter. Det er en klasse skrevet i PHP som fungerer som en wrapper for Flickr API. Filene behandler dataene som tilbys av Flickr og returnerer arrayer i PHP, som vi bruker til å vise våre bilder

Vi må laste ned filene som vi senere vil inkludere i vår nettside, og vil gjøre alt det kompliserte arbeidet for oss. Besøk phpflickr.com eller hoppe direkte til nedlastingssiden på Google Code. I denne demoen bruker vi zip-filen: phpFlickr-2.3.1 (zip)

Last ned og pakke ut den. For denne opplæringen trenger vi bare PEAR-mappen og phpFlickr.php-filen. Last opp filene til webkatalogen din

Trinn 3 - Grunnleggende oppsett og enkel konfigurasjon  

Nå har vi alt vi trenger for å koble sammen med Flickr og hente våre bilder. Vi lager to sider: en for å vise miniatyrbildene våre og en for å vise bildet. Alle koden vil være tilgjengelige som komplette sider på slutten av opplæringen.

Disse kodeeksemplene fungerer alle på grunnlag av at filene dine er på roten til serveren din - eller alt i samme mappe. Før alt annet, må vi opprette en hurtigmappe for at phpFlickr skal fungere skikkelig. Opprett en mappe som heter 'cache' i webkatalogen din og gi den skrivbare tillatelser (CHMOD 777).

Nå skal vi bygge en side som viser miniatyrbildene våre og har litt enkel personsøking. I eksempelgalleriet er dette index.php - og ser slik ut.

Før vi går videre, må vi sette to hovedvariabler i config.php-filen.

Åpne config.php. Du ser at det bare ber om to ting: API-nøkkelen din og ditt Flickr-brukernavn.

Først legg inn API-nøkkelen din - det lange tilfeldige settet med tall og bokstaver du ble gitt tidligere av Flickr. Hold informasjonen din inne i sitatmerket.

// sett inn API-nøkkelen $ key = "Skriv inn FLICKR API KEY HERE";

Nå for ditt Flickr brukernavn; Dette er ikke ditt Yahoo-brukernavn eller Flickr skjermnavn - men brukernavnet du bruker til Flickr selv. For å dobbeltsjekke, logg inn på Flickr og se på toppen av siden der det står "Signed in as ..." - det er brukernavnet ditt. Så la oss erklære vårt brukernavn som en variabel:

// skriv inn ditt Flickr brukernavn $ username = "DITT FLICKR USERNAME HERE";

Lagre endringene til config.php og last opp - du trenger ikke den filen igjen.

Trinn 4 - Bygg miniatyrbildesiden

På selve siden. Her er en sammenfatning av hva vi gjør øverst på siden, som cues opp alt klart for handlingen:

Vi skal inkludere noen tidligere og neste koblinger med en liten kode lenger ned på siden. Miniatyrbildene vi skal vise, avhenger av hvilken side vi er på, så vi kjører en enkel hvis setning som tar tak i vårt sidetal. Hvis det er et "fpage" -spørsmål i url, bruk det. Hvis ikke, er vi på side en.

 
 Deretter følger vi kjernen phpFlickr-filen som har alt vi trenger i det kommuniserer med Flickr.
 
// inkludere kjernefilen require_once ('phpFlickr.php');
 
 Nå brann vi opp en ny klasse fra phpFlickr-filen ved hjelp av vår API-nøkkel som vi fikk tidligere.
 
 // Brann opp hoved phpFlickr klassen $ f = ny phpFlickr ($ key);
 
 phpFlickr bruker caching for å øke hastigheten på prosessen. Det finnes muligheter for å bruke en databaseteknikk, men for denne opplæringen vil vi bruke det enklere cachemappen alternativet. Vi trenger en mappe kalt "cache" som er skrivbar, noe som betyr at systemet har tilgang til det og kan endre innholdet. For å gjøre dette sett mappens tillatelser til 777 via ditt FTP-program. Da legger vi til denne linjen for å aktivere den: 
 
$ f-> enableCache ("fs", "cache");
 
 Vi kaller people_findByUsername-metoden som returnerer en matrise:
 
$ result = $ f-> people_findByUsername ($ brukernavn);
 
 Fra dette feltet trenger vi også ditt unike bruker-ID (ditt Flickr-ID som ser slik ut: 11221312 @ N00, erklært her som $ nsid) som vi får slik:
 
// Ta tak i vårt unike bruker ID fra $ result array $ nsid = $ result ["id"];
 
 Deretter kaller vi people_getPublicPhotos-metoden, som igjen returnerer en matrise som vi vil ringe til $ photos. I denne linjen passerer vi også gjennom vårt id som vi fikk i linjen ovenfor ($ nsid). NULL refererer til alternativet 'extras' som vi ikke er opptatt av akkurat nå. Vi oppgir også antall miniatyrbilder vi vil vise (21), og passerer gjennom siden for å starte på ($ side) som relaterer seg til $ side-variabelen fra toppen av siden:
 
 $ photos = $ f-> people_getPublicPhotos ($ nsid, NULL, NULL, 21, $ side);
 
 Den siste biten vi trenger for å sette opp siden, er litt info vi trenger for personsøkingen til å fungere. Vi får tilgang til $ fotorabellen vi opprettet over, og trekker ut det totale antall sider, pluss total mengde bilder i vår fotostrøm:
 
$ sider = $ bilder [bilder] [sider]; // returnerer totalt antall sider $ totalt = $ bilder [bilder] [totalt]; // returnerer hvor mange bilder det er totalt?>
 
 Legg merke til at vi lukker php-seksjonen herfra med?> Nå har vi alt vi trenger for å få de første 21 miniatyrbildene fra Flickr-fotostrømmen og vise dem. Vi fortsetter med siden, legger til noen html, bruker PHP til å vise bildene, og inkluderer noen enkle personsøkingskoblinger. Så la oss begynne med å skrive noen grunnleggende html. 
 
        
Mitt galleri
 
 
 Ikke noe helt vanlig her; bare sette opp html og starte et område for miniatyrbildene. Det neste trinnet er å fylle vår div som heter 'tommelen' med våre miniatyrbilder som slik:
  
 Merk at vi åpner php igjen med  
 Vi bruker en foreach-loop for å løpe gjennom $ photos-arrayen og for å komme til bildeelementet ($ photo), som inneholder informasjonen vi trenger for miniatyrbildene.
Se kommentarene i koden for en forklaring på hva som skjer: 
 
 buildPhotoURL ($ photo, "Square"). "\" width = \ "75 \" height = \ "75 \" alt = \ "$ bilde [title] \" /> "; / / lukk lenke ekko"