Home » Articole » RO » Calculatoare » Dezvoltarea web » WordPress » Sintaxa formală API pentru scurtături în WordPress

Sintaxa formală API pentru scurtături în WordPress

postat în: WordPress 0

Sintaxa formală API

Scurtăturile WordPress nu folosesc caractere speciale, în același mod ca HTML. Parantezele pătrate pot părea la prima vedere magice, dar ele nu sunt cu adevărat parte din orice limbă. De exemplu:

[gallery]

Scurtătura gallery este analizată de API ca un simbol special, deoarece este o scurtătură înregistrată. Pe de altă parte, parantezele patrate sunt ignorate pur și simplu atunci când scurtătura dintre ele nu este înregistrată:

[ceva]

Simbolul ceva și parantezele sale pătrate sunt ignorate, deoarece ele nu fac parte din nicio scurtătură înregistrată.

Într-o lume perfecta, simbolul orice [*] ar putea fi manipulat de către API, dar trebuie să luăm în considerare următoarele provocări: parantezele pătrate sunt permise în HTML și nu sunt întotdeauna scurtături, parantezele unghiulare sunt permise în interiorul scurtăturilor numai în situații limitate, și toate acestea din cod trebuie să ruleze prin mai multe nivele de filtre și interpretoare personalizabile înainte de ieșire. Din cauza acestor probleme de compatibilitate lingvistice, parantezele pătrate nu pot fi magice.

Sintaxa scurtăturii utilizează aceste părți generale:

[nume atribute închise]

[nume atribute] Orice HTML sau scurtătură poate merge aici. [/ nume]

Scurtăturile libere sunt identice, dar au exact două paranteze suplimentare:

[[nume atribute închise]]

[[nume atribute] Orice HTML sau scurtătură poate merge aici. [/ nume]]

Din nou, scurtătura trebuie să fie înregistrată, în caz contrar toate cele patru exemple ar fi ignorate.

Nume

Numele scurtăturilor nu trebuie să conțină niciodată următoarele caractere:

  • Paranteze pătrate: []
  • Paranteze unghiulare: <>
  • Ampersand: &
  • Bară oblică: /
  • Spațiu liber: spațiu tab de linie
  • Caractere non-imprimabile: x00 – x20

Se recomandă să se evite, de asemenea, ghilimele în numele scurtăturilor:

  • Ghilimele: „”

Atribute

Atributele sunt opționale. Este nevoie de un spațiu între numele scurtăturii și atributele scurtăturii. Când se utilizează mai mult de un atribut, fiecare atribut trebuie să fie separate prin cel puțin un spațiu.

Fiecare atribut trebuie să fie conform cu una dintre aceste formate:

attribute_name = ‘valoare’

attribute_name = „valoare'”

attribute_name = valoare’

„valoare'”

valoare’

Numele de atribute sunt opționale și ar trebui să conțină numai caracterele următoare pentru compatibilitate pe toate platformele:

  • Majuscule și litere mici: A-Z a-z
  • Cifre: 0-9
  • Lini de subliniere: _
  • Cratimă: – (Nu este permisă înainte de versiunea 4.3.0)

Spațiile nu sunt permise în numele atributelor. Spațiile opționale pot fi utilizate între nume și semnul =. Spațiile opționale pot fi de asemenea utilizate între semnul = și valoare.

Valorile atributelor nu trebuie să conțină următoarele caractere:

  • Paranteze pătrate: []
  • Ghilimele: „”

Valorile fără ghilimele, de asemenea, nu trebuie să conțină spații.

Caracterele HTML < și > au doar un suport limitat în atribute.

Metoda recomandată de eliberare a caracterelor speciale în atributele scurtăturii este codarea HTML. Cel mai important, orice date introduse de utilizator care apare într-un atribut de scurtătură trebuie să fie eliberat sau deposedat de caractere speciale.

Rețineți că ghilimelele duble sunt permise în interiorul valorilor cu ghilimele simple și invers, însă acest lucru nu este recomandat în cazul datelor introduse de utilizator.

Următoarele caractere, în cazul în care nu sunt liberate într-o valoare de atribut, vor fi automat eliminate și convertite în spații:

  • Spațiu fără pauză: xC2xA0
  • Spațiu de lățime zero: xE2x80x8B

Auto-închiderea

Marcatorul de auto-închidere, o singură bară oblică, este opțional. Spațiul înainte de marcator este opțional. Spațiile nu sunt permise după marcator.

[exemplu /]

Marcatorul de auto-închidere este pur cosmetic și nu are niciun efect cu excepția faptului că va forța analizorul scurtăturii să ignore orice etichetă de închidere care îl urmează.

Scurtăturile tip de închidere pot să nu folosească un marcator de auto-închidere.

Eliberarea

WordPress încearcă să introducă ghilimele rotunde între etichetele [nume] și [/nume]. Se va procesa acest conținut la fel ca oricare altul. Începând cu 4.0.1, scurtăturile neînregistrate sunt, de asemenea, „texturizate” și acest lucru poate da naștere la paranteze rotunde neașteptate:

[ceva param=”test”]

Un exemplu mai bun ar fi:

<code>[ceva param=”test”]</code>

Elementul <code> este întotdeauna evitat în favoarea ghilimelelor rotunde.

Scurtăturile înregistrate sunt încă procesate în interiorul elementelor <code>. Pentru a elibera o scurtătură înregistrată pentru afișare pe site, sintaxa devine:

[[caption = param "test"]]

… care va afișa …

[caption = param "test"]

Elementul <code> este opțional în această situație.

Lasă un răspuns

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *