| blob | 3ecabefecc02d9bf3d645730fcf59990b39f46fc |
1 <sect1 id="zend.service.flickr">
2 <title>Zend_Service_Flickr</title>
3 <sect2 id="zend.service.flickr.introduction">
4 <title>Wprowadzenie do przeszukiwania Flickr</title>
5 <para>
6 <code>Zend_Service_Flickr</code> jest prostym API do użycia z serwisem
7 Flickr REST Web Service. W celu użycia web serwisów Flickr, musisz
8 posiadać klucz API. Aby zdoby klucz i uzyskać więcej informacji o
9 Flickr REST Web Service, odwiedź
10 <ulink url="http://www.flickr.com/services/api/">dokumentację Flickr API</ulink>.
11 </para>
12 <para>
13 W poniższym przykladzie, używamy metody <code>tagSearch()</code> do
14 wyszukiwania zdjęć zawierających etykietę "php".
15 </para>
16 <example id="zend.service.flickr.introduction.example-1">
17 <title>Proste wyszukiwanie zdjęć Flickr</title>
18 <programlisting role="php"><![CDATA[
19 $flickr = new Zend_Service_Flickr('MY_API_KEY');
21 $results = $flickr->tagSearch("php");
23 foreach ($results as $result) {
24 echo $result->title . '<br />';
25 }
26 ]]>
27 </programlisting>
28 </example>
29 <note>
30 <title>Opcjonalny parametr</title>
31 <para>
32 Metoda <code>tagSearch()</code> akceptuje tablicę opcji jako
33 opcjonalny drugi parametr.
34 </para>
35 </note>
36 </sect2>
37 <sect2 id="zend.service.flickr.finding-users">
38 <title>Wyszukiwanie zdjęć użytkowników Flickr i informacji o nich</title>
39 <para>
40 Klasa <code>Zend_Service_Flickr</code> zapewnia kilka możliwości
41 pobierania informacji o użytkownikach serwisu Flickr:
42 </para>
43 <itemizedlist>
44 <listitem>
45 <para>
46 <code>userSearch()</code>: akceptuje w parametrze treść
47 zapytania w postaci etykiet oddzielonych spacją oraz tablicę
48 opcji wyszukiwania jako opcjonalny drugi parametr, a zwraca
49 zestaw zdjęć jako obiekt
50 <code>Zend_Service_Flickr_ResultSet</code>.
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 <code>getIdByUsername()</code>: Zwraca ID użytkownika powiązane
56 z podaną nazwą użytkownika.
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 <code>getIdByEmail()</code>:Zwraca ID użytkownika powiązane z
62 podanym adresem email.
63 </para>
64 </listitem>
65 </itemizedlist>
66 <example id="zend.service.flickr.finding-users.example-1">
67 <title>Wyszukiwanie publicznych zdjęć użytkownika serwisu Flickr na podstawie adresu e-mail</title>
68 <para>
69 W tym przykładzie, posiadamy adres e-mail użytkownika serwisu
70 Flickr i szukamy publicznych zdjęć użytkownika używając metody
71 <code>userSearch()</code>:
72 </para>
73 <programlisting role="php"><![CDATA[
74 $flickr = new Zend_Service_Flickr('MY_API_KEY');
76 $results = $flickr->userSearch($userEmail);
78 foreach ($results as $result) {
79 echo $result->title . '<br />';
80 }
81 ]]>
82 </programlisting>
83 </example>
84 </sect2>
85 <sect2 id="zend.service.flickr.grouppoolgetphotos">
86 <title>Wyszukiwanie zdjęć w Group Pool</title>
87 <para>
88 Klasa <code>Zend_Service_Flickr</code> pozwala na pobieranie
89 zdjęć grupy w oparciu o jej ID. Użyj metody
90 <code>groupPoolGetPhotos()</code>:
91 </para>
92 <example id="zend.service.flickr.grouppoolgetphotos.example-1">
93 <title>Pobieranie zdjęć z Group Pool na podstawie ID grupy:</title>
94 <programlisting role="php"><![CDATA[
95 $flickr = new Zend_Service_Flickr('MY_API_KEY');
97 $results = $flickr->groupPoolGetPhotos($groupId);
99 foreach ($results as $result) {
100 echo $result->title . '<br />';
101 }
102 ]]>
103 </programlisting>
104 </example>
105 <note>
106 <title>Opcjonalny parametr</title>
107 <para>
108 Metoda <code>groupPoolGetPhotos()</code> akceptuje opcjonalny
109 drugi parametr będący tablicą opcji.
110 </para>
111 </note>
112 </sect2>
113 <sect2 id="zend.service.flickr.getimagedetails">
114 <title>Pobieranie szczegółów zdjęcia Flickr</title>
115 <para>
116 <code>Zend_Service_Flickr</code> ułatwia pobieranie informacji o
117 zdjęciu na podstawie podanego ID zdjęcia. Po prostu użyj metody
118 <code>getImageDetails()</code>, tak jak w poniższym przykładzie:
119 </para>
120 <example id="zend.service.flickr.getimagedetails.example-1">
121 <title>Pobieranie szczegółów zdjęcia Flickr</title>
122 <para>
123 Jeśli posiadasz ID zdjęcia Flickr, pobranie informacji o zdjęciu
124 jest bardzo proste:
125 </para>
126 <programlisting role="php"><![CDATA[
127 $flickr = new Zend_Service_Flickr('MY_API_KEY');
129 $image = $flickr->getImageDetails($imageId);
131 echo "Obrazek o ID $imageId ma rozmiar $image->width x $image->height pikseli.<br />\n";
132 echo "<a href=\"$image->clickUri\">Click for Image</a>\n";
133 ]]>
134 </programlisting>
135 </example>
136 </sect2>
137 <sect2 id="zend.service.flickr.classes">
138 <title>Klasy wyników Zend_Service_Flickr</title>
139 <para>
140 Poniższe klasy są zwracane przez metody <code>tagSearch()</code> oraz <code>userSearch()</code>:
141 <itemizedlist>
142 <listitem><para><link linkend="zend.service.flickr.classes.resultset"><code>Zend_Service_Flickr_ResultSet</code></link></para></listitem>
143 <listitem><para><link linkend="zend.service.flickr.classes.result"><code>Zend_Service_Flickr_Result</code></link></para></listitem>
144 <listitem><para><link linkend="zend.service.flickr.classes.image"><code>Zend_Service_Flickr_Image</code></link></para></listitem>
145 </itemizedlist>
146 </para>
147 <sect3 id="zend.service.flickr.classes.resultset">
148 <title>Zend_Service_Flickr_ResultSet</title>
149 <para>Reprezentuje zestaw wyników wysuzkiwania Flickr.</para>
150 <note>
151 <para>
152 Implementuje interfejs <code>SeekableIterator</code>
153 dla łatwej iteracji (np., używając <code>foreach</code>),
154 tak samo jak i dla bezpośredniego dostępu do specyficznego
155 wyniku używając metody <code>seek()</code>.
156 </para>
157 </note>
158 <sect4 id="zend.service.flickr.classes.resultset.properties">
159 <title>Właściwości</title>
160 <table id="zend.service.flickr.classes.resultset.properties.table-1">
161 <title>Właściwości Zend_Service_Flickr_ResultSet</title>
162 <tgroup cols="3">
163 <thead>
164 <row>
165 <entry>Nazwa</entry>
166 <entry>Typ</entry>
167 <entry>Opis</entry>
168 </row>
169 </thead>
170 <tbody>
171 <row>
172 <entry>totalResultsAvailable</entry>
173 <entry>int</entry>
174 <entry>Całkowita ilość dostępnych wyników wyszukiwania</entry>
175 </row>
176 <row>
177 <entry>totalResultsReturned</entry>
178 <entry>int</entry>
179 <entry>Całkowita ilość zwróconych wyników wyszukiwania</entry>
180 </row>
181 <row>
182 <entry>firstResultPosition</entry>
183 <entry>int</entry>
184 <entry>Pozycja obecnego zestawu wyników we wszystkich wynikach</entry>
185 </row>
186 </tbody>
187 </tgroup>
188 </table>
189 </sect4>
190 <sect4 id="zend.service.flickr.classes.resultset.totalResults">
191 <title>Zend_Service_Flickr_ResultSet::totalResults()</title>
192 <para>
193 <methodsynopsis>
194 <type>int</type>
195 <methodname>totalResults</methodname>
196 <void />
197 </methodsynopsis>
198 </para>
199 <para>
200 Zwraca całkowitą ilość wyników w tym zestawie wyników wyszukiwania.
201 </para>
202 <para>
203 <link linkend="zend.service.flickr.classes">Powrót do listy klas</link>
204 </para>
205 </sect4>
206 </sect3>
207 <sect3 id="zend.service.flickr.classes.result">
208 <title>Zend_Service_Flickr_Result</title>
209 <para>
210 Pojedynczy wynik wyszukiwania zdjęcia w serwisie Flickr
211 </para>
212 <sect4 id="zend.service.flickr.classes.result.properties">
213 <title>Właściwości</title>
214 <table id="zend.service.flickr.classes.result.properties.table-1">
215 <title>Właściwości Zend_Service_Flickr_Result</title>
216 <tgroup cols="3">
217 <thead>
218 <row>
219 <entry>Nazwa</entry>
220 <entry>Typ</entry>
221 <entry>Opis</entry>
222 </row>
223 </thead>
224 <tbody>
225 <row>
226 <entry>id</entry>
227 <entry>string</entry>
228 <entry>ID zdjęcia</entry>
229 </row>
230 <row>
231 <entry>owner</entry>
232 <entry>string</entry>
233 <entry>Identyfikator NSID właściciela zdjęcia.</entry>
234 </row>
235 <row>
236 <entry>secret</entry>
237 <entry>string</entry>
238 <entry>Klucz używany w konstrukcji URL.</entry>
239 </row>
240 <row>
241 <entry>server</entry>
242 <entry>string</entry>
243 <entry>Nazwa serwera używana w konstrukcji URL.</entry>
244 </row>
245 <row>
246 <entry>title</entry>
247 <entry>string</entry>
248 <entry>Tytuł zdjęcia.</entry>
249 </row>
250 <row>
251 <entry>ispublic</entry>
252 <entry>string</entry>
253 <entry>Czy zdjęcie jest publiczne.</entry>
254 </row>
255 <row>
256 <entry>isfriend</entry>
257 <entry>string</entry>
258 <entry>Czy zdjęcie jest dla Ciebie widoczne ponieważ jesteś przyjacielem właściciela.</entry>
259 </row>
260 <row>
261 <entry>isfamily</entry>
262 <entry>string</entry>
263 <entry>Czy zdjęcie jest dla Ciebie widoczne ponieważ jesteś rodziną właściciela.</entry>
264 </row>
265 <row>
266 <entry>license</entry>
267 <entry>string</entry>
268 <entry>Licencja pod jaką dostępne jest zdjęcie.</entry>
269 </row>
270 <row>
271 <entry>dateupload</entry>
272 <entry>string</entry>
273 <entry>Data wgrania zdjęcia.</entry>
274 </row>
275 <row>
276 <entry>datetaken</entry>
277 <entry>string</entry>
278 <entry>Data zrobienia zdjęcia.</entry>
279 </row>
280 <row>
281 <entry>ownername</entry>
282 <entry>string</entry>
283 <entry>Wyświetlana nazwa użytkownika.</entry>
284 </row>
285 <row>
286 <entry>iconserver</entry>
287 <entry>string</entry>
288 <entry>Serwer używany przy dołączaniu adresów URL ikon.</entry>
289 </row>
290 <row>
291 <entry>Square</entry>
292 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
293 <entry>Miniaturka zdjęcia o wielkości 75x75.</entry>
294 </row>
295 <row>
296 <entry>Thumbnail</entry>
297 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
298 <entry>Miniaturka zdjęcia o wielkości 100 pikseli.</entry>
299 </row>
300 <row>
301 <entry>Small</entry>
302 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
303 <entry>Wersja zdjęcia o wielkości 240 pikseli.</entry>
304 </row>
305 <row>
306 <entry>Medium</entry>
307 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
308 <entry>Wersja zdjęcia o wielkości 500 pikseli.</entry>
309 </row>
310 <row>
311 <entry>Large</entry>
312 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
313 <entry>Wersja zdjęcia o wielkości 640 pikseli.</entry>
314 </row>
315 <row>
316 <entry>Original</entry>
317 <entry><link linkend="zend.service.flickr.classes.image">Zend_Service_Flickr_Image</link></entry>
318 <entry>Oryginalne zdjęcie.</entry>
319 </row>
320 </tbody>
321 </tgroup>
322 </table>
323 <para>
324 <link linkend="zend.service.flickr.classes">Powrót do listy klas</link>
325 </para>
326 </sect4>
327 </sect3>
328 <sect3 id="zend.service.flickr.classes.image">
329 <title>Zend_Service_Flickr_Image</title>
330 <para>Reprezentuje zdjęcie zwrócone przez wyszukiwanie Flickr.</para>
331 <sect4 id="zend.service.flickr.classes.image.properties">
332 <title>Właściwości</title>
333 <table id="zend.service.flickr.classes.image.properties.table-1">
334 <title>Właściwości Zend_Service_Flickr_Image</title>
335 <tgroup cols="3">
336 <thead>
337 <row>
338 <entry>Nazwa</entry>
339 <entry>Typ</entry>
340 <entry>Opis</entry>
341 </row>
342 </thead>
343 <tbody>
344 <row>
345 <entry>uri</entry>
346 <entry>string</entry>
347 <entry>Adres URI oryginalnego zdjęcia</entry>
348 </row>
349 <row>
350 <entry>clickUri</entry>
351 <entry>string</entry>
352 <entry>Klikalny adres URI (np. strony Flickr) dla zdjęcia</entry>
353 </row>
354 <row>
355 <entry>width</entry>
356 <entry>int</entry>
357 <entry>Szerokość zdjęcia</entry>
358 </row>
359 <row>
360 <entry>height</entry>
361 <entry>int</entry>
362 <entry>Wysokość zdjęcia</entry>
363 </row>
364 </tbody>
365 </tgroup>
366 </table>
367 <para>
368 <link linkend="zend.service.flickr.classes">Powrót do listy klas</link>
369 </para>
370 </sect4>
371 </sect3>
372 </sect2>
373 </sect1>