Schimbă o formulare

Ce este: o modalitate îngrijită de a redenumi orice text care apare în TSync — un buton, o etichetă, un element de meniu — într-o formulare care se potrivește afacerii tale. De exemplu, poate preferi „Prospect" peste tot unde TSync spune „Lead".

De ce te interesează: există un mod corect și un mod greșit de a face asta. Modul greșit (editarea fișierelor de text încorporate ale lui TSync) este șters data viitoare când actualizezi. Modul corect îți pune formularea într-un mic fișier separat pe care actualizările nu îl ating niciodată — așa că modificările tale rămân pe vecie. Acest ghid îți arată modul corect.

Trucul stă într-un singur fișier special numit custom_lang.php. Orice pui acolo suprascrie în liniște formularea implicită a lui TSync și rămâne în siguranță prin fiecare actualizare.

Pas cu pas

1. Găsește „numele" textului pe care vrei să îl schimbi

În culise, fiecare bucată de text are o etichetă scurtă pe care TSync o folosește ca să o găsească — pentru „New lead", eticheta este new_lead. Ai nevoie de acea etichetă ca suprascrierea ta să indice către textul corect.

Cel mai rapid mod de a o găsi este să cauți cuvintele pe care le vezi pe ecran în fișierul de text englez al lui TSync:

# Caută de unde provine „New lead"
grep -n "New lead" application/language/english/english_lang.php

Îți va arăta o linie ca aceasta:

429:$lang['new_lead'] = 'New lead';

Partea dintre paranteze drepte — new_lead — este eticheta de care ai nevoie.

(Există și un instrument încorporat sub Tools → Find Missing Translations care listează etichetele, ceea ce poate fi util de asemenea.)

2. Creează fișierul tău `custom_lang.php`

Acesta este fișierul sigur în care trăiește formularea ta. Creează-l (dacă nu există deja) în folderul pentru limba ta:

application/language/<language>/custom_lang.php

Pentru engleză, asta este:

application/language/english/custom_lang.php

3. Scrie formularea ta nouă

În interiorul acelui fișier, enumeră fiecare etichetă și formularea pe care ai prefera-o în schimb. Eticheta din stânga rămâne aceeași; textul dintre ghilimele din dreapta este al tău, de schimbat:

<?php

$lang['new_lead']    = 'New prospect';
$lang['leads']       = 'Prospects';
$lang['lead']        = 'Prospect';
$lang['lead_status'] = 'Prospect status';

4. Salvează și aruncă o privire

Reîmprospătează pagina în browser cu Ctrl + Shift + R (o „reîmprospătare forțată" care ignoră versiunea din cache). Formularea ta nouă ar trebui să apară imediat — fără să fie nevoie de repornire.

De ce funcționează asta

TSync își citește formularea într-o ordine stabilită: mai întâi textul încorporat, apoi custom_lang.php-ul tău. Pentru că al tău este citit ultimul, el are ultimul cuvânt — versiunea ta pur și simplu o înlocuiește pe cea implicită. Acesta este tot secretul și de aceea actualizările pot reîmprospăta textul încorporat fără să calce vreodată pe al tău.

Exemple utile de copiat

Redenumește „Lead" în „Prospect" peste tot

<?php

$lang['lead']                     = 'Prospect';
$lang['leads']                    = 'Prospects';
$lang['new_lead']                 = 'New prospect';
$lang['lead_status']              = 'Prospect status';
$lang['lead_source']              = 'Prospect source';
$lang['leads_summary']            = 'Prospects summary';
$lang['lead_lowercase']           = 'prospect';

Reformulează mesajele pe care le văd clienții tăi

<?php

$lang['client_invalid_username_or_password'] = 'Wrong email or password. Please try again.';
$lang['inactive_account']                    = 'Account disabled. Contact your administrator.';

Reetichetează câmpurile din formulare

<?php

$lang['client_company']    = 'Company name';
$lang['client_vat_number'] = 'Tax ID';
$lang['clients_email']     = 'Contact email';

Câteva lucruri de ținut minte

Sunt mărunte, ușor de urmat și îți vor scuti o bătaie de cap:

Păstrează punctuația îngrijită. Fiecare linie trebuie să se termine cu punct și virgulă (;). Unul singur lipsă poate face paginile să nu se mai încarce — așa că, după editare, doar reîmprospătează o pagină ca să confirmi că totul se mai deschide. Dacă o pagină se comportă ciudat, un ; uitat este primul lucru de verificat.
Atenție la apostrofuri. Textul este încadrat în ghilimele simple. Dacă formularea ta conține un apostrof, pune un backslash în fața lui ca să nu termine linia mai devreme — de exemplu 'L\'utilisateur'.
Doar adaugă și înlocuiește — nu șterge liniile lui TSync. Dacă vreodată vrei ca o etichetă să nu afișeze nimic deloc, seteaz-o la ghilimele goale: $lang['xxx'] = '';

După ce actualizezi TSync

Mai întâi vestea bună: actualizările nu suprascriu niciodată custom_lang.php — formularea ta este în siguranță. Două lucruri mărunte care merită o privire după aceea:

Funcțiile noi pot introduce text nou pe care nu l-ai personalizat încă — doar adaugă acele etichete când le observi.
Foarte rar, o etichetă este redenumită într-o versiune nouă. Dacă una dintre suprascrierile tale pare brusc să „nu mai funcționeze", probabil eticheta originală a fost redenumită — găsește-o pe cea nouă și actualizează-ți fișierul.