Joomla 3.x are o nouă componentă numită com_ajax. Care este o componentă subțire, extensibilă, utilizată ca punct de plecare pentru executarea cererilor HTTP din module și plug-in-uri.
Câteva exemple de utilizare:
- Un modul care extrage datele dintr-un API extern
- Un modul care utilizează resursele componentei terță parte
- Plugin care implementează API-ul ca fiind funcțional pe site-ul dvs.
Aceasta nu este întreaga listă de posibilități pe care com_ajax le deschide dezvoltatorilor.
Anatomia întrebărilor Ajax
- format = [json | debug] - în mod implicit prime. dacă nu este specificat
- method = [fragment personalizat] - implicit obțineți. dacă nu este specificat
Toate cererile încep cu opțiunea = com_ajax - link-ul către componentă. De asemenea, ar trebui specificat tipul extensiei și numele acesteia.
Variabilele suplimentare și valorile utilizate de extensia dvs. pot fi, de asemenea, incluse în adresa URL. De exemplu, cererea pentru opțiunea = com_ajaxmodule = sesiune. unde se invocă mod_session. cu datele returnate în formatul implicit. În contrast. opțiune = com_ajaxplugin = sessionformat = json va apela peAjaxSession și va returna rezultatul în format JSON.
Pentru module
Modulul este suportat prin apelarea metodei din fișierul helper.php al modulului.
Cererea de module trebuie să includă variabila modulului în URL. asociat cu numele modulului (modul = sesiune pentru mod_session).
Această valoare este de asemenea utilizată:
- Ca nume de director pentru verificarea fișierului helper, de exemplu /modules/mod_session/helper.php
- Ca nume de clasă pentru apel, de exemplu modSessionHelper
De asemenea, interogarea poate conține un parametru opțional al metodei. O variabilă poate fi inclusă pentru a suprascrie metoda implicită (get).
NOTĂ: Toate metodele trebuie să se încheie cu Ajax. De exemplu: metoda = mySuperAwesomeMethodToTrigger fi numit mySuperAwesomeMethodToTriggerAjax
Ajax-Session-Module este un exemplu de modul care demonstrează această funcționalitate.
Pentru plug-in-uri
Pluginurile sunt acceptate prin apelarea evenimentului plug-in onAjax [Name].
Cererea modulului trebuie să includă pluginul variabil în adresa URL. asociat cu numele modulului (plugin = sesiune pentruAjaxSession).
Această valoare este de asemenea folosită pentru:
- Transmiterea numelui pluginului la conversia ulterioară plgAjax [Name]
- Transmiterea numelui funcției plugin la conversia onAjax [Name] ulterioară
Ajax-Latest-Articles este un exemplu de plug-in care demonstrează această funcționalitate.
Formatul datelor returnate
format = [json | debug] este un argument opțional care specifică formatul rezultatului:
- json pentru formatul JSON
- depanare pentru un rezultat de ieșire inteligibil de la om