Download the PHP package ichthus-soft/bible-api without Composer
On this page you can find all versions of the php package ichthus-soft/bible-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ichthus-soft/bible-api
More information about ichthus-soft/bible-api
Files in ichthus-soft/bible-api
Informations about the package bible-api
Bible Api
Acesta este un api open source care returneaza un sir de versete in format JSON pentru a fi putea utilizate in orice limbaj de programare. Spre exemplu, un plugin de Wordpress a fost creeat care te ajuta sa inserezi in pagina textul din Biblie doar cu un shortcode:
In curand voi face public si acest plugin de Wordpress, mai trebuie sa stea putin in faza de testare.
Cum se face query-ul
Bible Api foloseste pachetul ichthus-soft/bible_ref pentru a intelege query-ul pe care doresti sa il returnezi. Astfel ai urmatoarele optiuni:
Nota autor: De-a lungul exemplelor vei vedea ca poti in loc de spatiu sa pui +. Astfel url-ul va arata mult mai frumos decat cu spatiu. Este strict o alegere de gust, API-ul intelege si un query cu spatiu si un query cu +
Deci, ca sa generalizez:
- Formatul este numele-cartii capitol:verset[-sfarsit]
- Ca sa adaugi un nou capitol, adauga & la query - 2:1&3:5
- Ca sa adaugi o noua carte, adauga ; la query - Geneza 1:1;Faptele Apostolilor 1:9
Ce returneaza API-ul?
Daca esti familiar cu JSON, poti vedea un exemplu de raspuns mai jos. Api-ul returneaza:
- pasaj - Pasajul de unde sunt afisate versetele
- versete - un array de versete care are campurile urmatoare disponibile: testament - 1 este VT, 2 NT, carte - numele cartii, capitol - capitolul de unde este versetul, verset numarul versetului, text - textul adica versetul in sine.
- text - toate versetele concatenate, rezulta un singur bloc de text
- nl - versetele cu cate un intre ele
- nlvn - versetele cu un intre ele si cu numarul versetului la inceput de rand
In textul versetelor, cuvintele rostite de Domnul Isus sunt intr-un span cu clasa .Isus. Astfel poti din css-ul tau sa colorezi aceste cuvinte sau sa le dai un stil special fata de restul textului.
Versetul zilei Tot in acest api poti accesa versetul zilei cu ajutorul api-ului de la Resursecrestine.ro. Tot ce trebuie sa faci este sa vizitezi biblia.filipac.net/v2/versetulZilei si vei primi raspuns in acelasi stil standardizat pe care il gasesti la sfarsitul acestei documentatii.
Cum pot ajuta acest proiect?
Poti ajuta in multe moduri, amintesc doar unele din ele:
- Testeaza acest produs si vezi daca poti gasi un bug, raporteaza-l aici pe Github sau incearca sa il rezolvi tu (Fa-ti un fork la acest proiect, rezolva, da commit si apoi merge request)
- Spune la prieteni despre proiectul acesta.
- Foloseste api-ul la tine pe site (exemplu bisericasega.ro foloseste in mod frecvent acest api)
- Vino cu noi idei de inbunatatire - mereu se pot adauga chestii noi sau se pot inbunatati cele existente.
- Scrie o documentatie mai elaborata! Eu (Filip) nu prea am rabdare sa scriu documentatii. Poti sa o faci chiar tu.
- Instaleaza API-ul la tine pe site.
Acestea sunt doar cateva care imi vin acum in minte.
Cum instalez la mine pe site acest api?
Nu trebuie neaparat sa instalezi acest API, poti folosi cu incredere serverul meu. Totusi daca tu crezi ca mi-ai incetini cumva serverul cu mii de accesari pe minut, poti sa il instalezi pe serverul tau. Tot ce ai nevoie este un Apache, PHP 5.5, Composer si Mysql. Pasii sunt mai jos:
Metoda 1:
- Cloneaza acest proiect de Github:
- Instaleaza proiectul folosind Composer -
Metoda 2:
- Instaleaza proiectul folosit composer: .
Configurare:
- Copiaza intr-un fisier numit si schimba datele de access la baza de date.
- Acceseaza URL-ul public al serverului si urmeaza pasii de pe ecran pentru a insera tabelele in Mysql, necesare pentru a functiona.
- Gata! Ai instalat API-ul local. Acum in loc de poti folosi url-ul tau propriu.
Daca nu ai instalat local Apache: Pentru development poti lucra cu serverul intern PHP. Tot ce trebuie sa faci este sa deschizi un terminal in directorul unde ai instalat proiectul si sa scrii urmatoarea comanda: . Apoi poti vizita si vei vedea noul tau proiect functional. Pentru asta trebuie sa ai o versiune de PHP mai mare de 5.4.
Exemplu query si raspuns
http://biblia.filipac.net/v2/Ioan+3:16&1:1