Un folder care conține fișiere de localizare în cheia format: valoare. În prezent, sunt posibile numai două localizări: rusă (en) și engleză (ro). Toate traducerile vor fi disponibile atât în partea JS, cât și în partea PHP
După cum puteți vedea, este necesar doar fișierul manifest.json
4. Noțiuni de bază
De exemplu, vom lua un widget bazat numai pe JS. Afișează un buton în cartea de vizită când faceți clic pe care date din card este trimis către sistemul extern, unde, de exemplu, scriptul php este tratat cu un stub care poate fi scris în orice limbă.
Aceasta este o sarcină comună, pentru că adesea cerută de procesul de afaceri pentru a transfera date de la amoCRM în funcție de acțiunea angajatului în sistemul intern al companiei. Sau, dimpotrivă, extrageți date suplimentare din sistemul extern în cardurile amoCRM.
De asemenea, widgeturile publice pot interacționa cu funcționalitatea tranzacțiilor cu pâlnie digitală și a cumpărătorilor. Mai multe detalii pot fi găsite în secțiunea widget-urilor din conducta Digital
Deci, mai întâi, copiați dosarul cu eșantionul widget și sunați-l widget. Aceasta este baza viitorului nostru widget.
Nu vom folosi fișierul widget.php, astfel încât să îl puteți elimina în siguranță. Apoi, vom începe să ne ocupăm de toate dosarele.
5. manifest.json
Începem să edităm fișierul, ghidat de tabelul care descrie parametrii acestuia. În sensul dvs., puteți utiliza un link la mesajele lingvistice, dacă este necesar.
Blocul conține toate setările de bază ale widgetului
Numele widgetului, inclusiv lista widgeturilor. În exemplu, valoarea widget.name este setată. ceea ce înseamnă că valoarea va fi luată din fișierul corespunzător al dosarului i18n, în funcție de localizare. Dacă utilizați o singură limbă, puteți introduce imediat un nume.
Scurtă descriere pentru ieșire în lista widgeturilor
Faptul că ați introdus caractere latine când generați o cheie pe pagina dezvoltatorului. Codul dvs. widget
Cheia widget secretă pe care ați generat-o pe pagina dezvoltatorului
Widget version. Are doar o sarcină informativă.
(int) Versiunea de interfață (1,2) pentru care interfața de sistem este încărcată widgetul. În mod implicit, trebuie să lăsați 2. Interfața 1 - versiunea anterioară a interfeței întregului sistem amoCRM, fără a utiliza AJAX. Înregistrarea pentru vechea versiune este închisă acum.
De asemenea, este necesar să ne informăm sistemul dacă widgetul va folosi coloana din dreapta pentru afișare, o puteți face adăugând 0 sau 1 după specificarea zonei
Asta este, dacă specificați "clist-0", widgetul este inițializat în această zonă, dar nu va folosi coloana din dreapta.
De exemplu, panoul pentru fundal WEB nu este în coloana din dreapta a widget-urilor, ci în partea inferioară a oricărei interfețe. Prin urmare, pentru toate punctele de conectare din setările widgetului, 0 trebuie scris, dar este inițializat pe fiecare pagină.
O serie de setări widget disponibile pentru utilizator, adică Câmpurile care vor fi prezente în fereastra de setări widget și populate de utilizator. Această secțiune este necesară numai dacă instalarea = true, dacă installation = false, atunci această secțiune nu este necesară, deoarece în fereastra de setări va fi afișată numai descrierea widget-ului. Cheia în matrice este codul câmpului FIELD_CODE
adevărat / fals obligatoriu de completare de către utilizator.
Blochează configurația widget-urilor în conducta digitală.
Acest bloc trebuie să fie inclus în manifest.json numai dacă există un domeniu de aplicare al digital_pipeline.
Cu funcționalitatea conductei digitale, pot funcționa numai widgeturile publice care au fișierul widget.php, în care vine terminalul digital_pipeline (mai multe detalii conducte digitale)
Similar cu blocul de setări, dar va fi afișat la reglarea widgetului din canalul digital.
Câmp obligatoriu în blocul dp, valori - true / false, determină dacă acțiunea widget poate fi întinsă în mai multe etape
6. Fișierele de localizare i18n
Așa cum ați fi observat, manifest.json folosește constructe precum widget.name. Sunt necesare dacă widget-ul dvs. ar trebui să funcționeze în mai multe limbi.
IMPORTANT: Dacă se utilizează 2 localizări, este necesar ca fișierele să fie identice în structură.
i18n / en.json
„Nume“. "Demo widget".
"SHORT_DESCRIPTION". "Widget pentru trimiterea unui contact la sistemul intern".
„Descriere“. "Un widget care servește pentru a trimite date de pe cartela de contact a domeniului dvs. # SUBDOMAIN # la sistemul intern"