WP Trip Summary 0.2.8 – Emil Racoviță

După aproape doi ani de pauză (în care totuși am lucrat un pic), am reușit în sfârșit să lansez versiunea 0.2.8, denumită Emil Racoviță (mi-am propus să denumesc fiecare versiune după câte un explorator sau cartograf).

Nu sunt salturi spectaculoase și, de altfel, nici nu mi-am propus să procedez așa, dar, în primul rând, am reparat câteva dume:

avertizări care apăreau în consola browser-ului din cauză că includeam o serie de fișiere javascript acolo unde nu era cazul;
am reparat punctual librăria MysqliDb, care genera avertizări pentru o utilizare incorectă în versiunile mai noi de PHP a funcției implode;
– am reparat câteva probleme cu blocul de shortcode: o dată că nu era afișat (uneori) în selectorul de blocuri din editor, apoi că nu era redat (alteori) în pagina articolului.

Apoi, am adus și câteva îmbunătățiri:

– am adăugat două link-uri în pagina de listare a plug-in-urilor, pe rând-ul corespunzător acestui plug-in: unul către pagina de configurare, altul către pagina de mentenanță;
– se pot adăugat date structurate în format JSON-LD, pentru articolele care au un track GPS atașat folosind acest plug-in;
– am adăugat o pagină de mentenanță, prin care, momentan se pot efectua următoarele operațiuni: ștergerea cache-ului de track-uri GPS, ștergerea tuturor datelor gestionate de acest plug-in (mai puțin nomenclatoarele și opțiunile de configurare, evident) și, în sfârșit, găsirea articolelor care ar trebui să aibă track-uri GPS atașate, dar fișierele corespunzătoare lipsesc de pe disc;
am adăugat informații de auditare pentru cine și când a modificat ultima oară datele gestionate de acest modul, pentru fiecare articol în parte;
– am adăugat un câmp suplimentar la setul de date returnate de WordPress pentru un articol prin API-ul REST (/wp-json).

Mai jos reiau în detaliu trei din cele mai importante modificări.

Pagina de mentenanță

A fost inspirată de o nevoie personală: fiindcă sunt, poate, inteligent, chiar genial, lunea, marțea și vinerea, dar de-a dreptul bătut în cap precum berbecele la coaie miercurea și joia, ei bine, într-o miercuri, am reușit să șterg fișierele track-urilor pe care le-am încărcat pe acest site. Pentru unele aveam back-up, pentru altele nu, dar care lipseau?

A trebui să le iau la mână și chiar și acum mai lipsesc câteva. Așa că am construit secțiunea de mentenanță pornind de la o unealtă care să caute articolele aflate într-o situație similară și le-am adăugat pe celelalte două  mai mult ca un ajutor în procesul de dezvoltare.

Pagina de mentenanță

Pagina de mentenanță

Informații de auditare

Aceste informații erau oricum înregistrate încă de la început: am adăugat coloanele suplimentare dintr-un oarecare reflex și au rămas așa. Deci, de ce nu le-aș valorifica? Așa că am adăugat, în lista de articole din panoul de administrare un link care deschide o fereastră care le și prezintă.

Informații auditare

Informații auditare

Suplimentare API REST

Mi se părea un pas natural, odată ce informațiile gestionate de acest plug-in au fost mai mult sau mai puțin stabilizate. Nici nu mi-a fost foarte greu să implementez, deci, iată: câmpul wpts_trip_summary este acum disponibil (doar atunci când se cer detaliile unui articol prin API-ul REST) și oferă două categorii de date:

– informațiile care apar în tab-ul Detalii prozaice, dacă există;
– statisticile track-ului (altitudine minimă și maximă, coordonatele bounding-box-ului), dacă există.

Exemplu API REST

Exemplu API REST

În sfârșit, repet unde poate fi găsit plug-in-ul:

  • Pe directorul de plug-in-uri al WordPress: aici.
  • Pe GitHub, pentru cei care au și înclinații/curiozități tehnice: aici.