acronimele utilizate frecvent
Ce este oEmbed
În oEmbed-operațiune implică două părți: furnizor și consumator. Utilizatorul solicită elementele de conținut specifice, soluționarea cererilor de către furnizor API Endpoint. Furnizor de servicii de aceste cereri prin returnarea prezentarea elementelor necesare în XML sau JSON.
Prima abordare este simplă, dar conduce la un utilizator navighează pe site-ul dvs. pe site-ul YouTube cu multe ispite sale. În a doua abordare un vizitator rămâne pe site-ul dvs., dar trebuie să știi cum built-in player YouTube.
Listarea 1. Solicitare oEmbed
oEmbed-furnizori pot returna răspunsuri în XML sau JSON. Toate răspunsurile sunt codificarea UTF-8. Formatul de răspuns poate fi specificat în cerere, în formă de parametru suplimentar „format“. Un exemplu este prezentat în Listarea 2.
Listarea 2. Utilizarea API-ul oEmbed YouTube
Conținutul atașamentului cu oEmbed
Acum, că sunteți familiarizat cu munca oEmbed, ia în considerare exemplul de cod. Se presupune că sunteți de asemenea, familiarizat cu HTML, SQL, si XML, și că ai influența mediului Apache și PHP de dezvoltare. Cu toate acestea, se presupune că știți elementele de bază de lucru cu clase și obiecte PHP, deoarece PHP-componentele utilizate în acest articol, scris în conformitate cu principiile programării orientate pe obiecte.
Pentru a utiliza oEmbed cu PHP-aplicație, aveți nevoie pentru a alege una din cele două biblioteci: Services_oEmbed sau PERE oEmbed-PHP. În cele mai multe exemple pentru acest articol folosind PEAR Services_oEmbed (deși am inclus pentru referință sunt, de asemenea, mai multe exemple de php-oEmbed), așa că instalați. Acest lucru se poate face manual prin descărcarea site-ul bibliotecii PEAR (a se vedea. Link-ul din secțiunea Resurse), sau lăsați-l instalat automat prin intermediul PERE-Installer, așa cum este prezentat aici.
După instalare, încercați exemplul simplu din listingul 3.
Listarea 3. Folosind API-ul oEmbed YouTube
Figura 1. Obiect oEmbed, returnat Services_oEmbed PEAR bibliotecă
Lucrul cu conținut de metadate
În clipul încorporat, puteți adăuga metadate, așa cum se arată în Listarea 4.
Listarea 4. Utilizarea metadatelor oEmbed
Rețineți, de asemenea, că cererea poate include un parametru GetObject opțional (). o matrice care conține parametrii și maxwidth maxheight. care determină înălțimea și depunerea de retur lățime.
Utilizarea de conținut din surse multiple
Listarea 5. Utilizarea API oEmbed Revision3
Listarea 6 prezintă un alt exemplu, de data aceasta, atașarea unui fractal cu deviantART Web-site-ul.
Listarea 6. Cu ajutorul interfeței API oEmbed deviantART
Figura 5. Embedded DeviantArt imagine
OohEmbed serviciu
În timp ce multe aplicatii bazate pe web furnizează deja propriul lor punct final API oEmbed, unii nu fac încă. Dar aceste aplicații pot fi accesate - prin oohEmbed de serviciu, care se poziționează ca „furnizor de oEmbed compatibil cu HTML-cod încorporat pentru o varietate de Web-site-uri.“ Numărul de aplicații și servicii suplimentare care pot fi accesate prin oohEmbed, include imagini Amazon.com bunuri, actualizări de stare Twitter, Google Video, Metacafe, Slideshare, Twitpic, Wikipedia, Wordpress și altele. Cu toate acestea, trebuie remarcat faptul că oohEmbed acceptă numai ieșire JSON și de multe ori ignoră MaxWidth și MaxHeight.
Listarea 7 prezintă un exemplu de includere în codul de pe pagina de Web utilizând conținut oohEmbed de pe Wikipedia.
Listarea 7. Utilizarea oohEmbed și Wikipedia
Rețineți că, în 7 Listarea API punct final specificat se referă la oohEmbed, nu Wikipedia. oohEmbed funcționează ca un server proxy care primește o cerere oEmbed, uita la link-ul și returnează răspunsul oEmbed compatibil care conține datele solicitate.
Figura 6. integrat Pagina Wikipedia
Listarea 8 este un exemplu de investiții în Web-pagina de prezentare Slideshare (tip de mass-media bogat) folosind oohEmbed.
Listarea 8. Utilizarea oohEmbed și SlideShare
Figura 7. Prezentarea integrată SlideShare
Listarea 9 oohEmbed folosit pentru a extrage și de a insera imaginea element amazon.com URL pentru acest produs.
Listarea 9. Utilizarea oohEmbed și amazon.com
Figura 8. integrat Amazon imaginea produsului
Utilizarea de alternative PHP-biblioteci
O alternativă Services_oEmbed PEAR bibliotecă servește bibliotecă oEmbed php, care pot fi de asemenea folosite pentru a pune în aplicare conținutul în pagina de Web. Instalați această bibliotecă este simplu: descărcați (a se vedea link-ul în resurse.) Și copiați-l în orice loc în directorul PHP. Setup, cu toate acestea, va fi puțin mai complicat decât pentru Services_oEmbed.
Biblioteca oEmbed-php păstrează propria listă de furnizori și punctul final API oEmbed în XML-fișier numit providers.xml, localizat în directorul de instalare. Deci, înainte de a începe să utilizați un anumit furnizor de oEmbed, trebuie mai întâi să-l adăugați la dosar. De exemplu, dacă doriți să utilizați oEmbed API DeviantArt, trebuie mai întâi fișier edita providers.xml, adăugați o intrare la aceasta, așa cum se arată în Listarea 10.
Listarea 10. Editarea providers.xml cu adăugarea unei noi intrări
Atunci când este adăugat un furnizor, puteți începe să utilizați în scripturi PHP, așa cum se arată în Listing 11 oEmbed-php.
Listarea 11. Utilizarea oohEmbed și deviantART cu biblioteca oEmbed-php
Listarea 11 începe prin definirea locația fișierului și providers.xml și să includă toate clasele necesare pentru oEmbed-php. Apoi, creați un ProviderManager obiect de serviciu, să furnizeze () metoda este utilizată pentru a obține URL-ul de conținut oEmbed-depunere. Acest punct de vedere poate fi returnat într-o varietate de formate: XML, JSON, PHP-obiect, PHP-matrice sau ca o secvență de linii.
Figura 9. oEmbed-obiect returnat biblioteca php-oEmbed
Figura 10. Embedded deviantART imagine
Exemplu de aplicare: introducerea conținutului în corpul documentului
Acum, că știți elementele de bază ale folosind PHP cu oEmbed, să vedem cum funcționează în contextul unei cereri de probă. Deoarece oEmbed se referă la introducerea de conținut, un exemplu de pagina web oferă utilizatorilor un formular pentru a introduce un document (de exemplu, mesajele din blog), cu conversia automată a hyperlink-uri în acest document, în conținutul de vizualizare încorporat utilizând oEmbed.
Codul complet este prezentat în Listarea 12.
Listarea 12. O cerere de probă pentru punerea în aplicare a conținutului în corpul documentului
Listarea 12 este împărțit în două părți separate unul de celălalt prin verificarea condițiilor if-else (). Se verifică pentru echipa de pe formularul de transfer; în cazul în care este detectat, un simplu Web-formular în cazul în care utilizatorului i se solicită să introduceți un titlu de pagină și text. Utilizatorul poate introduce text în ambele domenii, introducând în ea hyperlink-uri, după caz. Figura 11 ilustrează un web-form generat prin listarea de intrare 12 cu câteva exemple. (Versiune text din Figura 11).
Figura 11. Web-ului sub formă de punere în aplicare a conținutului în corpul mesajului
folosește în continuare bucla foreach (), și încercați-catch bloc<> pentru iterația prin adresa URL matrice cu transmisia fiecărei metode elementului getObject () Services_oEmbed obiect. Acest pas conduce la solicitarea conținutului de la distanță prin intermediul oohEmbed API. În cazul în care conținutul este un serviciu susținut, getObject () returneaza inserarea HTML-cod corespunzător, care este stocat într-o matrice separată numit $ încorporări. În cazul în care conținutul nu este acceptat, codul generează o excepție, care este prins de blocul try-catch<>. Această excepție înseamnă că URL-ul încorporat de prezentare nu este disponibilă, astfel încât URL-ul este convertit într-o etichetă HTML-ancoră și stocate în matrice $ încorporări.
Ultimul pas este de a realiza căutarea și înlocuirea operare pe corpul original al documentului introdus de utilizator, cu înlocuirea fiecărei adrese URL sau inserați corespunzător codul HTML sau HTML-hyperlink. Apoi, documentul editat este imprimat pe pagina web.
Figura 12 ilustrează rezultatul final cu încorporat în conținutul documentului.
Figura 12. Web-pagină cu conținut de document încorporat
concluzie
După cum se poate observa din aceste exemple, oEmbed - API este un simplu specializat, conceput pentru unicul scop - introducerea de conținut, iar această problemă se rezolvă foarte bine. Este un instrument flexibil pentru cei care dezvoltatorii care doresc să creeze o aplicație nouă și originală, folosind agregarea de conținut și de căutare. Joaca-te cu ea pentru un timp și să facă propria opinie.